CreateJob

Cria um trabalho para importar ou exportar dados entre o Amazon S3 e o datacenter on-premises. Você Conta da AWS deve ter as políticas e permissões de confiança corretas para criar um trabalho para um dispositivo Snow. Se você estiver criando um trabalho para um nó em um cluster, basta fornecer o valor de clusterId; os outros atributos do trabalho são herdados do cluster.

nota

Somente o tipo de dispositivo Snowball; Edge é compatível ao solicitar trabalhos em cluster.

A capacidade do dispositivo é opcional.

A disponibilidade dos tipos de dispositivos varia por Região da AWS. Para obter mais informações sobre a disponibilidade da região, consulte Serviços regionais da AWS.

Dispositivos da Família Snow e suas capacidades.

• Tipo de dispositivo: SNC1_SSD

  • Capacidade: T14

  • Descrição: Snowcone

• Tipo de dispositivo: SNC1_HDD

  • Capacidade: T8

  • Descrição: Snowcone

• Tipo de dispositivo: EDGE_S

  • Capacidade: T98

  • Descrição: armazenamento Snowball Edge otimizado somente para transferência de dados

• Tipo de dispositivo: EDGE_CG

  • Capacidade: T42

  • Descrição: computação Snowball Edge otimizada com GPU

• Tipo de dispositivo: EDGE_C

  • Capacidade: T42

  • Descrição: computação Snowball Edge otimizada sem GPU

• Tipo de dispositivo: EDGE

  • Capacidade: T100

  • Descrição: armazenamento Snowball Edge otimizado com computação EC2

  nota

  Este dispositivo foi substituído pelo T98.

• Tipo de dispositivo: STANDARD

  • Capacidade: T50

  • Descrição: dispositivo Snowball original

    nota

    Este dispositivo está disponível apenas em Ningxia, Pequim e Cingapura Região da AWS

• Tipo de dispositivo: STANDARD

  • Capacidade: T80

  • Descrição: dispositivo Snowball original

    nota

    Este dispositivo está disponível apenas na Região da AWS Ningxia, Pequim e Singapura.

• Tipo de dispositivo da Família Snow: RACK_5U_C

  • Capacidade: T13

  • Descrição: Snowblade.

• Tipo de dispositivo: V3_5S

  • Capacidade: T240

  • Descrição: armazenamento Snowball Edge otimizado com 210TB

Sintaxe da Solicitação

{
   "AddressId": "string",
   "ClusterId": "string",
   "Description": "string",
   "DeviceConfiguration": { 
      "SnowconeDeviceConfiguration": { 
         "WirelessConnection": { 
            "IsWifiEnabled": boolean
         }
      }
   },
   "ForwardingAddressId": "string",
   "ImpactLevel": "string",
   "JobType": "string",
   "KmsKeyARN": "string",
   "LongTermPricingId": "string",
   "Notification": { 
      "DevicePickupSnsTopicARN": "string",
      "JobStatesToNotify": [ "string" ],
      "NotifyAll": boolean,
      "SnsTopicARN": "string"
   },
   "OnDeviceServiceConfiguration": { 
      "EKSOnDeviceService": { 
         "EKSAnywhereVersion": "string",
         "KubernetesVersion": "string"
      },
      "NFSOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "S3OnDeviceService": { 
         "FaultTolerance": number,
         "ServiceSize": number,
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "TGWOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      }
   },
   "PickupDetails": { 
      "DevicePickupId": "string",
      "Email": "string",
      "IdentificationExpirationDate": number,
      "IdentificationIssuingOrg": "string",
      "IdentificationNumber": "string",
      "Name": "string",
      "PhoneNumber": "string"
   },
   "RemoteManagement": "string",
   "Resources": { 
      "Ec2AmiResources": [ 
         { 
            "AmiId": "string",
            "SnowballAmiId": "string"
         }
      ],
      "LambdaResources": [ 
         { 
            "EventTriggers": [ 
               { 
                  "EventResourceARN": "string"
               }
            ],
            "LambdaArn": "string"
         }
      ],
      "S3Resources": [ 
         { 
            "BucketArn": "string",
            "KeyRange": { 
               "BeginMarker": "string",
               "EndMarker": "string"
            },
            "TargetOnDeviceServices": [ 
               { 
                  "ServiceName": "string",
                  "TransferOption": "string"
               }
            ]
         }
      ]
   },
   "RoleARN": "string",
   "ShippingOption": "string",
   "SnowballCapacityPreference": "string",
   "SnowballType": "string",
   "TaxDocuments": { 
      "IND": { 
         "GSTIN": "string"
      }
   }
}

Parâmetros da solicitação

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte Parâmetros comuns.

A solicitação aceita os dados a seguir no formato JSON.

AddressId

O ID do endereço para onde você deseja que o dispositivo Snow seja enviado.

Tipo: sequência

Restrições de tamanho: tamanho fixo de 40.

Padrão: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: não

ClusterId

O ID de um cluster. Se você estiver criando um trabalho para um nó em um cluster, precisará fornecer somente esse valor de clusterId. Os outros atributos do trabalho são herdados do cluster.

Tipo: sequência

Restrições de tamanho: tamanho fixo de 39.

Padrão: CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: não

Description

Define uma descrição opcional desse trabalho específico, por exemplo, Important Photos 2016-08-11.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

Padrão: .*

Obrigatório: não

DeviceConfiguration

Define a configuração do dispositivo para um AWS Snowcone trabalho.

Para obter informações sobre os tipos de dispositivos da Família Snow, consulte Snow Devices and Capacity no Snowcone User Guide ou Snow Devices and Capacity no Snowball Edge User Guide.

Tipo: objeto DeviceConfiguration

Obrigatório: Não

ForwardingAddressId

Esse campo não é compatível com a sua região.

Tipo: sequência

Restrições de tamanho: tamanho fixo de 40.

Padrão: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: não

ImpactLevel

O maior nível de impacto dos dados que serão armazenados ou processados no dispositivo, fornecido na criação do trabalho.

Tipo: sequências

Valores Válidos: IL2 | IL4 | IL5 | IL6 | IL99

Obrigatório: não

JobType

Define o tipo de trabalho que você está criando.

Tipo: sequências

Valores Válidos: IMPORT | EXPORT | LOCAL_USE

Obrigatório: não

KmsKeyARN

O KmsKeyARN que você deseja associar a esse trabalho. KmsKeyARNs são criados usando a ação da API CreateKey AWS Key Management Service (KMS).

Tipo: sequência

Restrições de tamanho: tamanho máximo de 255.

Padrão: arn:aws.*:kms:.*:[0-9]{12}:key/.*

Obrigatório: não

LongTermPricingId

O ID do tipo de preço de longo prazo do dispositivo.

Tipo: sequência

Restrições de tamanho: tamanho fixo de 41.

Padrão: LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: não

Notification

As configurações de notificação do Amazon Simple Notification Service (Amazon SNS) para esse trabalho.

Tipo: objeto Notification

Obrigatório: Não

OnDeviceServiceConfiguration

Especifica o serviço ou serviços no dispositivo da família Snow dos quais seus dados transferidos serão exportados ou importados. AWS O Snow Family é compatível com Amazon S3 e NFS (Network File System).

Tipo: objeto OnDeviceServiceConfiguration

Obrigatório: Não

PickupDetails

Informações que identificam a pessoa que está retirando o dispositivo.

Tipo: objeto PickupDetails

Obrigatório: Não

RemoteManagement

Permite que você opere e gerencie dispositivos Snowcone de forma segura remotamente, de fora da sua rede interna. Quando definido como INSTALLED_AUTOSTART, o gerenciamento remoto estará disponível automaticamente quando o dispositivo chegar ao seu local. Caso contrário, você precisará usar o cliente do Snowball Edge para gerenciar o dispositivo. Quando definido como NOT_INSTALLED, o gerenciamento remoto não estará disponível no dispositivo.

Tipo: sequências

Valores Válidos: INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED

Obrigatório: não

Resources

Define os buckets do Amazon S3 associados a esse trabalho.

Com trabalhos IMPORT, você especifica o bucket ou os buckets para os quais seus dados transferidos serão importados.

Com trabalhos EXPORT, você especifica o bucket ou os buckets do(s) qual(is) seus dados transferidos serão exportados. Como opção, também é possível especificar um valor de KeyRange. Se você optar por exportar um intervalo, o tamanho do intervalo é definido fornecendo, opcionalmente, um valor de BeginMarker inclusivo, um valor de EndMarker inclusivo, ou ambos. Os intervalos são classificados como binário UTF-8.

Tipo: objeto JobResource

Obrigatório: Não

RoleARN

O RoleARN que você deseja associar a esse trabalho. RoleArns são criados usando a ação da API CreateRole AWS Identity and Access Management (IAM).

Tipo: sequência

Restrições de tamanho: tamanho máximo de 255.

Padrão: arn:aws.*:iam::[0-9]{12}:role/.*

Obrigatório: não

ShippingOption

A velocidade de envio para esse trabalho. Essa velocidade não determina em quanto tempo você receberá o dispositivo Snow, mas representa a rapidez com que o dispositivo Snow se move até seu destino enquanto está em trânsito. As velocidades de envio regionais são as seguintes:

• Na Austrália, você tem acesso ao frete expresso. Normalmente, os dispositivos Snow enviados de forma expressa são entregues em cerca de um dia.

• Na União Europeia (UE), você tem acesso ao frete expresso. Normalmente, os dispositivos Snow enviados de forma expressa são entregues em cerca de um dia. Além disso, a maioria dos países na UE tem acesso ao envio padrão que geralmente leva menos de uma semana, só de envio.

• Na Índia, os dispositivos Snow são entregues em um a sete dias.

• Nos Estados Unidos, você tem acesso a envio em um dia e envio em dois dias.

Tipo: sequências

Valores Válidos: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

Obrigatório: não

SnowballCapacityPreference

Se seu trabalho está sendo criado em uma das regiões dos EUA, você tem a opção de especificar o tamanho do dispositivo Snow que deseja para esse trabalho. Em todas as outras regiões, o Snowballs vem com 80 TB em capacidade de armazenamento.

Para obter informações sobre os tipos de dispositivos da Família Snow, consulte Snow Devices and Capacity no Snowcone User Guide ou Snow Devices and Capacity no Snowball Edge User Guide.

Tipo: sequências

Valores Válidos: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

Obrigatório: não

SnowballType

O tipo de dispositivos da Família Snow a ser usado para esse trabalho.

nota

Para trabalhos em cluster, o AWS Snow Family atualmente suporta somente o tipo de EDGE dispositivo.

O tipo de dispositivo AWS Snow a ser usado para esse trabalho. Atualmente, o único tipo de dispositivo compatível com trabalhos de cluster é o EDGE.

Para obter mais informações, consulte Opções de dispositivos Snowball Edge no Guia do desenvolvedor do Snowball Edge.

Para obter informações sobre os tipos de dispositivos da Família Snow, consulte Snow Devices and Capacity no Snowcone User Guide ou Snow Family Devices and Capacity no Snowball Edge User Guide.

Tipo: sequências

Valores Válidos: STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C

Obrigatório: não

TaxDocuments

Os documentos fiscais exigidos em seu Região da AWS.

Tipo: objeto TaxDocuments

Obrigatório: Não

Sintaxe da Resposta

{
   "JobId": "string"
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

JobId

O ID gerado automaticamente para um trabalho, por exemplo, JID123e4567-e89b-12d3-a456-426655440000.

Tipo: sequência

Restrições de tamanho: tamanho fixo de 39.

Padrão: (M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erros

Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.

ClusterLimitExceededException

Assistente de criação de trabalho. Atualmente, os clusters oferecem suporte a cinco nós. Se você tiver menos de cinco nós para o seu cluster e precisar criar mais nós para este cluster, tente novamente e crie trabalhos até que seu cluster tenha exatamente cinco nós.

Código de Status HTTP: 400

Ec2RequestFailedException

Seu usuário não tem as permissões necessárias do Amazon EC2 para realizar a tentativa de ação.

Código de Status HTTP: 400

InvalidInputCombinationException

Falha na criação do trabalho ou do cluster. Uma ou mais entradas eram inválidas. Confirme se o SnowballType valor CreateCluster: suporta seu CreateJob: JobType e tente novamente.

Código de Status HTTP: 400

InvalidResourceException

Não foi possível encontrar o recurso especificado. Confira as informações fornecidas na última solicitação e tente novamente.

Código de Status HTTP: 400

KMSRequestFailedException

A AWS Key Management Service chave fornecida não tem as permissões para realizar a CreateJob UpdateJob ação especificada.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK para Go v2

• AWS SDK para Java V2

• AWS SDK para JavaScript V3

• AWS SDK para PHP V3

• AWS SDK para Python

• AWS SDK para Ruby V3