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 (строка)
Определяет тип создаваемой задачи.
Возможные значения:
IMPORTEXPORTLOCAL_USE
--resources (структура)
Определяет Amazon S3-хранилища, связанные с этой задачей.
Для задач IMPORT вы указываете ведро или ведра, в которые будет импортирована переносимая информация.
Для задач EXPORT вы указываете ведро или ведра, из которых будет экспортирована переносимая информация. Дополнительно можно указать значение KeyRange. Если вы выбираете экспорт диапазона, вы определяете длину диапазона, указав значение BeginMarker, значение EndMarker или оба. Диапазоны сортируются в двоичном порядке UTF-8.
S3Resources -> (список)
Массив объектов S3Resource.
(структура)
Каждый объект S3Resource представляет Amazon S3-хранилище, из которого или в которое будет экспортирована или импортирована переносимая информация. Для задач экспорта этот объект может иметь необязательное значение KeyRange. Длина диапазона определяется при создании задачи и задается значением BeginMarker, EndMarker или обоими. Диапазоны сортируются в двоичном порядке UTF-8.
BucketArn -> (строка)
KeyRange -> (структура)
Для задач экспорта вы можете указать необязательный KeyRange в определенном Amazon S3-хранилище. Длина диапазона определяется при создании задачи и задается значением BeginMarker, EndMarker или обоими. Диапазоны сортируются в двоичном порядке UTF-8.
BeginMarker -> (строка)
EndMarker -> (строка)
TargetOnDeviceServices -> (список)
Указывает сервис или сервисы на устройстве семейства Snow, из которых или в которые будет экспортирована или импортирована переносимая информация. Amazon Web Services Snow Family поддерживает Amazon S3 и NFS (сетевую файловую систему).
(структура)
Объект, представляющий сервис или сервисы на устройстве семейства Snow, из которых или в которые будет экспортирована или импортирована переносимая информация. Amazon Web Services Snow Family поддерживает Amazon S3 и NFS (сетевую файловую систему).
ServiceName -> (строка)
TransferOption -> (строка)
LambdaResources -> (список)
Функции Lambda на языке Python для этой задачи.
(структура)
Идентифицирует
LambdaArn -> (строка)
EventTriggers -> (список)
Массив ARN для объектов S3Resource, которые будут запускать объекты LambdaResource, связанные с этой задачей.
(структура)
Контейнер для EventTriggerDefinition$EventResourceARN.
EventResourceARN -> (строка)
Ec2AmiResources -> (список)
Ассоциированные Amazon Machine Images (AMI) для этой задачи.
(структура)
Объект в формате JSON, содержащий идентификаторы Amazon Machine Image (AMI), включая идентификатор AMI, совместимый с Amazon EC2, и идентификатор AMI устройства Snow. У каждой AMI есть эти два идентификатора для упрощения идентификации AMI в облаке Amazon Web Services и на устройстве.
AmiId -> (строка)
SnowballAmiId -> (строка)
Синтаксис 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 -> (целое число)
StorageUnit -> (строка)
Единица измерения масштаба хранения NFS на устройстве.
Допустимые значения: ТБ.
TGWOnDeviceService -> (структура)
Представляет сервис Storage Gateway типа Tape Gateway на устройстве семейства Snow.
StorageLimit -> (целое число)
StorageUnit -> (строка)
EKSOnDeviceService -> (структура)
Настройка EKS Anywhere на устройстве семейства Snow.
KubernetesVersion -> (строка)
EKSAnywhereVersion -> (строка)
S3OnDeviceService -> (структура)
Настройка совместимого с Amazon S3 хранилища на устройствах семейства Snow.
StorageLimit -> (двойное число)
StorageUnit -> (строка)
ServiceSize -> (целое число)
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 (строка)
--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.
Возможные значения:
T50T80T100T42T98T8T14T32NoPreferenceT240T13
--shipping-option (строка)
Скорость доставки для этой задачи. Эта скорость не определяет, как скоро вы получите устройство Snow, а скорее отражает, насколько быстро устройство Snow добирается до пункта назначения во время транспортировки. Региональные скорости доставки следующие:
- В Австралии доступна экспресс-доставка. Обычно устройства Snow, отправленные экспресс-доставкой, доставляются в течение дня.
- В странах Европейского союза (ЕС) доступна экспресс-доставка. Обычно устройства Snow, отправленные экспресс-доставкой, доставляются в течение дня. Кроме того, большинство стран ЕС имеют доступ к стандартной доставке, которая обычно занимает меньше недели в одну сторону.
- В Индии устройства Snow доставляются в течение одного-семи дней.
- В США доступна доставка в один и два дня.
Возможные значения:
SECOND_DAYNEXT_DAYEXPRESSSTANDARD
--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 -> (строка)
Сокращенный синтаксис:
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.
Возможные значения:
STANDARDEDGEEDGE_CEDGE_CGEDGE_SSNC1_HDDSNC1_SSDV3_5CV3_5SRACK_5U_C
--forwarding-address-id (строка)
--tax-documents (структура)
Налоговые документы, требуемые в вашем регионе Amazon Web Services.
IND -> (структура)
Налоговые документы, требуемые в регионе Amazon Web Services в Индии.
GSTIN -> (строка)
Сокращенная синтаксическая запись:
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 -> (булево)
Сокращенная синтаксическая запись:
SnowconeDeviceConfiguration={WirelessConnection={IsWifiEnabled=boolean}}
Синтаксис JSON:
{
"SnowconeDeviceConfiguration": {
"WirelessConnection": {
"IsWifiEnabled": true|false
}
}
}
--remote-management (строка)
Позволяет удалённо и безопасно управлять устройствами Snowcone извне вашей внутренней сети. При установке значения INSTALLED_AUTOSTART удалённое управление автоматически будет доступно по прибытии устройства в ваше местоположение. В противном случае для управления устройством необходимо использовать клиент Snowball Edge. При установке значения NOT_INSTALLED удалённое управление на устройстве будет недоступно.
Возможные значения:
INSTALLED_ONLYINSTALLED_AUTOSTARTNOT_INSTALLED
--long-term-pricing-id (строка)
--impact-level (строка)
Максимальный уровень влияния данных, которые будут храниться или обрабатываться на устройстве, предоставленный при создании задачи.
Возможные значения:
IL2IL4IL5IL6IL99
--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.