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
Modifica as configurações de um cluster. Você pode usar essa operação para alterar uma ou mais definições de configuração do cluster especificando as configurações e os novos valores.
Sintaxe da Solicitação
{
"ACLName": "string
",
"ClusterName": "string
",
"Description": "string
",
"EngineVersion": "string
",
"MaintenanceWindow": "string
",
"NodeType": "string
",
"ParameterGroupName": "string
",
"ReplicaConfiguration": {
"ReplicaCount": number
},
"SecurityGroupIds": [ "string
" ],
"ShardConfiguration": {
"ShardCount": number
},
"SnapshotRetentionLimit": number
,
"SnapshotWindow": "string
",
"SnsTopicArn": "string
",
"SnsTopicStatus": "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.
A solicitação aceita os dados a seguir no formato JSON.
- ACLName
-
A lista de controle de acesso associada ao cluster
Tipo: sequência
Restrições de tamanho: tamanho mínimo 1.
Padrão:
[a-zA-Z][a-zA-Z0-9\-]*
Obrigatório: não
- ClusterName
-
O nome do cluster a ser atualizado
Tipo: string
Obrigatório: Sim
- Description
-
A descrição do cluster a ser atualizado
Tipo: sequência
Obrigatório: não
- EngineVersion
-
A versão atualizada do mecanismo a ser executada nos nós. Você pode atualizar para uma versão de mecanismo, mas não pode fazer downgrade para uma versão de mecanismo anterior. Se quiser usar uma versão de mecanismo anterior, você deverá excluir o cluster e criá-lo de novo com a versão anterior do mecanismo.
Tipo: sequência
Obrigatório: não
- MaintenanceWindow
-
Especifica o período semanal durante o qual a manutenção no cluster é realizada. É especificado como um intervalo no formato ddd:hh24:mi-ddd:hh24:mi (relógio de 24 horas, em UTC). A janela de manutenção mínima consiste em um período de 60 minutos.
Os valores válidos para
ddd
são:-
sun
-
mon
-
tue
-
wed
-
thu
-
fri
-
sat
Exemplo:
sun:23:00-mon:01:30
Tipo: String
Obrigatório: não
-
- NodeType
-
Um tipo de nó válido para o qual você deseja escalar esse cluster para cima ou para baixo.
Tipo: sequência
Obrigatório: não
- ParameterGroupName
-
O nome do parâmetro de grupo a ser atualizado
Tipo: sequência
Obrigatório: não
- ReplicaConfiguration
-
O número de réplicas que residirão em cada fragmento
Tipo: objeto ReplicaConfigurationRequest
Obrigatório: Não
- SecurityGroupIds
-
O SecurityGroupIds para atualizar
Tipo: matriz de strings
Obrigatório: não
- ShardConfiguration
-
O número de fragmentos no cluster
Tipo: objeto ShardConfigurationRequest
Obrigatório: Não
- SnapshotRetentionLimit
-
O número de dias durante os quais o MemoryDB mantém snapshots automáticos do cluster antes de excluí-los. Por exemplo, se você SnapshotRetentionLimit definir como 5, um instantâneo que foi tirado hoje será retido por 5 dias antes de ser excluído.
Tipo: inteiro
Obrigatório: não
- SnapshotWindow
-
O intervalo de tempo diário (em UTC) durante o qual o MemoryDB começa a executar um snapshot diário do seu cluster.
Tipo: sequência
Obrigatório: não
- SnsTopicArn
-
O ARN do tópico do SNS a ser atualizado
Tipo: sequência
Obrigatório: não
- SnsTopicStatus
-
O status do tópico de notificação do Amazon SNS. As notificações são enviadas somente se o status estiver ativo.
Tipo: sequência
Obrigatório: não
Sintaxe da Resposta
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"Name": "string",
"NodeType": "string",
"NumberOfShards": number,
"ParameterGroupName": "string",
"ParameterGroupStatus": "string",
"PendingUpdates": {
"ACLs": {
"ACLToApply": "string"
},
"Resharding": {
"SlotMigration": {
"ProgressPercentage": number
}
},
"ServiceUpdates": [
{
"ServiceUpdateName": "string",
"Status": "string"
}
]
},
"SecurityGroups": [
{
"SecurityGroupId": "string",
"Status": "string"
}
],
"Shards": [
{
"Name": "string",
"Nodes": [
{
"AvailabilityZone": "string",
"CreateTime": number,
"Endpoint": {
"Address": "string",
"Port": number
},
"Name": "string",
"Status": "string"
}
],
"NumberOfNodes": number,
"Slots": "string",
"Status": "string"
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string",
"Status": "string",
"SubnetGroupName": "string",
"TLSEnabled": boolean
}
}
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.
Erros
Para obter informações sobre os erros comuns que são comuns em todas ações, consulte Erros comuns.
- ACLNotFoundFault
-
Código de Status HTTP: 400
- ClusterNotFoundFault
-
Código de Status HTTP: 400
- ClusterQuotaForCustomerExceededFault
-
Código de Status HTTP: 400
- InvalidACLStateFault
-
Código de Status HTTP: 400
- InvalidClusterStateFault
-
Código de Status HTTP: 400
- InvalidKMSKeyFault
-
Código de Status HTTP: 400
- InvalidNodeStateFault
-
Código de Status HTTP: 400
- InvalidParameterCombinationException
-
Código de Status HTTP: 400
- InvalidParameterValueException
-
Código de Status HTTP: 400
- InvalidVPCNetworkStateFault
-
Código de Status HTTP: 400
- NodeQuotaForClusterExceededFault
-
Código de Status HTTP: 400
- NodeQuotaForCustomerExceededFault
-
Código de Status HTTP: 400
- NoOperationFault
-
Código de Status HTTP: 400
- ParameterGroupNotFoundFault
-
Código de Status HTTP: 400
- ServiceLinkedRoleNotFoundFault
-
Código de Status HTTP: 400
- ShardsPerClusterQuotaExceededFault
-
Código de Status HTTP: 400
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: