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á. # CreateCluster **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 cluster vazio. Cada cluster oferece suporte a cinco nós. Você usa a ação [CreateJob](API_CreateJob.md) separadamente para criar os trabalhos para cada um desses nós. O cluster não é enviado até que esses trabalhos de cinco nós tenham sido criados. ## Sintaxe da solicitação ``` { "AddressId": "string", "Description": "string", "ForceCreateJobs": boolean, "ForwardingAddressId": "string", "InitialClusterSize": number, "JobType": "string", "KmsKeyARN": "string", "LongTermPricingIds": [ "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" } }, "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_CreateCluster_RequestSyntax) ** O ID do endereço para o qual você deseja que o cluster 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: Sim ** [Description](#API_CreateCluster_RequestSyntax) ** Uma descrição opcional desse cluster específico, por exemplo, `Environmental Data Cluster-01`. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1.024. Padrão: `.*` Obrigatório: não ** [ForceCreateJobs](#API_CreateCluster_RequestSyntax) ** Force a criação de um cluster quando o usuário tentar superprovisionar ou subprovisionar um cluster. Um cluster é superprovisionado ou subprovisionado se o tamanho inicial do cluster é maior (superprovisionado) ou menor (subprovisionado) do que o necessário para atender aos requisitos de capacidade especificados em `OnDeviceServiceConfiguration`. Tipo: booliano Obrigatório: não ** [ForwardingAddressId](#API_CreateCluster_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 ** [InitialClusterSize](#API_CreateCluster_RequestSyntax) ** Se fornecido, cada trabalho será criado automaticamente e associado ao novo cluster. Se não for fornecido, será tratado como 0. Tipo: inteiro Intervalo válido: valor mínimo de 0. Valor máximo de 16. Obrigatório: não ** [JobType](#API_CreateCluster_RequestSyntax) ** O tipo de trabalho desse cluster. Atualmente, o único tipo de trabalho compatível com clusters é `LOCAL_USE`. Para obter informações sobre os tipos de dispositivos do Snowball Edge, [consulte Informações sobre 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: `IMPORT | EXPORT | LOCAL_USE` Obrigatório: Sim ** [KmsKeyARN](#API_CreateCluster_RequestSyntax) ** O `KmsKeyARN` valor que você deseja associar a esse cluster. `KmsKeyARN`os valores são criados usando a ação [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)da API em AWS Key Management Service (AWS 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 ** [LongTermPricingIds](#API_CreateCluster_RequestSyntax) ** Lista o ID de preço de longo prazo que será usado para associação aos trabalhos criados automaticamente para o novo cluster. Tipo: matriz de strings 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_CreateCluster_RequestSyntax) ** As configurações de notificação do Amazon Simple Notification Service (Amazon SNS) para esse cluster. Tipo: objeto [Notification](API_Notification.md) Obrigatório: não ** [OnDeviceServiceConfiguration](#API_CreateCluster_RequestSyntax) ** Especifica o serviço ou serviços no dispositivo Snowball Edge dos quais seus dados transferidos serão exportados ou importados. AWS Os clusters de dispositivos Snowball Edge oferecem suporte ao Amazon S3 e ao NFS (Network File System). Tipo: objeto [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) Obrigatório: não ** [RemoteManagement](#API_CreateCluster_RequestSyntax) ** Permite que você opere e gerencie dispositivos Snow de forma segura em um cluster 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 Snowball Client para gerenciar o dispositivo. Tipo: string Valores válidos: `INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED` Obrigatório: não ** [Resources](#API_CreateCluster_RequestSyntax) ** Os recursos associados ao trabalho do cluster. Esses recursos incluem buckets do Amazon S3 e AWS Lambda funções opcionais escritas na linguagem Python. Tipo: objeto [JobResource](API_JobResource.md) Obrigatório: não ** [RoleARN](#API_CreateCluster_RequestSyntax) ** O `RoleARN` que você deseja associar a esse cluster. `RoleArn`os valores são criados usando a ação [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)da API em 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_CreateCluster_RequestSyntax) ** A velocidade de envio de cada nó nesse cluster. Essa velocidade não determina em quanto tempo você receberá cada dispositivo Snowball Edge, mas representa a rapidez com que cada dispositivo 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 da América (EUA), você tem acesso a envio em um dia e envio em dois dias. + Na Austrália, você tem acesso ao frete expresso. Normalmente, os dispositivos 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: Sim ** [SnowballCapacityPreference](#API_CreateCluster_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](/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_CreateCluster_RequestSyntax) ** O tipo de dispositivos da Família Snow a ser usado para esse cluster. Para trabalhos em cluster, o AWS Snowball Edge atualmente oferece suporte somente ao tipo de `EDGE` dispositivo. 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: `STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C` Obrigatório: Sim ** [TaxDocuments](#API_CreateCluster_RequestSyntax) ** Os documentos fiscais exigidos em seu Região da AWS. Tipo: objeto [TaxDocuments](API_TaxDocuments.md) Obrigatório: não ## Sintaxe da resposta ``` { "ClusterId": "string", "JobListEntries": [ { "CreationDate": number, "Description": "string", "IsMaster": boolean, "JobId": "string", "JobState": "string", "JobType": "string", "SnowballType": "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. ** [ClusterId](#API_CreateCluster_ResponseSyntax) ** O ID gerado automaticamente para um 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}` ** [JobListEntries](#API_CreateCluster_ResponseSyntax) ** Lista de trabalhos criados para esse cluster. Para obter a sintaxe, consulte [ListJobsResult\$1 JobListEntries](https://amazonaws.com/snowball/latest/api-reference/API_ListJobs.html#API_ListJobs_ResponseSyntax) neste guia. Tipo: matriz de objetos [JobListEntry](API_JobListEntry.md) ## Erros Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** 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:](#Snowball-CreateCluster-request-SnowballType) é compatível com seu [CreateJob: JobType](API_CreateJob.md#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 [UpdateJob](API_UpdateJob.md) ação [CreateJob](API_CreateJob.md) ou a 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/CreateCluster) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/CreateCluster) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateCluster) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateCluster) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateCluster) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/CreateCluster) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateCluster)