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à.

# Cluster
<a name="API_elastic_Cluster"></a>

Restituisce informazioni su uno specifico cluster elastico.

## Indice
<a name="API_elastic_Cluster_Contents"></a>

**Nota**  
Nell'elenco seguente, i parametri richiesti vengono descritti per primi.

 ** adminUserName **   <a name="documentdb-Type-elastic_Cluster-adminUserName"></a>
Il nome dell'amministratore del cluster elastico.  
Tipo: stringa  
Campo obbligatorio: sì

 ** authType **   <a name="documentdb-Type-elastic_Cluster-authType"></a>
Il tipo di autenticazione per il cluster elastico.  
Tipo: stringa  
Valori validi: `PLAIN_TEXT | SECRET_ARN`   
Campo obbligatorio: sì

 ** clusterArn **   <a name="documentdb-Type-elastic_Cluster-clusterArn"></a>
L'identificatore ARN del cluster elastico.  
Tipo: stringa  
Campo obbligatorio: sì

 ** clusterEndpoint **   <a name="documentdb-Type-elastic_Cluster-clusterEndpoint"></a>
L'URL utilizzato per connettersi al cluster elastico.  
Tipo: stringa  
Campo obbligatorio: sì

 ** clusterName **   <a name="documentdb-Type-elastic_Cluster-clusterName"></a>
Il nome del cluster elastico.  
Tipo: stringa  
Campo obbligatorio: sì

 ** createTime **   <a name="documentdb-Type-elastic_Cluster-createTime"></a>
L'ora in cui il cluster elastico è stato creato in UTC (Universal Coordinated Time).  
Tipo: stringa  
Campo obbligatorio: sì

 ** kmsKeyId **   <a name="documentdb-Type-elastic_Cluster-kmsKeyId"></a>
L'identificatore della chiave KMS da utilizzare per crittografare il cluster elastico.  
Tipo: stringa  
Campo obbligatorio: sì

 ** preferredMaintenanceWindow **   <a name="documentdb-Type-elastic_Cluster-preferredMaintenanceWindow"></a>
Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.  
 *Format*: `ddd:hh24:mi-ddd:hh24:mi`   
Tipo: stringa  
Campo obbligatorio: sì

 ** shardCapacity **   <a name="documentdb-Type-elastic_Cluster-shardCapacity"></a>
Il numero di v CPUs assegnato a ogni shard di cluster elastico. Il massimo è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.  
Tipo: integer  
Campo obbligatorio: sì

 ** shardCount **   <a name="documentdb-Type-elastic_Cluster-shardCount"></a>
Il numero di shard assegnati al cluster elastico. Il massimo è 32.  
Tipo: integer  
Campo obbligatorio: sì

 ** status **   <a name="documentdb-Type-elastic_Cluster-status"></a>
Lo stato del cluster elastico.  
Tipo: stringa  
Valori validi: `CREATING | ACTIVE | DELETING | UPDATING | VPC_ENDPOINT_LIMIT_EXCEEDED | IP_ADDRESS_LIMIT_EXCEEDED | INVALID_SECURITY_GROUP_ID | INVALID_SUBNET_ID | INACCESSIBLE_ENCRYPTION_CREDS | INACCESSIBLE_SECRET_ARN | INACCESSIBLE_VPC_ENDPOINT | INCOMPATIBLE_NETWORK | MERGING | MODIFYING | SPLITTING | COPYING | STARTING | STOPPING | STOPPED | MAINTENANCE | INACCESSIBLE_ENCRYPTION_CREDENTIALS_RECOVERABLE`   
Campo obbligatorio: sì

 ** subnetIds **   <a name="documentdb-Type-elastic_Cluster-subnetIds"></a>
La EC2 sottorete Amazon IDs per il cluster elastico.  
Tipo: matrice di stringhe  
Campo obbligatorio: sì

 ** vpcSecurityGroupIds **   <a name="documentdb-Type-elastic_Cluster-vpcSecurityGroupIds"></a>
Un elenco di gruppi di sicurezza EC2 VPC associati a questo cluster elastico.  
Tipo: matrice di stringhe  
Campo obbligatorio: sì

 ** backupRetentionPeriod **   <a name="documentdb-Type-elastic_Cluster-backupRetentionPeriod"></a>
Il numero di giorni per i quali vengono conservate le istantanee automatiche.  
Tipo: integer  
Campo obbligatorio: no

 ** preferredBackupWindow **   <a name="documentdb-Type-elastic_Cluster-preferredBackupWindow"></a>
L'intervallo di tempo giornaliero durante il quale vengono creati i backup automatici, se i backup automatici sono abilitati, come determinato da. `backupRetentionPeriod`  
Tipo: string  
Campo obbligatorio: no

 ** shardInstanceCount **   <a name="documentdb-Type-elastic_Cluster-shardInstanceCount"></a>
Il numero di istanze di replica che si applicano a tutti gli shard del cluster. `shardInstanceCount`Il valore 1 indica che esiste un'istanza di writer e tutte le istanze aggiuntive sono repliche che possono essere utilizzate per le letture e per migliorare la disponibilità.  
Tipo: integer  
Campo obbligatorio: no

 ** shards **   <a name="documentdb-Type-elastic_Cluster-shards"></a>
Il numero totale di shard nel cluster.  
Tipo: matrice di oggetti [Shard](API_elastic_Shard.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_elastic_Cluster_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/Cluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/Cluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/Cluster)