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
<a name="API_UpdateCluster"></a>

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
<a name="API_UpdateCluster_RequestSyntax"></a>

```
{
   "ACLName": "string",
   "ClusterName": "string",
   "Description": "string",
   "Engine": "string",
   "EngineVersion": "string",
   "IpDiscovery": "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
<a name="API_UpdateCluster_RequestParameters"></a>

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.

 ** [ACLName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ACLName"></a>
A lista de controle de acesso associada ao cluster.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1.  
Padrão: `[a-zA-Z][a-zA-Z0-9\-]*`   
Obrigatório: não

 ** [ClusterName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ClusterName"></a>
O nome do cluster a ser atualizado.  
Tipo: String  
Obrigatório: Sim

 ** [Description](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Description"></a>
A descrição do cluster a ser atualizado.  
Tipo: string  
Obrigatório: não

 ** [Engine](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-Engine"></a>
O nome do mecanismo a ser usado para o cluster.  
Tipo: string  
Obrigatório: não

 ** [EngineVersion](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-EngineVersion"></a>
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: string  
Obrigatório: não

 ** [IpDiscovery](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-IpDiscovery"></a>
O mecanismo para descobrir endereços IP para o protocolo de descoberta de clusters. Os valores válidos são 'ipv4' ou 'ipv6'. Quando definidas como 'ipv4', as funções de descoberta de cluster, como slots de cluster, fragmentos de cluster e nós de cluster, retornarão IPv4 endereços para nós de cluster. Quando definidas como 'ipv6', as funções de descoberta do cluster retornam IPv6 endereços para os nós do cluster. O valor deve ser compatível com o NetworkType parâmetro. Se não for especificado, o padrão será 'ipv4'.  
Tipo: string  
Valores válidos: `ipv4 | ipv6`   
Obrigatório: não

 ** [MaintenanceWindow](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-MaintenanceWindow"></a>
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](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-NodeType"></a>
Um tipo de nó válido para o qual você deseja escalar esse cluster para cima ou para baixo.  
Tipo: string  
Obrigatório: não

 ** [ParameterGroupName](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ParameterGroupName"></a>
O nome do grupo de parâmetro a ser atualizado.  
Tipo: string  
Obrigatório: não

 ** [ReplicaConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ReplicaConfiguration"></a>
O número de réplicas que residirão em cada fragmento.  
Tipo: objeto [ReplicaConfigurationRequest](API_ReplicaConfigurationRequest.md)  
Obrigatório: não

 ** [SecurityGroupIds](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SecurityGroupIds"></a>
O SecurityGroupIds para atualizar.  
Tipo: matriz de strings  
Obrigatório: Não

 ** [ShardConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-ShardConfiguration"></a>
O número de fragmentos no cluster.  
Tipo: objeto [ShardConfigurationRequest](API_ShardConfigurationRequest.md)  
Obrigatório: não

 ** [SnapshotRetentionLimit](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotRetentionLimit"></a>
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](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnapshotWindow"></a>
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: string  
Obrigatório: não

 ** [SnsTopicArn](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicArn"></a>
O ARN do tópico do SNS a ser atualizado.  
Tipo: string  
Obrigatório: não

 ** [SnsTopicStatus](#API_UpdateCluster_RequestSyntax) **   <a name="MemoryDB-UpdateCluster-request-SnsTopicStatus"></a>
O status do tópico de notificação do Amazon SNS. As notificações são enviadas somente se o status estiver ativo.  
Tipo: string  
Obrigatório: não

## Sintaxe da resposta
<a name="API_UpdateCluster_ResponseSyntax"></a>

```
{
   "Cluster": { 
      "ACLName": "string",
      "ARN": "string",
      "AutoMinorVersionUpgrade": boolean,
      "AvailabilityMode": "string",
      "ClusterEndpoint": { 
         "Address": "string",
         "Port": number
      },
      "DataTiering": "string",
      "Description": "string",
      "Engine": "string",
      "EnginePatchVersion": "string",
      "EngineVersion": "string",
      "IpDiscovery": "string",
      "KmsKeyId": "string",
      "MaintenanceWindow": "string",
      "MultiRegionClusterName": "string",
      "Name": "string",
      "NetworkType": "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
<a name="API_UpdateCluster_ResponseElements"></a>

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.

 ** [Cluster](#API_UpdateCluster_ResponseSyntax) **   <a name="MemoryDB-UpdateCluster-response-Cluster"></a>
O cluster atualizado.  
Tipo: objeto [Cluster](API_Cluster.md)

## Erros
<a name="API_UpdateCluster_Errors"></a>

Para obter informações sobre os erros comuns que são comuns em todas ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** 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
<a name="API_UpdateCluster_SeeAlso"></a>

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/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/UpdateCluster) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/UpdateCluster)