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á.
CreateCluster
Cria um cluster. Todos os nós no cluster executam o mesmo software de mecanismo compatível com protocolo.
Sintaxe da Solicitação
{
"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
}
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.
- ACLName
-
O nome da lista de controle de acesso a ser associada ao cluster.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1.
Padrão:
[a-zA-Z][a-zA-Z0-9\-]*
Exigido: Sim
- AutoMinorVersionUpgrade
-
Quando definido como true, o cluster receberá automaticamente upgrades secundários da versão do mecanismo após o lançamento.
Tipo: booliano
Obrigatório: não
- ClusterName
-
O nome do cluster. Esse valor deve ser exclusivo, pois também serve como identificador do cluster.
Tipo: string
Obrigatório: Sim
- DataTiering
-
Habilita a hierarquização de dados. A classificação de dados em níveis só é compatível com os clusters quem usam o tipo de nó r6gd. Esse parâmetro deve ser definido usando nós r6gd. Para mais informações, consulte Classificação de dados em níveis.
Tipo: booliano
Obrigatório: não
- Description
-
Uma descrição opcional do cluster.
Tipo: string
Obrigatório: Não
- EngineVersion
-
O número da versão do OSS mecanismo Redis a ser usado para o cluster.
Tipo: string
Obrigatório: Não
- KmsKeyId
-
O ID da KMS chave usada para criptografar o cluster.
Tipo: string
Obrigatório: Não
- MaintenanceWindow
-
Especifica o período semanal durante o qual a manutenção no cluster é realizada. Ele é especificado como um intervalo no formato ddd:hh24:mi-ddd:hh24:mi (24H Clock). 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
-
A capacidade de computação e de memória dos nós no cluster.
Tipo: string
Obrigatório: Sim
- NumReplicasPerShard
-
O número de réplicas a serem aplicadas a cada fragmento. O valor padrão é 1. O máximo é 5.
Tipo: número inteiro
Obrigatório: não
- NumShards
-
O número de fragmentos que o cluster conterá. O valor padrão é 1.
Tipo: número inteiro
Obrigatório: não
- ParameterGroupName
-
O nome do grupo de parâmetros a ser associado ao cluster.
Tipo: string
Obrigatório: Não
- Port
-
O número da porta na qual cada um dos nós aceitará conexões.
Tipo: número inteiro
Obrigatório: não
- SecurityGroupIds
-
Uma lista de nomes de grupos de segurança para associar a este cluster.
Tipo: Matriz de strings
Obrigatório: Não
- SnapshotArns
-
Uma lista de nomes de recursos da Amazon (ARN) que identificam de forma exclusiva os arquivos de RDB snapshot armazenados no Amazon S3. Os arquivos de snapshot são utilizados para preencher o novo cluster. O nome do objeto Amazon S3 no ARN não pode conter vírgulas.
Tipo: Matriz de strings
Obrigatório: Não
- SnapshotName
-
O nome de um snapshot do qual dados serão restaurados no novo cluster. O status do snapshot muda para em restauração enquanto o novo cluster está sendo criado.
Tipo: string
Obrigatório: Não
- SnapshotRetentionLimit
-
O número de dias durante os quais o MemoryDB retém snapshots automáticos 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: número inteiro
Obrigatório: não
- SnapshotWindow
-
O intervalo de tempo diário (emUTC) durante o qual o MemoryDB começa a tirar um instantâneo diário do seu fragmento.
Exemplo: de 05:00 às 09:00
Se você não especificar esse parâmetro, o MemoryDB escolherá automaticamente um intervalo de tempo apropriado.
Tipo: string
Obrigatório: Não
- SnsTopicArn
-
O Amazon Resource Name (ARN) do tópico Amazon Simple Notification Service (SNS) para o qual as notificações são enviadas.
Tipo: string
Obrigatório: Não
- SubnetGroupName
-
O nome do grupo de sub-redes a ser usado para o cluster.
Tipo: string
Obrigatório: Não
- Tags
-
Uma lista de tags a serem adicionadas a esse recurso. As tags são pares de chaves e valores separados por vírgula (por exemplo, Key=, Value=myKey. myKeyValue Você pode incluir várias tags conforme mostrado a seguir: Key=myKey, Value= Key=, Value= myKeyValue Value. mySecondKey mySecondKey
Tipo: matriz de objetos Tag
Membros da matriz: número máximo de 200 itens.
Obrigatório: Não
- TLSEnabled
-
Um sinalizador para habilitar a criptografia em trânsito no cluster.
Tipo: booliano
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 de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- ACLNotFoundFault
-
HTTPCódigo de status: 400
- ClusterAlreadyExistsFault
-
HTTPCódigo de status: 400
- ClusterQuotaForCustomerExceededFault
-
HTTPCódigo de status: 400
- InsufficientClusterCapacityFault
-
HTTPCódigo de status: 400
- InvalidACLStateFault
-
HTTPCódigo de status: 400
- InvalidCredentialsException
-
HTTPCódigo de status: 400
- InvalidParameterCombinationException
-
HTTPCódigo de status: 400
- InvalidParameterValueException
-
HTTPCódigo de status: 400
- InvalidVPCNetworkStateFault
-
HTTPCódigo de status: 400
- NodeQuotaForClusterExceededFault
-
HTTPCódigo de status: 400
- NodeQuotaForCustomerExceededFault
-
HTTPCódigo de status: 400
- ParameterGroupNotFoundFault
-
HTTPCódigo de status: 400
- ServiceLinkedRoleNotFoundFault
-
HTTPCódigo de status: 400
- ShardsPerClusterQuotaExceededFault
-
HTTPCódigo de status: 400
- SubnetGroupNotFoundFault
-
HTTPCódigo de status: 400
- TagQuotaPerResourceExceeded
-
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: