As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CreateJob **nota** AWS Snowball Edge não está mais disponível para novos clientes. Novos clientes devem explorar [AWS DataSync](https://aws.amazon.com/datasync/)transferências on-line, o [Terminal de Transferência de AWS Dados](https://aws.amazon.com/data-transfer-terminal/) para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore [AWS Outposts](https://aws.amazon.com/outposts/). 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 é suportado 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](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/?p=ngi&loc=4). **Dispositivos da Família Snow e suas capacidades.** + Tipo de dispositivo: **V3\$15C** + Capacidade: T32 + Descrição: Snowball Edge Compute Optimized + Tipo de dispositivo: **V3\$15S** + 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](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [AddressId](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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. O comprimento máximo é 1.024. Padrão: `^[a-zA-Z0-9\s\-\_\.\:]+$` Obrigatório: não ** [DeviceConfiguration](#API_CreateJob_RequestSyntax) ** Define a configuração do dispositivo para um AWS Snowball Edge trabalho. Para obter informações sobre os tipos de dispositivos do Snowball Edge, consulte [Informações de hardware do dispositivo no Guia](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) do desenvolvedor do Snowball Edge. Tipo: objeto [DeviceConfiguration](API_DeviceConfiguration.md) Obrigatório: não ** [ForwardingAddressId](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** Define o tipo de trabalho que você está criando. Tipo: string Valores válidos: `IMPORT | EXPORT | LOCAL_USE` Obrigatório: não ** [KmsKeyARN](#API_CreateJob_RequestSyntax) ** O `KmsKeyARN` que você deseja associar a esse trabalho. `KmsKeyARN`s são criados usando a ação da API [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html) 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** As configurações de notificação do Amazon Simple Notification Service (Amazon SNS) para esse trabalho. Tipo: objeto [Notification](API_Notification.md) Obrigatório: não ** [OnDeviceServiceConfiguration](#API_CreateJob_RequestSyntax) ** 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](API_OnDeviceServiceConfiguration.md) Obrigatório: não ** [PickupDetails](#API_CreateJob_RequestSyntax) ** Informações que identificam a pessoa que está retirando o dispositivo. Tipo: objeto [PickupDetails](API_PickupDetails.md) Obrigatório: não ** [RemoteManagement](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](API_JobResource.md) Obrigatório: não ** [RoleARN](#API_CreateJob_RequestSyntax) ** O `RoleARN` que você deseja associar a esse trabalho. `RoleArn`s são criados usando a ação da API [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) 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](#API_CreateJob_RequestSyntax) ** O tipo de dispositivos da Família Snow a ser usado para esse trabalho. 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](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) no Guia do desenvolvedor do Snowball Edge. Tipo: string 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](#API_CreateJob_RequestSyntax) ** Os documentos fiscais exigidos em seu Região da AWS. Tipo: objeto [TaxDocuments](API_TaxDocuments.md) 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](#API_CreateJob_ResponseSyntax) ** 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 informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** 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 EC2 permissões necessárias da Amazon 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:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) é compatível com seu [CreateJob: JobType](#Snowball-CreateJob-request-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. ** ResourceType ** O valor do recurso fornecido é inválido. Código de status HTTP: 400 ** KMSRequestFailedException ** A AWS Key Management Service chave fornecida não tem as permissões para realizar a [CreateJob](#API_CreateJob) [UpdateJob](API_UpdateJob.md) ação especificada. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/CreateJob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/CreateJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateJob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateJob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateJob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/CreateJob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateJob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateJob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateJob)