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á. # UpdateCluster **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/). Enquanto o valor de `ClusterState` de um cluster está no estado `AwaitingQuorum`, você pode atualizar algumas das informações associadas a um cluster. Quando o cluster muda para um estado de trabalho diferente, geralmente 60 minutos após a criação do cluster, essa ação não está mais disponível. ## Sintaxe da solicitação ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "ForwardingAddressId": "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" } }, "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" } ``` ## 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_UpdateCluster_RequestSyntax) ** O ID do objeto [Address](API_Address.md) atualizado. 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_UpdateCluster_RequestSyntax) ** O ID do cluster que você deseja atualizar, por exemplo, `CID123e4567-e89b-12d3-a456-426655440000`. 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: Sim ** [Description](#API_UpdateCluster_RequestSyntax) ** A descrição atualizada desse cluster. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1.024. Padrão: `.*` Obrigatório: não ** [ForwardingAddressId](#API_UpdateCluster_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 ** [Notification](#API_UpdateCluster_RequestSyntax) ** O objeto [Notification](API_Notification.md) novo ou atualizado. Tipo: objeto [Notification](API_Notification.md) Obrigatório: não ** [OnDeviceServiceConfiguration](#API_UpdateCluster_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 ** [Resources](#API_UpdateCluster_RequestSyntax) ** As matrizes atualizadas de objetos [JobResource](API_JobResource.md) que podem incluir objetos [S3Resource](API_S3Resource.md) ou objetos [LambdaResource](API_LambdaResource.md) atualizados. Tipo: objeto [JobResource](API_JobResource.md) Obrigatório: não ** [RoleARN](#API_UpdateCluster_RequestSyntax) ** O nome de recurso da Amazon (ARN) da nova função que você deseja associar a esse cluster. Para criar um ARN de função, use a ação da [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)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_UpdateCluster_RequestSyntax) ** O valor atualizado da opção de envio do objeto [ShippingDetails](API_ShippingDetails.md) desse cluster. Tipo: string Valores válidos: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Obrigatório: não ## Elementos de resposta Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio. ## 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:](API_CreateCluster.md#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 ** InvalidJobStateException ** A ação não pode ser executada porque o estado atual do trabalho não permite que essa ação seja executada. 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/UpdateCluster) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/UpdateCluster) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/UpdateCluster) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateCluster)