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
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 comuns a todas as ações, consulte Parâmetros Comuns.
A solicitação aceita os seguintes dados no JSON formato.
- AddressId
-
O ID do objeto Address 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
-
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}Exigido: Sim
- Description
-
A descrição atualizada desse cluster.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.
Padrão:
.*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
- 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 seus dados transferidos serão exportados ou importados. AWS Os clusters de dispositivos da família Snow oferecem suporte ao Amazon S3 e 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
-
A nova função Amazon Resource Name (ARN) que você deseja associar a esse cluster. Para criar uma funçãoARN, use a CreateRoleAPIação 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
-
O valor atualizado da opção de envio do objeto ShippingDetails desse cluster.
Tipo: string
Valores Válidos:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARDObrigatório: Não
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta de HTTP 200 com o HTTP corpo vazio.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- 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
- InvalidJobStateException
-
A ação não pode ser executada porque o estado atual do trabalho não permite que essa ação seja executada.
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:
