Spec-Zone.ru › AWS CLI v2

[ aws . snowball ]

create-job

Описание

Создаёт задание для импорта или экспорта данных между Amazon S3 и вашим локальным дата-центром. Ваша учётная запись Amazon Web Services должна иметь соответствующие политики доверия и разрешения для создания задания для устройства Snow. Если вы создаёте задание для узла в кластере, вам нужно указать только значение clusterId; другие атрибуты задания наследуются из кластера.

Примечание

При заказе заданий для кластеров поддерживается только тип устройства Snowball Edge.

Ёмкость устройства является необязательной.

Доступность типов устройств различается в зависимости от региона Amazon Web Services. Дополнительную информацию о доступности в регионах см. в документации Amazon Web Services Regional Services.

Устройства семейства Snow и их ёмкости.

  • Тип устройства: SNC1_SSD
    • Ёмкость: T14
    • Описание: Snowcone
  • Тип устройства: SNC1_HDD
    • Ёмкость: T8
    • Описание: Snowcone
  • Тип устройства: EDGE_S
    • Ёмкость: T98
    • Описание: Snowball Edge, оптимизированное для передачи данных
  • Тип устройства: EDGE_CG
    • Ёмкость: T42
    • Описание: Snowball Edge, оптимизированное для вычислений с графическим процессором (GPU)
  • Тип устройства: EDGE_C
    • Ёмкость: T42
    • Описание: Snowball Edge, оптимизированное для вычислений без графического процессора (GPU)
  • Тип устройства: EDGE
    • Ёмкость: T100
    • Описание: Snowball Edge, оптимизированное для хранения с вычислениями EC2

Примечание

Это устройство заменено на T98.
  • Тип устройства: STANDARD

    • Ёмкость: T50
    • Описание: Исходное устройство Snowball

    Примечание

    Это устройство доступно только в регионах Ningxia, Пекин и Сингапур Amazon Web Services

  • Тип устройства: STANDARD

    • Ёмкость: T80
    • Описание: Исходное устройство Snowball

    Примечание

    Это устройство доступно только в регионах Ningxia, Пекин и Сингапур Amazon Web Services.

  • Тип устройства семейства Snow: RACK_5U_C

    • Ёмкость: T13
    • Описание: Snowblade.
  • Тип устройства: V3_5S

    • Ёмкость: T240
    • Описание: Snowball Edge, оптимизированное для хранения, 210 ТБ

См. также: AWS API Documentation

Синопсис

  create-job
[--job-type <value>]
[--resources <value>]
[--on-device-service-configuration <value>]
[--description <value>]
[--address-id <value>]
[--kms-key-arn <value>]
[--role-arn <value>]
[--snowball-capacity-preference <value>]
[--shipping-option <value>]
[--notification <value>]
[--cluster-id <value>]
[--snowball-type <value>]
[--forwarding-address-id <value>]
[--tax-documents <value>]
[--device-configuration <value>]
[--remote-management <value>]
[--long-term-pricing-id <value>]
[--impact-level <value>]
[--pickup-details <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--job-type (строка)

Определяет тип создаваемой задачи.

Возможные значения:

  • IMPORT
  • EXPORT
  • LOCAL_USE

--resources (структура)

Определяет Amazon S3-хранилища, связанные с этой задачей.

Для задач IMPORT вы указываете ведро или ведра, в которые будет импортирована переносимая информация.

Для задач EXPORT вы указываете ведро или ведра, из которых будет экспортирована переносимая информация. Дополнительно можно указать значение KeyRange. Если вы выбираете экспорт диапазона, вы определяете длину диапазона, указав значение BeginMarker, значение EndMarker или оба. Диапазоны сортируются в двоичном порядке UTF-8.

S3Resources -> (список)

Массив объектов S3Resource.

(структура)

Каждый объект S3Resource представляет Amazon S3-хранилище, из которого или в которое будет экспортирована или импортирована переносимая информация. Для задач экспорта этот объект может иметь необязательное значение KeyRange. Длина диапазона определяется при создании задачи и задается значением BeginMarker, EndMarker или обоими. Диапазоны сортируются в двоичном порядке UTF-8.

BucketArn -> (строка)

Идентификатор ресурса Amazon (ARN) Amazon S3-хранилища.

KeyRange -> (структура)

Для задач экспорта вы можете указать необязательный KeyRange в определенном Amazon S3-хранилище. Длина диапазона определяется при создании задачи и задается значением BeginMarker, EndMarker или обоими. Диапазоны сортируются в двоичном порядке UTF-8.

BeginMarker -> (строка)

Ключ, начинающий необязательный диапазон ключей для задачи экспорта. Диапазоны включают граничные значения и сортируются в двоичном порядке UTF-8.

EndMarker -> (строка)

Ключ, завершающий необязательный диапазон ключей для задачи экспорта. Диапазоны включают граничные значения и сортируются в двоичном порядке UTF-8.

TargetOnDeviceServices -> (список)

Указывает сервис или сервисы на устройстве семейства Snow, из которых или в которые будет экспортирована или импортирована переносимая информация. Amazon Web Services Snow Family поддерживает Amazon S3 и NFS (сетевую файловую систему).

(структура)

Объект, представляющий сервис или сервисы на устройстве семейства Snow, из которых или в которые будет экспортирована или импортирована переносимая информация. Amazon Web Services Snow Family поддерживает Amazon S3 и NFS (сетевую файловую систему).

ServiceName -> (строка)

Указывает имя сервиса на устройстве семейства Snow, из которого или в который будет экспортирована или импортирована переносимая информация.

TransferOption -> (строка)

Указывает, импортируются или экспортируются данные, или они используются локально на устройстве.

LambdaResources -> (список)

Функции Lambda на языке Python для этой задачи.

(структура)

Идентифицирует

LambdaArn -> (строка)

Идентификатор ресурса Amazon (ARN), представляющий функцию Lambda, которая должна быть вызвана действиями PUT объекта на связанном локальном Amazon S3-ресурсе.

EventTriggers -> (список)

Массив ARN для объектов S3Resource, которые будут запускать объекты LambdaResource, связанные с этой задачей.

(структура)

Контейнер для EventTriggerDefinition$EventResourceARN.

EventResourceARN -> (строка)

Идентификатор ресурса Amazon (ARN) любого локального Amazon S3-ресурса, являющегося триггером события функции Lambda, связанной с этой задачей.

Ec2AmiResources -> (список)

Ассоциированные Amazon Machine Images (AMI) для этой задачи.

(структура)

Объект в формате JSON, содержащий идентификаторы Amazon Machine Image (AMI), включая идентификатор AMI, совместимый с Amazon EC2, и идентификатор AMI устройства Snow. У каждой AMI есть эти два идентификатора для упрощения идентификации AMI в облаке Amazon Web Services и на устройстве.

AmiId -> (строка)

Идентификатор AMI в Amazon EC2.

SnowballAmiId -> (строка)

Идентификатор AMI на устройстве Snow.

Синтаксис JSON:

{
  "S3Resources": [
    {
      "BucketArn": "string",
      "KeyRange": {
        "BeginMarker": "string",
        "EndMarker": "string"
      },
      "TargetOnDeviceServices": [
        {
          "ServiceName": "NFS_ON_DEVICE_SERVICE"|"S3_ON_DEVICE_SERVICE",
          "TransferOption": "IMPORT"|"EXPORT"|"LOCAL_USE"
        }
        ...
      ]
    }
    ...
  ],
  "LambdaResources": [
    {
      "LambdaArn": "string",
      "EventTriggers": [
        {
          "EventResourceARN": "string"
        }
        ...
      ]
    }
    ...
  ],
  "Ec2AmiResources": [
    {
      "AmiId": "string",
      "SnowballAmiId": "string"
    }
    ...
  ]
}

--on-device-service-configuration (структура)

Указывает сервис или сервисы на устройстве семейства Snow, из которых или в которые будет экспортирована или импортирована переносимая информация. Amazon Web Services Snow Family поддерживает Amazon S3, NFS (сетевую файловую систему) и сервис Amazon Web Services Storage Gateway типа Tape Gateway.

NFSOnDeviceService -> (структура)

Представляет сервис NFS (сетевую файловую систему) на устройстве семейства Snow.

StorageLimit -> (целое число)

Максимальный объем хранения NFS для одного устройства семейства Snow.

StorageUnit -> (строка)

Единица измерения масштаба хранения NFS на устройстве.

Допустимые значения: ТБ.

TGWOnDeviceService -> (структура)

Представляет сервис Storage Gateway типа Tape Gateway на устройстве семейства Snow.

StorageLimit -> (целое число)

Максимальное количество виртуальных лент для хранения на одном устройстве семейства Snow. Из-за ограничений физических ресурсов для Snowball Edge это значение должно быть установлено в 80.

StorageUnit -> (строка)

Единица измерения масштаба виртуальных лент на устройстве.

EKSOnDeviceService -> (структура)

Настройка EKS Anywhere на устройстве семейства Snow.

KubernetesVersion -> (строка)

Версия Kubernetes для EKS Anywhere на устройстве семейства Snow.

EKSAnywhereVersion -> (строка)

Необязательная версия EKS Anywhere на устройстве семейства Snow.

S3OnDeviceService -> (структура)

Настройка совместимого с Amazon S3 хранилища на устройствах семейства Snow.

StorageLimit -> (двойное число)

Если указанное значение лимита хранилища совпадает с лимитом хранилища одной из определенных конфигураций, будет использована эта конфигурация. Если указанное значение лимита хранилища не совпадает ни с одной из определенных конфигураций, запрос завершится неудачно. Если несколько конфигураций имеют одинаковый лимит хранилища, как указано, необходимо предоставить другие входные данные.

StorageUnit -> (строка)

Единица измерения хранилища. В настоящее время поддерживается только единица измерения ТБ.

ServiceSize -> (целое число)

Применимо при создании кластера. Указывает, сколько узлов требуется для совместимого с Amazon S3 хранилища на устройствах семейства Snow. Если указано, другие входные данные можно опустить.

FaultTolerance -> (целое число)

>Уровень отказоустойчивости кластера. Это указывает, сколько узлов может выйти из строя, не снижая производительность кластера. Эти дополнительные входные данные полезны, когда указанное StorageLimit соответствует более чем одной конфигурации сервиса совместимого с Amazon S3 хранилища на устройствах семейства Snow.

Сокращенный синтаксис:

NFSOnDeviceService={StorageLimit=integer,StorageUnit=string},TGWOnDeviceService={StorageLimit=integer,StorageUnit=string},EKSOnDeviceService={KubernetesVersion=string,EKSAnywhereVersion=string},S3OnDeviceService={StorageLimit=double,StorageUnit=string,ServiceSize=integer,FaultTolerance=integer}

Синтаксис JSON:

{
  "NFSOnDeviceService": {
    "StorageLimit": integer,
    "StorageUnit": "TB"
  },
  "TGWOnDeviceService": {
    "StorageLimit": integer,
    "StorageUnit": "TB"
  },
  "EKSOnDeviceService": {
    "KubernetesVersion": "string",
    "EKSAnywhereVersion": "string"
  },
  "S3OnDeviceService": {
    "StorageLimit": double,
    "StorageUnit": "TB",
    "ServiceSize": integer,
    "FaultTolerance": integer
  }
}

--description (строка)

Определяет необязательное описание этой конкретной задачи, например Important Photos 2016-08-11.

--address-id (строка)

Идентификатор адреса, по которому вы хотите отправить устройство Snow.

--kms-key-arn (строка)

KmsKeyARN, который вы хотите связать с этой задачей. KmsKeyARN создаются с помощью действия API CreateKey сервиса управления ключами (KMS).

--role-arn (строка)

RoleARN, который вы хотите связать с этой задачей. RoleArn создаются с помощью действия API CreateRole сервиса управления идентификацией и доступом (IAM).

--snowball-capacity-preference (строка)

Если ваша задача создается в одном из регионов США, вы можете указать размер устройства Snow, которое вам нужно для этой задачи. Во всех других регионах Snowballs имеют 80 ТБ емкости хранилища.

Дополнительную информацию см. в разделе «https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html» (Типы устройств семейства Snow и емкость) в Руководстве пользователя Snowcone или «https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html» (Типы устройств семейства Snow и емкость) в Руководстве пользователя Snowcone.

Возможные значения:

  • T50
  • T80
  • T100
  • T42
  • T98
  • T8
  • T14
  • T32
  • NoPreference
  • T240
  • T13

--shipping-option (строка)

Скорость доставки для этой задачи. Эта скорость не определяет, как скоро вы получите устройство Snow, а скорее отражает, насколько быстро устройство Snow добирается до пункта назначения во время транспортировки. Региональные скорости доставки следующие:

  • В Австралии доступна экспресс-доставка. Обычно устройства Snow, отправленные экспресс-доставкой, доставляются в течение дня.
  • В странах Европейского союза (ЕС) доступна экспресс-доставка. Обычно устройства Snow, отправленные экспресс-доставкой, доставляются в течение дня. Кроме того, большинство стран ЕС имеют доступ к стандартной доставке, которая обычно занимает меньше недели в одну сторону.
  • В Индии устройства Snow доставляются в течение одного-семи дней.
  • В США доступна доставка в один и два дня.

Возможные значения:

  • SECOND_DAY
  • NEXT_DAY
  • EXPRESS
  • STANDARD

--notification (структура)

Определяет параметры уведомлений Amazon Simple Notification Service (Amazon SNS) для этой задачи.

SnsTopicARN -> (строка)

Новый SNS-TopicArn, который вы хотите связать с этой задачей. Вы можете создавать идентификаторы ресурсов Amazon (ARN) для тем с помощью действия API CreateTopic Amazon SNS.

Вы можете подписывать адреса электронной почты на тему Amazon SNS через консоль управления Amazon Web Services или с помощью действия API Subscribe Amazon Simple Notification Service (Amazon SNS).

JobStatesToNotify -> (список)

Список состояний задачи, которые будут вызывать уведомление для этой задачи.

(строка)

NotifyAll -> (булево)

Любое изменение состояния задачи вызовет уведомление для этой задачи.

DevicePickupSnsTopicARN -> (строка)

Используется для отправки уведомлений SNS лицу, которое забирает устройство (определено при создании задачи).

Сокращенный синтаксис:

SnsTopicARN=string,JobStatesToNotify=string,string,NotifyAll=boolean,DevicePickupSnsTopicARN=string

Синтаксис JSON:

{
  "SnsTopicARN": "string",
  "JobStatesToNotify": ["New"|"PreparingAppliance"|"PreparingShipment"|"InTransitToCustomer"|"WithCustomer"|"InTransitToAWS"|"WithAWSSortingFacility"|"WithAWS"|"InProgress"|"Complete"|"Cancelled"|"Listing"|"Pending", ...],
  "NotifyAll": true|false,
  "DevicePickupSnsTopicARN": "string"
}

--cluster-id (строка)

Идентификатор кластера. Если вы создаете задачу для узла в кластере, вам нужно указать только это clusterId значение. Другие атрибуты задачи наследуются из кластера.

--snowball-type (строка)

Тип устройств Snow Family, которые следует использовать для этой задачи.

Примечание

Для задач кластеров Amazon Web Services Snow Family в настоящее время поддерживается только тип устройства EDGE.

Тип устройства Amazon Web Services Snow, которое следует использовать для этой задачи. В настоящее время единственный поддерживаемый тип устройства для задач кластеров — EDGE.

Дополнительную информацию см. в разделе «Параметры устройств Snowball Edge» в руководстве разработчика Snowball Edge.

Дополнительную информацию см. на странице «https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html» (Устройства семейства Snow и их ёмкость) в руководстве пользователя Snowcone или на странице «https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html» (Устройства семейства Snow и их ёмкость) в руководстве пользователя Snowcone.

Возможные значения:

  • STANDARD
  • EDGE
  • EDGE_C
  • EDGE_CG
  • EDGE_S
  • SNC1_HDD
  • SNC1_SSD
  • V3_5C
  • V3_5S
  • RACK_5U_C

--forwarding-address-id (строка)

Идентификатор адреса переадресации для задачи. Это поле не поддерживается в большинстве регионов.

--tax-documents (структура)

Налоговые документы, требуемые в вашем регионе Amazon Web Services.

IND -> (структура)

Налоговые документы, требуемые в регионе Amazon Web Services в Индии.

GSTIN -> (строка)

Документы по Налогу на товары и услуги (GST), необходимые в регионе Amazon Web Services в Индии.

Сокращенная синтаксическая запись:

IND={GSTIN=string}

Синтаксис JSON:

{
  "IND": {
    "GSTIN": "string"
  }
}

--device-configuration (структура)

Определяет конфигурацию устройства для задачи Snowcone.

Дополнительную информацию см. на странице «https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html» (Устройства семейства Snow и их ёмкость) в руководстве пользователя Snowcone или на странице «https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html» (Устройства семейства Snow и их ёмкость) в руководстве пользователя Snowcone.

SnowconeDeviceConfiguration -> (структура)

Возвращает сведения о конфигурации устройства для задачи Snowcone.

WirelessConnection -> (структура)

Настраивает беспроводное подключение для устройства Snowcone.

IsWifiEnabled -> (булево)

Включает адаптер Wi-Fi на устройстве Snowcone.

Сокращенная синтаксическая запись:

SnowconeDeviceConfiguration={WirelessConnection={IsWifiEnabled=boolean}}

Синтаксис JSON:

{
  "SnowconeDeviceConfiguration": {
    "WirelessConnection": {
      "IsWifiEnabled": true|false
    }
  }
}

--remote-management (строка)

Позволяет удалённо и безопасно управлять устройствами Snowcone извне вашей внутренней сети. При установке значения INSTALLED_AUTOSTART удалённое управление автоматически будет доступно по прибытии устройства в ваше местоположение. В противном случае для управления устройством необходимо использовать клиент Snowball Edge. При установке значения NOT_INSTALLED удалённое управление на устройстве будет недоступно.

Возможные значения:

  • INSTALLED_ONLY
  • INSTALLED_AUTOSTART
  • NOT_INSTALLED

--long-term-pricing-id (строка)

Идентификатор типа ценообразования на длительный срок для устройства.

--impact-level (строка)

Максимальный уровень влияния данных, которые будут храниться или обрабатываться на устройстве, предоставленный при создании задачи.

Возможные значения:

  • IL2
  • IL4
  • IL5
  • IL6
  • IL99

--pickup-details (структура)

Информация, идентифицирующая человека, забирающего устройство.

Name -> (строка)

Имя человека, забирающего устройство.

PhoneNumber -> (строка)

Номер телефона человека, забирающего устройство.

Email -> (строка)

Адрес электронной почты человека, забирающего устройство.

IdentificationNumber -> (строка)

Номер удостоверения личности человека, забирающего устройство.

IdentificationExpirationDate -> (метка времени)

Дата истечения срока действия удостоверения личности человека, забирающего устройство.

IdentificationIssuingOrg -> (строка)

Организация, выпустившая удостоверение личности человека, забирающего устройство.

DevicePickupId -> (строка)

Уникальный идентификатор устройства, которое будет забрано.

Сокращенная синтаксическая запись:

Name=string,PhoneNumber=string,Email=string,IdentificationNumber=string,IdentificationExpirationDate=timestamp,IdentificationIssuingOrg=string,DevicePickupId=string

Синтаксис JSON:

{
  "Name": "string",
  "PhoneNumber": "string",
  "Email": "string",
  "IdentificationNumber": "string",
  "IdentificationExpirationDate": timestamp,
  "IdentificationIssuingOrg": "string",
  "DevicePickupId": "string"
}

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения, используя значение, предоставленное в JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если не указано значение или указано значение input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если указано значение output, он проверит входные данные команд и вернёт пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладовую запись.

--endpoint-url (строка)

Переопределить значение URL по умолчанию для команды указанным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, который будет использоваться для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (булево)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросить параметры ввода CLI.

Вывод

JobId -> (строка)

Автоматически сгенерированный идентификатор для задачи, например, JID123e4567-e89b-12d3-a456-426655440000.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API