UpdateCluster

Enquanto o valor 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 a todas as ações, consulte Parâmetros comuns.

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

AddressId

O ID do objeto Address atualizado.

Tipo: string

Restrições de comprimento: comprimento 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 do cluster que você deseja atualizar, por exemplo, CID123e4567-e89b-12d3-a456-426655440000.

Tipo: string

Restrições de comprimento: comprimento 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}

Exigido: Sim

Description

A descrição atualizada desse cluster.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 1024.

Padrão: .*

Obrigatório: não

ForwardingAddressId

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

Tipo: string

Restrições de comprimento: comprimento 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

O objeto Notification novo ou atualizado.

Tipo: objeto Notification

Obrigatório: não

OnDeviceServiceConfiguration

Especifica o serviço ou serviços no dispositivo da Família Snow dos quais/para os quais seus dados transferidos serão exportados ou importados. AWS Os clusters de dispositivos da Família Snow oferecem suporte ao Amazon S3 e ao NFS (Network File System).

Tipo: objeto OnDeviceServiceConfiguration

Obrigatório: não

Resources

As matrizes atualizadas de objetos JobResource que podem incluir objetos S3Resource ou objetos LambdaResource atualizados.

Tipo: objeto JobResource

Obrigatório: não

RoleARN

O Amazon Resource Name (ARN) da nova função que você deseja associar a esse cluster. Para criar um ARN de função, use a ação da API CreateRole no 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

O valor atualizado da opção de envio do objeto ShippingDetails desse cluster.

Tipo: string

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

Obrigatório: não

Elementos de Resposta

Se a ação tiver êxito, o serviço reenviará uma resposta HTTP 200 com um corpo HTTP vazio.

Erros

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

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 valor CreateCluster:SnowballType é compatível com seu CreateJob: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.

Código de Status HTTP: 400

KMSRequestFailedException

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

Código de Status HTTP: 400

Ver também

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

• AWS Interface de linha de comando

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go

• AWS SDK for Java V2

• AWS SDK para JavaScript V3

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK para Ruby V3