UpdateCluster - Amazon MemoryDB
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateCluster

Modifica le impostazioni per un cluster. È possibile utilizzare questa operazione per modificare una o più impostazioni di configurazione del cluster specificando le impostazioni e i nuovi valori.

Sintassi della richiesta

{
   "ACLName": "string",
   "ClusterName": "string",
   "Description": "string",
   "Engine": "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"
}

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati nel JSON formato.

ACLName

L'elenco di controllo degli accessi associato al cluster

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1.

Modello: [a-zA-Z][a-zA-Z0-9\-]*

Campo obbligatorio: no

ClusterName

Il nome del cluster da aggiornare

Tipo: stringa

Campo obbligatorio: sì

Description

La descrizione del cluster da aggiornare

Tipo: string

Campo obbligatorio: no

Engine

Il nome del motore da utilizzare per i nodi di questo cluster. Il valore deve essere impostato su redis o valkey.

Tipo: string

Campo obbligatorio: no

EngineVersion

La versione aggiornata del motore da eseguire sui nodi. È possibile eseguire l'aggiornamento a una versione più recente del motore, ma non è possibile effettuare il downgrade a una versione precedente del motore. Se si desidera utilizzare una versione precedente del motore, è necessario eliminare il cluster esistente e crearlo di nuovo con la versione precedente del motore.

Tipo: string

Campo obbligatorio: no

MaintenanceWindow

Specifica l'intervallo di tempo settimanale durante il quale viene eseguita la manutenzione del cluster. Viene specificato come intervallo nel formato ddd:hh24:mi-ddd:hh24:mi (24H Clock). UTC La finestra di manutenzione minima è un periodo di 60 minuti.

I valori validi per ddd sono:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

Esempio: sun:23:00-mon:01:30

Tipo: string

Campo obbligatorio: no

NodeType

Un tipo di nodo valido a cui vuoi aumentare o ridurre questo cluster.

Tipo: string

Campo obbligatorio: no

ParameterGroupName

Il nome del gruppo di parametri da aggiornare

Tipo: string

Campo obbligatorio: no

ReplicaConfiguration

Il numero di repliche che risiederanno in ogni shard

Tipo: oggetto ReplicaConfigurationRequest

Campo obbligatorio: no

SecurityGroupIds

Il da aggiornare SecurityGroupIds

Tipo: matrice di stringhe

Campo obbligatorio: no

ShardConfiguration

Il numero di frammenti nel cluster

Tipo: oggetto ShardConfigurationRequest

Campo obbligatorio: no

SnapshotRetentionLimit

Il numero di giorni durante i quali MemoryDB conserva le istantanee automatiche del cluster prima di eliminarle. Ad esempio, se si imposta su 5, un'istantanea scattata oggi viene conservata SnapshotRetentionLimit per 5 giorni prima di essere eliminata.

Tipo: integer

Campo obbligatorio: no

SnapshotWindow

L'intervallo di tempo giornaliero (inUTC) durante il quale MemoryDB inizia a scattare un'istantanea giornaliera del cluster.

Tipo: string

Campo obbligatorio: no

SnsTopicArn

L'SNSargomento da aggiornare ARN

Tipo: string

Campo obbligatorio: no

SnsTopicStatus

Lo stato dell'argomento relativo alle SNS notifiche di Amazon. Le notifiche vengono inviate solo se lo stato è attivo.

Tipo: string

Campo obbligatorio: no

Sintassi della risposta

{
   "Cluster": { 
      "ACLName": "string",
      "ARN": "string",
      "AutoMinorVersionUpgrade": boolean,
      "AvailabilityMode": "string",
      "ClusterEndpoint": { 
         "Address": "string",
         "Port": number
      },
      "DataTiering": "string",
      "Description": "string",
      "Engine": "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
   }
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

Cluster

Il cluster aggiornato

Tipo: oggetto Cluster

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

ACLNotFoundFault

HTTPCodice di stato: 400

ClusterNotFoundFault

HTTPCodice di stato: 400

ClusterQuotaForCustomerExceededFault

HTTPCodice di stato: 400

InvalidACLStateFault

HTTPCodice di stato: 400

InvalidClusterStateFault

HTTPCodice di stato: 400

InvalidKMSKeyFault

HTTPCodice di stato: 400

InvalidNodeStateFault

HTTPCodice di stato: 400

InvalidParameterCombinationException

HTTPCodice di stato: 400

InvalidParameterValueException

HTTPCodice di stato: 400

InvalidVPCNetworkStateFault

HTTPCodice di stato: 400

NodeQuotaForClusterExceededFault

HTTPCodice di stato: 400

NodeQuotaForCustomerExceededFault

HTTPCodice di stato: 400

NoOperationFault

HTTPCodice di stato: 400

ParameterGroupNotFoundFault

HTTPCodice di stato: 400

ServiceLinkedRoleNotFoundFault

HTTPCodice di stato: 400

ShardsPerClusterQuotaExceededFault

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: