Sintaxe da Solicitação Parâmetros da solicitação Sintaxe da Resposta Elementos de Resposta Erros Consulte também

CreateJob

Importante

Aviso de fim do suporte: em 12 de novembro de 2024, AWS descontinuaremos os dispositivos Snowball AWS da geração anterior e os dispositivos Snowcone (e). HDD SDD Continuaremos oferecendo suporte aos clientes existentes que usam esses end-of-life dispositivos até 12 de novembro de 2025. Os dispositivos AWS Snowball de última geração estão disponíveis para todos os clientes. Veja esta postagem em blog para obter mais informações.

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: V3_5C
- Capacidade: T32
- Descrição: Snowball Edge Compute Optimized
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 comuns a todas as ações, consulte Parâmetros Comuns.

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

AddressId

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

Tipo: string

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: string

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: string

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

Padrão: ^[a-zA-Z0-9\s\-\_\.\:]+$

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 do Snowball Edge, consulte Informações de hardware do dispositivo no Guia do desenvolvedor do Snowball Edge.

Tipo: objeto DeviceConfiguration

Obrigatório: não

ForwardingAddressId

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

Tipo: string

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: string

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

Obrigatório: não

JobType

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

Tipo: string

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 API ação CreateKey AWS Key Management Service (KMS).

Tipo: string

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: string

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

Define as configurações de notificação do Amazon Simple Notification Service (AmazonSNS) 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: string

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 de forma binária de 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 API ação CreateRole AWS Identity and Access Management (IAM).

Tipo: string

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: string

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 do Snowball Edge, consulte Informações de hardware do dispositivo no Guia do desenvolvedor do Snowball Edge.

Tipo: string

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 Snowball Edge atualmente oferece suporte somente ao 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 Informações sobre hardware do dispositivo no Guia do desenvolvedor do Snowball Edge.

Tipo: string

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 de 200.

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

JobId

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

Tipo: string

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 retornados pelas 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.

HTTPCódigo de status: 400

Ec2RequestFailedException

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

HTTPCódigo de status: 400

InvalidInputCombinationException

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

HTTPCódigo de status: 400

InvalidResourceException

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

HTTPCódigo de status: 400

KMSRequestFailedException

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

HTTPCódigo de status: 400

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

CreateCluster

CreateLongTermPricing