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à.
CreateCluster
Crea un cluster. Tutti i nodi del cluster eseguono lo stesso software del motore conforme al protocollo.
Sintassi della richiesta
{
"ACLName": "string
",
"AutoMinorVersionUpgrade": boolean
,
"ClusterName": "string
",
"DataTiering": boolean
,
"Description": "string
",
"EngineVersion": "string
",
"KmsKeyId": "string
",
"MaintenanceWindow": "string
",
"NodeType": "string
",
"NumReplicasPerShard": number
,
"NumShards": number
,
"ParameterGroupName": "string
",
"Port": number
,
"SecurityGroupIds": [ "string
" ],
"SnapshotArns": [ "string
" ],
"SnapshotName": "string
",
"SnapshotRetentionLimit": number
,
"SnapshotWindow": "string
",
"SnsTopicArn": "string
",
"SubnetGroupName": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"TLSEnabled": boolean
}
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- ACLName
-
Il nome dell'Access Control List da associare al cluster.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1.
Modello:
[a-zA-Z][a-zA-Z0-9\-]*
Campo obbligatorio: sì
- AutoMinorVersionUpgrade
-
Se impostato su true, il cluster riceverà automaticamente aggiornamenti minori della versione del motore dopo il lancio.
Tipo: Booleano
Campo obbligatorio: no
- ClusterName
-
Il nome del cluster. Questo valore deve essere univoco in quanto funge anche da identificatore del cluster.
Tipo: stringa
Campo obbligatorio: sì
- DataTiering
-
Abilita la suddivisione dei dati. Il tiering dei dati è supportato solo per cluster che utilizzano il tipo di nodo r6gd. Questo parametro deve essere impostato quando si utilizzano i nodi r6gd. Per ulteriori informazioni, consulta Tiering di dati.
Tipo: Booleano
Campo obbligatorio: no
- Description
-
Una descrizione opzionale del cluster.
Tipo: string
Campo obbligatorio: no
- EngineVersion
-
Il numero di versione del motore Redis da utilizzare per il cluster.
Tipo: string
Campo obbligatorio: no
- KmsKeyId
-
L'ID della chiave KMS utilizzata per crittografare il cluster.
Tipo: string
Campo obbligatorio: no
- MaintenanceWindow
-
Specifica l'intervallo di tempo settimanale durante il quale viene eseguita la manutenzione del cluster. Viene specificato come un intervallo nel formato ggg:hh24:mi-ggg:hh24:mi (24 ore 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
-
La capacità di calcolo e di memoria dei nodi del cluster.
Tipo: stringa
Campo obbligatorio: sì
- NumReplicasPerShard
-
Il numero di repliche da applicare a ogni partizione. Il valore predefinito è 1. Il massimo è 5.
Tipo: integer
Campo obbligatorio: no
- NumShards
-
Il numero di frammenti che il cluster conterrà. Il valore predefinito è 1.
Tipo: integer
Campo obbligatorio: no
- ParameterGroupName
-
Il nome del gruppo di parametri associato al cluster.
Tipo: string
Campo obbligatorio: no
- Port
-
Il numero di porta su cui ogni nodo accetta le connessioni.
Tipo: integer
Campo obbligatorio: no
- SecurityGroupIds
-
Un elenco di nomi di gruppi di sicurezza da associare a questo cluster.
Tipo: matrice di stringhe
Campo obbligatorio: no
- SnapshotArns
-
Elenco di nomi delle risorse Amazon (ARN) in grado di identificare in modo univoco i file dello snapshot RDB archiviati in Amazon S3. I file di istantanea vengono utilizzati per popolare il nuovo cluster. Il nome dell'oggetto Amazon S3 nell'ARN non può contenere virgole.
Tipo: matrice di stringhe
Campo obbligatorio: no
- SnapshotName
-
Il nome di un'istantanea da cui ripristinare i dati nel nuovo cluster. Lo stato dell'istantanea cambia in ripristino durante la creazione del nuovo cluster.
Tipo: string
Campo obbligatorio: no
- SnapshotRetentionLimit
-
Il numero di giorni in cui MemoryDB conserva le istantanee automatiche 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 (in UTC) durante il quale MemoryDB inizia a scattare un'istantanea giornaliera dello shard.
Esempio: 05:00-09:00
Se non si specifica questo parametro, MemoryDB sceglie automaticamente un intervallo di tempo appropriato.
Tipo: string
Campo obbligatorio: no
- SnsTopicArn
-
L'Amazon Resource Name (ARN) dell'argomento Amazon Simple Notification Service (SNS) a cui vengono inviate le notifiche.
Tipo: string
Campo obbligatorio: no
- SubnetGroupName
-
Il nome del gruppo di sottoreti da utilizzare per il cluster.
Tipo: string
Campo obbligatorio: no
- Tags
-
Un elenco di tag da aggiungere a questa risorsa. I tag sono coppie di chiavi e valori separate da virgole (ad esempio key=myKey, Value=. myKeyValue È possibile includere più tag come illustrato di seguito: Key=MyKey, Value= Key=, Value= ValuemyKeyValue . mySecondKey mySecondKey
Tipo: matrice di oggetti Tag
Membri dell'array: numero massimo di 200 elementi.
Campo obbligatorio: no
- TLSEnabled
-
Un flag per abilitare la crittografia in transito sul cluster.
Tipo: Booleano
Campo obbligatorio: no
Sintassi della risposta
{
"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
}
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- ACLNotFoundFault
-
Codice di stato HTTP: 400
- ClusterAlreadyExistsFault
-
Codice di stato HTTP: 400
- ClusterQuotaForCustomerExceededFault
-
Codice di stato HTTP: 400
- InsufficientClusterCapacityFault
-
Codice di stato HTTP: 400
- InvalidACLStateFault
-
Codice di stato HTTP: 400
- InvalidCredentialsException
-
Codice di stato HTTP: 400
- InvalidParameterCombinationException
-
Codice di stato HTTP: 400
- InvalidParameterValueException
-
Codice di stato HTTP: 400
- InvalidVPCNetworkStateFault
-
Codice di stato HTTP: 400
- NodeQuotaForClusterExceededFault
-
Codice di stato HTTP: 400
- NodeQuotaForCustomerExceededFault
-
Codice di stato HTTP: 400
- ParameterGroupNotFoundFault
-
Codice di stato HTTP: 400
- ServiceLinkedRoleNotFoundFault
-
Codice di stato HTTP: 400
- ShardsPerClusterQuotaExceededFault
-
Codice di stato HTTP: 400
- SubnetGroupNotFoundFault
-
Codice di stato HTTP: 400
- TagQuotaPerResourceExceeded
-
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: