

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

# Riferimento all'API per la gestione di cluster, istanze e risorse di Amazon DocumentDB
<a name="api-reference"></a>

Questa sezione descrive le operazioni di gestione di cluster, istanze e risorse per Amazon DocumentDB (con compatibilità MongoDB) accessibili tramite HTTP, the AWS Command Line Interface (AWS CLI) o SDK. AWS Puoi usarle APIs per creare, eliminare e modificare cluster e istanze.

 

**Importante**  
 APIs Vengono utilizzati solo per la gestione di cluster, istanze e risorse correlate. Per informazioni su come connettersi a un cluster Amazon DocumentDB in esecuzione, consulta. [Guida introduttiva](get-started-guide.md)

**Topics**
+ [Operazioni](API_Operations.md)
+ [Tipi di dati](API_Types.md)
+ [Errori comuni](CommonErrors.md)
+ [Parametri comuni](CommonParameters.md)

# Operazioni
<a name="API_Operations"></a>

Le seguenti azioni sono supportate da Amazon DocumentDB (with MongoDB compatibility):
+  [AddSourceIdentifierToSubscription](API_AddSourceIdentifierToSubscription.md) 
+  [AddTagsToResource](API_AddTagsToResource.md) 
+  [ApplyPendingMaintenanceAction](API_ApplyPendingMaintenanceAction.md) 
+  [CopyDBClusterParameterGroup](API_CopyDBClusterParameterGroup.md) 
+  [CopyDBClusterSnapshot](API_CopyDBClusterSnapshot.md) 
+  [CreateDBCluster](API_CreateDBCluster.md) 
+  [CreateDBClusterParameterGroup](API_CreateDBClusterParameterGroup.md) 
+  [CreateDBClusterSnapshot](API_CreateDBClusterSnapshot.md) 
+  [CreateDBInstance](API_CreateDBInstance.md) 
+  [CreateDBSubnetGroup](API_CreateDBSubnetGroup.md) 
+  [CreateEventSubscription](API_CreateEventSubscription.md) 
+  [CreateGlobalCluster](API_CreateGlobalCluster.md) 
+  [DeleteDBCluster](API_DeleteDBCluster.md) 
+  [DeleteDBClusterParameterGroup](API_DeleteDBClusterParameterGroup.md) 
+  [DeleteDBClusterSnapshot](API_DeleteDBClusterSnapshot.md) 
+  [DeleteDBInstance](API_DeleteDBInstance.md) 
+  [DeleteDBSubnetGroup](API_DeleteDBSubnetGroup.md) 
+  [DeleteEventSubscription](API_DeleteEventSubscription.md) 
+  [DeleteGlobalCluster](API_DeleteGlobalCluster.md) 
+  [DescribeCertificates](API_DescribeCertificates.md) 
+  [DescribeDBClusterParameterGroups](API_DescribeDBClusterParameterGroups.md) 
+  [DescribeDBClusterParameters](API_DescribeDBClusterParameters.md) 
+  [DescribeDBClusters](API_DescribeDBClusters.md) 
+  [DescribeDBClusterSnapshotAttributes](API_DescribeDBClusterSnapshotAttributes.md) 
+  [DescribeDBClusterSnapshots](API_DescribeDBClusterSnapshots.md) 
+  [DescribeDBEngineVersions](API_DescribeDBEngineVersions.md) 
+  [DescribeDBInstances](API_DescribeDBInstances.md) 
+  [DescribeDBSubnetGroups](API_DescribeDBSubnetGroups.md) 
+  [DescribeEngineDefaultClusterParameters](API_DescribeEngineDefaultClusterParameters.md) 
+  [DescribeEventCategories](API_DescribeEventCategories.md) 
+  [DescribeEvents](API_DescribeEvents.md) 
+  [DescribeEventSubscriptions](API_DescribeEventSubscriptions.md) 
+  [DescribeGlobalClusters](API_DescribeGlobalClusters.md) 
+  [DescribeOrderableDBInstanceOptions](API_DescribeOrderableDBInstanceOptions.md) 
+  [DescribePendingMaintenanceActions](API_DescribePendingMaintenanceActions.md) 
+  [FailoverDBCluster](API_FailoverDBCluster.md) 
+  [FailoverGlobalCluster](API_FailoverGlobalCluster.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ModifyDBCluster](API_ModifyDBCluster.md) 
+  [ModifyDBClusterParameterGroup](API_ModifyDBClusterParameterGroup.md) 
+  [ModifyDBClusterSnapshotAttribute](API_ModifyDBClusterSnapshotAttribute.md) 
+  [ModifyDBInstance](API_ModifyDBInstance.md) 
+  [ModifyDBSubnetGroup](API_ModifyDBSubnetGroup.md) 
+  [ModifyEventSubscription](API_ModifyEventSubscription.md) 
+  [ModifyGlobalCluster](API_ModifyGlobalCluster.md) 
+  [RebootDBInstance](API_RebootDBInstance.md) 
+  [RemoveFromGlobalCluster](API_RemoveFromGlobalCluster.md) 
+  [RemoveSourceIdentifierFromSubscription](API_RemoveSourceIdentifierFromSubscription.md) 
+  [RemoveTagsFromResource](API_RemoveTagsFromResource.md) 
+  [ResetDBClusterParameterGroup](API_ResetDBClusterParameterGroup.md) 
+  [RestoreDBClusterFromSnapshot](API_RestoreDBClusterFromSnapshot.md) 
+  [RestoreDBClusterToPointInTime](API_RestoreDBClusterToPointInTime.md) 
+  [StartDBCluster](API_StartDBCluster.md) 
+  [StopDBCluster](API_StopDBCluster.md) 
+  [SwitchoverGlobalCluster](API_SwitchoverGlobalCluster.md) 

Le seguenti azioni sono supportate da Amazon DocumentDB Elastic Clusters:
+  [ApplyPendingMaintenanceAction](API_elastic_ApplyPendingMaintenanceAction.md) 
+  [CopyClusterSnapshot](API_elastic_CopyClusterSnapshot.md) 
+  [CreateCluster](API_elastic_CreateCluster.md) 
+  [CreateClusterSnapshot](API_elastic_CreateClusterSnapshot.md) 
+  [DeleteCluster](API_elastic_DeleteCluster.md) 
+  [DeleteClusterSnapshot](API_elastic_DeleteClusterSnapshot.md) 
+  [GetCluster](API_elastic_GetCluster.md) 
+  [GetClusterSnapshot](API_elastic_GetClusterSnapshot.md) 
+  [GetPendingMaintenanceAction](API_elastic_GetPendingMaintenanceAction.md) 
+  [ListClusters](API_elastic_ListClusters.md) 
+  [ListClusterSnapshots](API_elastic_ListClusterSnapshots.md) 
+  [ListPendingMaintenanceActions](API_elastic_ListPendingMaintenanceActions.md) 
+  [ListTagsForResource](API_elastic_ListTagsForResource.md) 
+  [RestoreClusterFromSnapshot](API_elastic_RestoreClusterFromSnapshot.md) 
+  [StartCluster](API_elastic_StartCluster.md) 
+  [StopCluster](API_elastic_StopCluster.md) 
+  [TagResource](API_elastic_TagResource.md) 
+  [UntagResource](API_elastic_UntagResource.md) 
+  [UpdateCluster](API_elastic_UpdateCluster.md) 

# Amazon DocumentDB (with MongoDB compatibility)
<a name="API_Operations_Amazon_DocumentDB_with_MongoDB_compatibility"></a>

Le seguenti azioni sono supportate da Amazon DocumentDB (with MongoDB compatibility):
+  [AddSourceIdentifierToSubscription](API_AddSourceIdentifierToSubscription.md) 
+  [AddTagsToResource](API_AddTagsToResource.md) 
+  [ApplyPendingMaintenanceAction](API_ApplyPendingMaintenanceAction.md) 
+  [CopyDBClusterParameterGroup](API_CopyDBClusterParameterGroup.md) 
+  [CopyDBClusterSnapshot](API_CopyDBClusterSnapshot.md) 
+  [CreateDBCluster](API_CreateDBCluster.md) 
+  [CreateDBClusterParameterGroup](API_CreateDBClusterParameterGroup.md) 
+  [CreateDBClusterSnapshot](API_CreateDBClusterSnapshot.md) 
+  [CreateDBInstance](API_CreateDBInstance.md) 
+  [CreateDBSubnetGroup](API_CreateDBSubnetGroup.md) 
+  [CreateEventSubscription](API_CreateEventSubscription.md) 
+  [CreateGlobalCluster](API_CreateGlobalCluster.md) 
+  [DeleteDBCluster](API_DeleteDBCluster.md) 
+  [DeleteDBClusterParameterGroup](API_DeleteDBClusterParameterGroup.md) 
+  [DeleteDBClusterSnapshot](API_DeleteDBClusterSnapshot.md) 
+  [DeleteDBInstance](API_DeleteDBInstance.md) 
+  [DeleteDBSubnetGroup](API_DeleteDBSubnetGroup.md) 
+  [DeleteEventSubscription](API_DeleteEventSubscription.md) 
+  [DeleteGlobalCluster](API_DeleteGlobalCluster.md) 
+  [DescribeCertificates](API_DescribeCertificates.md) 
+  [DescribeDBClusterParameterGroups](API_DescribeDBClusterParameterGroups.md) 
+  [DescribeDBClusterParameters](API_DescribeDBClusterParameters.md) 
+  [DescribeDBClusters](API_DescribeDBClusters.md) 
+  [DescribeDBClusterSnapshotAttributes](API_DescribeDBClusterSnapshotAttributes.md) 
+  [DescribeDBClusterSnapshots](API_DescribeDBClusterSnapshots.md) 
+  [DescribeDBEngineVersions](API_DescribeDBEngineVersions.md) 
+  [DescribeDBInstances](API_DescribeDBInstances.md) 
+  [DescribeDBSubnetGroups](API_DescribeDBSubnetGroups.md) 
+  [DescribeEngineDefaultClusterParameters](API_DescribeEngineDefaultClusterParameters.md) 
+  [DescribeEventCategories](API_DescribeEventCategories.md) 
+  [DescribeEvents](API_DescribeEvents.md) 
+  [DescribeEventSubscriptions](API_DescribeEventSubscriptions.md) 
+  [DescribeGlobalClusters](API_DescribeGlobalClusters.md) 
+  [DescribeOrderableDBInstanceOptions](API_DescribeOrderableDBInstanceOptions.md) 
+  [DescribePendingMaintenanceActions](API_DescribePendingMaintenanceActions.md) 
+  [FailoverDBCluster](API_FailoverDBCluster.md) 
+  [FailoverGlobalCluster](API_FailoverGlobalCluster.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ModifyDBCluster](API_ModifyDBCluster.md) 
+  [ModifyDBClusterParameterGroup](API_ModifyDBClusterParameterGroup.md) 
+  [ModifyDBClusterSnapshotAttribute](API_ModifyDBClusterSnapshotAttribute.md) 
+  [ModifyDBInstance](API_ModifyDBInstance.md) 
+  [ModifyDBSubnetGroup](API_ModifyDBSubnetGroup.md) 
+  [ModifyEventSubscription](API_ModifyEventSubscription.md) 
+  [ModifyGlobalCluster](API_ModifyGlobalCluster.md) 
+  [RebootDBInstance](API_RebootDBInstance.md) 
+  [RemoveFromGlobalCluster](API_RemoveFromGlobalCluster.md) 
+  [RemoveSourceIdentifierFromSubscription](API_RemoveSourceIdentifierFromSubscription.md) 
+  [RemoveTagsFromResource](API_RemoveTagsFromResource.md) 
+  [ResetDBClusterParameterGroup](API_ResetDBClusterParameterGroup.md) 
+  [RestoreDBClusterFromSnapshot](API_RestoreDBClusterFromSnapshot.md) 
+  [RestoreDBClusterToPointInTime](API_RestoreDBClusterToPointInTime.md) 
+  [StartDBCluster](API_StartDBCluster.md) 
+  [StopDBCluster](API_StopDBCluster.md) 
+  [SwitchoverGlobalCluster](API_SwitchoverGlobalCluster.md) 

# AddSourceIdentifierToSubscription
<a name="API_AddSourceIdentifierToSubscription"></a>

Aggiunge un identificatore di origine a una sottoscrizione alle notifiche di eventi esistente.

## Parametri della richiesta
<a name="API_AddSourceIdentifierToSubscription_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SourceIdentifier **   
L'identificatore dell'origine dell'evento da aggiungere:  
+ Se il tipo di origine è un'istanza, è `DBInstanceIdentifier` necessario fornire a.
+ Se il tipo di origine è un gruppo di sicurezza, è `DBSecurityGroupName` necessario fornire un.
+ Se il tipo di origine è un gruppo di parametri, è `DBParameterGroupName` necessario fornire a.
+ Se il tipo di origine è un'istantanea, è `DBSnapshotIdentifier` necessario fornire a.
Tipo: stringa  
Obbligatorio: sì

 ** SubscriptionName **   
Il nome dell'abbonamento di notifica degli eventi di Amazon DocumentDB a cui desideri aggiungere un identificatore di origine.  
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_AddSourceIdentifierToSubscription_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** EventSubscription **   
Informazioni dettagliate su un evento a cui ti sei iscritto.  
Tipo: oggetto [EventSubscription](API_EventSubscription.md)

## Errori
<a name="API_AddSourceIdentifierToSubscription_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** SourceNotFound **   
La fonte richiesta non è stata trovata.   
Codice di stato HTTP: 404

 ** SubscriptionNotFound **   
Il nome dell'abbonamento non esiste.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/AddSourceIdentifierToSubscription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/AddSourceIdentifierToSubscription) 

# AddTagsToResource
<a name="API_AddTagsToResource"></a>

Aggiunge tag di metadati a una risorsa Amazon DocumentDB. Puoi utilizzare questi tag con i report sull'allocazione dei costi per tenere traccia dei costi associati alle risorse di Amazon DocumentDB o in `Condition` una dichiarazione in AWS Identity and Access Management una policy (IAM) per Amazon DocumentDB.

## Parametri della richiesta
<a name="API_AddTagsToResource_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** ResourceName **   
La risorsa Amazon DocumentDB a cui vengono aggiunti i tag. Questo valore è un Amazon Resource Name.  
Tipo: stringa  
Obbligatorio: sì

 **Tag.Tag.N**   
I tag da assegnare alla risorsa Amazon DocumentDB.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: sì

## Errori
<a name="API_AddTagsToResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** DBSnapshotNotFound **   
 `DBSnapshotIdentifier`non fa riferimento a un'istantanea esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/AddTagsToResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/AddTagsToResource) 

# ApplyPendingMaintenanceAction
<a name="API_ApplyPendingMaintenanceAction"></a>

Applica un'azione di manutenzione in sospeso a una risorsa (ad esempio, a un'istanza Amazon DocumentDB).

## Parametri della richiesta
<a name="API_ApplyPendingMaintenanceAction_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** ApplyAction **   
L'operazione di manutenzione in sospeso da applicare a questa risorsa.  
Valori validi: `system-update`, `db-upgrade`   
Tipo: stringa  
Obbligatorio: sì

 ** OptInType **   
Un valore che specifica il tipo di richiesta di opt-in o annulla una richiesta di opt-in. Una richiesta di consenso esplicito di tipo `immediate` non può essere annullata.  
Valori validi:  
+  `immediate`: applica immediatamente l'azione di manutenzione.
+  `next-maintenance` -Applica l'operazione di manutenzione durante la finestra di manutenzione successiva per la risorsa. 
+  `undo-opt-in`: annulla qualsiasi richiesta di consenso esplicito `next-maintenance` esistente.
Tipo: stringa  
Obbligatorio: sì

 ** ResourceIdentifier **   
L'Amazon Resource Name (ARN) della risorsa alla quale viene applicata l'operazione di manutenzione in sospeso.  
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_ApplyPendingMaintenanceAction_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** ResourcePendingMaintenanceActions **   
Rappresenta l'output di[ApplyPendingMaintenanceAction](#API_ApplyPendingMaintenanceAction).   
Tipo: oggetto [ResourcePendingMaintenanceActions](API_ResourcePendingMaintenanceActions.md)

## Errori
<a name="API_ApplyPendingMaintenanceAction_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

 ** ResourceNotFoundFault **   
L'ID della risorsa specificata non è stato trovato.  
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ApplyPendingMaintenanceAction) 

# CopyDBClusterParameterGroup
<a name="API_CopyDBClusterParameterGroup"></a>

Copia il gruppo di parametri del cluster specificato.

## Parametri della richiesta
<a name="API_CopyDBClusterParameterGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SourceDBClusterParameterGroupIdentifier **   
L'identificatore o Amazon Resource Name (ARN) per il gruppo di parametri del cluster di origine.  
Vincoli:  
+ È necessario specificare un gruppo di parametri del cluster valido.
+ Se il gruppo di parametri del cluster di origine è lo Regione AWS stesso della copia, specificare un identificatore di gruppo di parametri valido, ad esempio`my-db-cluster-param-group`, o un ARN valido.
+ Se il gruppo di parametri di origine si trova in un formato Regione AWS diverso da quello della copia, specificare un gruppo di parametri del cluster valido (ARN), ad esempio. `arn:aws:rds:us-east-1:123456789012:sample-cluster:sample-parameter-group`
Tipo: stringa  
Obbligatorio: sì

 ** TargetDBClusterParameterGroupDescription **   
Una descrizione per il gruppo di parametri del cluster copiato.  
Tipo: stringa  
Obbligatorio: sì

 ** TargetDBClusterParameterGroupIdentifier **   
L'identificatore per il gruppo di parametri del cluster copiato.  
Vincoli:  
+ Non può essere null o vuoto.
+ Deve contenere da 1 a 255 lettere, numeri o trattini. 
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi. 
Ad esempio: `my-cluster-param-group1`   
Tipo: stringa  
Obbligatorio: sì

 **Tag.Tag.N**   
I tag da assegnare al gruppo di parametri.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CopyDBClusterParameterGroup_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBClusterParameterGroup **   
Informazioni dettagliate su un gruppo di parametri del cluster.   
Tipo: oggetto [DBClusterParameterGroup](API_DBClusterParameterGroup.md)

## Errori
<a name="API_CopyDBClusterParameterGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupAlreadyExists **   
Esiste già un gruppo di parametri con lo stesso nome.  
Codice di stato HTTP: 400

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

 ** DBParameterGroupQuotaExceeded **   
Questa richiesta comporterebbe il superamento del numero consentito di gruppi di parametri.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterParameterGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterParameterGroup) 

# CopyDBClusterSnapshot
<a name="API_CopyDBClusterSnapshot"></a>

Copia un'istantanea di un cluster.

Per copiare uno snapshot del cluster da uno snapshot del cluster manuale condiviso, `SourceDBClusterSnapshotIdentifier` deve essere l'Amazon Resource Name (ARN) dello snapshot del cluster condiviso. Puoi copiare solo uno snapshot condiviso del cluster di database, crittografato o meno, nella stessa Regione AWS.

*Per annullare l'operazione di copia dopo che è in corso, elimina lo snapshot del cluster di destinazione identificato da `TargetDBClusterSnapshotIdentifier` mentre lo snapshot del cluster è in stato di copia.*

## Parametri della richiesta
<a name="API_CopyDBClusterSnapshot_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SourceDBClusterSnapshotIdentifier **   
L'identificatore della snapshot del cluster da copiare. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ *È necessario specificare un'istantanea del cluster valida nello stato disponibile.*
+ Se l'istantanea del cluster di origine è Regione AWS uguale alla copia, specificare un identificatore di snapshot valido.
+ Se lo snapshot del cluster di origine si trova in un altro account Regione AWS o è di proprietà di un altro AWS account, specificare l'ARN dello snapshot.
Ad esempio: `my-cluster-snapshot1`   
Tipo: stringa  
Obbligatorio: sì

 ** TargetDBClusterSnapshotIdentifier **   
L'identificatore della nuova snapshot del cluster da creare dalla snapshot del cluster di origine. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini. 
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi. 
Ad esempio: `my-cluster-snapshot2`   
Tipo: stringa  
Obbligatorio: sì

 ** CopyTags **   
`true`Impostare su per copiare tutti i tag dallo snapshot del cluster di origine allo snapshot del cluster di destinazione e in altro modo. `false` Il valore predefinito è `false`.  
Tipo: Booleano  
Obbligatorio: no

 ** KmsKeyId **   
L'ID della AWS KMS chiave per un'istantanea del cluster crittografata. L'ID della AWS KMS chiave è l'Amazon Resource Name (ARN), l'identificatore della AWS KMS chiave o l'alias della AWS KMS chiave di crittografia. AWS KMS   
Se copi uno snapshot crittografato del cluster dal tuo Account AWS, puoi specificare un valore per `KmsKeyId` crittografare la copia con una nuova chiave di crittografia. AWS KMS Se non si specifica un valore per`KmsKeyId`, la copia dello snapshot del cluster viene crittografata con la stessa AWS KMS chiave dello snapshot del cluster di origine.  
Se si copia un'istantanea del cluster crittografata condivisa da un altro Account AWS, è necessario specificare un valore per. `KmsKeyId`  
Per copiare un'istantanea del cluster crittografata su un'altra Regione AWS, imposta `KmsKeyId` l'ID della AWS KMS chiave che desideri utilizzare per crittografare la copia dello snapshot del cluster nella regione di destinazione. AWS KMS le chiavi di crittografia sono specifiche del dispositivo in Regione AWS cui vengono create e non è possibile utilizzare le chiavi di crittografia l'una nell'altra Regione AWS . Regione AWS  
Se si copia un'istantanea del cluster non crittografata e si specifica un valore per il `KmsKeyId` parametro, viene restituito un errore.  
▬Tipo: stringa  
Obbligatorio: no

 ** PreSignedUrl **   
L'URL che contiene una richiesta firmata Signature Version 4 per l'azione `CopyDBClusterSnapshot` API in Regione AWS quella che contiene lo snapshot del cluster di origine da copiare. È necessario utilizzare il `PreSignedUrl` parametro quando si copia uno snapshot del cluster da un altro. Regione AWS  
Se utilizzate uno strumento AWS SDK o il AWS CLI, potete specificare `SourceRegion` (o `--source-region` per AWS CLI) invece di specificare manualmente. `PreSignedUrl` La specificazione `SourceRegion` genera automaticamente un URL prefirmato che rappresenta una richiesta valida per l'operazione che può essere eseguita nell'origine. Regione AWS  
L'URL predefinito deve essere una richiesta valida per l'azione `CopyDBClusterSnapshot` API che può essere eseguita nell'origine Regione AWS che contiene lo snapshot del cluster da copiare. La richiesta URL prefirmata deve contenere i seguenti valori di parametro:  
+  `SourceRegion`- L'ID della regione che contiene l'istantanea da copiare.
+  `SourceDBClusterSnapshotIdentifier`- L'identificatore per l'istantanea del cluster crittografata da copiare. L'identificatore deve essere nel formato Amazon Resource Name (ARN) per la Regione AWS di origine. Ad esempio, se stai copiando un'istantanea del cluster crittografata da us-east-1 Regione AWS, allora avrai un `SourceDBClusterSnapshotIdentifier` aspetto simile al seguente:. `arn:aws:rds:us-east-1:12345678012:sample-cluster:sample-cluster-snapshot`
+  `TargetDBClusterSnapshotIdentifier`- L'identificatore per la nuova istantanea del cluster da creare. Questo parametro non fa distinzione tra maiuscole e minuscole.
▬Tipo: stringa  
Obbligatorio: no

 **Tag.Tag.N**   
I tag da assegnare allo snapshot del cluster.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CopyDBClusterSnapshot_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBClusterSnapshot **   
Informazioni dettagliate su un'istantanea del cluster.   
Tipo: oggetto [DBClusterSnapshot](API_DBClusterSnapshot.md)

## Errori
<a name="API_CopyDBClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterSnapshotAlreadyExistsFault **   
È già disponibile un'istantanea del cluster con l'identificatore specificato.  
Codice di stato HTTP: 400

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido di snapshot del cluster.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** KMSKeyNotAccessibleFault **   
Si è verificato un errore durante l'accesso a una AWS KMS chiave.  
Codice di stato HTTP: 400

 ** SnapshotQuotaExceeded **   
La richiesta comporterebbe il superamento del numero consentito di istantanee.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CopyDBClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CopyDBClusterSnapshot) 

# CreateDBCluster
<a name="API_CreateDBCluster"></a>

Crea un nuovo cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_CreateDBCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
Identificatore del cluster. Questo parametro è archiviato come stringa in minuscolo.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini. 
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi. 
Ad esempio: `my-cluster`   
Tipo: stringa  
Obbligatorio: sì

 ** Engine **   
Il nome del motore di database da utilizzare per questo cluster.  
Valori validi: `docdb`   
Tipo: stringa  
Obbligatorio: sì

 **AvailabilityZones. AvailabilityZone**N.   
Elenco delle zone di disponibilità Amazon EC2 in cui possono essere create istanze nel cluster.  
Tipo: array di stringhe  
Obbligatorio: no

 ** BackupRetentionPeriod **   
Il numero di giorni durante i quali vengono conservati i backup automatici. È necessario specificare un valore minimo pari a 1.  
Impostazione predefinita: 1  
Vincoli:  
+ Il valore deve essere compreso tra 1 e 35.
Tipo: Integer  
Obbligatorio: no

 ** DBClusterParameterGroupName **   
Il nome del gruppo di parametri del cluster da associare a questo cluster.  
▬Tipo: stringa  
Obbligatorio: no

 ** DBSubnetGroupName **   
Gruppo di sottoreti da associare a questo cluster.  
Vincoli: deve corrispondere al nome di un oggetto `DBSubnetGroup` esistente. Non deve essere predefinito.  
Ad esempio: `mySubnetgroup`   
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
Speciifica se questo cluster può essere eliminato. Se `DeletionProtection` è abilitato, il cluster non può essere eliminato a meno che non venga modificato e `DeletionProtection` disabilitato. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.  
Tipo: Booleano  
Obbligatorio: no

 **EnableCloudwatchLogsExports.Member.**   
Un elenco di tipi di log che devono essere abilitati per l'esportazione in Amazon CloudWatch Logs. È possibile abilitare i log di audit o i log del profiler. Per ulteriori informazioni, consulta [Auditing Amazon DocumentDB Events e Profiling Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html) [Operations](https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html).   
Tipo: array di stringhe  
Obbligatorio: no

 ** EngineVersion **   
Numero di versione del motore di database da utilizzare. Per impostazione predefinita, `--engine-version` sarà l'ultima versione principale del motore. Per i carichi di lavoro di produzione, è consigliabile dichiarare esplicitamente questo parametro con la versione principale del motore prevista.  
▬Tipo: stringa  
Obbligatorio: no

 ** GlobalClusterIdentifier **   
L'identificatore del nuovo cluster globale.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: no

 ** KmsKeyId **   
L'identificatore della AWS KMS chiave per un cluster crittografato.  
L'identificatore della AWS KMS chiave è Amazon Resource Name (ARN) per AWS KMS la chiave di crittografia. Se si crea un cluster utilizzando Account AWS lo stesso proprietario della chiave di AWS KMS crittografia utilizzata per crittografare il nuovo cluster, è possibile utilizzare l'alias della AWS KMS chiave anziché l'ARN per la chiave di crittografia. AWS KMS   
Se non è specificata una chiave di crittografia in `KmsKeyId`:   
+ Se il parametro `StorageEncrypted` è `true`, Amazon DocumentDB utilizza la chiave di crittografia predefinita. 
 AWS KMS crea la chiave di crittografia predefinita per il tuo. Account AWS La tua Account AWS ha una chiave di crittografia predefinita diversa per ciascuna Regioni AWS.  
▬Tipo: stringa  
Obbligatorio: no

 ** ManageMasterUserPassword **   
Speciifica se gestire la password dell'utente principale con Amazon Web Services Secrets Manager.  
Vincolo: non è possibile gestire la password dell'utente principale con Amazon Web Services Secrets Manager, se specificata`MasterUserPassword`.  
Tipo: Booleano  
Obbligatorio: no

 ** MasterUsername **   
Nome dell'utente master per il cluster.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere o numeri.
+ Il primo carattere deve essere una lettera.
+ Non può essere una parola riservata per il motore di database scelto. 
▬Tipo: stringa  
Obbligatorio: no

 ** MasterUserPassword **   
La password per l'utente del database master. Questa password può contenere qualsiasi carattere ASCII stampabile, eccetto la barra (/), le virgolette (") o il simbolo chiocciola (@).  
Vincoli: deve contenere da 8 a 100 caratteri.  
▬Tipo: stringa  
Obbligatorio: no

 ** MasterUserSecretKmsKeyId **   
L'identificatore della chiave KMS di Amazon Web Services per crittografare un segreto che viene generato e gestito automaticamente in Amazon Web Services Secrets Manager. Questa impostazione è valida solo se la password dell'utente principale è gestita da Amazon DocumentDB in Amazon Web Services Secrets Manager per il cluster DB.  
L'identificatore della chiave KMS di Amazon Web Services è l'ARN della chiave, l'ID della chiave, l'alias ARN o il nome alias per la chiave KMS. Per utilizzare una chiave KMS in un altro account Amazon Web Services, specifica la chiave ARN o l'alias ARN.  
Se non lo specifichi`MasterUserSecretKmsKeyId`, la chiave `aws/secretsmanager` KMS viene utilizzata per crittografare il segreto. Se il segreto si trova in un altro account Amazon Web Services, non puoi utilizzare la chiave `aws/secretsmanager` KMS per crittografare il segreto e devi utilizzare una chiave KMS gestita dal cliente.  
Esiste una chiave KMS predefinita per il tuo account Amazon Web Services. Il tuo account Amazon Web Services ha una chiave KMS predefinita diversa per ogni regione Amazon Web Services.  
▬Tipo: stringa  
Obbligatorio: no

 ** NetworkType **   
Il tipo di rete del cluster.  
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).  
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.  
Valori validi: `IPV4` \$1 `DUAL`   
▬Tipo: stringa  
Obbligatorio: no

 ** Port **   
Il numero di porta su cui le istanze del cluster accettano connessioni.  
Tipo: Integer  
Obbligatorio: no

 ** PreferredBackupWindow **   
Intervallo di tempo giornaliero durante il quale vengono creati i backup automatici se sono abilitati tramite il parametro `BackupRetentionPeriod`.   
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna. Regione AWS  
Vincoli:  
+ Il valore deve essere nel formato `hh24:mi-hh24:mi`.
+ Il valore deve essere nel fuso orario UTC (Universal Coordinated Time).
+ Il valore non deve essere in conflitto con la finestra di manutenzione preferita. 
+ Il valore deve essere almeno di 30 minuti.
▬Tipo: stringa  
Obbligatorio: no

 ** PreferredMaintenanceWindow **   
Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.  
Formato: `ddd:hh24:mi-ddd:hh24:mi`   
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna Regione AWS, che si verifica in un giorno casuale della settimana.  
Giorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica  
Vincoli: finestra di un minimo di 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** PreSignedUrl **   
Attualmente non è supportato.   
▬Tipo: stringa  
Obbligatorio: no

 ** ServerlessV2ScalingConfiguration **   
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.  
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)  
Obbligatorio: no

 ** StorageEncrypted **   
Specifica se il cluster è crittografato.  
Tipo: Booleano  
Obbligatorio: no

 ** StorageType **   
Il tipo di archiviazione da associare al cluster di database.  
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*  
Valori validi per il tipo di storage - `standard | iopt1`   
Il valore predefinito è `standard `   
Quando crei un cluster Amazon DocumentDB con il tipo di storage impostato su`iopt1`, il tipo di storage viene restituito nella risposta. Il tipo di storage non viene restituito quando lo imposti `standard` su.
▬Tipo: stringa  
Obbligatorio: no

 **Tag.Tag.N**   
I tag da assegnare al cluster.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

 **VpcSecurityGroupIds. VpcSecurityGroupId**N.   
Elenco dei gruppi di sicurezza VPC EC2 da associare a questo cluster.   
Tipo: array di stringhe  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateDBCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_CreateDBCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterAlreadyExistsFault **   
Hai già un cluster con l'identificatore fornito.  
Codice di stato HTTP: 400

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBClusterParameterGroupNotFound **   
 `DBClusterParameterGroupName`non fa riferimento a un gruppo di parametri del cluster esistente.   
Codice di stato HTTP: 404

 ** DBClusterQuotaExceededFault **   
Il cluster non può essere creato perché è stata raggiunta la quota massima consentita di cluster.  
Codice di stato HTTP: 403

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** DBSubnetGroupDoesNotCoverEnoughAZs **   
Le sottoreti del gruppo di sottoreti devono coprire almeno due zone di disponibilità, a meno che non esista una sola zona di disponibilità.  
Codice di stato HTTP: 400

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

 ** InsufficientStorageClusterCapacity **   
Lo spazio di archiviazione disponibile non è sufficiente per l'azione corrente. È possibile risolvere questo errore aggiornando il gruppo di sottoreti in modo che utilizzi zone di disponibilità diverse con più spazio di archiviazione disponibile.   
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

 ** InvalidDBSubnetGroupStateFault **   
Il gruppo di sottoreti non può essere eliminato perché è in uso.  
Codice di stato HTTP: 400

 ** InvalidGlobalClusterStateFault **   
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

 ** InvalidVPCNetworkStateFault **   
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.  
Codice di stato HTTP: 400

 ** KMSKeyNotAccessibleFault **   
Si è verificato un errore durante l'accesso a una AWS KMS chiave.  
Codice di stato HTTP: 400

 ** NetworkTypeNotSupported **   
Il tipo di rete non è supportato `DBSubnetGroup` né dalla versione del motore DB.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBCluster) 

# CreateDBClusterParameterGroup
<a name="API_CreateDBClusterParameterGroup"></a>

Crea un nuovo gruppo di parametri del cluster.

I parametri in un gruppo di parametri del cluster si applicano a tutte le istanze in un cluster.

Un gruppo di parametri del cluster viene creato inizialmente con i parametri predefiniti per il motore di database utilizzato dalle istanze nel cluster. In Amazon DocumentDB, non è possibile apportare modifiche direttamente al gruppo di parametri del `default.docdb3.6` cluster. Se il tuo cluster Amazon DocumentDB utilizza il gruppo di parametri del cluster predefinito e desideri modificare un valore al suo interno, devi prima [creare un nuovo gruppo di parametri](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-create.html) o [copiare un gruppo di parametri esistente](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-copy.html), modificarlo e quindi applicare il gruppo di parametri modificato al cluster. Affinché il nuovo gruppo di parametri del cluster e le impostazioni associate abbiano effetto, è necessario riavviare le istanze nel cluster senza failover. Per ulteriori informazioni, consulta [Modificare i gruppi di parametri del cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_group-modify.html). 

## Parametri della richiesta
<a name="API_CreateDBClusterParameterGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterParameterGroupName **   
Il nome del gruppo di parametri del cluster.  
Vincoli:  
+ Non deve corrispondere al nome di un oggetto `DBClusterParameterGroup` esistente.
Questo valore è archiviato come stringa in caratteri minuscoli.
Tipo: stringa  
Obbligatorio: sì

 ** DBParameterGroupFamily **   
Il nome della famiglia del gruppo di parametri del cluster.  
Tipo: stringa  
Obbligatorio: sì

 ** Description **   
La descrizione del gruppo di parametri del cluster.  
Tipo: stringa  
Obbligatorio: sì

 **Tag.Tag.N**   
I tag da assegnare al gruppo di parametri del cluster.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateDBClusterParameterGroup_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBClusterParameterGroup **   
Informazioni dettagliate su un gruppo di parametri del cluster.   
Tipo: oggetto [DBClusterParameterGroup](API_DBClusterParameterGroup.md)

## Errori
<a name="API_CreateDBClusterParameterGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupAlreadyExists **   
Esiste già un gruppo di parametri con lo stesso nome.  
Codice di stato HTTP: 400

 ** DBParameterGroupQuotaExceeded **   
Questa richiesta comporterebbe il superamento del numero consentito di gruppi di parametri.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBClusterParameterGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBClusterParameterGroup) 

# CreateDBClusterSnapshot
<a name="API_CreateDBClusterSnapshot"></a>

Crea un'istantanea di un cluster. 

## Parametri della richiesta
<a name="API_CreateDBClusterSnapshot_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'identificatore del cluster per cui creare un'istantanea. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere all'identificativo di un `DBCluster` esistente.
Ad esempio: `my-cluster`   
Tipo: stringa  
Obbligatorio: sì

 ** DBClusterSnapshotIdentifier **   
L'identificatore dello snapshot del cluster. Questo parametro è archiviato come stringa in minuscolo.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi. 
Ad esempio: `my-cluster-snapshot1`   
Tipo: stringa  
Obbligatorio: sì

 **Tag.Tag.N**   
I tag da assegnare allo snapshot del cluster.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateDBClusterSnapshot_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBClusterSnapshot **   
Informazioni dettagliate su un'istantanea del cluster.   
Tipo: oggetto [DBClusterSnapshot](API_DBClusterSnapshot.md)

## Errori
<a name="API_CreateDBClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBClusterSnapshotAlreadyExistsFault **   
Hai già un'istantanea del cluster con l'identificatore specificato.  
Codice di stato HTTP: 400

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido dello snapshot del cluster.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** SnapshotQuotaExceeded **   
La richiesta comporterebbe il superamento del numero consentito di istantanee.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBClusterSnapshot) 

# CreateDBInstance
<a name="API_CreateDBInstance"></a>

Crea una nuova istanza.

## Parametri della richiesta
<a name="API_CreateDBInstance_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
Identificatore del cluster a cui apparterrà l'istanza.  
Tipo: stringa  
Obbligatorio: sì

 ** DBInstanceClass **   
La capacità di calcolo e di memoria dell'istanza, ad esempio `db.r5.large`.   
Tipo: stringa  
Obbligatorio: sì

 ** DBInstanceIdentifier **   
L'identificatore delle istanze. Questo parametro è archiviato come stringa in minuscolo.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Ad esempio: `mydbinstance`   
Tipo: stringa  
Obbligatorio: sì

 ** Engine **   
Nome del motore di database da utilizzare per questa istanza.  
Valore valido: `docdb`   
Tipo: stringa  
Obbligatorio: sì

 ** AutoMinorVersionUpgrade **   
Questo parametro non si applica ad Amazon DocumentDB. Amazon DocumentDB non esegue aggiornamenti di versione secondari indipendentemente dal valore impostato.  
Impostazione predefinita: `false`   
Tipo: Booleano  
Obbligatorio: no

 ** AvailabilityZone **   
Zona di disponibilità Amazon EC2 in cui viene creata l'istanza.   
Predefinita: una zona di disponibilità scelta casualmente dal sistema nell'endpoint. Regione AWS  
Ad esempio: `us-east-1d`   
▬Tipo: stringa  
Obbligatorio: no

 ** CACertificateIdentifier **   
L'identificatore del certificato CA da utilizzare per il certificato del server dell'istanza DB.  
*Per ulteriori informazioni, consulta [Updating your Amazon DocumentDB TLS Certificates](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) and [Encrypting Data in Transit nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) Amazon DocumentDB Developer Guide.*  
▬Tipo: stringa  
Obbligatorio: no

 ** CopyTagsToSnapshot **   
Un valore che indica se copiare i tag dall'istanza database sugli snapshot dell'istanza database. Per impostazione predefinita i tag non vengono copiati.  
Tipo: Booleano  
Obbligatorio: no

 ** EnablePerformanceInsights **   
Un valore che indica se abilitare Performance Insights per l'istanza del database. Per ulteriori informazioni, consulta la sezione [Utilizzo di Amazon Performance Insights](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html).  
Tipo: Booleano  
Obbligatorio: no

 ** PerformanceInsightsKMSKeyId **   
L'identificatore AWS KMS chiave per la crittografia dei dati di Performance Insights.  
L'identificatore della AWS KMS chiave è l'ARN della chiave, l'ID della chiave, l'alias ARN o il nome alias per la chiave KMS.  
Se non specifichi un valore per PerformanceInsights KMSKey Id, Amazon DocumentDB utilizza la tua chiave KMS predefinita. Esiste una chiave KMS predefinita per il tuo account Amazon Web Services. Il tuo account Amazon Web Services ha una chiave KMS predefinita diversa per ogni regione Amazon Web Services.  
▬Tipo: stringa  
Obbligatorio: no

 ** PreferredMaintenanceWindow **   
Intervallo di tempo settimanale durante il quale può venire eseguita la manutenzione del sistema, nel fuso orario UTC (Universal Coordinated Time).  
 Formato: `ddd:hh24:mi-ddd:hh24:mi`   
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna Regione AWS, che si verifica in un giorno casuale della settimana.   
Giorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica  
Vincoli: finestra di un minimo di 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** PromotionTier **   
Un valore che specifica l'ordine in cui una replica di Amazon DocumentDB viene promossa all'istanza principale dopo un errore dell'istanza primaria esistente.  
Impostazione predefinita: 1  
Valori validi: 0-15  
Tipo: Integer  
Obbligatorio: no

 **Tag.Tag.N**   
I tag da assegnare all'istanza. Puoi assegnare fino a 10 tag a un'istanza.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateDBInstance_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBInstance **   
Informazioni dettagliate su un'istanza.   
Tipo: oggetto [DBInstance](API_DBInstance.md)

## Errori
<a name="API_CreateDBInstance_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AuthorizationNotFound **   
L'IP CIDR o il gruppo di sicurezza Amazon EC2 specificato non sono autorizzati per il gruppo di sicurezza specificato.  
Amazon DocumentDB potrebbe inoltre non essere autorizzato a eseguire le azioni necessarie per tuo conto utilizzando IAM.  
Codice di stato HTTP: 404

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBInstanceAlreadyExists **   
Hai già un'istanza con l'identificatore specificato.  
Codice di stato HTTP: 400

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

 ** DBSecurityGroupNotFound **   
 `DBSecurityGroupName`non fa riferimento a un gruppo di sicurezza esistente.   
Codice di stato HTTP: 404

 ** DBSubnetGroupDoesNotCoverEnoughAZs **   
Le sottoreti del gruppo di sottoreti devono coprire almeno due zone di disponibilità, a meno che non esista una sola zona di disponibilità.  
Codice di stato HTTP: 400

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** InstanceQuotaExceeded **   
La richiesta comporterebbe il superamento del numero consentito di istanze.  
Codice di stato HTTP: 400

 ** InsufficientDBInstanceCapacity **   
La classe di istanza specificata non è disponibile nella zona di disponibilità specificata.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

 ** InvalidVPCNetworkStateFault **   
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.  
Codice di stato HTTP: 400

 ** KMSKeyNotAccessibleFault **   
Si è verificato un errore durante l'accesso a una AWS KMS chiave.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

 ** StorageTypeNotSupported **   
L'archiviazione dello spazio specificato non `StorageType` può essere associata all'istanza DB.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBInstance) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBInstance) 

# CreateDBSubnetGroup
<a name="API_CreateDBSubnetGroup"></a>

Crea un nuovo gruppo di sottoreti. I gruppi di sottoreti devono contenere almeno una sottorete in almeno due zone di disponibilità nel. Regione AWS

## Parametri della richiesta
<a name="API_CreateDBSubnetGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBSubnetGroupDescription **   
La descrizione per il gruppo di sottoreti.  
Tipo: stringa  
Obbligatorio: sì

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti. Questo valore è archiviato come stringa in caratteri minuscoli.  
Vincoli: devono contenere un massimo di 255 lettere, numeri, punti, trattini bassi, spazi o trattini. Non deve essere predefinito.  
Ad esempio: `mySubnetgroup`   
Tipo: stringa  
Obbligatorio: sì

 **SubnetIds. SubnetIdentifier**N.   
La sottorete Amazon EC2 IDs per il gruppo di sottoreti.  
Tipo: array di stringhe  
Obbligatorio: sì

 **Tag.Tag.N**   
Il tag da assegnare al gruppo di sottoreti.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateDBSubnetGroup_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBSubnetGroup **   
Informazioni dettagliate su un gruppo di sottoreti.   
Tipo: oggetto [DBSubnetGroup](API_DBSubnetGroup.md)

## Errori
<a name="API_CreateDBSubnetGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBSubnetGroupAlreadyExists **   
 `DBSubnetGroupName`è già utilizzato da un gruppo di sottoreti esistente.   
Codice di stato HTTP: 400

 ** DBSubnetGroupDoesNotCoverEnoughAZs **   
Le sottoreti del gruppo di sottoreti devono coprire almeno due zone di disponibilità, a meno che non esista una sola zona di disponibilità.  
Codice di stato HTTP: 400

 ** DBSubnetGroupQuotaExceeded **   
La richiesta comporterebbe il superamento del numero consentito di gruppi di sottoreti.  
Codice di stato HTTP: 400

 ** DBSubnetQuotaExceededFault **   
La richiesta comporterebbe il superamento del numero consentito di sottoreti in un gruppo di sottoreti.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBSubnetGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBSubnetGroup) 

# CreateEventSubscription
<a name="API_CreateEventSubscription"></a>

Crea un abbonamento per la notifica degli eventi di Amazon DocumentDB. Questa azione richiede un argomento Amazon Resource Name (ARN) creato utilizzando la console Amazon DocumentDB, la console Amazon SNS o l'API Amazon SNS. Per ottenere un ARN con Amazon SNS, devi creare un argomento in Amazon SNS e abbonarti all'argomento. L'ARN viene visualizzato nella console Amazon SNS.

Puoi specificare il tipo di fonte (`SourceType`) di cui desideri ricevere una notifica. Puoi anche fornire un elenco di fonti Amazon DocumentDB (`SourceIds`) che attivano gli eventi e puoi fornire un elenco di categorie di eventi (`EventCategories`) per gli eventi di cui desideri ricevere notifiche. Ad esempio, puoi specificare `SourceType = db-instance` `SourceIds = mydbinstance1, mydbinstance2` e`EventCategories = Availability, Backup`.

Se si specificano entrambi `SourceType` e `SourceIds` (ad esempio `SourceType = db-instance` e`SourceIdentifier = myDBInstance1`), si riceve una notifica di tutti gli `db-instance` eventi relativi all'origine specificata. Se specifichi a `SourceType` ma non specifichi a`SourceIdentifier`, riceverai una notifica degli eventi per quel tipo di sorgente per tutte le tue fonti Amazon DocumentDB. Se non specifichi `SourceType` né il`SourceIdentifier`, riceverai una notifica degli eventi generati da tutte le fonti Amazon DocumentDB appartenenti al tuo account cliente.

## Parametri della richiesta
<a name="API_CreateEventSubscription_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SnsTopicArn **   
L'Amazon Resource Name (ARN) dell'argomento SNS creato per la notifica di eventi. Amazon SNS crea l'ARN quando crei un argomento e ti iscrivi.  
Tipo: stringa  
Obbligatorio: sì

 ** SubscriptionName **   
Il nome dell'abbonamento.  
Vincoli: il nome deve contenere meno di 255 caratteri.  
Tipo: stringa  
Obbligatorio: sì

 ** Enabled **   
 Un valore booleano; impostato `true` per attivare l'abbonamento, impostato per `false` creare l'abbonamento ma non attivarlo.   
Tipo: Booleano  
Obbligatorio: no

 **EventCategories. EventCategory**N.   
 Un elenco di categorie di eventi a `SourceType` cui desideri iscriverti.   
Tipo: array di stringhe  
Obbligatorio: no

 **SourceIds. SourceId**N.   
L'elenco di identificatori di origini di eventi per le quali vengono restituiti gli eventi. Se non è specificato, tutte le origini sono incluse nella risposta. Un identificare deve iniziare con una lettera e deve contenere solo caratteri ASCII, cifre e trattini, non può terminare con un trattino o contenere due trattini consecutivi.  
Vincoli:  
+ Se `SourceIds` vengono forniti, `SourceType` devono essere forniti anche.
+ Se il tipo di origine è un'istanza, è `DBInstanceIdentifier` necessario fornire a.
+ Se il tipo di origine è un gruppo di sicurezza, è `DBSecurityGroupName` necessario fornire un.
+ Se il tipo di origine è un gruppo di parametri, è `DBParameterGroupName` necessario fornire a.
+ Se il tipo di origine è un'istantanea, è `DBSnapshotIdentifier` necessario fornire a.
Tipo: array di stringhe  
Obbligatorio: no

 ** SourceType **   
Il tipo di origine che genera gli eventi. Ad esempio, se desideri ricevere una notifica degli eventi generati da un'istanza, devi impostare questo parametro su. `db-instance` Se questo valore non viene specificato, vengono restituiti tutti gli eventi.  
Valori validi: `db-instance`, `db-cluster`, `db-parameter-group`, `db-security-group`, `db-cluster-snapshot`   
▬Tipo: stringa  
Obbligatorio: no

 **Tag.Tag.N**   
I tag da assegnare all'abbonamento all'evento.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateEventSubscription_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** EventSubscription **   
Informazioni dettagliate su un evento a cui ti sei iscritto.  
Tipo: oggetto [EventSubscription](API_EventSubscription.md)

## Errori
<a name="API_CreateEventSubscription_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** EventSubscriptionQuotaExceeded **   
Hai raggiunto il numero massimo di iscrizioni agli eventi.   
Codice di stato HTTP: 400

 ** SNSInvalidTopic **   
Amazon SNS ha risposto che c'è un problema con l'argomento specificato.   
Codice di stato HTTP: 400

 ** SNSNoAuthorization **   
Non sei autorizzato a pubblicare sull'argomento SNS Amazon Resource Name (ARN).   
Codice di stato HTTP: 400

 ** SNSTopicArnNotFound **   
L'argomento SNS Amazon Resource Name (ARN) non esiste.   
Codice di stato HTTP: 404

 ** SourceNotFound **   
La fonte richiesta non è stata trovata.   
Codice di stato HTTP: 404

 ** SubscriptionAlreadyExist **   
Il nome di abbonamento fornito esiste già.   
Codice di stato HTTP: 400

 ** SubscriptionCategoryNotFound **   
La categoria fornita non esiste.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateEventSubscription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateEventSubscription) 

# CreateGlobalCluster
<a name="API_CreateGlobalCluster"></a>

Crea un cluster globale Amazon DocumentDB che può estendersi su più di un cluster. Regioni AWS Il cluster globale contiene un cluster primario con funzionalità di lettura/scrittura e fino a 10 cluster secondari di sola lettura. I cluster globali utilizzano la replica rapida basata sullo storage tra regioni con latenze inferiori a un secondo, utilizzando un'infrastruttura dedicata senza alcun impatto sulle prestazioni del carico di lavoro.



È possibile creare un cluster globale inizialmente vuoto e quindi aggiungervi un cluster primario e uno secondario. In alternativa, è possibile specificare un cluster esistente durante l'operazione di creazione e questo cluster diventa il cluster principale del cluster globale. 

**Nota**  
Questa azione si applica solo ai cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_CreateGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** GlobalClusterIdentifier **   
L'identificatore del cluster del nuovo cluster globale.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

 ** DatabaseName **   
Nome per il database, composto da un massimo di 64 caratteri alfanumerici. Se non fornisci un nome, Amazon DocumentDB non creerà un database nel cluster globale che stai creando.  
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
L'impostazione di protezione dall'eliminazione per il nuovo cluster globale. Il cluster globale non può essere eliminato quando è abilitata la protezione dall'eliminazione.   
Tipo: Booleano  
Obbligatorio: no

 ** Engine **   
Il nome del motore di database da utilizzare per questo cluster.  
▬Tipo: stringa  
Obbligatorio: no

 ** EngineVersion **   
La versione del motore del cluster globale.  
▬Tipo: stringa  
Obbligatorio: no

 ** SourceDBClusterIdentifier **   
L'Amazon Resource Name (ARN) da utilizzare come cluster primario del cluster globale. Questo parametro è facoltativo.  
▬Tipo: stringa  
Obbligatorio: no

 ** StorageEncrypted **   
L'impostazione di crittografia dello storage per il nuovo cluster globale.   
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_CreateGlobalCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_CreateGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** GlobalClusterAlreadyExistsFault **   
`GlobalClusterIdentifier` esiste già. Scegli un nuovo identificatore globale del cluster (nome univoco) per creare un nuovo cluster globale.   
Codice di stato HTTP: 400

 ** GlobalClusterQuotaExceededFault **   
Il numero di cluster globali per questo account è già al massimo consentito.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateGlobalCluster) 

# DeleteDBCluster
<a name="API_DeleteDBCluster"></a>

Elimina un cluster precedentemente fornito. Quando si elimina un cluster, tutti i backup automatici per quel cluster vengono eliminati e non possono essere ripristinati. Le istantanee manuali del cluster DB del cluster specificato non vengono eliminate.



## Parametri della richiesta
<a name="API_DeleteDBCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'identificatore del cluster per il cluster da eliminare. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere a un esistente`DBClusterIdentifier`.
Tipo: stringa  
Obbligatorio: sì

 ** FinalDBSnapshotIdentifier **   
 L'identificatore dello snapshot del cluster nuovo creato quando `SkipFinalSnapshot` è impostato su. `false`   
 Se si specifica questo parametro e si imposta anche il `SkipFinalShapshot` parametro su, viene `true` generato un errore. 
Vincoli:  
+ Deve contenere da 1 a 255 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
▬Tipo: stringa  
Obbligatorio: no

 ** SkipFinalSnapshot **   
 Determina se viene creata un'istantanea finale del cluster prima dell'eliminazione del cluster. Se specificato, non `true` viene creata alcuna istantanea del cluster. Se specificato, `false` viene creata un'istantanea del cluster prima dell'eliminazione del cluster DB.   
In caso `SkipFinalSnapshot` `false` affermativo, è necessario specificare un `FinalDBSnapshotIdentifier` parametro.
Impostazione predefinita: `false`   
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_DeleteDBCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_DeleteDBCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBClusterSnapshotAlreadyExistsFault **   
Hai già un'istantanea del cluster con l'identificatore specificato.  
Codice di stato HTTP: 400

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido dello snapshot del cluster.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** SnapshotQuotaExceeded **   
La richiesta comporterebbe il superamento del numero consentito di istantanee.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteDBCluster) 

# DeleteDBClusterParameterGroup
<a name="API_DeleteDBClusterParameterGroup"></a>

Elimina un gruppo di parametri del cluster specificato. Il gruppo di parametri del cluster da eliminare non può essere associato a nessun cluster.

## Parametri della richiesta
<a name="API_DeleteDBClusterParameterGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterParameterGroupName **   
Il nome del gruppo di parametri del cluster.  
Vincoli:  
+ Deve essere il nome di un gruppo di parametri del cluster esistente.
+ Non è possibile eliminare un gruppo di parametri di cluster predefinito.
+ Non può essere associato a nessun cluster.
Tipo: stringa  
Obbligatorio: sì

## Errori
<a name="API_DeleteDBClusterParameterGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

 ** InvalidDBParameterGroupState **   
Il gruppo di parametri è in uso o si trova in uno stato non valido. Se state cercando di eliminare il gruppo di parametri, non potete eliminarlo quando il gruppo di parametri si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteDBClusterParameterGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteDBClusterParameterGroup) 

# DeleteDBClusterSnapshot
<a name="API_DeleteDBClusterSnapshot"></a>

Elimina un'istantanea del cluster. Se si copia lo snapshot, l'operazione di copia viene terminata.

**Nota**  
L'istantanea del cluster deve trovarsi `available` nello stato in cui deve essere eliminata.

## Parametri della richiesta
<a name="API_DeleteDBClusterSnapshot_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterSnapshotIdentifier **   
L'identificatore dello snapshot del cluster da eliminare.  
Vincoli: deve essere il nome di un'istantanea del cluster esistente nello stato. `available`  
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_DeleteDBClusterSnapshot_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBClusterSnapshot **   
Informazioni dettagliate su un'istantanea del cluster.   
Tipo: oggetto [DBClusterSnapshot](API_DBClusterSnapshot.md)

## Errori
<a name="API_DeleteDBClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido di snapshot del cluster.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteDBClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteDBClusterSnapshot) 

# DeleteDBInstance
<a name="API_DeleteDBInstance"></a>

Elimina un'istanza precedentemente fornita.

## Parametri della richiesta
<a name="API_DeleteDBInstance_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBInstanceIdentifier **   
L'identificatore dell'istanza da eliminare. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere al nome di un'istanza esistente.
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_DeleteDBInstance_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBInstance **   
Informazioni dettagliate su un'istanza.   
Tipo: oggetto [DBInstance](API_DBInstance.md)

## Errori
<a name="API_DeleteDBInstance_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** DBSnapshotAlreadyExists **   
 `DBSnapshotIdentifier`è già utilizzato da un'istantanea esistente.   
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

 ** SnapshotQuotaExceeded **   
La richiesta comporterebbe il superamento del numero consentito di istantanee.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteDBInstance) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteDBInstance) 

# DeleteDBSubnetGroup
<a name="API_DeleteDBSubnetGroup"></a>

Elimina un gruppo di sottoreti.

**Nota**  
Il gruppo di sottoreti di database specificato non deve essere associato ad alcuna istanza database.

## Parametri della richiesta
<a name="API_DeleteDBSubnetGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti di database da eliminare.  
Non è possibile eliminare il gruppo di sottoreti di default.
Vincoli:  
Deve corrispondere il nome di un oggetto `DBSubnetGroup` esistente. Non deve essere predefinito.  
Ad esempio: `mySubnetgroup`   
Tipo: stringa  
Obbligatorio: sì

## Errori
<a name="API_DeleteDBSubnetGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** InvalidDBSubnetGroupStateFault **   
Il gruppo di sottoreti non può essere eliminato perché è in uso.  
Codice di stato HTTP: 400

 ** InvalidDBSubnetStateFault **   
 La sottorete non è nello stato *disponibile.*   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteDBSubnetGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteDBSubnetGroup) 

# DeleteEventSubscription
<a name="API_DeleteEventSubscription"></a>

Elimina un abbonamento per la notifica di eventi di Amazon DocumentDB.

## Parametri della richiesta
<a name="API_DeleteEventSubscription_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SubscriptionName **   
Il nome dell'abbonamento di notifica degli eventi di Amazon DocumentDB che desideri eliminare.  
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_DeleteEventSubscription_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** EventSubscription **   
Informazioni dettagliate su un evento a cui ti sei iscritto.  
Tipo: oggetto [EventSubscription](API_EventSubscription.md)

## Errori
<a name="API_DeleteEventSubscription_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InvalidEventSubscriptionState **   
È possibile che qualcun altro stia modificando un abbonamento. Attendi qualche secondo e riprova.  
Codice di stato HTTP: 400

 ** SubscriptionNotFound **   
Il nome dell'abbonamento non esiste.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteEventSubscription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteEventSubscription) 

# DeleteGlobalCluster
<a name="API_DeleteGlobalCluster"></a>

Elimina un cluster globale. I cluster primari e secondari devono essere già scollegati o eliminati prima di tentare di eliminare un cluster globale.

**Nota**  
Questa azione si applica solo ai cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_DeleteGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** GlobalClusterIdentifier **   
L'identificatore del cluster globale da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

## Elementi di risposta
<a name="API_DeleteGlobalCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_DeleteGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

 ** InvalidGlobalClusterStateFault **   
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteGlobalCluster) 

# DescribeCertificates
<a name="API_DescribeCertificates"></a>

Restituisce un elenco di certificati di autorità di certificazione (CA) forniti da Amazon DocumentDB a tale scopo. Account AWS

## Parametri della richiesta
<a name="API_DescribeCertificates_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** CertificateIdentifier **   
L'identificatore del certificato fornito dall'utente. Se viene specificato questo parametro, vengono restituite le informazioni relative solo al certificato specificato. Se questo parametro viene omesso, viene restituito un elenco contenente un massimo di `MaxRecords` certificati. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli  
+ Deve corrispondere a un esistente`CertificateIdentifier`.
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filter.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta `DescribeCertificates` precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
Numero massimo di record da includere nella risposta. Se sono presenti più record rispetto al valore di `MaxRecords` specificato, nella risposta viene incluso un token di paginazione detto contrassegno (oggetto Marker), per permettere di recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli:  
+ Minimo: 20
+ Massimo: 100
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeCertificates_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **Certificati.Certificate.N**   
Un elenco di certificati a tal fine. Account AWS  
Tipo: matrice di oggetti [Certificate](API_Certificate.md)

 ** Marker **   
Un token di impaginazione opzionale fornito se il numero di record recuperati è maggiore di. `MaxRecords` Se viene specificato questo parametro, il marker specifica il record successivo nell'elenco. Includendo il valore di `Marker` nella successiva chiamata a si `DescribeCertificates` ottiene la pagina successiva dei certificati.  
Tipo: String

## Errori
<a name="API_DescribeCertificates_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** CertificateNotFound **   
 `CertificateIdentifier`non fa riferimento a un certificato esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeCertificates) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeCertificates) 

# DescribeDBClusterParameterGroups
<a name="API_DescribeDBClusterParameterGroups"></a>

Restituisce un elenco di descrizioni `DBClusterParameterGroup`. Se viene specificato un `DBClusterParameterGroupName` parametro, l'elenco contiene solo la descrizione del gruppo di parametri del cluster specificato. 

## Parametri della richiesta
<a name="API_DescribeDBClusterParameterGroups_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterParameterGroupName **   
Il nome di uno specifico gruppo di parametri del cluster per cui restituire i dettagli.  
Vincoli:  
+ Se fornito, deve corrispondere al nome di un esistente`DBClusterParameterGroup`.
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBClusterParameterGroups_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBClusterParameterGroups. DBClusterParameterGroup**N.   
Un elenco di gruppi di parametri del cluster.  
Tipo: matrice di oggetti [DBClusterParameterGroup](API_DBClusterParameterGroup.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBClusterParameterGroups_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterParameterGroups) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterParameterGroups) 

# DescribeDBClusterParameters
<a name="API_DescribeDBClusterParameters"></a>

Restituisce l'elenco dettagliato dei parametri per un particolare gruppo di parametri del cluster.

## Parametri della richiesta
<a name="API_DescribeDBClusterParameters_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterParameterGroupName **   
Il nome di uno specifico gruppo di parametri del cluster per cui restituire i dettagli dei parametri.  
Vincoli:  
+ Se fornito, deve corrispondere al nome di un esistente`DBClusterParameterGroup`.
Tipo: stringa  
Obbligatorio: sì

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

 ** Source **   
 Un valore che indica la restituzione solo di parametri per una determinata origine. Le origini dei parametri possono essere `engine`, `service` o `customer`.   
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBClusterParameters_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

 **Parametri.Parameter.N**   
Fornisce un elenco di parametri per il gruppo di parametri del cluster.  
Tipo: matrice di oggetti [Parameter](API_Parameter.md)

## Errori
<a name="API_DescribeDBClusterParameters_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterParameters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterParameters) 

# DescribeDBClusters
<a name="API_DescribeDBClusters"></a>

Restituisce informazioni sui cluster Amazon DocumentDB forniti. Questa operazione API supporta l'impaginazione. Per alcune funzionalità di gestione come la gestione del ciclo di vita di cluster e istanze, Amazon DocumentDB sfrutta la tecnologia operativa condivisa con Amazon RDS e Amazon Neptune. Utilizza il parametro `filterName=engine,Values=docdb` filter per restituire solo i cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_DescribeDBClusters_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'identificatore del cluster fornito dall'utente. Se viene specificato questo parametro, vengono restituite le informazioni provenienti solo dal cluster specifico. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Se fornito, deve corrispondere a un valore esistente`DBClusterIdentifier`.
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Un filtro che specifica uno o più cluster da descrivere.  
Filtri supportati:  
+  `db-cluster-id`- Accetta identificatori di cluster e Amazon Resource Names (ARNs) del cluster. L'elenco dei risultati include solo informazioni sui cluster identificati da questi. ARNs
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBClusters_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBClusters. DBCluster**N.   
Un elenco di cluster.  
Tipo: matrice di oggetti [DBCluster](API_DBCluster.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBClusters_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusters) 

# DescribeDBClusterSnapshotAttributes
<a name="API_DescribeDBClusterSnapshotAttributes"></a>

Restituisce un elenco di nomi e valori degli attributi dello snapshot del cluster per uno snapshot manuale del cluster DB.

Quando si condividono istantanee con altri Account AWS, `DescribeDBClusterSnapshotAttributes` restituisce l'`restore`attributo e un elenco di IDs coloro Account AWS che sono autorizzati a copiare o ripristinare lo snapshot manuale del cluster. Se `all` è inclusa nell'elenco di valori dell'`restore`attributo, l'istantanea manuale del cluster è pubblica e può essere copiata o ripristinata da tutti. Account AWS

## Parametri della richiesta
<a name="API_DescribeDBClusterSnapshotAttributes_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterSnapshotIdentifier **   
L'identificatore dell'istantanea del cluster di cui descrivere gli attributi.  
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_DescribeDBClusterSnapshotAttributes_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBClusterSnapshotAttributesResult **   
Informazioni dettagliate sugli attributi associati a uno snapshot del cluster.  
Tipo: oggetto [DBClusterSnapshotAttributesResult](API_DBClusterSnapshotAttributesResult.md)

## Errori
<a name="API_DescribeDBClusterSnapshotAttributes_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterSnapshotAttributes) 

# DescribeDBClusterSnapshots
<a name="API_DescribeDBClusterSnapshots"></a>

Restituisce informazioni sulle istantanee del cluster. Questa operazione API supporta l'impaginazione.

## Parametri della richiesta
<a name="API_DescribeDBClusterSnapshots_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'ID del cluster per cui recuperare l'elenco delle istantanee del cluster. Questo parametro non può essere utilizzato con il `DBClusterSnapshotIdentifier` parametro. Questo parametro non distingue tra maiuscole e minuscole.   
Vincoli:  
+ Se fornito, deve corrispondere all'identificatore di un esistente`DBCluster`.
▬Tipo: stringa  
Obbligatorio: no

 ** DBClusterSnapshotIdentifier **   
Un identificatore di istantanea del cluster specifico da descrivere. Questo parametro non può essere utilizzato con il `DBClusterIdentifier` parametro. Questo valore è archiviato come stringa in caratteri minuscoli.   
Vincoli:  
+ Se fornito, deve corrispondere all'identificatore di un esistente`DBClusterSnapshot`.
+ Se questo identificatore è per uno snapshot automatizzato, anche il parametro `SnapshotType` deve essere specificato.
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** IncludePublic **   
Impostato `true` per includere istantanee manuali del cluster che sono pubbliche e possono essere copiate o ripristinate da chiunque e in altro modo. Account AWS`false` Il valore predefinito è `false`.  
Tipo: Booleano  
Obbligatorio: no

 ** IncludeShared **   
È impostata `true` per includere istantanee manuali condivise del cluster provenienti da altri utenti per Account AWS le quali Account AWS è stata concessa l'autorizzazione a copiare o ripristinare e in altro modo. `false` Il valore predefinito è `false`.  
Tipo: Booleano  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

 ** SnapshotType **   
Il tipo di istantanee del cluster da restituire. È possibile specificare uno dei seguenti valori:  
+  `automated`- Restituisci tutte le istantanee del cluster che Amazon DocumentDB ha creato automaticamente per te. Account AWS
+  `manual`- Restituisci tutte le istantanee del cluster che hai creato manualmente per il tuo. Account AWS
+  `shared`- Restituisci tutte le istantanee manuali del cluster che sono state condivise con il tuo. Account AWS
+  `public`- Restituisce tutte le istantanee del cluster che sono state contrassegnate come pubbliche.
Se non si specifica un `SnapshotType` valore, vengono restituite sia le istantanee automatiche che quelle manuali del cluster. È possibile includere istantanee condivise del cluster con questi risultati impostando il `IncludeShared` parametro su. `true` È possibile includere istantanee pubbliche del cluster con questi risultati impostando il `IncludePublic` parametro su. `true`  
I parametri `IncludePublic` e `IncludeShared` non sono applicabili ai valori `SnapshotType` di `manual` o `automated`. Il parametro `IncludePublic` non è applicabile quando `SnapshotType` è impostato su `shared`. Il parametro `IncludeShared` non è applicabile quando `SnapshotType` è impostato su `public`.  
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBClusterSnapshots_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBClusterIstantanee. DBClusterIstantanea.N**   
Fornisce un elenco di istantanee del cluster.  
Tipo: matrice di oggetti [DBClusterSnapshot](API_DBClusterSnapshot.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBClusterSnapshots_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterSnapshots) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterSnapshots) 

# DescribeDBEngineVersions
<a name="API_DescribeDBEngineVersions"></a>

Restituisce un elenco dei motori disponibili.

## Parametri della richiesta
<a name="API_DescribeDBEngineVersions_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBParameterGroupFamily **   
Il nome di una specifica famiglia di gruppi di parametri per cui restituire i dettagli.  
Vincoli:  
+ Se fornito, deve corrispondere a uno esistente`DBParameterGroupFamily`.
▬Tipo: stringa  
Obbligatorio: no

 ** DefaultOnly **   
Indica che solo la versione predefinita del motore specificato o una combinazione di motore e versione principale viene restituita.  
Tipo: Booleano  
Obbligatorio: no

 ** Engine **   
Il motore di database da restituire.  
▬Tipo: stringa  
Obbligatorio: no

 ** EngineVersion **   
La versione del motore di database da restituire.  
Ad esempio: `3.6.0`   
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** ListSupportedCharacterSets **   
Se questo parametro viene specificato e il modulo di richiesta supporta il parametro `CharacterSetName` per `CreateDBInstance`, la risposta include un elenco di set di caratteri supportati per ciascuna versione del motore.   
Tipo: Booleano  
Obbligatorio: no

 ** ListSupportedTimezones **   
Se questo parametro viene specificato e il modulo di richiesta supporta il parametro `TimeZone` per `CreateDBInstance`, la risposta include un elenco di fusi orari supportati per ciascuna versione del motore.   
Tipo: Booleano  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBEngineVersions_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBEngineVersioni. DBEngineVersione.N**   
Informazioni dettagliate su una o più versioni del motore.  
Tipo: matrice di oggetti [DBEngineVersion](API_DBEngineVersion.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBEngineVersions_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBEngineVersions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBEngineVersions) 

# DescribeDBInstances
<a name="API_DescribeDBInstances"></a>

Restituisce informazioni sulle istanze Amazon DocumentDB assegnate. Quest'API supporta la paginazione.

## Parametri della richiesta
<a name="API_DescribeDBInstances_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBInstanceIdentifier **   
L'identificatore dell'istanza fornito dall'utente. Se viene specificato questo parametro, vengono restituite solo le informazioni relative all'istanza specifica. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Se fornito, deve corrispondere all'identificatore di un'esistente`DBInstance`.
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Un filtro che specifica una o più istanze da descrivere.  
Filtri supportati:  
+  `db-cluster-id`- Accetta identificatori di cluster e Amazon Resource Names (ARNs) del cluster. L'elenco dei risultati include solo le informazioni sulle istanze associate ai cluster da questi identificati. ARNs
+  `db-instance-id`- Accetta identificatori di istanza e istanze. ARNs L'elenco dei risultati include solo le informazioni sulle istanze da queste identificate. ARNs
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBInstances_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBInstances. DBInstance**N.   
Informazioni dettagliate su una o più istanze.   
Tipo: matrice di oggetti [DBInstance](API_DBInstance.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBInstances_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBInstances) 

# DescribeDBSubnetGroups
<a name="API_DescribeDBSubnetGroups"></a>

Restituisce un elenco di descrizioni `DBSubnetGroup`. Se `DBSubnetGroupName` viene specificato a, l'elenco conterrà solo le descrizioni del specificato`DBSubnetGroup`.

## Parametri della richiesta
<a name="API_DescribeDBSubnetGroups_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti per cui restituire i dettagli.  
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filter.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBSubnetGroups_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBSubnetGruppi. DBSubnetGruppo.N**   
Informazioni dettagliate su uno o più gruppi di sottoreti.  
Tipo: matrice di oggetti [DBSubnetGroup](API_DBSubnetGroup.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBSubnetGroups_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBSubnetGroups) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBSubnetGroups) 

# DescribeEngineDefaultClusterParameters
<a name="API_DescribeEngineDefaultClusterParameters"></a>

Restituisce il motore predefinito e le informazioni del parametro di sistema per il motore del cluster di database .

## Parametri della richiesta
<a name="API_DescribeEngineDefaultClusterParameters_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBParameterGroupFamily **   
Il nome della famiglia del gruppo di parametri del cluster per cui restituire le informazioni sui parametri del motore.  
Tipo: stringa  
Obbligatorio: sì

 **Filtri.Filter.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeEngineDefaultClusterParameters_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** EngineDefaults **   
Contiene il risultato di una chiamata riuscita dell'`DescribeEngineDefaultClusterParameters`operazione.   
Tipo: oggetto [EngineDefaults](API_EngineDefaults.md)

## Errori
<a name="API_DescribeEngineDefaultClusterParameters_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeEngineDefaultClusterParameters) 

# DescribeEventCategories
<a name="API_DescribeEventCategories"></a>

Visualizza un elenco di categorie per tutti i tipi di origini di eventi, oppure, se specificato, per un determinato tipo di origine. 

## Parametri della richiesta
<a name="API_DescribeEventCategories_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** SourceType **   
Il tipo di origine che genera gli eventi.  
Valori validi: `db-instance`, `db-parameter-group`, `db-security-group`   
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeEventCategories_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 **EventCategoriesMapList. EventCategoriesMap**N.   
Un elenco di mappe delle categorie di eventi.  
Tipo: matrice di oggetti [EventCategoriesMap](API_EventCategoriesMap.md)

## Errori
<a name="API_DescribeEventCategories_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeEventCategories) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeEventCategories) 

# DescribeEvents
<a name="API_DescribeEvents"></a>

Restituisce eventi relativi a istanze, gruppi di sicurezza, istantanee e gruppi di parametri DB degli ultimi 14 giorni. È possibile ottenere eventi specifici per una particolare istanza DB, gruppo di sicurezza, snapshot o gruppo di parametri fornendo il nome come parametro. Per impostazione predefinita, vengono restituiti gli eventi dell'ultima ora.

## Parametri della richiesta
<a name="API_DescribeEvents_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** Duration **   
Il numero di minuti per il quale recuperare gli eventi.  
Impostazione predefinita: 60  
Tipo: Integer  
Obbligatorio: no

 ** EndTime **   
 La fine dell'intervallo di tempo per il quale recuperare gli eventi, specificato nel formato ISO 8601.   
Esempio: 2009-07-08T18:00Z  
Tipo: Timestamp  
Obbligatorio: no

 **EventCategories. EventCategory**N.   
Un elenco di categorie di eventi che attivano le notifiche per un abbonamento alla notifica di eventi.  
Tipo: array di stringhe  
Obbligatorio: no

 **Filtri.Filter.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

 ** SourceIdentifier **   
L'identificatore dell'origine dell'evento in base a cui vengono restituiti gli eventi. Se non è specificato, tutte le origini sono incluse nella risposta.  
Vincoli:  
+ Se `SourceIdentifier` fornito, `SourceType` deve essere fornito anche.
+ Se il tipo di sorgente è`DBInstance`, `DBInstanceIdentifier` deve essere fornito un.
+ Se il tipo di fonte è`DBSecurityGroup`, `DBSecurityGroupName` deve essere fornito a.
+ Se il tipo di fonte è`DBParameterGroup`, `DBParameterGroupName` deve essere fornito a.
+ Se il tipo di fonte è`DBSnapshot`, `DBSnapshotIdentifier` deve essere fornito a.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
▬Tipo: stringa  
Obbligatorio: no

 ** SourceType **   
L'origine eventi per la quale recuperare gli eventi. Se non viene specificato alcun valore, tutti gli eventi vengono restituiti.  
Tipo: String  
Valori validi: `db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot`   
Campo obbligatorio: no

 ** StartTime **   
 L'inizio dell'intervallo di tempo per il quale recuperare gli eventi, specificato nel formato ISO 8601.   
Esempio: 2009-07-08T18:00Z  
Tipo: Timestamp  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeEvents_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **Events.Event.N**   
Informazioni dettagliate su uno o più eventi.   
Tipo: matrice di oggetti [Event](API_Event.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeEvents_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeEvents) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeEvents) 

# DescribeEventSubscriptions
<a name="API_DescribeEventSubscriptions"></a>

Elenca tutte le descrizioni di sottoscrizioni per un account cliente. La descrizione di un abbonamento include `SubscriptionName``SNSTopicARN`,`CustomerID`,`SourceType`,`SourceID`,`CreationTime`, e`Status`.

Se si specifica un`SubscriptionName`, elenca la descrizione di tale abbonamento.

## Parametri della richiesta
<a name="API_DescribeEventSubscriptions_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

 ** SubscriptionName **   
Il nome dell'abbonamento di notifica degli eventi di Amazon DocumentDB che desideri descrivere.  
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeEventSubscriptions_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **EventSubscriptionsList. EventSubscription**N.   
Un elenco di sottoscrizioni a eventi.  
Tipo: matrice di oggetti [EventSubscription](API_EventSubscription.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeEventSubscriptions_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** SubscriptionNotFound **   
Il nome dell'abbonamento non esiste.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeEventSubscriptions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeEventSubscriptions) 

# DescribeGlobalClusters
<a name="API_DescribeGlobalClusters"></a>

Restituisce informazioni sui cluster globali di Amazon DocumentDB. Quest'API supporta la paginazione.

**Nota**  
Questa azione si applica solo ai cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_DescribeGlobalClusters_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 **Filtri.Filtro.N**   
Un filtro che specifica uno o più cluster DB globali da descrivere.  
Filtri supportati: `db-cluster-id` accetta identificatori di cluster e Amazon Resource Names (ARNs) del cluster. L'elenco dei risultati includerà solo informazioni sui cluster identificati da questi. ARNs  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** GlobalClusterIdentifier **   
L'identificatore del cluster fornito dall'utente. Se viene specificato questo parametro, vengono restituite le informazioni provenienti solo dal cluster specifico. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta `DescribeGlobalClusters` precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione chiamato marker in modo da poter recuperare i risultati rimanenti.   
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeGlobalClusters_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **GlobalClusters. GlobalClusterMember**N.   
  
Tipo: matrice di oggetti [GlobalCluster](API_GlobalCluster.md)

 ** Marker **   
  
Tipo: String

## Errori
<a name="API_DescribeGlobalClusters_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeGlobalClusters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeGlobalClusters) 

# DescribeOrderableDBInstanceOptions
<a name="API_DescribeOrderableDBInstanceOptions"></a>

Restituisce un elenco di opzioni di istanza ordinabili per il motore specificato.

## Parametri della richiesta
<a name="API_DescribeOrderableDBInstanceOptions_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** Engine **   
Il nome del motore per il quale recuperare le opzioni di istanza.  
Tipo: stringa  
Obbligatorio: sì

 ** DBInstanceClass **   
Il valore del filtro della classe di istanza. Specificate questo parametro per mostrare solo le offerte disponibili che corrispondono alla classe di istanza specificata.  
▬Tipo: stringa  
Obbligatorio: no

 ** EngineVersion **   
Valore di filtro della versione del motore. Specificate questo parametro per mostrare solo le offerte disponibili che corrispondono alla versione del motore specificata.  
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** LicenseModel **   
Valore di filtro del modello di licenza. Specificate questo parametro per mostrare solo le offerte disponibili che corrispondono al modello di licenza specificato.  
▬Tipo: stringa  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

 ** Vpc **   
Il valore del filtro del cloud privato virtuale (VPC). Specifica questo parametro per visualizzare solo le offerte VPC o non VPC disponibili.  
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeOrderableDBInstanceOptions_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

 **Opzioni DBInstance ordinabili.Opzione ordinabile.N DBInstance**   
Le opzioni disponibili per una particolare istanza ordinabile.  
Tipo: matrice di oggetti [OrderableDBInstanceOption](API_OrderableDBInstanceOption.md)

## Errori
<a name="API_DescribeOrderableDBInstanceOptions_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeOrderableDBInstanceOptions) 

# DescribePendingMaintenanceActions
<a name="API_DescribePendingMaintenanceActions"></a>

Restituisce un elenco di risorse (ad esempio, istanze) che hanno almeno un'azione di manutenzione in sospeso.

## Parametri della richiesta
<a name="API_DescribePendingMaintenanceActions_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 **Filtri.Filter.N**   
Un filtro che specifica una o più risorse per restituire le operazioni di manutenzione in sospeso.  
Filtri supportati:  
+  `db-cluster-id`- Accetta identificatori di cluster e Amazon Resource Names (ARNs) del cluster. L'elenco dei risultati include solo le azioni di manutenzione in sospeso per i cluster da questi identificati. ARNs
+  `db-instance-id`- Accetta identificatori di istanza e istanze. ARNs L'elenco dei risultati include solo le azioni di manutenzione in sospeso per le istanze DB da queste identificate. ARNs
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

 ** ResourceIdentifier **   
L'ARN della risorsa per la quale restituire operazioni di manutenzione in sospeso.  
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribePendingMaintenanceActions_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

 **PendingMaintenanceActions. ResourcePendingMaintenanceActions**N.   
Le azioni di manutenzione da applicare.  
Tipo: matrice di oggetti [ResourcePendingMaintenanceActions](API_ResourcePendingMaintenanceActions.md)

## Errori
<a name="API_DescribePendingMaintenanceActions_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** ResourceNotFoundFault **   
L'ID della risorsa specificata non è stato trovato.  
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribePendingMaintenanceActions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribePendingMaintenanceActions) 

# FailoverDBCluster
<a name="API_FailoverDBCluster"></a>

Impone un failover per un cluster.

Un failover per un cluster promuove una delle repliche di Amazon DocumentDB (istanze di sola lettura) nel cluster come istanza principale (lo scrittore del cluster).

In caso di errore dell'istanza primaria, Amazon DocumentDB esegue automaticamente il failover su una replica di Amazon DocumentDB, se esistente. Puoi forzare un failover per simulare un guasto di un'istanza primaria per scopi di testing.

## Parametri della richiesta
<a name="API_FailoverDBCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
Un identificatore di cluster per cui forzare un failover. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere all'identificativo di un `DBCluster` esistente.
▬Tipo: stringa  
Obbligatorio: no

 ** TargetDBInstanceIdentifier **   
Nome dell'istanza da promuovere a istanza primaria.  
È necessario specificare l'identificatore di istanza per una replica di Amazon DocumentDB nel cluster. Ad esempio, `mydbcluster-replica1`.  
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_FailoverDBCluster_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_FailoverDBCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/FailoverDBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/FailoverDBCluster) 

# FailoverGlobalCluster
<a name="API_FailoverGlobalCluster"></a>

Promuove il cluster DB secondario specificato a diventare il cluster DB primario nel cluster globale quando si verifica il failover di un cluster globale.

Utilizzate questa operazione per rispondere a un evento non pianificato, ad esempio un disastro regionale nella regione primaria. Il failover può comportare la perdita dei dati delle transazioni di scrittura che non sono stati replicati sul dispositivo secondario scelto prima che si verificasse l'evento di failover. Tuttavia, il processo di ripristino che promuove un'istanza DB sul cluster DB secondario scelto come istanza DB di scrittura principale garantisce che i dati si trovino in uno stato transazionale coerente.

## Parametri della richiesta
<a name="API_FailoverGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** GlobalClusterIdentifier **   
L'identificatore del cluster globale Amazon DocumentDB per applicare questa operazione. L'identificatore è la chiave univoca assegnata dall'utente al momento della creazione del cluster. In altre parole, è il nome del cluster globale.  
Vincoli:  
+ Deve corrispondere all'identificatore di un cluster globale esistente.
+ Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

 ** TargetDbClusterIdentifier **   
L'identificatore del cluster Amazon DocumentDB secondario che desideri promuovere a primario per il cluster globale. Utilizza Amazon Resource Name (ARN) come identificatore in modo che Amazon DocumentDB possa localizzare il cluster nella sua regione. AWS   
Vincoli:  
+ Deve corrispondere all'identificatore di un cluster secondario esistente.
+ Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

 ** AllowDataLoss **   
Speciifica se consentire la perdita di dati per questa operazione globale del cluster. Consentire la perdita di dati attiva un'operazione di failover globale.  
Se non si specifica`AllowDataLoss`, per impostazione predefinita l'operazione globale del cluster è uno switchover.  
Vincoli:  
+ Non può essere specificato insieme al parametro. `Switchover`
Tipo: Booleano  
Obbligatorio: no

 ** Switchover **   
Speciifica se passare da un cluster di database globale a un altro.  
Vincoli:  
+ Non può essere specificato insieme al `AllowDataLoss` parametro.
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_FailoverGlobalCluster_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_FailoverGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidGlobalClusterStateFault **   
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/FailoverGlobalCluster) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Elenca tutti i tag su una risorsa Amazon DocumentDB.

## Parametri della richiesta
<a name="API_ListTagsForResource_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** ResourceName **   
La risorsa Amazon DocumentDB con i tag da elencare. Questo valore è un Amazon Resource Name (ARN).  
Tipo: stringa  
Obbligatorio: sì

 **Filtri.Filter.N**   
Questo parametro non è attualmente supportato.  
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

## Elementi di risposta
<a name="API_ListTagsForResource_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 **TagList.Tag.N**   
Un elenco di uno o più tag.  
Tipo: matrice di oggetti [Tag](API_Tag.md)

## Errori
<a name="API_ListTagsForResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** DBSnapshotNotFound **   
 `DBSnapshotIdentifier`non fa riferimento a un'istantanea esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ListTagsForResource) 

# ModifyDBCluster
<a name="API_ModifyDBCluster"></a>

Modifica un'impostazione per un cluster Amazon DocumentDB. Puoi modificare uno o più parametri di configurazione del database specificando questi parametri e i nuovi valori nella richiesta. 

## Parametri della richiesta
<a name="API_ModifyDBCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'identificatore del cluster per il cluster che viene modificato. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere all'identificativo di un `DBCluster` esistente.
Tipo: stringa  
Obbligatorio: sì

 ** AllowMajorVersionUpgrade **   
Un valore che Indica che gli aggiornamenti delle versioni principali sono permessi.  
Vincoli:  
+ È necessario consentire gli aggiornamenti delle versioni principali quando si specifica un valore per il `EngineVersion` parametro che è una versione principale diversa dalla versione corrente del cluster.
+ Poiché alcuni parametri sono specifici della versione, la loro modifica richiede l'esecuzione di una nuova chiamata `ModifyDBCluster` API dopo il completamento dell'MVU locale.
L'esecuzione di un MVU influisce direttamente sui seguenti parametri:  
+  `MasterUserPassword` 
+  `NewDBClusterIdentifier` 
+  `VpcSecurityGroupIds` 
+  `Port` 
Tipo: Booleano  
Obbligatorio: no

 ** ApplyImmediately **   
Un valore che specifica se le modifiche in questa richiesta e le eventuali modifiche in sospeso vengono applicate in modo asincrono il prima possibile, indipendentemente dall'impostazione per il cluster. `PreferredMaintenanceWindow` Se questo parametro è impostato su`false`, le modifiche al cluster vengono applicate durante la finestra di manutenzione successiva.  
Il `ApplyImmediately` parametro influisce solo sui `MasterUserPassword` valori `NewDBClusterIdentifier` and. Se impostate questo valore del parametro su`false`, le modifiche ai `MasterUserPassword` valori `NewDBClusterIdentifier` and vengono applicate durante la finestra di manutenzione successiva. Tutte le altre modifiche vengono applicate immediatamente, indipendentemente dal valore del parametro `ApplyImmediately`.  
Impostazione predefinita: `false`   
Tipo: Booleano  
Obbligatorio: no

 ** BackupRetentionPeriod **   
Il numero di giorni durante i quali vengono conservati i backup automatici. È necessario specificare un valore minimo pari a 1.  
Impostazione predefinita: 1  
Vincoli:  
+ Il valore deve essere compreso tra 1 e 35.
Tipo: Integer  
Obbligatorio: no

 ** CloudwatchLogsExportConfiguration **   
L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in Amazon CloudWatch Logs per un'istanza o un cluster specifico. Gli `DisableLogTypes` array `EnableLogTypes` and determinano quali log vengono esportati (o non esportati) in Logs. CloudWatch   
Tipo: oggetto [CloudwatchLogsExportConfiguration](API_CloudwatchLogsExportConfiguration.md)  
Obbligatorio: no

 ** DBClusterParameterGroupName **   
Il nome del gruppo di parametri del cluster da utilizzare per il cluster.  
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
Speciifica se questo cluster può essere eliminato. Se `DeletionProtection` è abilitato, il cluster non può essere eliminato a meno che non venga modificato e `DeletionProtection` disabilitato. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.  
Tipo: Booleano  
Obbligatorio: no

 ** EngineVersion **   
Numero di versione del motore di database a cui eseguire l'aggiornamento. La modifica di questo parametro provoca un'interruzione. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che il parametro `ApplyImmediately` non sia abilitato.  
Per elencare tutte le versioni del motore disponibili per Amazon DocumentDB, usa il seguente comando:  
 `aws docdb describe-db-engine-versions --engine docdb --query "DBEngineVersions[].EngineVersion"`   
▬Tipo: stringa  
Obbligatorio: no

 ** ManageMasterUserPassword **   
Speciifica se gestire la password dell'utente principale con Amazon Web Services Secrets Manager. Se il cluster non gestisce la password dell'utente principale con Amazon Web Services Secrets Manager, puoi attivare questa gestione. In questo caso, non puoi specificare`MasterUserPassword`. Se il cluster gestisce già la password dell'utente principale con Amazon Web Services Secrets Manager e specifichi che la password dell'utente principale non è gestita con Amazon Web Services Secrets Manager, devi specificare`MasterUserPassword`. In questo caso, Amazon DocumentDB elimina il segreto e utilizza la nuova password per l'utente master specificato da. `MasterUserPassword`  
Tipo: Booleano  
Obbligatorio: no

 ** MasterUserPassword **   
La password per l'utente del database master. Questa password può contenere qualsiasi carattere ASCII stampabile, eccetto la barra (/), le virgolette (") o il simbolo chiocciola (@).  
Vincoli: deve contenere da 8 a 100 caratteri.  
▬Tipo: stringa  
Obbligatorio: no

 ** MasterUserSecretKmsKeyId **   
L'identificatore della chiave KMS di Amazon Web Services per crittografare un segreto che viene generato e gestito automaticamente in Amazon Web Services Secrets Manager.  
Questa impostazione è valida solo se sono soddisfatte entrambe le seguenti condizioni:  
+ Il cluster non gestisce la password dell'utente principale in Amazon Web Services Secrets Manager. Se il cluster gestisce già la password dell'utente principale in Amazon Web Services Secrets Manager, non puoi modificare la chiave KMS utilizzata per crittografare il segreto.
+ Stai abilitando `ManageMasterUserPassword` la gestione della password utente principale in Amazon Web Services Secrets Manager. Se lo stai attivando `ManageMasterUserPassword` e non lo specifichi`MasterUserSecretKmsKeyId`, la chiave `aws/secretsmanager` KMS viene utilizzata per crittografare il segreto. Se il segreto si trova in un altro account Amazon Web Services, non puoi utilizzare la chiave `aws/secretsmanager` KMS per crittografare il segreto e devi utilizzare una chiave KMS gestita dal cliente.
L'identificatore della chiave KMS di Amazon Web Services è l'ARN della chiave, l'ID della chiave, l'alias ARN o il nome alias per la chiave KMS. Per utilizzare una chiave KMS in un altro account Amazon Web Services, specifica la chiave ARN o l'alias ARN.  
Esiste una chiave KMS predefinita per il tuo account Amazon Web Services. Il tuo account Amazon Web Services ha una chiave KMS predefinita diversa per ogni regione Amazon Web Services.  
▬Tipo: stringa  
Obbligatorio: no

 ** NetworkType **   
Il tipo di rete del cluster.  
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).  
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.  
Valori validi: `IPV4` \$1 `DUAL`   
▬Tipo: stringa  
Obbligatorio: no

 ** NewDBClusterIdentifier **   
Il nuovo identificatore per il cluster quando un cluster viene rinominato. Questo valore è archiviato come stringa in caratteri minuscoli.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Ad esempio: `my-cluster2`   
▬Tipo: stringa  
Obbligatorio: no

 ** Port **   
Numero della porta sulla quale il cluster accetta le connessioni.  
Vincoli: deve essere un valore compreso tra a. `1150` `65535`   
Impostazione predefinita: la stessa porta del cluster originale.  
Tipo: Integer  
Obbligatorio: no

 ** PreferredBackupWindow **   
Intervallo di tempo giornaliero durante il quale vengono creati i backup automatici, se sono abilitati tramite il parametro `BackupRetentionPeriod`.   
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un blocco di tempo di 8 ore per ciascuna. Regione AWS  
Vincoli:  
+ Il valore deve essere nel formato `hh24:mi-hh24:mi`.
+ Il valore deve essere nel fuso orario UTC (Universal Coordinated Time).
+ Il valore non deve essere in conflitto con la finestra di manutenzione preferita.
+ Il valore deve essere almeno di 30 minuti.
▬Tipo: stringa  
Obbligatorio: no

 ** PreferredMaintenanceWindow **   
Intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.  
Formato: `ddd:hh24:mi-ddd:hh24:mi`   
L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna Regione AWS, che si verifica in un giorno casuale della settimana.   
Giorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica  
Vincoli: finestra di un minimo di 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** RotateMasterUserPassword **   
Speciifica se ruotare il segreto gestito da Amazon Web Services Secrets Manager per la password dell'utente principale.  
Questa impostazione è valida solo se la password dell'utente principale è gestita da Amazon DocumentDB in Amazon Web Services Secrets Manager per il cluster. Il valore segreto contiene la password aggiornata.  
Vincolo: è necessario applicare la modifica immediatamente quando si ruota la password dell'utente principale.  
Tipo: Booleano  
Obbligatorio: no

 ** ServerlessV2ScalingConfiguration **   
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.  
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)  
Obbligatorio: no

 ** StorageType **   
Il tipo di archiviazione da associare al cluster di database.  
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*  
Valori validi per il tipo di storage - `standard | iopt1`   
Il valore predefinito è `standard `   
▬Tipo: stringa  
Obbligatorio: no

 **VpcSecurityGroupIds. VpcSecurityGroupId**N.   
Un elenco di gruppi di sicurezza del cloud privato virtuale (VPC) a cui apparterrà il cluster.  
Tipo: array di stringhe  
Obbligatorio: no

## Elementi di risposta
<a name="API_ModifyDBCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_ModifyDBCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterAlreadyExistsFault **   
Hai già un cluster con l'identificatore fornito.  
Codice di stato HTTP: 400

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBClusterParameterGroupNotFound **   
 `DBClusterParameterGroupName`non fa riferimento a un gruppo di parametri del cluster esistente.   
Codice di stato HTTP: 404

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

 ** InvalidDBSecurityGroupState **   
Lo stato del gruppo di sicurezza non consente l'eliminazione.  
Codice di stato HTTP: 400

 ** InvalidDBSubnetGroupStateFault **   
Il gruppo di sottoreti non può essere eliminato perché è in uso.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

 ** InvalidVPCNetworkStateFault **   
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.  
Codice di stato HTTP: 400

 ** NetworkTypeNotSupported **   
Il tipo di rete non è supportato `DBSubnetGroup` né da nessuna delle versioni del motore DB.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBCluster) 

# ModifyDBClusterParameterGroup
<a name="API_ModifyDBClusterParameterGroup"></a>

 Modifica i parametri di un gruppo di parametri del cluster. Per modificare più di un parametro, inviare un elenco di quanto segue: `ParameterName`, `ParameterValue` e `ApplyMethod`. Un massimo di 20 parametri possono essere modificati in una singola richiesta. 

**Nota**  
Le modifiche apportate ai parametri dinamici vengono applicate immediatamente. Le modifiche ai parametri statici richiedono una finestra di riavvio o di manutenzione prima che la modifica possa avere effetto.

**Importante**  
Dopo aver creato un gruppo di parametri del cluster, è necessario attendere almeno 5 minuti prima di creare il primo cluster che utilizza il gruppo di parametri del cluster come gruppo predefinito. Ciò consente ad Amazon DocumentDB di completare completamente l'azione di creazione prima che il gruppo di parametri venga utilizzato come predefinito per un nuovo cluster. Questa fase è particolarmente importante per parametri che sono critici durante la creazione del database predefinito per un cluster, ad esempio il set di caratteri per il database predefinito specificato dal parametro `character_set_database`.

## Parametri della richiesta
<a name="API_ModifyDBClusterParameterGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterParameterGroupName **   
Il nome del gruppo di parametri del cluster da modificare.  
Tipo: stringa  
Obbligatorio: sì

 **Parametri.Parameter.N**   
Un elenco di parametri nel gruppo di parametri del cluster da modificare.  
Tipo: matrice di oggetti [Parameter](API_Parameter.md)  
Obbligatorio: sì

## Elementi di risposta
<a name="API_ModifyDBClusterParameterGroup_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBClusterParameterGroupName **   
Il nome di un gruppo di parametri del cluster.  
Vincoli:  
+ Deve contenere da 1 a 255 lettere o numeri.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Questo valore è archiviato come stringa in caratteri minuscoli.
Tipo: String

## Errori
<a name="API_ModifyDBClusterParameterGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

 ** InvalidDBParameterGroupState **   
Il gruppo di parametri è in uso o si trova in uno stato non valido. Se state cercando di eliminare il gruppo di parametri, non potete eliminarlo quando il gruppo di parametri si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBClusterParameterGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBClusterParameterGroup) 

# ModifyDBClusterSnapshotAttribute
<a name="API_ModifyDBClusterSnapshotAttribute"></a>

Aggiunge un attributo e dei valori o rimuove un attributo e dei valori da un'istantanea manuale del cluster.

Per condividere un'istantanea manuale del `AttributeName` cluster con altri Account AWS, specifica `restore` come e utilizza il `ValuesToAdd` parametro per aggiungere un elenco IDs di quelle autorizzate a ripristinare l' Account AWS istantanea manuale del cluster. Utilizzate il valore `all` per rendere pubblica l'istantanea manuale del cluster, il che significa che può essere copiata o ripristinata da tutti. Account AWS Non aggiungete il `all` valore per le istantanee manuali del cluster che contengono informazioni private che non desiderate siano disponibili per tutti. Account AWS Se un'istantanea manuale del cluster è crittografata, può essere condivisa, ma solo specificando un elenco di quelle autorizzate Account AWS IDs per il parametro. `ValuesToAdd` Non è possibile utilizzare `all` come valore per il parametro in questo caso.

## Parametri della richiesta
<a name="API_ModifyDBClusterSnapshotAttribute_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** AttributeName **   
Il nome dell'attributo dello snapshot del cluster da modificare.  
Per gestire l'autorizzazione di altri utenti Account AWS a copiare o ripristinare un'istantanea manuale del cluster, imposta questo valore su. `restore`  
Tipo: stringa  
Obbligatorio: sì

 ** DBClusterSnapshotIdentifier **   
L'identificatore dello snapshot del cluster di cui modificare gli attributi.  
Tipo: stringa  
Obbligatorio: sì

 **ValuesToAdd. AttributeValue**N.   
Un elenco di attributi di snapshot del cluster da aggiungere all'attributo specificato da. `AttributeName`  
Per autorizzare altri utenti Account AWS a copiare o ripristinare un'istantanea manuale del cluster, imposta questo elenco in modo da includerne uno o più. Account AWS IDs Per rendere l'istantanea manuale del cluster ripristinabile da qualsiasi utente Account AWS, impostala su. `all` Non aggiungete il `all` valore per le istantanee manuali del cluster che contengono informazioni private che non desiderate siano disponibili per tutti. Account AWS  
Tipo: array di stringhe  
Obbligatorio: no

 **ValuesToRemove. AttributeValue**N.   
Un elenco di attributi di snapshot del cluster da rimuovere dall'attributo specificato da. `AttributeName`  
Per rimuovere l'autorizzazione ad altri utenti Account AWS a copiare o ripristinare manualmente un'istantanea del cluster, imposta questo elenco in modo che includa uno o più Account AWS identificatori. Per rimuovere l'autorizzazione Account AWS a copiare o ripristinare l'istantanea del cluster, impostala su. `all` Se lo specifichi`all`, un utente Account AWS il cui ID account viene aggiunto in modo esplicito all'`restore`attributo può comunque copiare o ripristinare un'istantanea manuale del cluster.  
Tipo: array di stringhe  
Obbligatorio: no

## Elementi di risposta
<a name="API_ModifyDBClusterSnapshotAttribute_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBClusterSnapshotAttributesResult **   
Informazioni dettagliate sugli attributi associati a uno snapshot del cluster.  
Tipo: oggetto [DBClusterSnapshotAttributesResult](API_DBClusterSnapshotAttributesResult.md)

## Errori
<a name="API_ModifyDBClusterSnapshotAttribute_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido di snapshot del cluster.  
Codice di stato HTTP: 400

 ** SharedSnapshotQuotaExceeded **   
È stato superato il numero massimo di account che è possibile condividere con uno snapshot DB manuale.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBClusterSnapshotAttribute) 

# ModifyDBInstance
<a name="API_ModifyDBInstance"></a>

Modifica le impostazioni per un'istanza. Puoi modificare uno o più parametri di configurazione del database specificando questi parametri e i nuovi valori nella richiesta.

## Parametri della richiesta
<a name="API_ModifyDBInstance_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBInstanceIdentifier **   
L'identificatore delle istanze. Questo valore è archiviato come stringa in caratteri minuscoli.  
Vincoli:  
+ Deve corrispondere all'identificativo di un `DBInstance` esistente.
Tipo: stringa  
Obbligatorio: sì

 ** ApplyImmediately **   
Speciifica se le modifiche in questa richiesta e tutte le modifiche in sospeso vengono applicate in modo asincrono il prima possibile, indipendentemente dall'impostazione per l'istanza. `PreferredMaintenanceWindow`   
 Se questo parametro è impostato su`false`, le modifiche all'istanza vengono applicate durante la finestra di manutenzione successiva. Alcune modifiche ai parametri possono causare un'interruzione e vengono applicate al riavvio successivo.  
Impostazione predefinita: `false`   
Tipo: Booleano  
Obbligatorio: no

 ** AutoMinorVersionUpgrade **   
Questo parametro non si applica ad Amazon DocumentDB. Amazon DocumentDB non esegue aggiornamenti di versione secondari indipendentemente dal valore impostato.  
Tipo: Booleano  
Obbligatorio: no

 ** CACertificateIdentifier **   
Indica il certificato che deve essere associato all'istanza.  
▬Tipo: stringa  
Obbligatorio: no

 ** CertificateRotationRestart **   
Speciifica se l'istanza DB viene riavviata quando si ruota il certificato. SSL/TLS   
Per impostazione predefinita, l'istanza DB viene riavviata quando si ruota il certificato. SSL/TLS Il certificato non viene aggiornato finché l'istanza DB non viene riavviata.  
Imposta questo parametro solo se *non* lo utilizzi SSL/TLS per connetterti all'istanza DB.
*Se lo utilizzi SSL/TLS per connetterti all'istanza DB, consulta [Updating Your Amazon DocumentDB TLS Certificates](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) and [Encrypting Data in Transit nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) Amazon DocumentDB Developer Guide.*  
Tipo: Booleano  
Obbligatorio: no

 ** CopyTagsToSnapshot **   
Un valore che indica se copiare tutti i tag dall'istanza DB negli snapshot dell'istanza DB. Per impostazione predefinita i tag non vengono copiati.  
Tipo: Booleano  
Obbligatorio: no

 ** DBInstanceClass **   
La nuova capacità di calcolo e memoria dell'istanza, ad esempio. `db.r5.large` Non tutte le classi di istanze sono disponibili in tutte Regioni AWS.   
Se si modifica la classe dell'istanza, si verifica un'interruzione durante la modifica. La modifica viene applicata durante la finestra di manutenzione successiva, a meno che il valore di `ApplyImmediately` per questa richiesta non sia `true`.   
Predefinito: utilizza l'impostazione esistente.  
▬Tipo: stringa  
Obbligatorio: no

 ** EnablePerformanceInsights **   
Un valore che indica se abilitare Performance Insights per l'istanza del database. Per ulteriori informazioni, consulta la sezione [Utilizzo di Amazon Performance Insights](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html).  
Tipo: Booleano  
Obbligatorio: no

 ** NewDBInstanceIdentifier **   
 Il nuovo identificatore di istanza per l'istanza quando si rinomina un'istanza. Quando si modifica l'identificatore dell'istanza, si verifica immediatamente un riavvio dell'istanza se si imposta su. `Apply Immediately` `true` Si verifica durante la finestra di manutenzione successiva, se impostata su`Apply Immediately`. `false` Questo valore è archiviato come stringa in caratteri minuscoli.   
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Ad esempio: `mydbinstance`   
▬Tipo: stringa  
Obbligatorio: no

 ** PerformanceInsightsKMSKeyId **   
L'identificatore AWS KMS chiave per la crittografia dei dati di Performance Insights.  
L'identificatore della AWS KMS chiave è l'ARN della chiave, l'ID della chiave, l'alias ARN o il nome alias per la chiave KMS.  
Se non specifichi un valore per PerformanceInsights KMSKey Id, Amazon DocumentDB utilizza la tua chiave KMS predefinita. Esiste una chiave KMS predefinita per il tuo account Amazon Web Services. Il tuo account Amazon Web Services ha una chiave KMS predefinita diversa per ogni regione Amazon Web Services.  
▬Tipo: stringa  
Obbligatorio: no

 ** PreferredMaintenanceWindow **   
Intervallo di tempo settimanale (nel fuso orario UTC) durante il quale può verificarsi la finestra di manutenzione del sistema, che potrebbe comportare un'interruzione. La modifica di questo parametro non comporta un'interruzione tranne nella situazione seguente e la modifica viene applicata in modo asincrono il prima possibile. Se ci sono azioni in sospeso che causano il riavvio e la finestra di manutenzione viene modificata per includere l'ora corrente, la modifica di questo parametro provoca il riavvio dell'istanza. Se si sposta questa finestra all'ora corrente, devono trascorrere almeno 30 minuti tra l'ora corrente e la fine della finestra per garantire che vengano applicate le modifiche in sospeso.  
Predefinito: utilizza l'impostazione esistente.  
Formato: `ddd:hh24:mi-ddd:hh24:mi`   
Giorni validi: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica  
Vincoli: deve durare almeno 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** PromotionTier **   
Un valore che specifica l'ordine in cui una replica di Amazon DocumentDB viene promossa all'istanza principale dopo un errore dell'istanza primaria esistente.  
Impostazione predefinita: 1  
Valori validi: 0-15  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_ModifyDBInstance_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBInstance **   
Informazioni dettagliate su un'istanza.   
Tipo: oggetto [DBInstance](API_DBInstance.md)

## Errori
<a name="API_ModifyDBInstance_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AuthorizationNotFound **   
L'IP CIDR o il gruppo di sicurezza Amazon EC2 specificato non sono autorizzati per il gruppo di sicurezza specificato.  
Amazon DocumentDB potrebbe inoltre non essere autorizzato a eseguire le azioni necessarie per tuo conto utilizzando IAM.  
Codice di stato HTTP: 404

 ** CertificateNotFound **   
 `CertificateIdentifier`non fa riferimento a un certificato esistente.   
Codice di stato HTTP: 404

 ** DBInstanceAlreadyExists **   
Hai già un'istanza con l'identificatore specificato.  
Codice di stato HTTP: 400

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

 ** DBSecurityGroupNotFound **   
 `DBSecurityGroupName`non fa riferimento a un gruppo di sicurezza esistente.   
Codice di stato HTTP: 404

 ** DBUpgradeDependencyFailure **   
L'aggiornamento non è riuscito perché una risorsa da cui dipende non può essere modificata.  
Codice di stato HTTP: 400

 ** InsufficientDBInstanceCapacity **   
La classe di istanza specificata non è disponibile nella zona di disponibilità specificata.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

 ** InvalidDBSecurityGroupState **   
Lo stato del gruppo di sicurezza non consente l'eliminazione.  
Codice di stato HTTP: 400

 ** InvalidVPCNetworkStateFault **   
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la sua creazione a causa delle modifiche apportate.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

 ** StorageTypeNotSupported **   
L'archiviazione dello spazio specificato non `StorageType` può essere associata all'istanza DB.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBInstance) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBInstance) 

# ModifyDBSubnetGroup
<a name="API_ModifyDBSubnetGroup"></a>

Modifica un gruppo di sottoreti esistente. I gruppi di sottoreti devono contenere almeno una sottorete in almeno due zone di disponibilità in. Regione AWS

## Parametri della richiesta
<a name="API_ModifyDBSubnetGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti. Questo valore è archiviato come stringa in caratteri minuscoli. Non è possibile modificare il gruppo di sottoreti di default.   
Vincoli: deve corrispondere al nome di un oggetto `DBSubnetGroup` esistente. Non deve essere predefinito.  
Ad esempio: `mySubnetgroup`   
Tipo: stringa  
Obbligatorio: sì

 **SubnetIds. SubnetIdentifier**N.   
La sottorete Amazon EC2 IDs per il gruppo di sottoreti.  
Tipo: array di stringhe  
Obbligatorio: sì

 ** DBSubnetGroupDescription **   
La descrizione per il gruppo di sottoreti.  
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_ModifyDBSubnetGroup_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBSubnetGroup **   
Informazioni dettagliate su un gruppo di sottoreti.   
Tipo: oggetto [DBSubnetGroup](API_DBSubnetGroup.md)

## Errori
<a name="API_ModifyDBSubnetGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBSubnetGroupDoesNotCoverEnoughAZs **   
Le sottoreti del gruppo di sottoreti devono coprire almeno due zone di disponibilità, a meno che non esista una sola zona di disponibilità.  
Codice di stato HTTP: 400

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** DBSubnetQuotaExceededFault **   
La richiesta comporterebbe il superamento del numero consentito di sottoreti in un gruppo di sottoreti.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

 ** SubnetAlreadyInUse **   
La sottorete è già in uso nella zona di disponibilità.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyDBSubnetGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyDBSubnetGroup) 

# ModifyEventSubscription
<a name="API_ModifyEventSubscription"></a>

Modifica un abbonamento esistente per la notifica di eventi di Amazon DocumentDB.

## Parametri della richiesta
<a name="API_ModifyEventSubscription_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SubscriptionName **   
Il nome dell'abbonamento per la notifica degli eventi di Amazon DocumentDB.  
Tipo: stringa  
Obbligatorio: sì

 ** Enabled **   
 Un valore booleano; impostato per `true` attivare l'abbonamento.   
Tipo: Booleano  
Obbligatorio: no

 **EventCategories. EventCategory**N.   
 Un elenco di categorie di eventi a `SourceType` cui desideri iscriverti.  
Tipo: array di stringhe  
Obbligatorio: no

 ** SnsTopicArn **   
L'Amazon Resource Name (ARN) dell'argomento SNS creato per la notifica di eventi. L'ARN viene creato da Amazon SNS al momento della creazione di un argomento e la sottoscrizione.  
▬Tipo: stringa  
Obbligatorio: no

 ** SourceType **   
Il tipo di origine che genera gli eventi. Ad esempio, se desideri ricevere una notifica degli eventi generati da un'istanza, imposta questo parametro su`db-instance`. Se questo valore non viene specificato, vengono restituiti tutti gli eventi.  
Valori validi: `db-instance`, `db-parameter-group`, `db-security-group`   
▬Tipo: stringa  
Obbligatorio: no

## Elementi di risposta
<a name="API_ModifyEventSubscription_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** EventSubscription **   
Informazioni dettagliate su un evento a cui ti sei iscritto.  
Tipo: oggetto [EventSubscription](API_EventSubscription.md)

## Errori
<a name="API_ModifyEventSubscription_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** EventSubscriptionQuotaExceeded **   
Hai raggiunto il numero massimo di iscrizioni agli eventi.   
Codice di stato HTTP: 400

 ** SNSInvalidTopic **   
Amazon SNS ha risposto che c'è un problema con l'argomento specificato.   
Codice di stato HTTP: 400

 ** SNSNoAuthorization **   
Non sei autorizzato a pubblicare sull'argomento SNS Amazon Resource Name (ARN).   
Codice di stato HTTP: 400

 ** SNSTopicArnNotFound **   
L'argomento SNS Amazon Resource Name (ARN) non esiste.   
Codice di stato HTTP: 404

 ** SubscriptionCategoryNotFound **   
La categoria fornita non esiste.   
Codice di stato HTTP: 404

 ** SubscriptionNotFound **   
Il nome dell'abbonamento non esiste.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyEventSubscription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyEventSubscription) 

# ModifyGlobalCluster
<a name="API_ModifyGlobalCluster"></a>

Modifica un'impostazione per un cluster globale Amazon DocumentDB. Puoi modificare uno o più parametri di configurazione (ad esempio: protezione dall'eliminazione) o l'identificatore globale del cluster specificando questi parametri e i nuovi valori nella richiesta.

**Nota**  
Questa azione si applica solo ai cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_ModifyGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** GlobalClusterIdentifier **   
L'identificatore del cluster globale da modificare. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere all'identificatore di un cluster globale esistente.
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

 ** DeletionProtection **   
Indica se il cluster globale ha la protezione da eliminazione abilitata. Il cluster globale non può essere eliminato quando la protezione da eliminazione è abilitata.   
Tipo: Booleano  
Obbligatorio: no

 ** NewGlobalClusterIdentifier **   
Il nuovo identificatore per un cluster globale quando si modifica un cluster globale. Questo valore è archiviato come stringa in caratteri minuscoli.  
+ Deve contenere da 1 a 63 lettere, numeri o trattini

  Il primo carattere deve essere una lettera

  Non può terminare con un trattino o contenere due trattini consecutivi
Ad esempio: `my-cluster2`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: no

## Elementi di risposta
<a name="API_ModifyGlobalCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_ModifyGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

 ** InvalidGlobalClusterStateFault **   
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ModifyGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ModifyGlobalCluster) 

# RebootDBInstance
<a name="API_RebootDBInstance"></a>

Potrebbe essere necessario riavviare l'istanza, in genere per motivi di manutenzione. Ad esempio, se si apportano determinate modifiche o se si modifica il gruppo di parametri del cluster associato all'istanza, è necessario riavviare l'istanza affinché le modifiche abbiano effetto. 

Il riavvio di un'istanza comporta il riavvio del servizio del motore di database. *Il riavvio di un'istanza provoca un'interruzione momentanea, durante la quale lo stato dell'istanza è impostato su Riavvio.* 

## Parametri della richiesta
<a name="API_RebootDBInstance_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBInstanceIdentifier **   
L'identificatore delle istanze. Questo parametro è archiviato come stringa in minuscolo.  
Vincoli:  
+ Deve corrispondere all'identificativo di un `DBInstance` esistente.
Tipo: stringa  
Obbligatorio: sì

 ** ForceFailover **   
 Quando`true`, il riavvio viene eseguito tramite un failover Multi-AZ.   
Vincolo: non è possibile specificare `true` se l'istanza non è configurata per Multi-AZ.  
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_RebootDBInstance_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBInstance **   
Informazioni dettagliate su un'istanza.   
Tipo: oggetto [DBInstance](API_DBInstance.md)

## Errori
<a name="API_RebootDBInstance_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RebootDBInstance) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RebootDBInstance) 

# RemoveFromGlobalCluster
<a name="API_RemoveFromGlobalCluster"></a>

Scollega un cluster secondario Amazon DocumentDB da un cluster globale. Il cluster diventa un cluster autonomo con funzionalità di lettura/scrittura anziché essere di sola lettura e ricevere dati da un sistema primario in un'altra regione. 

**Nota**  
Questa azione si applica solo ai cluster Amazon DocumentDB.

## Parametri della richiesta
<a name="API_RemoveFromGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DbClusterIdentifier **   
L'Amazon Resource Name (ARN) che identifica il cluster che è stato separato dal cluster globale Amazon DocumentDB.   
Tipo: stringa  
Obbligatorio: sì

 ** GlobalClusterIdentifier **   
L'identificatore del cluster da staccare dal cluster globale Amazon DocumentDB.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

## Elementi di risposta
<a name="API_RemoveFromGlobalCluster_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_RemoveFromGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

 ** InvalidGlobalClusterStateFault **   
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RemoveFromGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RemoveFromGlobalCluster) 

# RemoveSourceIdentifierFromSubscription
<a name="API_RemoveSourceIdentifierFromSubscription"></a>

Rimuove un identificatore di origine da un abbonamento esistente per la notifica di eventi di Amazon DocumentDB.

## Parametri della richiesta
<a name="API_RemoveSourceIdentifierFromSubscription_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** SourceIdentifier **   
 L'identificatore di origine da rimuovere dall'abbonamento, ad esempio l'identificatore di istanza per un'istanza o il nome di un gruppo di sicurezza.   
Tipo: stringa  
Obbligatorio: sì

 ** SubscriptionName **   
Il nome dell'abbonamento di notifica degli eventi di Amazon DocumentDB da cui desideri rimuovere un identificatore di origine.  
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_RemoveSourceIdentifierFromSubscription_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** EventSubscription **   
Informazioni dettagliate su un evento a cui ti sei iscritto.  
Tipo: oggetto [EventSubscription](API_EventSubscription.md)

## Errori
<a name="API_RemoveSourceIdentifierFromSubscription_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** SourceNotFound **   
La fonte richiesta non è stata trovata.   
Codice di stato HTTP: 404

 ** SubscriptionNotFound **   
Il nome dell'abbonamento non esiste.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RemoveSourceIdentifierFromSubscription) 

# RemoveTagsFromResource
<a name="API_RemoveTagsFromResource"></a>

Rimuove i tag di metadati da una risorsa Amazon DocumentDB.

## Parametri della richiesta
<a name="API_RemoveTagsFromResource_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** ResourceName **   
La risorsa Amazon DocumentDB da cui vengono rimossi i tag. Questo valore è un Amazon Resource Name (ARN).  
Tipo: stringa  
Obbligatorio: sì

 **TagKeys.Membern.**   
La chiave del tag (nome) del tag da rimuovere.  
Tipo: array di stringhe  
Obbligatorio: sì

## Errori
<a name="API_RemoveTagsFromResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

 ** DBSnapshotNotFound **   
 `DBSnapshotIdentifier`non fa riferimento a un'istantanea esistente.   
Codice di stato HTTP: 404

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RemoveTagsFromResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RemoveTagsFromResource) 

# ResetDBClusterParameterGroup
<a name="API_ResetDBClusterParameterGroup"></a>

 Modifica i parametri di un gruppo di parametri del cluster riportandoli al valore predefinito. Per ripristinare parametri specifici, invia un elenco dei seguenti elementi: `ParameterName` e`ApplyMethod`. Per reimpostare l'intero gruppo di parametri del cluster, specificate i `ResetAllParameters` parametri `DBClusterParameterGroupName` and. 

 Quando si ripristina l'intero gruppo, i parametri dinamici vengono aggiornati immediatamente e i parametri statici vengono impostati in `pending-reboot` modo da avere effetto al successivo riavvio dell'istanza DB.

## Parametri della richiesta
<a name="API_ResetDBClusterParameterGroup_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterParameterGroupName **   
Il nome del gruppo di parametri del cluster da reimpostare.  
Tipo: stringa  
Obbligatorio: sì

 **Parametri.Parameter.N**   
Un elenco di nomi di parametri nel gruppo di parametri del cluster da ripristinare ai valori predefiniti. Non è possibile utilizzare questo parametro se il parametro `ResetAllParameters` è impostato su `true`.  
Tipo: matrice di oggetti [Parameter](API_Parameter.md)  
Obbligatorio: no

 ** ResetAllParameters **   
Un valore impostato per `true` ripristinare tutti i parametri nel gruppo di parametri del cluster ai valori predefiniti e `false` altro. Non è possibile utilizzare questo parametro se c'è un elenco di nomi di parametri specificati per il parametro `Parameters`.  
Tipo: Booleano  
Obbligatorio: no

## Elementi di risposta
<a name="API_ResetDBClusterParameterGroup_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBClusterParameterGroupName **   
Il nome di un gruppo di parametri del cluster.  
Vincoli:  
+ Deve contenere da 1 a 255 lettere o numeri.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Questo valore è archiviato come stringa in caratteri minuscoli.
Tipo: String

## Errori
<a name="API_ResetDBClusterParameterGroup_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBParameterGroupNotFound **   
 `DBParameterGroupName`non fa riferimento a un gruppo di parametri esistente.   
Codice di stato HTTP: 404

 ** InvalidDBParameterGroupState **   
Il gruppo di parametri è in uso o si trova in uno stato non valido. Se state cercando di eliminare il gruppo di parametri, non potete eliminarlo quando il gruppo di parametri si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/ResetDBClusterParameterGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/ResetDBClusterParameterGroup) 

# RestoreDBClusterFromSnapshot
<a name="API_RestoreDBClusterFromSnapshot"></a>

Crea un nuovo cluster da un'istantanea o da un'istantanea del cluster.

Se viene specificata un'istantanea, il cluster di destinazione viene creato dallo snapshot del DB di origine con una configurazione e un gruppo di sicurezza predefiniti.

Se viene specificata un'istantanea del cluster, il cluster di destinazione viene creato dal punto di ripristino del cluster di origine con la stessa configurazione del cluster DB di origine, tranne per il fatto che il nuovo cluster viene creato con il gruppo di sicurezza predefinito.

## Parametri della richiesta
<a name="API_RestoreDBClusterFromSnapshot_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
Il nome del cluster da creare a partire dall'istantanea o dall'istantanea del cluster. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Ad esempio: `my-snapshot-id`   
Tipo: stringa  
Obbligatorio: sì

 ** Engine **   
Il motore di database da utilizzare per il nuovo cluster.  
Predefinito: lo stesso del codice sorgente.  
Vincolo: deve essere compatibile con il motore del sorgente.  
Tipo: stringa  
Obbligatorio: sì

 ** SnapshotIdentifier **   
L'identificatore dello snapshot o dello snapshot del cluster da cui effettuare il ripristino.  
È possibile utilizzare il nome o l'Amazon Resource Name (ARN) per specificare uno snapshot del cluster. Tuttavia, è possibile utilizzare solo l'ARN per specificare uno snapshot.  
Vincoli:  
+ Deve corrispondere all'identificatore di una snapshot esistente.
Tipo: stringa  
Obbligatorio: sì

 **AvailabilityZones. AvailabilityZone**N.   
Fornisce l'elenco delle zone di disponibilità di Amazon EC2 in cui è possibile creare le istanze nel cluster DB ripristinato.  
Tipo: array di stringhe  
Obbligatorio: no

 ** DBClusterParameterGroupName **   
Nome del gruppo di parametri del cluster di database che desideri associare al cluster di database.  
 *Tipo:* stringa.       *Obbligatorio: No*.  
Se questo argomento viene omesso, viene utilizzato il gruppo di parametri predefinito del cluster DB. Se fornito, deve corrispondere al nome di un gruppo di parametri predefinito del cluster DB esistente. La stringa deve essere composta da 1 a 255 lettere, numeri o trattini. Il primo carattere deve essere una lettera e non può terminare con un trattino o contenere due trattini consecutivi.  
▬Tipo: stringa  
Obbligatorio: no

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti da utilizzare per il nuovo cluster.  
Vincoli: se forniti, devono corrispondere al nome di un esistente. `DBSubnetGroup`  
Ad esempio: `mySubnetgroup`   
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
Speciifica se questo cluster può essere eliminato. Se `DeletionProtection` è abilitato, il cluster non può essere eliminato a meno che non venga modificato e `DeletionProtection` disabilitato. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.  
Tipo: Booleano  
Obbligatorio: no

 **EnableCloudwatchLogsExports.Member.**   
Un elenco di tipi di log che devono essere abilitati per l'esportazione in Amazon CloudWatch Logs.  
Tipo: array di stringhe  
Obbligatorio: no

 ** EngineVersion **   
La versione del motore di database da utilizzare per il nuovo cluster.  
▬Tipo: stringa  
Obbligatorio: no

 ** KmsKeyId **   
L'identificatore AWS KMS chiave da utilizzare per il ripristino di un cluster crittografato da un'istantanea del database o da un'istantanea del cluster.  
L'identificatore della AWS KMS chiave è Amazon Resource Name (ARN) per AWS KMS la chiave di crittografia. Se si ripristina un cluster con Account AWS lo stesso proprietario della chiave di AWS KMS crittografia utilizzata per crittografare il nuovo cluster, è possibile utilizzare l'alias della AWS KMS chiave anziché l'ARN per la chiave di crittografia. AWS KMS   
Se non specifichi un valore per il parametro `KmsKeyId`, avviene quanto segue:  
+ Se l'istantanea o l'istantanea del cluster in `SnapshotIdentifier` è crittografata, il cluster ripristinato viene crittografato utilizzando la AWS KMS chiave utilizzata per crittografare l'istantanea o l'istantanea del cluster.
+ Se l'istantanea o l'istantanea del cluster in ingresso non `SnapshotIdentifier` è crittografata, il cluster DB ripristinato non è crittografato.
▬Tipo: stringa  
Obbligatorio: no

 ** NetworkType **   
Il tipo di rete del cluster.  
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).  
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.  
Valori validi: `IPV4` \$1 `DUAL`   
▬Tipo: stringa  
Obbligatorio: no

 ** Port **   
Il numero di porta su cui il nuovo cluster accetta le connessioni.  
Vincoli: deve essere un valore compreso tra a`1150`. `65535`  
Impostazione predefinita: la stessa porta del cluster originale.  
Tipo: Integer  
Obbligatorio: no

 ** ServerlessV2ScalingConfiguration **   
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.  
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)  
Obbligatorio: no

 ** StorageType **   
Il tipo di archiviazione da associare al cluster di database.  
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*  
Valori validi per il tipo di storage - `standard | iopt1`   
Il valore predefinito è `standard `   
▬Tipo: stringa  
Obbligatorio: no

 **Tags.Tag.N**   
I tag da assegnare al cluster ripristinato.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

 **VpcSecurityGroupIds. VpcSecurityGroupId**N.   
Un elenco di gruppi di sicurezza del cloud privato virtuale (VPC) a cui apparterrà il nuovo cluster.  
Tipo: array di stringhe  
Obbligatorio: no

## Elementi di risposta
<a name="API_RestoreDBClusterFromSnapshot_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_RestoreDBClusterFromSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterAlreadyExistsFault **   
Hai già un cluster con l'identificatore fornito.  
Codice di stato HTTP: 400

 ** DBClusterQuotaExceededFault **   
Il cluster non può essere creato perché hai raggiunto la quota massima consentita di cluster.  
Codice di stato HTTP: 403

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

 ** DBSnapshotNotFound **   
 `DBSnapshotIdentifier`non fa riferimento a un'istantanea esistente.   
Codice di stato HTTP: 404

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** InsufficientDBClusterCapacityFault **   
Il cluster non dispone di capacità sufficiente per l'operazione corrente.  
Codice di stato HTTP: 403

 ** InsufficientStorageClusterCapacity **   
Lo spazio di archiviazione disponibile non è sufficiente per l'azione corrente. È possibile risolvere questo errore aggiornando il gruppo di sottoreti per utilizzare zone di disponibilità diverse con più spazio di archiviazione disponibile.   
Codice di stato HTTP: 400

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido di snapshot del cluster.  
Codice di stato HTTP: 400

 ** InvalidDBSnapshotState **   
Lo stato dell'istantanea non consente l'eliminazione.  
Codice di stato HTTP: 400

 ** InvalidRestoreFault **   
Non è possibile eseguire il ripristino da un backup su cloud privato virtuale (VPC) su un'istanza DB non VPC.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

 ** InvalidVPCNetworkStateFault **   
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.  
Codice di stato HTTP: 400

 ** KMSKeyNotAccessibleFault **   
Si è verificato un errore durante l'accesso a una AWS KMS chiave.  
Codice di stato HTTP: 400

 ** NetworkTypeNotSupported **   
Il tipo di rete non è supportato `DBSubnetGroup` né dalla versione del motore DB.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di spazio di archiviazione consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RestoreDBClusterFromSnapshot) 

# RestoreDBClusterToPointInTime
<a name="API_RestoreDBClusterToPointInTime"></a>

Ripristina un cluster a un punto temporale arbitrario. Gli utenti possono ripristinare a qualsiasi point-in-time prima di `LatestRestorableTime` per un massimo di `BackupRetentionPeriod` giorni. Il cluster di destinazione viene creato dal cluster di origine con la stessa configurazione del cluster originale, tranne per il fatto che il nuovo cluster viene creato con il gruppo di sicurezza predefinito. 

## Parametri della richiesta
<a name="API_RestoreDBClusterToPointInTime_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
Il nome del nuovo cluster da creare.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Tipo: stringa  
Obbligatorio: sì

 ** SourceDBClusterIdentifier **   
L'identificativo del cluster di origine dal quale eseguire il ripristino.  
Vincoli:  
+ Deve corrispondere all'identificativo di un `DBCluster` esistente.
Tipo: stringa  
Obbligatorio: sì

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti da utilizzare per il nuovo cluster.  
Vincoli: se fornito, deve corrispondere al nome di un esistente. `DBSubnetGroup`  
Ad esempio: `mySubnetgroup`   
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
Speciifica se questo cluster può essere eliminato. Se `DeletionProtection` è abilitato, il cluster non può essere eliminato a meno che non venga modificato e `DeletionProtection` disabilitato. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.  
Tipo: Booleano  
Obbligatorio: no

 **EnableCloudwatchLogsExports.Member.**   
Un elenco di tipi di log che devono essere abilitati per l'esportazione in Amazon CloudWatch Logs.  
Tipo: array di stringhe  
Obbligatorio: no

 ** KmsKeyId **   
L'identificatore della AWS KMS chiave da utilizzare per ripristinare un cluster crittografato da un cluster crittografato.  
L'identificatore della AWS KMS chiave è Amazon Resource Name (ARN) per AWS KMS la chiave di crittografia. Se si ripristina un cluster con Account AWS lo stesso proprietario della chiave di AWS KMS crittografia utilizzata per crittografare il nuovo cluster, è possibile utilizzare l'alias della AWS KMS chiave anziché l'ARN per la chiave di crittografia. AWS KMS   
È possibile eseguire il ripristino in un nuovo cluster e crittografare il nuovo cluster con una AWS KMS chiave diversa da quella utilizzata per crittografare il AWS KMS cluster di origine. Il nuovo cluster DB è crittografato con la AWS KMS chiave identificata dal `KmsKeyId` parametro.  
Se non specifichi un valore per il parametro `KmsKeyId`, avviene quanto segue:  
+ Se il cluster è crittografato, il cluster ripristinato viene crittografato utilizzando la AWS KMS chiave utilizzata per crittografare il cluster di origine.
+ Se il cluster non è crittografato, il cluster ripristinato non è crittografato.
Se `DBClusterIdentifier` si riferisce a un cluster non crittografato, la richiesta di ripristino viene rifiutata.  
▬Tipo: stringa  
Obbligatorio: no

 ** NetworkType **   
Il tipo di rete del cluster.  
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).  
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.  
Valori validi: `IPV4` \$1 `DUAL`   
▬Tipo: stringa  
Obbligatorio: no

 ** Port **   
Il numero di porta su cui il nuovo cluster accetta le connessioni.  
Vincoli: deve essere un valore compreso tra a`1150`. `65535`   
Predefinita: la porta predefinita per il motore.  
Tipo: Integer  
Obbligatorio: no

 ** RestoreToTime **   
La data e l'ora alle quali ripristinare il cluster.  
Valori validi: un orario in formato Universal Coordinated Time (UTC).  
Vincoli:  
+ Deve essere antecedente all'ultimo orario ripristinabile per l'istanza.
+ Deve essere specificato se il parametro `UseLatestRestorableTime` non viene fornito.
+ Non può essere specificato se il parametro `UseLatestRestorableTime` è `true`.
+ Non può essere specificato se il parametro `RestoreType` è `copy-on-write`.
Ad esempio: `2015-03-07T23:45:00Z`   
Tipo: Timestamp  
Obbligatorio: no

 ** RestoreType **   
Il tipo di ripristino da eseguire. È possibile specificare uno dei seguenti valori:  
+  `full-copy`: il nuovo cluster database viene ripristinato come una copia completa del cluster database di origine.
+  `copy-on-write`: il nuovo cluster database viene ripristinato come un clone del cluster database di origine.
Vincoli: non puoi specificare `copy-on-write` se la versione del motore del cluster di database di origine è precedente alla 1.11.  
Se non si specifica un valore `RestoreType`, il nuovo cluster di database viene ripristinato come una copia completa del cluster di database di origine.  
▬Tipo: stringa  
Obbligatorio: no

 ** ServerlessV2ScalingConfiguration **   
Contiene la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.  
Tipo: oggetto [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md)  
Obbligatorio: no

 ** StorageType **   
Il tipo di archiviazione da associare al cluster di database.  
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*  
Valori validi per il tipo di storage - `standard | iopt1`   
Il valore predefinito è `standard `   
▬Tipo: stringa  
Obbligatorio: no

 **Tags.Tag.N**   
I tag da assegnare al cluster ripristinato.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Obbligatorio: no

 ** UseLatestRestorableTime **   
Un valore impostato su `true` per ripristinare il cluster all'ora dell'ultimo backup ripristinabile; in alternativa è impostato su `false`.   
Impostazione predefinita: `false`   
Vincoli: non può essere specificato se viene fornito il parametro `RestoreToTime`.  
Tipo: Booleano  
Obbligatorio: no

 **VpcSecurityGroupIds. VpcSecurityGroupId**N.   
Un elenco di gruppi di sicurezza VPC a cui appartiene il nuovo cluster.  
Tipo: array di stringhe  
Obbligatorio: no

## Elementi di risposta
<a name="API_RestoreDBClusterToPointInTime_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_RestoreDBClusterToPointInTime_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterAlreadyExistsFault **   
Hai già un cluster con l'identificatore fornito.  
Codice di stato HTTP: 400

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non fa riferimento a un cluster esistente.   
Codice di stato HTTP: 404

 ** DBClusterQuotaExceededFault **   
Il cluster non può essere creato perché hai raggiunto la quota massima consentita di cluster.  
Codice di stato HTTP: 403

 ** DBClusterSnapshotNotFoundFault **   
 `DBClusterSnapshotIdentifier`non fa riferimento a un'istantanea del cluster esistente.   
Codice di stato HTTP: 404

 ** DBSubnetGroupNotFoundFault **   
 `DBSubnetGroupName`non fa riferimento a un gruppo di sottoreti esistente.   
Codice di stato HTTP: 404

 ** InsufficientDBClusterCapacityFault **   
Il cluster non dispone di capacità sufficiente per l'operazione corrente.  
Codice di stato HTTP: 403

 ** InsufficientStorageClusterCapacity **   
Lo spazio di archiviazione disponibile non è sufficiente per l'azione corrente. È possibile risolvere questo errore aggiornando il gruppo di sottoreti in modo che utilizzi zone di disponibilità diverse con più spazio di archiviazione disponibile.   
Codice di stato HTTP: 400

 ** InvalidDBClusterSnapshotStateFault **   
Il valore fornito non è uno stato valido di snapshot del cluster.  
Codice di stato HTTP: 400

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBSnapshotState **   
Lo stato dell'istantanea non consente l'eliminazione.  
Codice di stato HTTP: 400

 ** InvalidRestoreFault **   
Non è possibile eseguire il ripristino da un backup su cloud privato virtuale (VPC) su un'istanza DB non VPC.  
Codice di stato HTTP: 400

 ** InvalidSubnet **   
La sottorete richiesta non è valida oppure sono state richieste più sottoreti che non si trovano tutte in un cloud privato virtuale (VPC) comune.  
Codice di stato HTTP: 400

 ** InvalidVPCNetworkStateFault **   
Il gruppo di sottoreti non copre tutte le zone di disponibilità dopo la creazione a causa delle modifiche apportate.  
Codice di stato HTTP: 400

 ** KMSKeyNotAccessibleFault **   
Si è verificato un errore durante l'accesso a una AWS KMS chiave.  
Codice di stato HTTP: 400

 ** NetworkTypeNotSupported **   
Il tipo di rete non è supportato `DBSubnetGroup` né dalla versione del motore DB.  
Codice di stato HTTP: 400

 ** StorageQuotaExceeded **   
La richiesta comporterebbe il superamento della quantità di storage consentita disponibile in tutte le istanze.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/RestoreDBClusterToPointInTime) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/RestoreDBClusterToPointInTime) 

# StartDBCluster
<a name="API_StartDBCluster"></a>

Riavvia il cluster interrotto specificato da`DBClusterIdentifier`. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-stop-start.html).

## Parametri della richiesta
<a name="API_StartDBCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'identificatore del cluster da riavviare. Ad esempio: `docdb-2019-05-28-15-24-52`   
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_StartDBCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_StartDBCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/StartDBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/StartDBCluster) 

# StopDBCluster
<a name="API_StopDBCluster"></a>

Arresta il cluster in esecuzione specificato da`DBClusterIdentifier`. Il cluster deve essere nello stato *disponibile*. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-stop-start.html).

## Parametri della richiesta
<a name="API_StopDBCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBClusterIdentifier **   
L'identificatore del cluster da interrompere. Ad esempio: `docdb-2019-05-28-15-24-52`   
Tipo: stringa  
Obbligatorio: sì

## Elementi di risposta
<a name="API_StopDBCluster_ResponseElements"></a>

Il seguente elemento viene restituito dal servizio.

 ** DBCluster **   
Informazioni dettagliate su un cluster.   
Tipo: oggetto [DBCluster](API_DBCluster.md)

## Errori
<a name="API_StopDBCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidDBInstanceState **   
 L'istanza specificata non è nello stato *disponibile*.   
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/StopDBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/StopDBCluster) 

# SwitchoverGlobalCluster
<a name="API_SwitchoverGlobalCluster"></a>

Passa al cluster Amazon DocumentDB secondario specificato per diventare il nuovo cluster Amazon DocumentDB primario nel cluster di database globale.

## Parametri della richiesta
<a name="API_SwitchoverGlobalCluster_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** GlobalClusterIdentifier **   
L'identificatore del cluster di database globale Amazon DocumentDB su cui passare. L'identificatore è la chiave univoca assegnata dall'utente al momento della creazione del cluster. In altre parole, è il nome del cluster globale. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Deve corrispondere all'identificatore di un cluster globale esistente (database globale Amazon DocumentDB).
+ Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

 ** TargetDbClusterIdentifier **   
L'identificatore del cluster Amazon DocumentDB secondario da promuovere al nuovo cluster primario per il cluster di database globale. Utilizza Amazon Resource Name (ARN) come identificatore in modo che Amazon DocumentDB possa localizzare il cluster nella sua regione. AWS   
Vincoli:  
+ Deve corrispondere all'identificatore di un cluster secondario esistente.
+ Lunghezza minima pari a 1. Lunghezza massima di 255.
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: sì

## Elementi di risposta
<a name="API_SwitchoverGlobalCluster_ResponseElements"></a>

Il servizio restituisce il seguente elemento.

 ** GlobalCluster **   
Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.  
Tipo: oggetto [GlobalCluster](API_GlobalCluster.md)

## Errori
<a name="API_SwitchoverGlobalCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier`non si riferisce a un cluster esistente.   
Codice di stato HTTP: 404

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Non si riferisce a un cluster globale esistente.  
Codice di stato HTTP: 404

 ** InvalidDBClusterStateFault **   
Il cluster non è in uno stato valido.  
Codice di stato HTTP: 400

 ** InvalidGlobalClusterStateFault **   
L'operazione richiesta non può essere eseguita mentre il cluster si trova in questo stato.  
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/SwitchoverGlobalCluster) 

# Cluster elastici Amazon DocumentDB
<a name="API_Operations_Amazon_DocumentDB_Elastic_Clusters"></a>

Le seguenti azioni sono supportate da Amazon DocumentDB Elastic Clusters:
+  [ApplyPendingMaintenanceAction](API_elastic_ApplyPendingMaintenanceAction.md) 
+  [CopyClusterSnapshot](API_elastic_CopyClusterSnapshot.md) 
+  [CreateCluster](API_elastic_CreateCluster.md) 
+  [CreateClusterSnapshot](API_elastic_CreateClusterSnapshot.md) 
+  [DeleteCluster](API_elastic_DeleteCluster.md) 
+  [DeleteClusterSnapshot](API_elastic_DeleteClusterSnapshot.md) 
+  [GetCluster](API_elastic_GetCluster.md) 
+  [GetClusterSnapshot](API_elastic_GetClusterSnapshot.md) 
+  [GetPendingMaintenanceAction](API_elastic_GetPendingMaintenanceAction.md) 
+  [ListClusters](API_elastic_ListClusters.md) 
+  [ListClusterSnapshots](API_elastic_ListClusterSnapshots.md) 
+  [ListPendingMaintenanceActions](API_elastic_ListPendingMaintenanceActions.md) 
+  [ListTagsForResource](API_elastic_ListTagsForResource.md) 
+  [RestoreClusterFromSnapshot](API_elastic_RestoreClusterFromSnapshot.md) 
+  [StartCluster](API_elastic_StartCluster.md) 
+  [StopCluster](API_elastic_StopCluster.md) 
+  [TagResource](API_elastic_TagResource.md) 
+  [UntagResource](API_elastic_UntagResource.md) 
+  [UpdateCluster](API_elastic_UpdateCluster.md) 

# ApplyPendingMaintenanceAction
<a name="API_elastic_ApplyPendingMaintenanceAction"></a>

Il tipo di azione di manutenzione in sospeso da applicare alla risorsa.

## Sintassi della richiesta
<a name="API_elastic_ApplyPendingMaintenanceAction_RequestSyntax"></a>

```
POST /pending-action HTTP/1.1
Content-type: application/json

{
   "applyAction": "string",
   "applyOn": "string",
   "optInType": "string",
   "resourceArn": "string"
}
```

## Parametri della richiesta URI:
<a name="API_elastic_ApplyPendingMaintenanceAction_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_elastic_ApplyPendingMaintenanceAction_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [applyAction](#API_elastic_ApplyPendingMaintenanceAction_RequestSyntax) **   <a name="documentdb-elastic_ApplyPendingMaintenanceAction-request-applyAction"></a>
L'azione di manutenzione in sospeso da applicare alla risorsa.  
Le operazioni valide sono:  
+  `ENGINE_UPDATE ` 
+  `ENGINE_UPGRADE` 
+  `SECURITY_UPDATE` 
+  `OS_UPDATE` 
+  `MASTER_USER_PASSWORD_UPDATE` 
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [optInType](#API_elastic_ApplyPendingMaintenanceAction_RequestSyntax) **   <a name="documentdb-elastic_ApplyPendingMaintenanceAction-request-optInType"></a>
Un valore che specifica il tipo di richiesta di consenso esplicito o ne annulla una. Una richiesta di consenso esplicito di tipo `IMMEDIATE` non può essere annullata.  
Tipo: String  
Valori validi: `IMMEDIATE | NEXT_MAINTENANCE | APPLY_ON | UNDO_OPT_IN`   
Obbligatorio: sì

 ** [resourceArn](#API_elastic_ApplyPendingMaintenanceAction_RequestSyntax) **   <a name="documentdb-elastic_ApplyPendingMaintenanceAction-request-resourceArn"></a>
Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [applyOn](#API_elastic_ApplyPendingMaintenanceAction_RequestSyntax) **   <a name="documentdb-elastic_ApplyPendingMaintenanceAction-request-applyOn"></a>
Una data specifica per applicare l'azione di manutenzione in sospeso. Necessario se opt-in-type è `APPLY_ON`. Formato: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_ApplyPendingMaintenanceAction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "resourcePendingMaintenanceAction": { 
      "pendingMaintenanceActionDetails": [ 
         { 
            "action": "string",
            "autoAppliedAfterDate": "string",
            "currentApplyDate": "string",
            "description": "string",
            "forcedApplyDate": "string",
            "optInStatus": "string"
         }
      ],
      "resourceArn": "string"
   }
}
```

## Elementi di risposta
<a name="API_elastic_ApplyPendingMaintenanceAction_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [resourcePendingMaintenanceAction](#API_elastic_ApplyPendingMaintenanceAction_ResponseSyntax) **   <a name="documentdb-elastic_ApplyPendingMaintenanceAction-response-resourcePendingMaintenanceAction"></a>
L'output dell'azione di manutenzione in sospeso applicata.  
Tipo: oggetto [ResourcePendingMaintenanceAction](API_elastic_ResourcePendingMaintenanceAction.md)

## Errori
<a name="API_elastic_ApplyPendingMaintenanceAction_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ApplyPendingMaintenanceAction) 

# CopyClusterSnapshot
<a name="API_elastic_CopyClusterSnapshot"></a>

Copia un'istantanea di un cluster elastico.

## Sintassi della richiesta
<a name="API_elastic_CopyClusterSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/copy HTTP/1.1
Content-type: application/json

{
   "copyTags": boolean,
   "kmsKeyId": "string",
   "tags": { 
      "string" : "string" 
   },
   "targetSnapshotName": "string"
}
```

## Parametri della richiesta URI
<a name="API_elastic_CopyClusterSnapshot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [snapshotArn](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-uri-snapshotArn"></a>
L'identificatore Amazon Resource Name (ARN) dello snapshot del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_CopyClusterSnapshot_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [targetSnapshotName](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-targetSnapshotName"></a>
L'identificatore del nuovo snapshot del cluster elastico da creare a partire dallo snapshot del cluster di origine. Questo parametro non distingue tra maiuscole e minuscole.  
Vincoli:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
Ad esempio: `elastic-cluster-snapshot-5`   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Obbligatorio: sì

 ** [copyTags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-copyTags"></a>
Impostare su `true` per copiare tutti i tag dallo snapshot del cluster di origine allo snapshot del cluster elastico di destinazione. Il valore predefinito è `false`.  
Tipo: Booleano  
Obbligatorio: no

 ** [kmsKeyId](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-kmsKeyId"></a>
L'ID della chiave AWS KMS per un'istantanea crittografata del cluster elastico. L'ID della chiave AWS KMS è l'Amazon Resource Name (ARN) AWS , l'identificatore della chiave KMS o AWS l'alias della chiave KMS per la chiave di crittografia KMS. AWS   
Se copi un'istantanea del cluster elastico crittografato dal tuo AWS account, puoi specificare un valore per crittografare la copia con una nuova chiave `KmsKeyId` di crittografia S KMS. AWS Se non specifichi un valore per`KmsKeyId`, la copia dello snapshot del cluster elastico viene crittografata con la stessa chiave `AWS` KMS dello snapshot del cluster elastico di origine.  
Se si copia uno snapshot del cluster elastico non crittografato e si specifica un valore per il `KmsKeyId` parametro, viene restituito un errore.  
▬Tipo: stringa  
Obbligatorio: no

 ** [tags](#API_elastic_CopyClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-request-tags"></a>
I tag da assegnare allo snapshot del cluster elastico.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_CopyClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_CopyClusterSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [snapshot](#API_elastic_CopyClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CopyClusterSnapshot-response-snapshot"></a>
Restituisce informazioni su uno specifico snapshot del cluster elastico.  
Tipo: oggetto [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

## Errori
<a name="API_elastic_CopyClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CopyClusterSnapshot) 

# CreateCluster
<a name="API_elastic_CreateCluster"></a>

Crea un nuovo cluster elastico Amazon DocumentDB e ne restituisce la struttura del cluster.

## Sintassi della richiesta
<a name="API_elastic_CreateCluster_RequestSyntax"></a>

```
POST /cluster HTTP/1.1
Content-type: application/json

{
   "adminUserName": "string",
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "clusterName": "string",
   "kmsKeyId": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parametri della richiesta URI:
<a name="API_elastic_CreateCluster_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_elastic_CreateCluster_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [adminUserName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserName"></a>
Il nome dell'amministratore dei cluster elastici di Amazon DocumentDB.  
 *Vincoli*:  
+ Deve contenere da 1 a 63 lettere o numeri.
+ Il primo carattere deve essere una lettera.
+ Non può essere una parola riservata.
Tipo: stringa  
Obbligatorio: sì

 ** [adminUserPassword](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-adminUserPassword"></a>
La password per l'amministratore dei cluster elastici di Amazon DocumentDB. La password può contenere qualsiasi carattere ASCII stampabile.  
 *Vincoli*:  
+ Deve contenere da 8 a 100 caratteri.
+ Non può contenere una barra (/), virgolette doppie («) o il simbolo «at» (@).
Tipo: stringa  
Obbligatorio: sì

 ** [authType](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-authType"></a>
Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono `PLAIN_TEXT` o`SECRET_ARN`.  
Tipo: String  
Valori validi: `PLAIN_TEXT | SECRET_ARN`   
Obbligatorio: sì

 ** [clusterName](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clusterName"></a>
Il nome del nuovo cluster elastico. Questo parametro è archiviato come stringa in minuscolo.  
 *Vincoli*:  
+ Deve contenere da 1 a 63 lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
 *Esempio*: `my-cluster`   
Tipo: stringa  
Obbligatorio: sì

 ** [shardCapacity](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCapacity"></a>
Il numero di v CPUs assegnato a ciascun frammento di cluster elastico. Il massimo è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64.  
Tipo: numero intero  
Obbligatorio: sì

 ** [shardCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardCount"></a>
Il numero di shard assegnati al cluster elastico. Il massimo è 32.  
Tipo: numero intero  
Obbligatorio: sì

 ** [backupRetentionPeriod](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-backupRetentionPeriod"></a>
Il numero di giorni per i quali vengono conservate le istantanee automatiche.  
Tipo: Integer  
Obbligatorio: no

 ** [clientToken](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-clientToken"></a>
Il token client per il cluster elastico.  
▬Tipo: stringa  
Obbligatorio: no

 ** [kmsKeyId](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-kmsKeyId"></a>
L'identificatore della chiave KMS da utilizzare per crittografare il nuovo cluster elastico.  
L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai creando un cluster utilizzando lo stesso account Amazon che possiede questa chiave di crittografia KMS, puoi utilizzare l'alias della chiave KMS anziché l'ARN come chiave di crittografia KMS.  
Se non viene specificata una chiave di crittografia, Amazon DocumentDB utilizza la chiave di crittografia predefinita creata da KMS per l'account. Il tuo account ha una chiave di crittografia predefinita diversa per ogni regione Amazon.  
▬Tipo: stringa  
Obbligatorio: no

 ** [preferredBackupWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-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: stringa  
Obbligatorio: no

 ** [preferredMaintenanceWindow](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-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`   
 *Impostazione predefinita*: una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna Regione AWS, che si verifica in un giorno casuale della settimana.  
 *Giorni validi*: lun, mar, mer, gio, ven, sab, dom  
 *Vincoli*: finestra di un minimo di 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** [shardInstanceCount](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-shardInstanceCount"></a>
Il numero di istanze di replica che si applicano a tutti gli shard del cluster elastico. `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  
Obbligatorio: no

 ** [subnetIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-subnetIds"></a>
La sottorete Amazon EC2 IDs per il nuovo cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

 ** [tags](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-tags"></a>
I tag da assegnare al nuovo cluster elastico.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

 ** [vpcSecurityGroupIds](#API_elastic_CreateCluster_RequestSyntax) **   <a name="documentdb-elastic_CreateCluster-request-vpcSecurityGroupIds"></a>
Un elenco di gruppi di sicurezza VPC EC2 da associare al nuovo cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_CreateCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_CreateCluster_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_CreateCluster_ResponseSyntax) **   <a name="documentdb-elastic_CreateCluster-response-cluster"></a>
Il nuovo cluster elastico che è stato creato.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_CreateCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CreateCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CreateCluster) 

# CreateClusterSnapshot
<a name="API_elastic_CreateClusterSnapshot"></a>

Crea un'istantanea di un cluster elastico.

## Sintassi della richiesta
<a name="API_elastic_CreateClusterSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot HTTP/1.1
Content-type: application/json

{
   "clusterArn": "string",
   "snapshotName": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI:
<a name="API_elastic_CreateClusterSnapshot_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_elastic_CreateClusterSnapshot_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [clusterArn](#API_elastic_CreateClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CreateClusterSnapshot-request-clusterArn"></a>
L'identificatore ARN del cluster elastico di cui si desidera creare un'istantanea.  
Tipo: stringa  
Obbligatorio: sì

 ** [snapshotName](#API_elastic_CreateClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CreateClusterSnapshot-request-snapshotName"></a>
Il nome della nuova istantanea del cluster elastico.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Obbligatorio: sì

 ** [tags](#API_elastic_CreateClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_CreateClusterSnapshot-request-tags"></a>
I tag da assegnare alla nuova istantanea del cluster elastico.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_CreateClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_CreateClusterSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [snapshot](#API_elastic_CreateClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_CreateClusterSnapshot-response-snapshot"></a>
Restituisce informazioni sulla nuova istantanea del cluster elastico.  
Tipo: oggetto [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

## Errori
<a name="API_elastic_CreateClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/CreateClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/CreateClusterSnapshot) 

# DeleteCluster
<a name="API_elastic_DeleteCluster"></a>

Eliminare un cluster elastico.

## Sintassi della richiesta
<a name="API_elastic_DeleteCluster_RequestSyntax"></a>

```
DELETE /cluster/clusterArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_DeleteCluster_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [clusterArn](#API_elastic_DeleteCluster_RequestSyntax) **   <a name="documentdb-elastic_DeleteCluster-request-uri-clusterArn"></a>
L'identificatore ARN del cluster elastico da eliminare.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_DeleteCluster_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_DeleteCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_DeleteCluster_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_DeleteCluster_ResponseSyntax) **   <a name="documentdb-elastic_DeleteCluster-response-cluster"></a>
Restituisce informazioni sul cluster elastico appena eliminato.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_DeleteCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/DeleteCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/DeleteCluster) 

# DeleteClusterSnapshot
<a name="API_elastic_DeleteClusterSnapshot"></a>

Eliminare un'istantanea del cluster elastico.

## Sintassi della richiesta
<a name="API_elastic_DeleteClusterSnapshot_RequestSyntax"></a>

```
DELETE /cluster-snapshot/snapshotArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_DeleteClusterSnapshot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [snapshotArn](#API_elastic_DeleteClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_DeleteClusterSnapshot-request-uri-snapshotArn"></a>
L'identificatore ARN dello snapshot del cluster elastico da eliminare.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_DeleteClusterSnapshot_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_DeleteClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_DeleteClusterSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [snapshot](#API_elastic_DeleteClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_DeleteClusterSnapshot-response-snapshot"></a>
Restituisce informazioni sullo snapshot del cluster elastico appena eliminato.  
Tipo: oggetto [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

## Errori
<a name="API_elastic_DeleteClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/DeleteClusterSnapshot) 

# GetCluster
<a name="API_elastic_GetCluster"></a>

Restituisce informazioni su un cluster elastico specifico.

## Sintassi della richiesta
<a name="API_elastic_GetCluster_RequestSyntax"></a>

```
GET /cluster/clusterArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_GetCluster_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [clusterArn](#API_elastic_GetCluster_RequestSyntax) **   <a name="documentdb-elastic_GetCluster-request-uri-clusterArn"></a>
L'identificatore ARN del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_GetCluster_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_GetCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_GetCluster_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_GetCluster_ResponseSyntax) **   <a name="documentdb-elastic_GetCluster-response-cluster"></a>
Restituisce informazioni su un cluster elastico specifico.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_GetCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/GetCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/GetCluster) 

# GetClusterSnapshot
<a name="API_elastic_GetClusterSnapshot"></a>

Restituisce informazioni su uno specifico snapshot del cluster elastico

## Sintassi della richiesta
<a name="API_elastic_GetClusterSnapshot_RequestSyntax"></a>

```
GET /cluster-snapshot/snapshotArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_GetClusterSnapshot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [snapshotArn](#API_elastic_GetClusterSnapshot_RequestSyntax) **   <a name="documentdb-elastic_GetClusterSnapshot-request-uri-snapshotArn"></a>
L'identificatore ARN dello snapshot del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_GetClusterSnapshot_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_GetClusterSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "snapshot": { 
      "adminUserName": "string",
      "clusterArn": "string",
      "clusterCreationTime": "string",
      "kmsKeyId": "string",
      "snapshotArn": "string",
      "snapshotCreationTime": "string",
      "snapshotName": "string",
      "snapshotType": "string",
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_GetClusterSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [snapshot](#API_elastic_GetClusterSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_GetClusterSnapshot-response-snapshot"></a>
Restituisce informazioni su uno specifico snapshot del cluster elastico.  
Tipo: oggetto [ClusterSnapshot](API_elastic_ClusterSnapshot.md)

## Errori
<a name="API_elastic_GetClusterSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/GetClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/GetClusterSnapshot) 

# GetPendingMaintenanceAction
<a name="API_elastic_GetPendingMaintenanceAction"></a>

Recupera tutte le azioni di manutenzione in sospeso.

## Sintassi della richiesta
<a name="API_elastic_GetPendingMaintenanceAction_RequestSyntax"></a>

```
GET /pending-action/resourceArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_GetPendingMaintenanceAction_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_elastic_GetPendingMaintenanceAction_RequestSyntax) **   <a name="documentdb-elastic_GetPendingMaintenanceAction-request-uri-resourceArn"></a>
Recupera le azioni di manutenzione in sospeso per uno specifico Amazon Resource Name (ARN).  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_GetPendingMaintenanceAction_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_GetPendingMaintenanceAction_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "resourcePendingMaintenanceAction": { 
      "pendingMaintenanceActionDetails": [ 
         { 
            "action": "string",
            "autoAppliedAfterDate": "string",
            "currentApplyDate": "string",
            "description": "string",
            "forcedApplyDate": "string",
            "optInStatus": "string"
         }
      ],
      "resourceArn": "string"
   }
}
```

## Elementi di risposta
<a name="API_elastic_GetPendingMaintenanceAction_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [resourcePendingMaintenanceAction](#API_elastic_GetPendingMaintenanceAction_ResponseSyntax) **   <a name="documentdb-elastic_GetPendingMaintenanceAction-response-resourcePendingMaintenanceAction"></a>
Fornisce informazioni su un'operazione di manutenzione in sospeso per una risorsa.  
Tipo: oggetto [ResourcePendingMaintenanceAction](API_elastic_ResourcePendingMaintenanceAction.md)

## Errori
<a name="API_elastic_GetPendingMaintenanceAction_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/GetPendingMaintenanceAction) 

# ListClusters
<a name="API_elastic_ListClusters"></a>

Restituisce informazioni sui cluster elastici di Amazon DocumentDB forniti.

## Sintassi della richiesta
<a name="API_elastic_ListClusters_RequestSyntax"></a>

```
GET /clusters?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_ListClusters_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_elastic_ListClusters_RequestSyntax) **   <a name="documentdb-elastic_ListClusters-request-uri-maxResults"></a>
Il numero massimo di risultati di snapshot del cluster elastico da ricevere nella risposta.  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [nextToken](#API_elastic_ListClusters_RequestSyntax) **   <a name="documentdb-elastic_ListClusters-request-uri-nextToken"></a>
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da`max-results`.  
Se non ci sono più dati nella risposta, non `nextToken` verrà restituita.

## Corpo della richiesta
<a name="API_elastic_ListClusters_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_ListClusters_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "clusters": [ 
      { 
         "clusterArn": "string",
         "clusterName": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementi di risposta
<a name="API_elastic_ListClusters_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [clusters](#API_elastic_ListClusters_ResponseSyntax) **   <a name="documentdb-elastic_ListClusters-response-clusters"></a>
Un elenco di cluster elastici di Amazon DocumentDB.  
Tipo: matrice di oggetti [ClusterInList](API_elastic_ClusterInList.md)

 ** [nextToken](#API_elastic_ListClusters_ResponseSyntax) **   <a name="documentdb-elastic_ListClusters-response-nextToken"></a>
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da`max-results`.  
Se non ci sono più dati nella risposta, non `nextToken` verrà restituita.  
Tipo: String

## Errori
<a name="API_elastic_ListClusters_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ListClusters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ListClusters) 

# ListClusterSnapshots
<a name="API_elastic_ListClusterSnapshots"></a>

Restituisce informazioni sulle istantanee per un cluster elastico specificato.

## Sintassi della richiesta
<a name="API_elastic_ListClusterSnapshots_RequestSyntax"></a>

```
GET /cluster-snapshots?clusterArn=clusterArn&maxResults=maxResults&nextToken=nextToken&snapshotType=snapshotType HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_ListClusterSnapshots_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [clusterArn](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-clusterArn"></a>
L'identificatore ARN del cluster elastico.

 ** [maxResults](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-maxResults"></a>
Il numero massimo di risultati di snapshot del cluster elastico da ricevere nella risposta.  
Intervallo valido: valore minimo di 20. valore massimo pari a 100.

 ** [nextToken](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-nextToken"></a>
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da`max-results`.  
Se non ci sono più dati nella risposta, non `nextToken` verrà restituita.

 ** [snapshotType](#API_elastic_ListClusterSnapshots_RequestSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-request-uri-snapshotType"></a>
Il tipo di istantanee del cluster da restituire. È possibile specificare uno dei seguenti valori:  
+  `automated`- Restituisci tutte le istantanee del cluster che Amazon DocumentDB ha creato automaticamente per AWS il tuo account.
+  `manual`- Restituisci tutte le istantanee del cluster che hai creato manualmente per il tuo account. AWS 

## Corpo della richiesta
<a name="API_elastic_ListClusterSnapshots_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_ListClusterSnapshots_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "snapshots": [ 
      { 
         "clusterArn": "string",
         "snapshotArn": "string",
         "snapshotCreationTime": "string",
         "snapshotName": "string",
         "status": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_elastic_ListClusterSnapshots_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [nextToken](#API_elastic_ListClusterSnapshots_ResponseSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-response-nextToken"></a>
Un token di impaginazione fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre questo token, fino al valore specificato da`max-results`.  
Se non ci sono più dati nella risposta, non `nextToken` verrà restituita.  
Tipo: String

 ** [snapshots](#API_elastic_ListClusterSnapshots_ResponseSyntax) **   <a name="documentdb-elastic_ListClusterSnapshots-response-snapshots"></a>
Un elenco di istantanee per un cluster elastico specificato.  
Tipo: matrice di oggetti [ClusterSnapshotInList](API_elastic_ClusterSnapshotInList.md)

## Errori
<a name="API_elastic_ListClusterSnapshots_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ListClusterSnapshots) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ListClusterSnapshots) 

# ListPendingMaintenanceActions
<a name="API_elastic_ListPendingMaintenanceActions"></a>

Recupera un elenco di tutte le azioni di manutenzione in sospeso.

## Sintassi della richiesta
<a name="API_elastic_ListPendingMaintenanceActions_RequestSyntax"></a>

```
GET /pending-actions?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_ListPendingMaintenanceActions_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [maxResults](#API_elastic_ListPendingMaintenanceActions_RequestSyntax) **   <a name="documentdb-elastic_ListPendingMaintenanceActions-request-uri-maxResults"></a>
Il numero massimo di risultati da includere nella risposta. Se esistono più record rispetto al `maxResults` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.

 ** [nextToken](#API_elastic_ListPendingMaintenanceActions_RequestSyntax) **   <a name="documentdb-elastic_ListPendingMaintenanceActions-request-uri-nextToken"></a>
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `maxResults`.

## Corpo della richiesta
<a name="API_elastic_ListPendingMaintenanceActions_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_ListPendingMaintenanceActions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "resourcePendingMaintenanceActions": [ 
      { 
         "pendingMaintenanceActionDetails": [ 
            { 
               "action": "string",
               "autoAppliedAfterDate": "string",
               "currentApplyDate": "string",
               "description": "string",
               "forcedApplyDate": "string",
               "optInStatus": "string"
            }
         ],
         "resourceArn": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_elastic_ListPendingMaintenanceActions_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [resourcePendingMaintenanceActions](#API_elastic_ListPendingMaintenanceActions_ResponseSyntax) **   <a name="documentdb-elastic_ListPendingMaintenanceActions-response-resourcePendingMaintenanceActions"></a>
Fornisce informazioni su un'operazione di manutenzione in sospeso per una risorsa.  
Tipo: matrice di oggetti [ResourcePendingMaintenanceAction](API_elastic_ResourcePendingMaintenanceAction.md)

 ** [nextToken](#API_elastic_ListPendingMaintenanceActions_ResponseSyntax) **   <a name="documentdb-elastic_ListPendingMaintenanceActions-response-nextToken"></a>
Token di paginazione opzionale fornito da una richiesta precedente. Se viene visualizzato questo parametro, le risposte includeranno solo i record oltre il marker, fino al valore specificato da. `maxResults`  
Tipo: String

## Errori
<a name="API_elastic_ListPendingMaintenanceActions_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ListPendingMaintenanceActions) 

# ListTagsForResource
<a name="API_elastic_ListTagsForResource"></a>

Elenca tutti i tag su una risorsa cluster elastica

## Sintassi della richiesta
<a name="API_elastic_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_ListTagsForResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_elastic_ListTagsForResource_RequestSyntax) **   <a name="documentdb-elastic_ListTagsForResource-request-uri-resourceArn"></a>
L'identificatore ARN della risorsa del cluster elastico.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_ListTagsForResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## Elementi di risposta
<a name="API_elastic_ListTagsForResource_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [tags](#API_elastic_ListTagsForResource_ResponseSyntax) **   <a name="documentdb-elastic_ListTagsForResource-response-tags"></a>
L'elenco di tag per la risorsa del cluster elastico specificata.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

## Errori
<a name="API_elastic_ListTagsForResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stata trovata.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ListTagsForResource) 

# RestoreClusterFromSnapshot
<a name="API_elastic_RestoreClusterFromSnapshot"></a>

Ripristina un cluster elastico da un'istantanea.

## Sintassi della richiesta
<a name="API_elastic_RestoreClusterFromSnapshot_RequestSyntax"></a>

```
POST /cluster-snapshot/snapshotArn/restore HTTP/1.1
Content-type: application/json

{
   "clusterName": "string",
   "kmsKeyId": "string",
   "shardCapacity": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "tags": { 
      "string" : "string" 
   },
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parametri della richiesta URI
<a name="API_elastic_RestoreClusterFromSnapshot_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [snapshotArn](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-uri-snapshotArn"></a>
L'identificatore ARN dello snapshot del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_RestoreClusterFromSnapshot_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [clusterName](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-clusterName"></a>
Il nome del cluster elastico.  
Tipo: stringa  
Obbligatorio: sì

 ** [kmsKeyId](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-kmsKeyId"></a>
L'identificatore di chiave KMS da utilizzare per crittografare il nuovo cluster elastico di cluster Amazon DocumentDB.  
L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai creando un cluster utilizzando lo stesso account Amazon che possiede questa chiave di crittografia KMS, puoi utilizzare l'alias della chiave KMS anziché l'ARN come chiave di crittografia KMS.  
Se non viene specificata una chiave di crittografia qui, Amazon DocumentDB utilizza la chiave di crittografia predefinita creata da KMS per il tuo account. Il tuo account ha una chiave di crittografia predefinita diversa per ogni regione Amazon.  
▬Tipo: stringa  
Obbligatorio: no

 ** [shardCapacity](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-shardCapacity"></a>
La capacità di ogni shard nel nuovo cluster elastico ripristinato.  
Tipo: Integer  
Obbligatorio: no

 ** [shardInstanceCount](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-shardInstanceCount"></a>
Il numero di istanze di replica che si applicano a tutti gli shard del cluster elastico. `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  
Obbligatorio: no

 ** [subnetIds](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-subnetIds"></a>
La sottorete Amazon EC2 IDs per il cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

 ** [tags](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-tags"></a>
Un elenco dei nomi di tag da assegnare al cluster elastico ripristinato, sotto forma di una matrice di coppie chiave-valore in cui la chiave è il nome del tag e il valore è il valore chiave.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

 ** [vpcSecurityGroupIds](#API_elastic_RestoreClusterFromSnapshot_RequestSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-request-vpcSecurityGroupIds"></a>
Un elenco di gruppi di sicurezza VPC EC2 da associare al cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_RestoreClusterFromSnapshot_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_RestoreClusterFromSnapshot_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_RestoreClusterFromSnapshot_ResponseSyntax) **   <a name="documentdb-elastic_RestoreClusterFromSnapshot-response-cluster"></a>
Restituisce informazioni su un cluster elastico ripristinato.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_RestoreClusterFromSnapshot_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ServiceQuotaExceededException **   
La quota di servizio per l'azione è stata superata.  
Codice di stato HTTP: 402

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta viene rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/RestoreClusterFromSnapshot) 

# StartCluster
<a name="API_elastic_StartCluster"></a>

Riavvia il cluster elastico interrotto specificato da`clusterARN`.

## Sintassi della richiesta
<a name="API_elastic_StartCluster_RequestSyntax"></a>

```
POST /cluster/clusterArn/start HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_StartCluster_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [clusterArn](#API_elastic_StartCluster_RequestSyntax) **   <a name="documentdb-elastic_StartCluster-request-uri-clusterArn"></a>
L'identificatore ARN del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_StartCluster_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_StartCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_StartCluster_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_StartCluster_ResponseSyntax) **   <a name="documentdb-elastic_StartCluster-response-cluster"></a>
Restituisce informazioni su un cluster elastico specifico.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_StartCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/StartCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/StartCluster) 

# StopCluster
<a name="API_elastic_StopCluster"></a>

Arresta il cluster elastico in esecuzione specificato da`clusterArn`. Il cluster elastico deve essere nello stato *disponibile*. 

## Sintassi della richiesta
<a name="API_elastic_StopCluster_RequestSyntax"></a>

```
POST /cluster/clusterArn/stop HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_StopCluster_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [clusterArn](#API_elastic_StopCluster_RequestSyntax) **   <a name="documentdb-elastic_StopCluster-request-uri-clusterArn"></a>
L'identificatore ARN del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_StopCluster_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_StopCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_StopCluster_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_StopCluster_ResponseSyntax) **   <a name="documentdb-elastic_StopCluster-response-cluster"></a>
Restituisce informazioni su un cluster elastico specifico.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_StopCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/StopCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/StopCluster) 

# TagResource
<a name="API_elastic_TagResource"></a>

Aggiunge tag di metadati a una risorsa cluster elastica

## Sintassi della richiesta
<a name="API_elastic_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## Parametri della richiesta URI
<a name="API_elastic_TagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_elastic_TagResource_RequestSyntax) **   <a name="documentdb-elastic_TagResource-request-uri-resourceArn"></a>
L'identificatore ARN della risorsa del cluster elastico.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_TagResource_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [tags](#API_elastic_TagResource_RequestSyntax) **   <a name="documentdb-elastic_TagResource-request-tags"></a>
I tag assegnati alla risorsa del cluster elastico.  
Tipo: mappatura stringa a stringa  
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.  
Modello di chiave:`(?!aws:)[a-zA-Z+-=._:/]+`   
Vincoli di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_elastic_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_elastic_TagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_elastic_TagResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/TagResource) 

# UntagResource
<a name="API_elastic_UntagResource"></a>

Rimuove i tag di metadati da una risorsa cluster elastica

## Sintassi della richiesta
<a name="API_elastic_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_elastic_UntagResource_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [resourceArn](#API_elastic_UntagResource_RequestSyntax) **   <a name="documentdb-elastic_UntagResource-request-uri-resourceArn"></a>
L'identificatore ARN della risorsa del cluster elastico.  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1011.  
Obbligatorio: sì

 ** [tagKeys](#API_elastic_UntagResource_RequestSyntax) **   <a name="documentdb-elastic_UntagResource-request-uri-tagKeys"></a>
Le chiavi dei tag da rimuovere dalla risorsa del cluster elastico.  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Modello: `(?!aws:)[a-zA-Z+-=._:/]+`   
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_UntagResource_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_elastic_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_elastic_UntagResource_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_elastic_UntagResource_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/UntagResource) 

# UpdateCluster
<a name="API_elastic_UpdateCluster"></a>

Modifica un cluster elastico. Ciò include l'aggiornamento del nome utente/della password dell'amministratore, l'aggiornamento della versione dell'API e la configurazione di una finestra di backup e di manutenzione

## Sintassi della richiesta
<a name="API_elastic_UpdateCluster_RequestSyntax"></a>

```
PUT /cluster/clusterArn HTTP/1.1
Content-type: application/json

{
   "adminUserPassword": "string",
   "authType": "string",
   "backupRetentionPeriod": number,
   "clientToken": "string",
   "preferredBackupWindow": "string",
   "preferredMaintenanceWindow": "string",
   "shardCapacity": number,
   "shardCount": number,
   "shardInstanceCount": number,
   "subnetIds": [ "string" ],
   "vpcSecurityGroupIds": [ "string" ]
}
```

## Parametri della richiesta URI
<a name="API_elastic_UpdateCluster_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [clusterArn](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-uri-clusterArn"></a>
L'identificatore ARN del cluster elastico.  
Obbligatorio: sì

## Corpo della richiesta
<a name="API_elastic_UpdateCluster_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [adminUserPassword](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-adminUserPassword"></a>
La password associata all'amministratore del cluster elastico. Questa password può contenere qualsiasi carattere ASCII stampabile, eccetto la barra (/), le virgolette (") o il simbolo chiocciola (@).  
 *Vincoli*: deve contenere da 8 a 100 caratteri.  
▬Tipo: stringa  
Obbligatorio: no

 ** [authType](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-authType"></a>
Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono `PLAIN_TEXT` o`SECRET_ARN`.  
Tipo: String  
Valori validi: `PLAIN_TEXT | SECRET_ARN`   
Campo obbligatorio: no

 ** [backupRetentionPeriod](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-backupRetentionPeriod"></a>
Il numero di giorni per i quali vengono conservate le istantanee automatiche.  
Tipo: Integer  
Obbligatorio: no

 ** [clientToken](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-clientToken"></a>
Il token client per il cluster elastico.  
▬Tipo: stringa  
Obbligatorio: no

 ** [preferredBackupWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-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: stringa  
Obbligatorio: no

 ** [preferredMaintenanceWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-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`   
 *Impostazione predefinita*: una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna Regione AWS, che si verifica in un giorno casuale della settimana.  
 *Giorni validi*: lun, mar, mer, gio, ven, sab, dom  
 *Vincoli*: finestra di un minimo di 30 minuti.  
▬Tipo: stringa  
Obbligatorio: no

 ** [shardCapacity](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-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  
Obbligatorio: no

 ** [shardCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCount"></a>
Il numero di shard assegnati al cluster elastico. Il massimo è 32.  
Tipo: Integer  
Obbligatorio: no

 ** [shardInstanceCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardInstanceCount"></a>
Il numero di istanze di replica che si applicano a tutti gli shard del cluster elastico. `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  
Obbligatorio: no

 ** [subnetIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-subnetIds"></a>
La sottorete Amazon EC2 IDs per il cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

 ** [vpcSecurityGroupIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-vpcSecurityGroupIds"></a>
Un elenco di gruppi di sicurezza VPC EC2 da associare al cluster elastico.  
Tipo: array di stringhe  
Obbligatorio: no

## Sintassi della risposta
<a name="API_elastic_UpdateCluster_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "cluster": { 
      "adminUserName": "string",
      "authType": "string",
      "backupRetentionPeriod": number,
      "clusterArn": "string",
      "clusterEndpoint": "string",
      "clusterName": "string",
      "createTime": "string",
      "kmsKeyId": "string",
      "preferredBackupWindow": "string",
      "preferredMaintenanceWindow": "string",
      "shardCapacity": number,
      "shardCount": number,
      "shardInstanceCount": number,
      "shards": [ 
         { 
            "createTime": "string",
            "shardId": "string",
            "status": "string"
         }
      ],
      "status": "string",
      "subnetIds": [ "string" ],
      "vpcSecurityGroupIds": [ "string" ]
   }
}
```

## Elementi di risposta
<a name="API_elastic_UpdateCluster_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [cluster](#API_elastic_UpdateCluster_ResponseSyntax) **   <a name="documentdb-elastic_UpdateCluster-response-cluster"></a>
Restituisce informazioni sul cluster elastico aggiornato.  
Tipo: oggetto [Cluster](API_elastic_Cluster.md)

## Errori
<a name="API_elastic_UpdateCluster_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Un'eccezione che si verifica quando non ci sono autorizzazioni sufficienti per eseguire un'azione.    
 ** message **   
Un messaggio di errore che spiega perché l'accesso è stato negato.
Codice di stato HTTP: 403

 ** ConflictException **   
C'è stato un conflitto di accesso.    
 ** resourceId **   
L'ID della risorsa in cui si è verificato un conflitto di accesso.  
 ** resourceType **   
Il tipo di risorsa in cui si è verificato un conflitto di accesso.
Codice di stato HTTP: 409

 ** InternalServerException **   
Si è verificato un errore interno del server.  
Codice di stato HTTP: 500

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.    
 ** message **   
Un messaggio di errore che descrive l'errore.  
 ** resourceId **   
L'ID della risorsa che non è stato possibile individuare.  
 ** resourceType **   
Il tipo di risorsa che non è stato possibile trovare.
Codice di stato HTTP: 404

 ** ThrottlingException **   
ThrottlingException verrà generata quando la richiesta è stata rifiutata a causa della limitazione della richiesta.    
 ** retryAfterSeconds **   
Il numero di secondi di attesa prima di ritentare l'operazione.
Codice di stato HTTP: 429

 ** ValidationException **   
Una struttura che definisce un'eccezione di convalida.    
 ** fieldList **   
Un elenco dei campi in cui si è verificata l'eccezione di convalida.  
 ** message **   
Un messaggio di errore che descrive l'eccezione di convalida.  
 ** reason **   
Il motivo per cui si è verificata l'eccezione di convalida (uno tra`unknownOperation`, `cannotParse``fieldValidationFailed`, o). `other`
Codice di stato HTTP: 400

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

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/UpdateCluster) 

# Tipi di dati
<a name="API_Types"></a>

I seguenti tipi di dati sono supportati da Amazon DocumentDB (with MongoDB compatibility):
+  [AvailabilityZone](API_AvailabilityZone.md) 
+  [Certificate](API_Certificate.md) 
+  [CertificateDetails](API_CertificateDetails.md) 
+  [CloudwatchLogsExportConfiguration](API_CloudwatchLogsExportConfiguration.md) 
+  [ClusterMasterUserSecret](API_ClusterMasterUserSecret.md) 
+  [DBCluster](API_DBCluster.md) 
+  [DBClusterMember](API_DBClusterMember.md) 
+  [DBClusterParameterGroup](API_DBClusterParameterGroup.md) 
+  [DBClusterRole](API_DBClusterRole.md) 
+  [DBClusterSnapshot](API_DBClusterSnapshot.md) 
+  [DBClusterSnapshotAttribute](API_DBClusterSnapshotAttribute.md) 
+  [DBClusterSnapshotAttributesResult](API_DBClusterSnapshotAttributesResult.md) 
+  [DBEngineVersion](API_DBEngineVersion.md) 
+  [DBInstance](API_DBInstance.md) 
+  [DBInstanceStatusInfo](API_DBInstanceStatusInfo.md) 
+  [DBSubnetGroup](API_DBSubnetGroup.md) 
+  [Endpoint](API_Endpoint.md) 
+  [EngineDefaults](API_EngineDefaults.md) 
+  [Event](API_Event.md) 
+  [EventCategoriesMap](API_EventCategoriesMap.md) 
+  [EventSubscription](API_EventSubscription.md) 
+  [FailoverState](API_FailoverState.md) 
+  [Filter](API_Filter.md) 
+  [GlobalCluster](API_GlobalCluster.md) 
+  [GlobalClusterMember](API_GlobalClusterMember.md) 
+  [OrderableDBInstanceOption](API_OrderableDBInstanceOption.md) 
+  [Parameter](API_Parameter.md) 
+  [PendingCloudwatchLogsExports](API_PendingCloudwatchLogsExports.md) 
+  [PendingMaintenanceAction](API_PendingMaintenanceAction.md) 
+  [PendingModifiedValues](API_PendingModifiedValues.md) 
+  [ResourcePendingMaintenanceActions](API_ResourcePendingMaintenanceActions.md) 
+  [ServerlessV2FeaturesSupport](API_ServerlessV2FeaturesSupport.md) 
+  [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md) 
+  [ServerlessV2ScalingConfigurationInfo](API_ServerlessV2ScalingConfigurationInfo.md) 
+  [Subnet](API_Subnet.md) 
+  [Tag](API_Tag.md) 
+  [UpgradeTarget](API_UpgradeTarget.md) 
+  [VpcSecurityGroupMembership](API_VpcSecurityGroupMembership.md) 

I seguenti tipi di dati sono supportati da Amazon DocumentDB Elastic Clusters:
+  [Cluster](API_elastic_Cluster.md) 
+  [ClusterInList](API_elastic_ClusterInList.md) 
+  [ClusterSnapshot](API_elastic_ClusterSnapshot.md) 
+  [ClusterSnapshotInList](API_elastic_ClusterSnapshotInList.md) 
+  [PendingMaintenanceActionDetails](API_elastic_PendingMaintenanceActionDetails.md) 
+  [ResourcePendingMaintenanceAction](API_elastic_ResourcePendingMaintenanceAction.md) 
+  [Shard](API_elastic_Shard.md) 
+  [ValidationExceptionField](API_elastic_ValidationExceptionField.md) 

# Amazon DocumentDB (with MongoDB compatibility)
<a name="API_Types_Amazon_DocumentDB_with_MongoDB_compatibility"></a>

I seguenti tipi di dati sono supportati da Amazon DocumentDB (with MongoDB compatibility):
+  [AvailabilityZone](API_AvailabilityZone.md) 
+  [Certificate](API_Certificate.md) 
+  [CertificateDetails](API_CertificateDetails.md) 
+  [CloudwatchLogsExportConfiguration](API_CloudwatchLogsExportConfiguration.md) 
+  [ClusterMasterUserSecret](API_ClusterMasterUserSecret.md) 
+  [DBCluster](API_DBCluster.md) 
+  [DBClusterMember](API_DBClusterMember.md) 
+  [DBClusterParameterGroup](API_DBClusterParameterGroup.md) 
+  [DBClusterRole](API_DBClusterRole.md) 
+  [DBClusterSnapshot](API_DBClusterSnapshot.md) 
+  [DBClusterSnapshotAttribute](API_DBClusterSnapshotAttribute.md) 
+  [DBClusterSnapshotAttributesResult](API_DBClusterSnapshotAttributesResult.md) 
+  [DBEngineVersion](API_DBEngineVersion.md) 
+  [DBInstance](API_DBInstance.md) 
+  [DBInstanceStatusInfo](API_DBInstanceStatusInfo.md) 
+  [DBSubnetGroup](API_DBSubnetGroup.md) 
+  [Endpoint](API_Endpoint.md) 
+  [EngineDefaults](API_EngineDefaults.md) 
+  [Event](API_Event.md) 
+  [EventCategoriesMap](API_EventCategoriesMap.md) 
+  [EventSubscription](API_EventSubscription.md) 
+  [FailoverState](API_FailoverState.md) 
+  [Filter](API_Filter.md) 
+  [GlobalCluster](API_GlobalCluster.md) 
+  [GlobalClusterMember](API_GlobalClusterMember.md) 
+  [OrderableDBInstanceOption](API_OrderableDBInstanceOption.md) 
+  [Parameter](API_Parameter.md) 
+  [PendingCloudwatchLogsExports](API_PendingCloudwatchLogsExports.md) 
+  [PendingMaintenanceAction](API_PendingMaintenanceAction.md) 
+  [PendingModifiedValues](API_PendingModifiedValues.md) 
+  [ResourcePendingMaintenanceActions](API_ResourcePendingMaintenanceActions.md) 
+  [ServerlessV2FeaturesSupport](API_ServerlessV2FeaturesSupport.md) 
+  [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md) 
+  [ServerlessV2ScalingConfigurationInfo](API_ServerlessV2ScalingConfigurationInfo.md) 
+  [Subnet](API_Subnet.md) 
+  [Tag](API_Tag.md) 
+  [UpgradeTarget](API_UpgradeTarget.md) 
+  [VpcSecurityGroupMembership](API_VpcSecurityGroupMembership.md) 

# AvailabilityZone
<a name="API_AvailabilityZone"></a>

Informazioni su una zona di disponibilità.

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

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

 ** Name **   
Nome della zona di disponibilità.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_AvailabilityZone_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-2014-10-31/AvailabilityZone) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/AvailabilityZone) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/AvailabilityZone) 

# Certificate
<a name="API_Certificate"></a>

Un certificato di autorità di certificazione (CA) per un Account AWS.

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

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

 ** CertificateArn **   
L'Amazon Resource Name (ARN) per il certificato.  
Esempio: `arn:aws:rds:us-east-1::cert:rds-ca-2019`   
Tipo: string  
Campo obbligatorio: no

 ** CertificateIdentifier **   
La chiave univoca che identifica un certificato.  
Esempio: `rds-ca-2019`   
Tipo: string  
Campo obbligatorio: no

 ** CertificateType **   
Il tipo di certificato.  
Esempio: `CA`   
Tipo: string  
Campo obbligatorio: no

 ** Thumbprint **   
L'impronta digitale del certificato.  
Tipo: string  
Campo obbligatorio: no

 ** ValidFrom **   
La data-ora di inizio della validità del certificato.  
Esempio: `2019-07-31T17:57:09Z`   
Tipo: Timestamp  
Campo obbligatorio: no

 ** ValidTill **   
La data-ora dopo la quale il certificato non è più valido.  
Esempio: `2024-07-31T17:57:09Z`   
Tipo: Timestamp  
Campo obbligatorio: no

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

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

# CertificateDetails
<a name="API_CertificateDetails"></a>

Restituisce i dettagli del certificato del server dell'istanza DB.

*Per ulteriori informazioni, consulta [Updating your Amazon DocumentDB TLS Certificates](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) and [Encrypting Data in Transit nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) Amazon DocumentDB Developer Guide.*

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

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

 ** CAIdentifier **   
L'identificatore CA del certificato CA utilizzato per il certificato del server dell'istanza DB.  
Tipo: string  
Campo obbligatorio: no

 ** ValidTill **   
La data di scadenza del certificato del server dell'istanza DB.  
Tipo: Timestamp  
Campo obbligatorio: no

## Vedi anche
<a name="API_CertificateDetails_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-2014-10-31/CertificateDetails) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CertificateDetails) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CertificateDetails) 

# CloudwatchLogsExportConfiguration
<a name="API_CloudwatchLogsExportConfiguration"></a>

L'impostazione di configurazione per i tipi di log da abilitare per l'esportazione in Amazon CloudWatch Logs per un'istanza o un cluster specifico.

Gli `DisableLogTypes` array `EnableLogTypes` and determinano quali log vengono esportati (o non esportati) in Logs. CloudWatch I valori all'interno di questi array dipendono dal motore utilizzato.

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

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

 ** DisableLogTypes.member.N **   
L'elenco dei tipi di log da disabilitare.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** EnableLogTypes.member.N **   
L'elenco dei tipi di log da abilitare.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

## Vedi anche
<a name="API_CloudwatchLogsExportConfiguration_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-2014-10-31/CloudwatchLogsExportConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CloudwatchLogsExportConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CloudwatchLogsExportConfiguration) 

# ClusterMasterUserSecret
<a name="API_ClusterMasterUserSecret"></a>

Contiene il segreto gestito da Amazon DocumentDB in AWS Secrets Manager per la password dell'utente principale.

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

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

 ** KmsKeyId **   
L'identificatore della chiave AWS KMS utilizzato per crittografare il segreto.  
Tipo: string  
Campo obbligatorio: no

 ** SecretArn **   
Il nome della risorsa Amazon (ARN) del segreto.  
Tipo: string  
Campo obbligatorio: no

 ** SecretStatus **   
Lo stato del segreto.  
I valori possibili per lo stato sono:  
+ creazione: il segreto è in fase di creazione.
+ active - Il segreto è disponibile per l'uso e la rotazione normali.
+ rotante - Il segreto viene ruotato.
+ alterato: il segreto può essere usato per accedere alle credenziali del database, ma non può essere ruotato. Un segreto può avere questo stato se, ad esempio, le autorizzazioni vengono modificate in modo che Amazon DocumentDB non possa più accedere né al segreto né alla chiave KMS del segreto.

  Quando un segreto ha questo stato, puoi correggere la condizione che lo ha causato. In alternativa, modifica l'istanza per disattivare la gestione automatica delle credenziali del database, quindi modifica nuovamente l'istanza per attivare la gestione automatica delle credenziali del database.
Tipo: string  
Campo obbligatorio: no

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

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

# DBCluster
<a name="API_DBCluster"></a>

Informazioni dettagliate su un cluster. 

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

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

 ** AssociatedRoles.DBClusterRole.N **   
Fornisce un elenco dei ruoli AWS Identity and Access Management (IAM) associati al cluster. I ruoli (IAM) associati a un cluster concedono l'autorizzazione al cluster di accedere ad altri AWS servizi per conto dell'utente.  
Tipo: matrice di oggetti [DBClusterRole](API_DBClusterRole.md)  
Campo obbligatorio: no

 ** AvailabilityZones.AvailabilityZone.N **   
Fornisce l'elenco delle zone di EC2 disponibilità Amazon in cui è possibile creare le istanze del cluster.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** BackupRetentionPeriod **   
Speciifica il numero di giorni per i quali vengono conservate le istantanee automatiche.  
Tipo: integer  
Campo obbligatorio: no

 ** CloneGroupId **   
Identifica il gruppo di cloni a cui è associato il cluster di database.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** ClusterCreateTime **   
Speciifica l'ora in cui è stato creato il cluster, in UTC (Universal Coordinated Time).  
Tipo: Timestamp  
Campo obbligatorio: no

 ** DBClusterArn **   
L'Amazon Resource Name (ARN) per il cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DBClusterIdentifier **   
Contiene un identificatore di cluster fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DBClusterMembers.DBClusterMember.N **   
Fornisce l'elenco delle istanze che compongono il cluster.  
Tipo: matrice di oggetti [DBClusterMember](API_DBClusterMember.md)  
Campo obbligatorio: no

 ** DBClusterParameterGroup **   
Speciifica il nome del gruppo di parametri del cluster per il cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DbClusterResourceId **   
L'identificatore Regione AWS-unique e immutabile per il cluster. Questo identificatore si trova nelle voci di AWS CloudTrail registro ogni volta che si accede alla AWS KMS chiave per il cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DBSubnetGroup **   
Speciifica le informazioni sul gruppo di sottoreti associato al cluster, inclusi il nome, la descrizione e le sottoreti del gruppo di sottoreti.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DeletionProtection **   
Speciifica se questo cluster può essere eliminato. Se `DeletionProtection` è abilitato, il cluster non può essere eliminato a meno che non venga modificato e `DeletionProtection` disabilitato. `DeletionProtection`protegge i cluster dall'eliminazione accidentale.  
Tipo: Booleano  
Campo obbligatorio: no

 ** EarliestRestorableTime **   
Il primo momento in cui un database può essere ripristinato con point-in-time restore.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** EnabledCloudwatchLogsExports.member.N **   
Un elenco di tipi di log che questo cluster è configurato per esportare in Amazon CloudWatch Logs.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** Endpoint **   
Speciifica l'endpoint di connessione per l'istanza principale del cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** Engine **   
Fornisce il nome del motore di database da utilizzare per questo cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** EngineVersion **   
Indica la versione del motore di database.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** HostedZoneId **   
Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** IOOptimizedNextAllowedModificationTime **   
La prossima volta potrai modificare il cluster Amazon DocumentDB per utilizzare il tipo di storage iopt1.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** KmsKeyId **   
In caso `StorageEncrypted` affermativo`true`, l'identificatore della AWS KMS chiave per il cluster crittografato.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** LatestRestorableTime **   
Speciifica l'ora più recente alla quale un database può essere ripristinato con point-in-time restore.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** MasterUsername **   
Contiene il nome utente principale per il cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** MasterUserSecret **   
Il segreto gestito da Amazon DocumentDB in AWS Secrets Manager per la password dell'utente principale.  
Tipo: oggetto [ClusterMasterUserSecret](API_ClusterMasterUserSecret.md)  
Campo obbligatorio: no

 ** MultiAZ **   
Speciifica se il cluster dispone di istanze in più zone di disponibilità.  
Tipo: Booleano  
Campo obbligatorio: no

 ** NetworkType **   
Il tipo di rete del cluster.  
Il tipo di rete è determinato da quello `DBSubnetGroup` specificato per il cluster. A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv4 e i IPv6 protocolli (`DUAL`).  
Per ulteriori informazioni, consulta [DocumentDB clusters in a VPC nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) Amazon DocumentDB Developer Guide.  
Valori validi: `IPV4` \$1 `DUAL`   
▬Tipo: stringa  
Campo obbligatorio: no

 ** PercentProgress **   
Specifica l'avanzamento dell'operazione sotto forma di percentuale.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** Port **   
Specifica la porta su cui è in ascolto il motore di database.  
Tipo: integer  
Campo obbligatorio: no

 ** PreferredBackupWindow **   
Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da `BackupRetentionPeriod`.   
▬Tipo: stringa  
Campo obbligatorio: no

 ** PreferredMaintenanceWindow **   
Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** ReaderEndpoint **   
L'endpoint di lettura per il cluster. L'endpoint di lettura per un cluster bilancia il carico delle connessioni tra le repliche di Amazon DocumentDB disponibili in un cluster. Quando i client richiedono nuove connessioni all'endpoint del lettore, Amazon DocumentDB distribuisce le richieste di connessione tra le repliche di Amazon DocumentDB nel cluster. Questa funzionalità può aiutare a bilanciare il carico di lavoro di lettura su più repliche di Amazon DocumentDB nel cluster.   
Se si verifica un failover e la replica di Amazon DocumentDB a cui sei connesso viene promossa a istanza principale, la connessione viene interrotta. Per continuare a inviare il carico di lavoro di lettura ad altre repliche di Amazon DocumentDB nel cluster, puoi riconnetterti all'endpoint di lettura.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** ReadReplicaIdentifiers.ReadReplicaIdentifier.N **   
Contiene uno o più identificatori dei cluster secondari associati a questo cluster.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** ReplicationSourceIdentifier **   
Contiene l'identificatore del cluster di origine se questo cluster è un cluster secondario.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** ServerlessV2ScalingConfiguration **   
La configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.  
Tipo: oggetto [ServerlessV2ScalingConfigurationInfo](API_ServerlessV2ScalingConfigurationInfo.md)  
Campo obbligatorio: no

 ** Status **   
Specifica lo stato attuale di questo cluster.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** StorageEncrypted **   
Specifica se il cluster è crittografato.  
Tipo: Booleano  
Campo obbligatorio: no

 ** StorageType **   
Tipo di archiviazione associato al cluster  
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*  
Valori validi per il tipo di storage - `standard | iopt1`   
Il valore predefinito è `standard `   
▬Tipo: stringa  
Campo obbligatorio: no

 ** VpcSecurityGroups.VpcSecurityGroupMembership.N **   
Fornisce un elenco di gruppi di sicurezza del cloud privato virtuale (VPC) a cui appartiene il cluster.  
Tipo: matrice di oggetti [VpcSecurityGroupMembership](API_VpcSecurityGroupMembership.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_DBCluster_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-2014-10-31/DBCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DBCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DBCluster) 

# DBClusterMember
<a name="API_DBClusterMember"></a>

Contiene informazioni su un'istanza che fa parte di un cluster.

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

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

 ** DBClusterParameterGroupStatus **   
Specifica lo stato del gruppo di parametri del cluster per questo membro del cluster DB.  
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceIdentifier **   
Speciifica l'identificatore di istanza per questo membro del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** IsClusterWriter **   
Un valore che indica `true` se il membro del cluster è l'istanza principale del cluster e `false` altro.  
Tipo: Booleano  
Campo obbligatorio: no

 ** PromotionTier **   
Un valore che specifica l'ordine in cui una replica di Amazon DocumentDB viene promossa all'istanza principale dopo un errore dell'istanza primaria esistente.   
Tipo: integer  
Campo obbligatorio: no

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

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

# DBClusterParameterGroup
<a name="API_DBClusterParameterGroup"></a>

Informazioni dettagliate su un gruppo di parametri del cluster. 

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

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

 ** DBClusterParameterGroupArn **   
L'Amazon Resource Name (ARN) per il gruppo di parametri del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** DBClusterParameterGroupName **   
Fornisce il nome del gruppo di parametri del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** DBParameterGroupFamily **   
Fornisce il nome della famiglia di gruppi di parametri con cui questo gruppo di parametri del cluster è compatibile.  
Tipo: string  
Campo obbligatorio: no

 ** Description **   
Fornisce la descrizione specificata dal cliente per questo gruppo di parametri del cluster.  
Tipo: string  
Campo obbligatorio: no

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

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

# DBClusterRole
<a name="API_DBClusterRole"></a>

Descrive un ruolo AWS Identity and Access Management (IAM) associato a un cluster.

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

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

 ** RoleArn **   
L'Amazon Resource Name (ARN) del IAMrole che è associato al cluster DB.  
Tipo: string  
Campo obbligatorio: no

 ** Status **   
Descrive lo stato di associazione tra il IAMrole e il cluster. La `Status` proprietà restituisce uno dei seguenti valori:  
+  `ACTIVE`- L' IAMrole ARN è associato al cluster e può essere utilizzato per accedere ad altri AWS servizi per conto dell'utente.
+  `PENDING`- L' IAMrole ARN viene associato al cluster.
+  `INVALID`- L' IAMrole ARN è associato al cluster, ma il cluster non può presupporre l'accesso IAMrole ad altri AWS servizi per conto dell'utente.
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_DBClusterRole_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-2014-10-31/DBClusterRole) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DBClusterRole) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DBClusterRole) 

# DBClusterSnapshot
<a name="API_DBClusterSnapshot"></a>

Informazioni dettagliate su un'istantanea del cluster. 

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

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

 ** AvailabilityZones.AvailabilityZone.N **   
Fornisce l'elenco delle zone di EC2 disponibilità di Amazon in cui è possibile ripristinare le istanze dello snapshot del cluster.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** ClusterCreateTime **   
Speciifica l'ora in cui è stato creato il cluster, in UTC (Universal Coordinated Time).  
Tipo: Timestamp  
Campo obbligatorio: no

 ** DBClusterIdentifier **   
Speciifica l'identificatore del cluster da cui è stata creata questa istantanea del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** DBClusterSnapshotArn **   
L'Amazon Resource Name (ARN) per lo snapshot del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** DBClusterSnapshotIdentifier **   
Speciifica l'identificatore per lo snapshot del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** Engine **   
Specifica il nome del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** EngineVersion **   
Fornisce la versione del motore di database per questa istantanea del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** KmsKeyId **   
In caso `StorageEncrypted` `true` affermativo, l'identificatore della AWS KMS chiave per lo snapshot crittografato del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** MasterUsername **   
Fornisce il nome utente principale per lo snapshot del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** PercentProgress **   
Specifica la percentuale dei dati stimati che sono stati trasferiti.  
Tipo: integer  
Campo obbligatorio: no

 ** Port **   
Speciifica la porta su cui il cluster era in ascolto al momento dell'istantanea.  
Tipo: integer  
Campo obbligatorio: no

 ** SnapshotCreateTime **   
Fornisce l'ora in cui è stata scattata l'istantanea, in UTC.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** SnapshotType **   
Fornisce il tipo di istantanea del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** SourceDBClusterSnapshotArn **   
Se lo snapshot del cluster è stato copiato da uno snapshot del cluster di origine, l'ARN per lo snapshot del cluster di origine; in caso contrario, un valore nullo.  
Tipo: string  
Campo obbligatorio: no

 ** Status **   
Speciifica lo stato di questa istantanea del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** StorageEncrypted **   
Speciifica se l'istantanea del cluster è crittografata.  
Tipo: Booleano  
Campo obbligatorio: no

 ** StorageType **   
Tipo di storage associato allo snapshot del cluster  
*Per informazioni sui tipi di storage per i cluster Amazon DocumentDB, consulta le configurazioni di storage dei cluster nella Amazon DocumentDB Developer Guide.*  
Valori validi per il tipo di storage - `standard | iopt1`   
Il valore predefinito è `standard `   
Tipo: string  
Campo obbligatorio: no

 ** VpcId **   
Fornisce l'ID del cloud privato virtuale (VPC) associato allo snapshot del cluster.  
Tipo: string  
Campo obbligatorio: no

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

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

# DBClusterSnapshotAttribute
<a name="API_DBClusterSnapshotAttribute"></a>

Contiene il nome e i valori di un attributo manuale di snapshot del cluster.

Gli attributi manuali di snapshot del cluster vengono utilizzati per autorizzare altri utenti Account AWS a ripristinare un'istantanea manuale del cluster.

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

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

 ** AttributeName **   
Il nome dell'attributo manuale dello snapshot del cluster.  
L'attributo denominato `restore` si riferisce all'elenco di coloro Account AWS che dispongono dell'autorizzazione a copiare o ripristinare l'istantanea manuale del cluster.  
Tipo: string  
Campo obbligatorio: no

 ** AttributeValues.AttributeValue.N **   
I valori per l'attributo manuale dello snapshot del cluster.  
Se il `AttributeName` campo è impostato su`restore`, questo elemento restituisce un elenco IDs di Account AWS quelli autorizzati a copiare o ripristinare l'istantanea manuale del cluster. Se nell'elenco `all` è presente un valore di, l'istantanea manuale del cluster è pubblica e può essere copiata o ripristinata Account AWS da chiunque.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

## Vedi anche
<a name="API_DBClusterSnapshotAttribute_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-2014-10-31/DBClusterSnapshotAttribute) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DBClusterSnapshotAttribute) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DBClusterSnapshotAttribute) 

# DBClusterSnapshotAttributesResult
<a name="API_DBClusterSnapshotAttributesResult"></a>

Informazioni dettagliate sugli attributi associati a un'istantanea del cluster.

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

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

 ** DBClusterSnapshotAttributes.DBClusterSnapshotAttribute.N **   
L'elenco di attributi e valori per l'istantanea del cluster.  
Tipo: matrice di oggetti [DBClusterSnapshotAttribute](API_DBClusterSnapshotAttribute.md)  
Campo obbligatorio: no

 ** DBClusterSnapshotIdentifier **   
L'identificatore dello snapshot del cluster a cui si applicano gli attributi.  
Tipo: string  
Campo obbligatorio: no

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

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

# DBEngineVersion
<a name="API_DBEngineVersion"></a>

 Informazioni dettagliate sulla versione del motore. 

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

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

 ** DBEngineDescription **   
La descrizione del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** DBEngineVersionDescription **   
La descrizione della versione del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** DBParameterGroupFamily **   
Il nome della famiglia di gruppi di parametri per il motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** Engine **   
Il nome del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** EngineVersion **   
Il numero di versione del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** ExportableLogTypes.member.N **   
I tipi di log che il motore di database ha a disposizione per l'esportazione in Amazon CloudWatch Logs.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** ServerlessV2FeaturesSupport **   
Speciifica eventuali proprietà o limiti di Amazon DocumentDB Serverless che differiscono tra le versioni del motore di Amazon DocumentDB. Puoi testare i valori di questo attributo quando decidi quale versione di Amazon DocumentDB utilizzare in un cluster nuovo o aggiornato. Puoi anche recuperare la versione di un cluster esistente e verificare se tale versione supporta determinate funzionalità di Amazon DocumentDB Serverless prima di provare a utilizzare tali funzionalità.  
Tipo: oggetto [ServerlessV2FeaturesSupport](API_ServerlessV2FeaturesSupport.md)  
Campo obbligatorio: no

 ** SupportedCACertificateIdentifiers.member.N **   
Un elenco degli identificatori di certificato CA supportati.  
*Per ulteriori informazioni, consulta [Updating your Amazon DocumentDB TLS Certificates](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) and [Encrypting Data in Transit nella](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) Amazon DocumentDB Developer Guide.*  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** SupportsCertificateRotationWithoutRestart **   
Indica se la versione del motore supporta la rotazione del certificato del server senza riavviare l'istanza DB.  
Tipo: Booleano  
Campo obbligatorio: no

 ** SupportsLogExportsToCloudwatchLogs **   
Un valore che indica se la versione del motore supporta l'esportazione dei tipi di log specificati da to Logs. `ExportableLogTypes` CloudWatch   
Tipo: Booleano  
Campo obbligatorio: no

 ** ValidUpgradeTarget.UpgradeTarget.N **   
Un elenco di versioni dei motori alle quali questa versione del motore di database può essere aggiornata.  
Tipo: matrice di oggetti [UpgradeTarget](API_UpgradeTarget.md)  
Campo obbligatorio: no

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

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

# DBInstance
<a name="API_DBInstance"></a>

Informazioni dettagliate su un'istanza. 

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

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

 ** AutoMinorVersionUpgrade **   
Non si applica. Questo parametro non si applica ad Amazon DocumentDB. Amazon DocumentDB non esegue aggiornamenti di versione secondari indipendentemente dal valore impostato.  
Tipo: Booleano  
Campo obbligatorio: no

 ** AvailabilityZone **   
Speciifica il nome della zona di disponibilità in cui si trova l'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** BackupRetentionPeriod **   
Speciifica il numero di giorni per i quali vengono conservate le istantanee automatiche.  
Tipo: integer  
Campo obbligatorio: no

 ** CACertificateIdentifier **   
Identificatore del certificato CA per questa istanza database.  
Tipo: string  
Campo obbligatorio: no

 ** CertificateDetails **   
I dettagli del certificato del server dell'istanza DB.  
Tipo: oggetto [CertificateDetails](API_CertificateDetails.md)  
Campo obbligatorio: no

 ** CopyTagsToSnapshot **   
Un valore che indica se copiare i tag dall'istanza database sugli snapshot dell'istanza database. Per impostazione predefinita i tag non vengono copiati.  
Tipo: Booleano  
Campo obbligatorio: no

 ** DBClusterIdentifier **   
Contiene il nome del cluster di cui l'istanza fa parte se l'istanza è membro di un cluster.  
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceArn **   
Il nome della risorsa Amazon (ARN) per l'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceClass **   
Contiene il nome della classe di capacità di calcolo e memoria dell'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceIdentifier **   
Contiene un identificatore di database fornito dall'utente. Questo identificatore è la chiave univoca che identifica un'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceStatus **   
Specifica lo stato corrente di questo database.  
Tipo: string  
Campo obbligatorio: no

 ** DbiResourceId **   
L'identificatore Regione AWS-unique e immutabile dell'istanza. Questo identificatore si trova nelle voci di AWS CloudTrail registro ogni volta che si accede alla AWS KMS chiave dell'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** DBSubnetGroup **   
Speciifica le informazioni sul gruppo di sottoreti associato all'istanza, inclusi il nome, la descrizione e le sottoreti del gruppo di sottoreti.  
Tipo: oggetto [DBSubnetGroup](API_DBSubnetGroup.md)  
Campo obbligatorio: no

 ** EnabledCloudwatchLogsExports.member.N **   
Un elenco di tipi di log che questa istanza è configurata per esportare in Logs. CloudWatch   
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** Endpoint **   
Specifica l'endpoint di connessione.  
Tipo: oggetto [Endpoint](API_Endpoint.md)  
Campo obbligatorio: no

 ** Engine **   
Fornisce il nome del motore di database da utilizzare per questa istanza.  
Tipo: string  
Campo obbligatorio: no

 ** EngineVersion **   
Indica la versione del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** InstanceCreateTime **   
Fornisce la data e l'ora di creazione dell'istanza.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** KmsKeyId **   
 In caso `StorageEncrypted` `true` affermativo, l'identificatore della AWS KMS chiave per l'istanza crittografata.   
Tipo: string  
Campo obbligatorio: no

 ** LatestRestorableTime **   
Speciifica l'ora più recente in cui un database può essere ripristinato con point-in-time restore.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** PendingModifiedValues **   
Speciifica che le modifiche all'istanza sono in sospeso. Questo elemento è incluso solo quando le modifiche sono in sospeso. Le modifiche specifiche sono identificate dagli elementi secondari.  
Tipo: oggetto [PendingModifiedValues](API_PendingModifiedValues.md)  
Campo obbligatorio: no

 ** PerformanceInsightsEnabled **   
Imposta `true` se Amazon RDS Performance Insights è abilitato per l'istanza DB e in altro modo`false`.  
Tipo: Booleano  
Campo obbligatorio: no

 ** PerformanceInsightsKMSKeyId **   
L'identificatore AWS KMS chiave per la crittografia dei dati di Performance Insights. L'ID della AWS KMS chiave è l'Amazon Resource Name (ARN), l'identificatore della AWS KMS chiave o l'alias della AWS KMS chiave di crittografia. AWS KMS   
Tipo: string  
Campo obbligatorio: no

 ** PreferredBackupWindow **   
 Specifica l'intervallo di tempo giornaliero in cui vengono creati i backup automatici se questi sono abilitati, come determinato da `BackupRetentionPeriod`.   
Tipo: string  
Campo obbligatorio: no

 ** PreferredMaintenanceWindow **   
Specifica un intervallo temporale settimanale nel fuso orario UTC (Universal Coordinated Time) durante il quale può verificarsi la manutenzione dei sistemi.  
Tipo: string  
Campo obbligatorio: no

 ** PromotionTier **   
Un valore che specifica l'ordine in cui una replica di Amazon DocumentDB viene promossa all'istanza principale dopo un errore dell'istanza primaria esistente.  
Tipo: integer  
Campo obbligatorio: no

 ** PubliclyAccessible **   
Non supportato. Amazon DocumentDB attualmente non supporta endpoint pubblici. Il valore di `PubliclyAccessible` è sempre. `false`  
Tipo: Booleano  
Campo obbligatorio: no

 ** StatusInfos.DBInstanceStatusInfo.N **   
Lo stato di una replica letta. Se l'istanza non è una replica letta, questo campo è vuoto.  
Tipo: matrice di oggetti [DBInstanceStatusInfo](API_DBInstanceStatusInfo.md)  
Campo obbligatorio: no

 ** StorageEncrypted **   
Speciifica se l'istanza è crittografata o meno.  
Tipo: Booleano  
Campo obbligatorio: no

 ** VpcSecurityGroups.VpcSecurityGroupMembership.N **   
Fornisce un elenco di elementi del gruppo di sicurezza VPC a cui appartiene l'istanza.  
Tipo: matrice di oggetti [VpcSecurityGroupMembership](API_VpcSecurityGroupMembership.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_DBInstance_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-2014-10-31/DBInstance) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DBInstance) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DBInstance) 

# DBInstanceStatusInfo
<a name="API_DBInstanceStatusInfo"></a>

Fornisce un elenco di informazioni sullo stato di un'istanza.

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

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

 ** Message **   
Dettagli dell'errore in caso di errore per l'istanza. Se l'istanza non è in stato di errore, il valore è vuoto.  
Tipo: string  
Campo obbligatorio: no

 ** Normal **   
Un valore booleano che indica `true` se l'istanza funziona normalmente o `false` se si trova in uno stato di errore.  
Tipo: Booleano  
Campo obbligatorio: no

 ** Status **   
Stato dell'istanza. Per una `StatusType` replica già letta, i valori possono essere`replicating`, error`stopped`, o`terminated`.  
Tipo: string  
Campo obbligatorio: no

 ** StatusType **   
Questo valore è attualmente "`read replication`.»  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_DBInstanceStatusInfo_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-2014-10-31/DBInstanceStatusInfo) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DBInstanceStatusInfo) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DBInstanceStatusInfo) 

# DBSubnetGroup
<a name="API_DBSubnetGroup"></a>

Informazioni dettagliate su un gruppo di sottoreti. 

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

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

 ** DBSubnetGroupArn **   
Amazon Resource Name (ARN) per il gruppo di sottoreti di database.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DBSubnetGroupDescription **   
Fornisce la descrizione del gruppo di sottoreti.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** DBSubnetGroupName **   
Il nome del gruppo di sottoreti.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** SubnetGroupStatus **   
Fornisce lo stato del gruppo di sottoreti.  
▬Tipo: stringa  
Campo obbligatorio: no

 ** Subnets.Subnet.N **   
Informazioni dettagliate su una o più sottoreti all'interno di un gruppo di sottoreti.  
Tipo: matrice di oggetti [Subnet](API_Subnet.md)  
Campo obbligatorio: no

 ** SupportedNetworkTypes.member.N **   
Il tipo di rete del gruppo di sottoreti DB.  
Valori validi: `IPV4` \$1 `DUAL`   
A `DBSubnetGroup` può supportare solo il IPv4 protocollo o i IPv6 protocolli IPv4 and (DUAL).  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** VpcId **   
Fornisce l'ID del cloud privato virtuale (VPC) del gruppo di sottoreti.  
▬Tipo: stringa  
Campo obbligatorio: no

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

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

# Endpoint
<a name="API_Endpoint"></a>

Informazioni di rete per accedere a un cluster o a un'istanza. I programmi client devono specificare un endpoint valido per accedere a queste risorse Amazon DocumentDB.

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

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

 ** Address **   
Speciifica l'indirizzo DNS dell'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** HostedZoneId **   
Specifica l'ID che Amazon Route 53 assegna al momento della creazione di una zona ospitata.  
Tipo: string  
Campo obbligatorio: no

 ** Port **   
Specifica la porta su cui è in ascolto il motore di database.  
Tipo: integer  
Campo obbligatorio: no

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

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

# EngineDefaults
<a name="API_EngineDefaults"></a>

Contiene il risultato di una chiamata riuscita dell'`DescribeEngineDefaultClusterParameters`operazione. 

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

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

 ** DBParameterGroupFamily **   
Il nome della famiglia del gruppo di parametri del cluster per cui restituire le informazioni sui parametri del motore.  
Tipo: string  
Campo obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: string  
Campo obbligatorio: no

 ** Parameters.Parameter.N **   
I parametri di una particolare famiglia di gruppi di parametri del cluster.  
Tipo: matrice di oggetti [Parameter](API_Parameter.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_EngineDefaults_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-2014-10-31/EngineDefaults) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/EngineDefaults) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/EngineDefaults) 

# Event
<a name="API_Event"></a>

Informazioni dettagliate su un evento.

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

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

 ** Date **   
Specifica la data e l'ora dell'evento.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** EventCategories.EventCategory.N **   
Specifica la categoria per l'evento.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** Message **   
Fornisce il testo di questo evento.  
Tipo: string  
Campo obbligatorio: no

 ** SourceArn **   
L'Amazon Resource Name (ARN) per l'evento.  
Tipo: string  
Campo obbligatorio: no

 ** SourceIdentifier **   
Fornisce l'identificatore per l'origine dell'evento.  
Tipo: string  
Campo obbligatorio: no

 ** SourceType **   
Specifica il tipo di origine per questo evento.  
Tipo: stringa  
Valori validi: `db-instance | db-parameter-group | db-security-group | db-snapshot | db-cluster | db-cluster-snapshot`   
Campo obbligatorio: no

## Vedi anche
<a name="API_Event_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-2014-10-31/Event) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/Event) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/Event) 

# EventCategoriesMap
<a name="API_EventCategoriesMap"></a>

Un tipo di origine di eventi, accompagnato da uno o più nomi di categorie di eventi.

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

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

 ** EventCategories.EventCategory.N **   
Le categorie di eventi per il tipo di sorgente specificato.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** SourceType **   
Il tipo di origine a cui appartengono le categorie restituite.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_EventCategoriesMap_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-2014-10-31/EventCategoriesMap) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/EventCategoriesMap) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/EventCategoriesMap) 

# EventSubscription
<a name="API_EventSubscription"></a>

Informazioni dettagliate su un evento a cui ti sei iscritto.

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

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

 ** CustomerAwsId **   
L'account AWS cliente associato all'abbonamento per la notifica degli eventi di Amazon DocumentDB.  
Tipo: string  
Campo obbligatorio: no

 ** CustSubscriptionId **   
L'ID di sottoscrizione alla notifica degli eventi di Amazon DocumentDB.  
Tipo: string  
Campo obbligatorio: no

 ** Enabled **   
Un valore booleano che indica se l'abbonamento è abilitato. Il valore di `true` indica che l'abbonamento è abilitato.  
Tipo: Booleano  
Campo obbligatorio: no

 ** EventCategoriesList.EventCategory.N **   
Un elenco di categorie di eventi per l'abbonamento alle notifiche di eventi di Amazon DocumentDB.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** EventSubscriptionArn **   
L'Amazon Resource Name (ARN) per la sottoscrizione all'evento.  
Tipo: string  
Campo obbligatorio: no

 ** SnsTopicArn **   
L'argomento ARN dell'abbonamento per la notifica degli eventi di Amazon DocumentDB.  
Tipo: string  
Campo obbligatorio: no

 ** SourceIdsList.SourceId.N **   
Un elenco di sorgenti IDs per l'abbonamento alla notifica di eventi di Amazon DocumentDB.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** SourceType **   
Il tipo di sorgente per l'abbonamento alla notifica degli eventi di Amazon DocumentDB.  
Tipo: string  
Campo obbligatorio: no

 ** Status **   
Lo stato dell'abbonamento per la notifica degli eventi di Amazon DocumentDB.  
Vincoli:  
Può essere uno dei seguenti:`creating`,`modifying`,`deleting`,`active`, `no-permission` `topic-not-exist`   
Lo `no-permission` stato indica che Amazon DocumentDB non è più autorizzato a pubblicare post sull'argomento SNS. Lo `topic-not-exist` stato indica che l'argomento è stato eliminato dopo la creazione dell'abbonamento.  
Tipo: string  
Campo obbligatorio: no

 ** SubscriptionCreationTime **   
L'ora in cui è stato creato l'abbonamento per la notifica degli eventi di Amazon DocumentDB.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_EventSubscription_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-2014-10-31/EventSubscription) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/EventSubscription) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/EventSubscription) 

# FailoverState
<a name="API_FailoverState"></a>

Contiene lo stato delle operazioni pianificate o in corso su un cluster globale Amazon DocumentDB. Questo tipo di dati è vuoto a meno che non sia pianificata o in corso un'operazione di switchover o failover sul cluster globale.

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

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

 ** FromDbClusterArn **   
L'Amazon Resource Name (ARN) del cluster Amazon DocumentDB attualmente in fase di retrocessione e associato a questo stato.  
▬Tipo: stringa  
Obbligatorio: no

 ** IsDataLossAllowed **   
Indica se l'operazione è uno switchover globale o un failover globale. Se è consentita la perdita di dati, l'operazione è un failover globale. Altrimenti, si tratta di un passaggio.  
Tipo: Booleano  
Obbligatorio: no

 ** Status **   
Lo stato attuale del cluster globale. I valori possibili sono i seguenti:  
+  **in sospeso**: il servizio ha ricevuto una richiesta di commutazione o failover del cluster globale. Il cluster primario del cluster globale e il cluster secondario specificato vengono verificati prima dell'inizio dell'operazione.
+  **failing-over**: il cluster secondario scelto viene promosso a nuovo cluster primario per il quale eseguire il failover del cluster globale.
+  **annullamento**: la richiesta di commutazione o failover del cluster globale è stata annullata e il cluster primario e il cluster secondario selezionato tornano allo stato precedente.
Tipo: String  
Valori validi: `pending | failing-over | cancelling`   
Campo obbligatorio: no

 ** ToDbClusterArn **   
L'Amazon Resource Name (ARN) del cluster Amazon DocumentDB attualmente promosso e associato a questo stato.  
▬Tipo: stringa  
Obbligatorio: no

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

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

# Filter
<a name="API_Filter"></a>

Un set denominato di valori di filtro, utilizzato per restituire un elenco di risultati più specifico. È possibile utilizzare un filtro per abbinare un insieme di risorse in base a criteri specifici, ad esempio IDs.

I caratteri jolly non sono supportati nei filtri.

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

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

 ** Name **   
Il nome del filtro. I nomi dei filtri distinguono tra maiuscole e minuscole  
Tipo: stringa  
Campo obbligatorio: sì

 ** Values.Value.N **   
Uno o più valori di filtro. I valori di filtro fanno distinzione tra maiuscole e minuscole.  
Tipo: matrice di stringhe  
Campo obbligatorio: sì

## Vedi anche
<a name="API_Filter_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-2014-10-31/Filter) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/Filter) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/Filter) 

# GlobalCluster
<a name="API_GlobalCluster"></a>

Un tipo di dati che rappresenta un cluster globale Amazon DocumentDB.

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

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

 ** DatabaseName **   
Il nome del database predefinito all'interno del nuovo cluster globale.  
▬Tipo: stringa  
Obbligatorio: no

 ** DeletionProtection **   
L'impostazione di protezione dall'eliminazione per il nuovo cluster globale.  
Tipo: Booleano  
Obbligatorio: no

 ** Engine **   
Il motore di database Amazon DocumentDB utilizzato dal cluster globale.   
▬Tipo: stringa  
Obbligatorio: no

 ** EngineVersion **   
Indica la versione del motore di database.  
▬Tipo: stringa  
Obbligatorio: no

 ** FailoverState **   
Un oggetto di dati contenente tutte le proprietà relative allo stato corrente di un processo di switchover o failover in corso o in sospeso per questo cluster globale. Questo oggetto è vuoto a meno che l'`FailoverGlobalCluster`operazione `SwitchoverGlobalCluster` or non sia stata chiamata su questo cluster globale.  
Tipo: oggetto [FailoverState](API_FailoverState.md)  
Obbligatorio: no

 ** GlobalClusterArn **   
L'Amazon Resource Name (ARN) per il cluster globale.  
▬Tipo: stringa  
Obbligatorio: no

 ** GlobalClusterIdentifier **   
Contiene un identificatore globale del cluster fornito dall'utente. Questo identificatore è la chiave univoca che identifica un cluster globale.   
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.  
Modello: `[A-Za-z][0-9A-Za-z-:._]*`   
Obbligatorio: no

 ** GlobalClusterMembers.GlobalClusterMember.N **   
L'elenco dei cluster IDs per i cluster secondari all'interno del cluster globale. Attualmente limitato a un articolo.   
Tipo: matrice di oggetti [GlobalClusterMember](API_GlobalClusterMember.md)  
Obbligatorio: no

 ** GlobalClusterResourceId **   
L'identificatore Regione AWS unico e immutabile della regione per il cluster di database globale. Questo identificatore si trova nelle voci di AWS CloudTrail registro ogni volta che si accede alla chiave master del AWS KMS cliente (CMK) per il cluster.   
▬Tipo: stringa  
Obbligatorio: no

 ** Status **   
Specifica lo stato corrente di questo cluster globale.  
▬Tipo: stringa  
Obbligatorio: no

 ** StorageEncrypted **   
L'impostazione di crittografia dell'archiviazione per il cluster globale.  
Tipo: Booleano  
Obbligatorio: no

 ** TagList.Tag.N **   
Un elenco di tag del cluster globale.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Campo obbligatorio: no

## Vedi anche
<a name="API_GlobalCluster_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-2014-10-31/GlobalCluster) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/GlobalCluster) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/GlobalCluster) 

# GlobalClusterMember
<a name="API_GlobalClusterMember"></a>

Una struttura di dati con informazioni su qualsiasi cluster primario e secondario associato a un cluster globale di Amazon DocumentDB. 

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

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

 ** DBClusterArn **   
L'Amazon Resource Name (ARN) per ogni cluster Amazon DocumentDB.  
▬Tipo: stringa  
Obbligatorio: no

 ** IsWriter **   
 Speciifica se il cluster Amazon DocumentDB è il cluster principale (ovvero ha funzionalità di lettura/scrittura) per il cluster globale Amazon DocumentDB a cui è associato.   
Tipo: Booleano  
Obbligatorio: no

 ** Readers.member.N **   
L'Amazon Resource Name (ARN) per ogni cluster secondario di sola lettura associato al cluster globale Amazon DocumentDB.  
Tipo: array di stringhe  
Obbligatorio: no

 ** SynchronizationStatus **   
Lo stato di sincronizzazione di ogni cluster Amazon DocumentDB nel cluster globale.  
Tipo: String  
Valori validi: `connected | pending-resync`   
Campo obbligatorio: no

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

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

# OrderableDBInstanceOption
<a name="API_OrderableDBInstanceOption"></a>

Le opzioni disponibili per un'istanza.

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

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

 ** AvailabilityZones.AvailabilityZone.N **   
Un elenco di zone di disponibilità per un'istanza.  
Tipo: matrice di oggetti [AvailabilityZone](API_AvailabilityZone.md)  
Campo obbligatorio: no

 ** DBInstanceClass **   
La classe di istanza per un'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** Engine **   
Il tipo di motore di un'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** EngineVersion **   
La versione del motore di un'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** LicenseModel **   
Il modello di licenza per un'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** StorageType **   
Il tipo di archiviazione da associare al cluster DB  
Tipo: string  
Campo obbligatorio: no

 ** Vpc **   
Indica se un'istanza si trova in un cloud privato virtuale (VPC).  
Tipo: Booleano  
Campo obbligatorio: no

## Vedi anche
<a name="API_OrderableDBInstanceOption_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-2014-10-31/OrderableDBInstanceOption) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/OrderableDBInstanceOption) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/OrderableDBInstanceOption) 

# Parameter
<a name="API_Parameter"></a>

Informazioni dettagliate su un singolo parametro.

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

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

 ** AllowedValues **   
Specifica l'intervallo valido di valori per il parametro.  
Tipo: string  
Campo obbligatorio: no

 ** ApplyMethod **   
Indica quando applicare gli aggiornamenti dei parametri.  
Tipo: stringa  
Valori validi: `immediate | pending-reboot`   
Campo obbligatorio: no

 ** ApplyType **   
Specificate il tipo di parametri specifici del motore.  
Tipo: string  
Campo obbligatorio: no

 ** DataType **   
Specifica il tipo di dati valido per il parametro.  
Tipo: string  
Campo obbligatorio: no

 ** Description **   
Fornisce una descrizione del parametro.  
Tipo: string  
Campo obbligatorio: no

 ** IsModifiable **   
 Indica se il parametro può essere modificato (`true`) o meno (`false`). Alcuni parametri presentano implicazioni operative o di sicurezza che evitano la loro modifica.   
Tipo: Booleano  
Campo obbligatorio: no

 ** MinimumEngineVersion **   
La prima versione del motore sulla quale si può applicare il parametro.  
Tipo: string  
Campo obbligatorio: no

 ** ParameterName **   
Specifica il nome del parametro.  
Tipo: string  
Campo obbligatorio: no

 ** ParameterValue **   
Specifica il valore del parametro. Deve essere uno o più parametri del cluster in formato CSV: `AllowedValues`  
I valori validi sono:  
+  `enabled`: Il cluster accetta connessioni sicure utilizzando TLS dalla versione 1.0 alla 1.3. 
+  `disabled`: Il cluster non accetta connessioni sicure tramite TLS. 
+  `fips-140-3`: Il cluster accetta solo connessioni sicure in base ai requisiti della pubblicazione 140-3 degli standard federali di elaborazione delle informazioni (FIPS). Supportato solo a partire dai cluster Amazon DocumentDB 5.0 (versione del motore 3.0.3727) in queste regioni: ca-central-1, us-west-2, us-east-1, us-east-2, -1. us-gov-east us-gov-west
+  `tls1.2+`: Il cluster accetta connessioni sicure utilizzando TLS versione 1.2 e successive. Supportato solo a partire da Amazon DocumentDB 4.0 (versione del motore 2.0.10980) e Amazon DocumentDB 5.0 (versione del motore 3.0.11051).
+  `tls1.3+`: Il cluster accetta connessioni sicure utilizzando TLS versione 1.3 e successive. Supportato solo a partire da Amazon DocumentDB 4.0 (versione del motore 2.0.10980) e Amazon DocumentDB 5.0 (versione del motore 3.0.11051).
Tipo: string  
Campo obbligatorio: no

 ** Source **   
Indica l'origine del valore del parametro.  
Tipo: string  
Campo obbligatorio: no

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

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

# PendingCloudwatchLogsExports
<a name="API_PendingCloudwatchLogsExports"></a>

Elenco dei tipi di log la cui configurazione è ancora in sospeso. Questi tipi di registro sono in fase di attivazione o disattivazione.

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

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

 ** LogTypesToDisable.member.N **   
Tipi di log in fase di abilitazione. Una volta abilitati, questi tipi di log vengono esportati in Amazon CloudWatch Logs.  
Tipo: matrice di stringhe  
Campo obbligatorio: no

 ** LogTypesToEnable.member.N **   
Tipi di log in fase di disattivazione. Dopo la disattivazione, questi tipi di log non vengono esportati in Logs. CloudWatch   
Tipo: matrice di stringhe  
Campo obbligatorio: no

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

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

# PendingMaintenanceAction
<a name="API_PendingMaintenanceAction"></a>

Fornisce informazioni su un'operazione di manutenzione in sospeso per una risorsa.

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

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

 ** Action **   
Il tipo di operazione di manutenzione in sospeso che è disponibile per la risorsa.  
Tipo: string  
Campo obbligatorio: no

 ** AutoAppliedAfterDate **   
La data della finestra di manutenzione quando l'operazione viene applicata. L'operazione di manutenzione viene applicata alla risorsa durante la prima finestra di manutenzione dopo questa data. Se questa data è specificata, qualsiasi richiesta di consenso esplicito `next-maintenance` viene ignorata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** CurrentApplyDate **   
La data di validità quando l'operazione di manutenzione in sospeso viene applicata alla risorsa.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** Description **   
Una descrizione che fornisce dettagli sull'operazione di manutenzione.  
Tipo: string  
Campo obbligatorio: no

 ** ForcedApplyDate **   
La data quando l'operazione di manutenzione viene applicata automaticamente. L'operazione di manutenzione viene applicata alla risorsa in questa data indipendentemente dalla finestra di manutenzione per la risorsa. Se questa data è specificata, qualsiasi richiesta di consenso esplicito `immediate` viene ignorata.  
Tipo: Timestamp  
Campo obbligatorio: no

 ** OptInStatus **   
Indica il tipo di richiesta di consenso esplicito che è stata ricevuta per la risorsa.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_PendingMaintenanceAction_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-2014-10-31/PendingMaintenanceAction) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/PendingMaintenanceAction) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/PendingMaintenanceAction) 

# PendingModifiedValues
<a name="API_PendingModifiedValues"></a>

 Una o più impostazioni modificate per un'istanza. Queste impostazioni modificate sono state richieste, ma non sono ancora state applicate.

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

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

 ** AllocatedStorage **   
 Contiene la nuova `AllocatedStorage` dimensione per l'istanza che verrà applicata o che è attualmente applicata.   
Tipo: integer  
Campo obbligatorio: no

 ** BackupRetentionPeriod **   
Specifica il numero di giorni in sospeso durante i quali vengono conservati i backup automatici.  
Tipo: integer  
Campo obbligatorio: no

 ** CACertificateIdentifier **   
Speciifica l'identificatore del certificato dell'autorità di certificazione (CA) per l'istanza DB.  
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceClass **   
 Contiene il nuovo codice `DBInstanceClass` per l'istanza che verrà applicata o che è attualmente applicata.   
Tipo: string  
Campo obbligatorio: no

 ** DBInstanceIdentifier **   
 Contiene il nuovo `DBInstanceIdentifier` elemento relativo all'istanza che verrà applicata o è attualmente applicata.   
Tipo: string  
Campo obbligatorio: no

 ** DBSubnetGroupName **   
Il nuovo gruppo di sottoreti per l'istanza.   
Tipo: string  
Campo obbligatorio: no

 ** EngineVersion **   
Indica la versione del motore di database.  
Tipo: string  
Campo obbligatorio: no

 ** Iops **   
Speciifica il nuovo valore Provisioned IOPS per l'istanza che verrà applicata o è attualmente applicata.  
Tipo: integer  
Campo obbligatorio: no

 ** LicenseModel **   
Il modello di licenza per l'istanza.  
Valori validi: `license-included`, `bring-your-own-license`, `general-public-license`   
Tipo: string  
Campo obbligatorio: no

 ** MasterUserPassword **   
Contiene la modifica in sospeso o attualmente in corso delle credenziali principali per l'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** MultiAZ **   
Indica che l'istanza Single-AZ deve passare a una distribuzione Multi-AZ.  
Tipo: Booleano  
Campo obbligatorio: no

 ** PendingCloudwatchLogsExports **   
Elenco dei tipi di log la cui configurazione è ancora in sospeso. Questi tipi di registro sono in fase di attivazione o disattivazione.  
Tipo: oggetto [PendingCloudwatchLogsExports](API_PendingCloudwatchLogsExports.md)  
Campo obbligatorio: no

 ** Port **   
Speciifica la porta in sospeso per l'istanza.  
Tipo: integer  
Campo obbligatorio: no

 ** StorageType **   
Speciifica il tipo di archiviazione da associare all'istanza.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_PendingModifiedValues_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-2014-10-31/PendingModifiedValues) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/PendingModifiedValues) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/PendingModifiedValues) 

# ResourcePendingMaintenanceActions
<a name="API_ResourcePendingMaintenanceActions"></a>

Rappresenta l'output di[ApplyPendingMaintenanceAction](API_ApplyPendingMaintenanceAction.md). 

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

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

 ** PendingMaintenanceActionDetails.PendingMaintenanceAction.N **   
Un elenco che fornisce i dettagli sulle operazioni di manutenzione in sospeso per la risorsa.  
Tipo: matrice di oggetti [PendingMaintenanceAction](API_PendingMaintenanceAction.md)  
Campo obbligatorio: no

 ** ResourceIdentifier **   
L'Amazon Resource Name (ARN) della risorsa con azioni di manutenzione in sospeso.  
Tipo: string  
Campo obbligatorio: no

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

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

# ServerlessV2FeaturesSupport
<a name="API_ServerlessV2FeaturesSupport"></a>

Speciifica eventuali proprietà o limiti di Amazon DocumentDB Serverless che differiscono tra le versioni del motore di Amazon DocumentDB. Puoi testare i valori di questo attributo quando decidi quale versione di Amazon DocumentDB utilizzare in un cluster nuovo o aggiornato. Puoi anche recuperare la versione di un cluster esistente e verificare se tale versione supporta determinate funzionalità di Amazon DocumentDB Serverless prima di provare a utilizzare tali funzionalità.

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

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

 ** MaxCapacity **   
Il numero massimo di unità di capacità di Amazon DocumentDB (DCUs) per un'istanza in un cluster Amazon DocumentDB Serverless. È possibile specificare i valori DCU in incrementi di mezzo passaggio, ad esempio 32, 32,5, 33 e così via.  
Tipo: double  
Campo obbligatorio: no

 ** MinCapacity **   
Il numero minimo di unità di capacità di Amazon DocumentDB (DCUs) per un'istanza in un cluster Amazon DocumentDB Serverless. È possibile specificare i valori DCU in incrementi di mezzo passaggio, ad esempio 8, 8,5, 9 e così via.  
Tipo: double  
Campo obbligatorio: no

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

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

# ServerlessV2ScalingConfiguration
<a name="API_ServerlessV2ScalingConfiguration"></a>

Imposta la configurazione di scalabilità di un cluster Amazon DocumentDB Serverless.

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

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

 ** MaxCapacity **   
Il numero massimo di unità di capacità di Amazon DocumentDB (DCUs) per un'istanza in un cluster Amazon DocumentDB Serverless. È possibile specificare i valori DCU in incrementi di mezzo passaggio, ad esempio 32, 32,5, 33 e così via.  
Tipo: double  
Campo obbligatorio: no

 ** MinCapacity **   
Il numero minimo di unità di capacità di Amazon DocumentDB (DCUs) per un'istanza in un cluster Amazon DocumentDB Serverless. È possibile specificare i valori DCU in incrementi di mezzo passaggio, ad esempio 8, 8,5, 9 e così via.  
Tipo: double  
Campo obbligatorio: no

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

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

# ServerlessV2ScalingConfigurationInfo
<a name="API_ServerlessV2ScalingConfigurationInfo"></a>

Recupera la configurazione di scalabilità per un cluster Amazon DocumentDB Serverless.

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

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

 ** MaxCapacity **   
Il numero massimo di unità di capacità di Amazon DocumentDB (DCUs) per un'istanza in un cluster Amazon DocumentDB Serverless. È possibile specificare i valori DCU in incrementi di mezzo passaggio, ad esempio 32, 32,5, 33 e così via.   
Tipo: double  
Campo obbligatorio: no

 ** MinCapacity **   
Il numero minimo di unità di capacità di Amazon DocumentDB (DCUs) per un'istanza in un cluster Amazon DocumentDB Serverless. È possibile specificare i valori DCU in incrementi di mezzo passaggio, ad esempio 8, 8,5, 9 e così via.  
Tipo: double  
Campo obbligatorio: no

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

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

# Subnet
<a name="API_Subnet"></a>

 Informazioni dettagliate su una sottorete. 

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

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

 ** SubnetAvailabilityZone **   
Speciifica la zona di disponibilità per la sottorete.  
Tipo: oggetto [AvailabilityZone](API_AvailabilityZone.md)  
Campo obbligatorio: no

 ** SubnetIdentifier **   
Specifica l'identificatore della sottorete.  
Tipo: string  
Campo obbligatorio: no

 ** SubnetStatus **   
Specifica lo stato della sottorete.  
Tipo: string  
Campo obbligatorio: no

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

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

# Tag
<a name="API_Tag"></a>

Metadati assegnati a una risorsa Amazon DocumentDB costituiti da una coppia chiave-valore.

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

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

 ** Key **   
Il nome richiesto del tag. Il valore della stringa può avere una lunghezza compresa tra 1 e 128 caratteri Unicode e non può essere preceduto da "" o `aws:` "»`rds:`. La stringa può contenere solo l'insieme di lettere Unicode, cifre, spazi bianchi, '\$1', ' . ','/',' = ',' \$1 ',' - '(espressione regolare Java: «^ ([\$1\$1 p \$1L\$1\$1\$1 p \$1Z\$1\$1\$1 p \$1N\$1 \$1.: /=\$1\$1\$1 -] \$1) \$1»).).  
Tipo: string  
Campo obbligatorio: no

 ** Value **   
Il valore opzionale del tag. Il valore della stringa può avere una lunghezza compresa tra 1 e 256 caratteri Unicode e non può essere preceduto da "" o `aws:` "»`rds:`. La stringa può contenere solo l'insieme di lettere Unicode, cifre, spazi bianchi, '\$1', ' . ','/',' = ',' \$1 ',' - '(espressione regolare Java: «^ ([\$1\$1 p \$1L\$1\$1\$1 p \$1Z\$1\$1\$1 p \$1N\$1 \$1.: /=\$1\$1\$1 -] \$1) \$1»).).  
Tipo: string  
Campo obbligatorio: no

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

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

# UpgradeTarget
<a name="API_UpgradeTarget"></a>

La versione del motore di database a cui è possibile aggiornare un'istanza.

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

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

 ** AutoUpgrade **   
Un valore che indica se la versione di destinazione viene applicata a qualsiasi istanza DB di origine `AutoMinorVersionUpgrade` impostata su. `true`  
Tipo: Booleano  
Campo obbligatorio: no

 ** Description **   
La versione del motore di database a cui è possibile aggiornare un'istanza.  
Tipo: string  
Campo obbligatorio: no

 ** Engine **   
Il nome del motore di database di destinazione di aggiornamento.  
Tipo: string  
Campo obbligatorio: no

 ** EngineVersion **   
Il numero di versione del motore di database di destinazione di aggiornamento.  
Tipo: string  
Campo obbligatorio: no

 ** IsMajorVersionUpgrade **   
Un valore che indica se un motore di database viene aggiornato a una versione principale.  
Tipo: Booleano  
Campo obbligatorio: no

## Vedi anche
<a name="API_UpgradeTarget_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-2014-10-31/UpgradeTarget) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/UpgradeTarget) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/UpgradeTarget) 

# VpcSecurityGroupMembership
<a name="API_VpcSecurityGroupMembership"></a>

Utilizzato come elemento di risposta per le domande sull'appartenenza al gruppo di sicurezza del cloud privato virtuale (VPC).

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

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

 ** Status **   
Stato del gruppo di sicurezza VPC.  
Tipo: string  
Campo obbligatorio: no

 ** VpcSecurityGroupId **   
Nome del gruppo di sicurezza VPC.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_VpcSecurityGroupMembership_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-2014-10-31/VpcSecurityGroupMembership) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/VpcSecurityGroupMembership) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/VpcSecurityGroupMembership) 

# Cluster elastici Amazon DocumentDB
<a name="API_Types_Amazon_DocumentDB_Elastic_Clusters"></a>

I seguenti tipi di dati sono supportati da Amazon DocumentDB Elastic Clusters:
+  [Cluster](API_elastic_Cluster.md) 
+  [ClusterInList](API_elastic_ClusterInList.md) 
+  [ClusterSnapshot](API_elastic_ClusterSnapshot.md) 
+  [ClusterSnapshotInList](API_elastic_ClusterSnapshotInList.md) 
+  [PendingMaintenanceActionDetails](API_elastic_PendingMaintenanceActionDetails.md) 
+  [ResourcePendingMaintenanceAction](API_elastic_ResourcePendingMaintenanceAction.md) 
+  [Shard](API_elastic_Shard.md) 
+  [ValidationExceptionField](API_elastic_ValidationExceptionField.md) 

# 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) 

# ClusterInList
<a name="API_elastic_ClusterInList"></a>

Un elenco di cluster elastici di Amazon DocumentDB.

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

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

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

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

 ** status **   <a name="documentdb-Type-elastic_ClusterInList-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ì

## Vedi anche
<a name="API_elastic_ClusterInList_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/ClusterInList) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ClusterInList) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ClusterInList) 

# ClusterSnapshot
<a name="API_elastic_ClusterSnapshot"></a>

Restituisce informazioni su uno specifico snapshot del cluster elastico.

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

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

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

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

 ** clusterCreationTime **   <a name="documentdb-Type-elastic_ClusterSnapshot-clusterCreationTime"></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_ClusterSnapshot-kmsKeyId"></a>
L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia KMS. Se stai creando un cluster utilizzando lo stesso account Amazon che possiede questa chiave di crittografia KMS, puoi utilizzare l'alias della chiave KMS anziché l'ARN come chiave di crittografia KMS. Se non viene specificata una chiave di crittografia qui, Amazon DocumentDB utilizza la chiave di crittografia predefinita creata da KMS per il tuo account. Il tuo account ha una chiave di crittografia predefinita diversa per ogni regione Amazon.   
Tipo: stringa  
Campo obbligatorio: sì

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

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

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

 ** status **   <a name="documentdb-Type-elastic_ClusterSnapshot-status"></a>
Lo stato dello snapshot 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_ClusterSnapshot-subnetIds"></a>
La EC2 sottorete Amazon IDs per il cluster elastico.  
Tipo: matrice di stringhe  
Campo obbligatorio: sì

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

 ** snapshotType **   <a name="documentdb-Type-elastic_ClusterSnapshot-snapshotType"></a>
Il tipo di istantanee del cluster da restituire. È possibile specificare uno dei seguenti valori:  
+  `automated`- Restituisci tutte le istantanee del cluster che Amazon DocumentDB ha creato automaticamente per AWS il tuo account.
+  `manual`- Restituisci tutte le istantanee del cluster che hai creato manualmente per il tuo account. AWS 
Tipo: stringa  
Valori validi: `MANUAL | AUTOMATED`   
Campo obbligatorio: no

## Vedi anche
<a name="API_elastic_ClusterSnapshot_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/ClusterSnapshot) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ClusterSnapshot) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ClusterSnapshot) 

# ClusterSnapshotInList
<a name="API_elastic_ClusterSnapshotInList"></a>

Un elenco di istantanee di cluster elastici.

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

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

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

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

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

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

 ** status **   <a name="documentdb-Type-elastic_ClusterSnapshotInList-status"></a>
Lo stato dello snapshot 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ì

## Vedi anche
<a name="API_elastic_ClusterSnapshotInList_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/ClusterSnapshotInList) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ClusterSnapshotInList) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ClusterSnapshotInList) 

# PendingMaintenanceActionDetails
<a name="API_elastic_PendingMaintenanceActionDetails"></a>

Recupera i dettagli delle azioni di manutenzione in sospeso.

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

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

 ** action **   <a name="documentdb-Type-elastic_PendingMaintenanceActionDetails-action"></a>
Visualizza l'azione specifica di un'azione di manutenzione in sospeso.  
Tipo: stringa  
Campo obbligatorio: sì

 ** autoAppliedAfterDate **   <a name="documentdb-Type-elastic_PendingMaintenanceActionDetails-autoAppliedAfterDate"></a>
Visualizza la data della finestra di manutenzione in cui viene applicata l'azione. L'operazione di manutenzione viene applicata alla risorsa durante la prima finestra di manutenzione dopo questa data. Se viene specificata questa data, tutte `NEXT_MAINTENANCE` `optInType` le richieste vengono ignorate.  
Tipo: string  
Campo obbligatorio: no

 ** currentApplyDate **   <a name="documentdb-Type-elastic_PendingMaintenanceActionDetails-currentApplyDate"></a>
Visualizza la data di validità in cui l'azione di manutenzione in sospeso viene applicata alla risorsa.  
Tipo: string  
Campo obbligatorio: no

 ** description **   <a name="documentdb-Type-elastic_PendingMaintenanceActionDetails-description"></a>
Visualizza una descrizione che fornisce maggiori dettagli sull'azione di manutenzione.  
Tipo: string  
Campo obbligatorio: no

 ** forcedApplyDate **   <a name="documentdb-Type-elastic_PendingMaintenanceActionDetails-forcedApplyDate"></a>
Visualizza la data in cui l'azione di manutenzione viene applicata automaticamente. L'operazione di manutenzione viene applicata alla risorsa in questa data indipendentemente dalla finestra di manutenzione per la risorsa. Se viene specificata questa data, tutte `IMMEDIATE` `optInType` le richieste vengono ignorate.  
Tipo: string  
Campo obbligatorio: no

 ** optInStatus **   <a name="documentdb-Type-elastic_PendingMaintenanceActionDetails-optInStatus"></a>
Visualizza il tipo di `optInType` richiesta ricevuta per la risorsa.  
Tipo: string  
Campo obbligatorio: no

## Vedi anche
<a name="API_elastic_PendingMaintenanceActionDetails_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/PendingMaintenanceActionDetails) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/PendingMaintenanceActionDetails) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/PendingMaintenanceActionDetails) 

# ResourcePendingMaintenanceAction
<a name="API_elastic_ResourcePendingMaintenanceAction"></a>

Fornisce informazioni su un'operazione di manutenzione in sospeso per una risorsa.

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

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

 ** pendingMaintenanceActionDetails **   <a name="documentdb-Type-elastic_ResourcePendingMaintenanceAction-pendingMaintenanceActionDetails"></a>
Fornisce informazioni su un'operazione di manutenzione in sospeso per una risorsa.  
Tipo: matrice di oggetti [PendingMaintenanceActionDetails](API_elastic_PendingMaintenanceActionDetails.md)  
Campo obbligatorio: no

 ** resourceArn **   <a name="documentdb-Type-elastic_ResourcePendingMaintenanceAction-resourceArn"></a>
Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso.  
Tipo: string  
Campo obbligatorio: no

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

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

# Shard
<a name="API_elastic_Shard"></a>

Il nome del frammento.

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

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

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

 ** shardId **   <a name="documentdb-Type-elastic_Shard-shardId"></a>
L'ID dello shard.  
Tipo: stringa  
Campo obbligatorio: sì

 ** status **   <a name="documentdb-Type-elastic_Shard-status"></a>
Lo stato attuale dello shard.  
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ì

## Vedi anche
<a name="API_elastic_Shard_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/Shard) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/Shard) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/Shard) 

# ValidationExceptionField
<a name="API_elastic_ValidationExceptionField"></a>

Un campo specifico in cui si è verificata una determinata eccezione di convalida.

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

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

 ** message **   <a name="documentdb-Type-elastic_ValidationExceptionField-message"></a>
Un messaggio di errore che descrive l'eccezione di convalida in questo campo.  
Tipo: stringa  
Campo obbligatorio: sì

 ** name **   <a name="documentdb-Type-elastic_ValidationExceptionField-name"></a>
Il nome del campo in cui si è verificata l'eccezione di convalida.  
Tipo: stringa  
Campo obbligatorio: sì

## Vedi anche
<a name="API_elastic_ValidationExceptionField_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/ValidationExceptionField) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/ValidationExceptionField) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/ValidationExceptionField) 

# Errori comuni
<a name="CommonErrors"></a>

Questa sezione elenca gli errori comuni alle azioni API di tutti i AWS servizi. Per gli errori specifici di un'azione API per questo servizio, consulta l'argomento per quell'azione API.

 **AccessDeniedException**   
Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.  
Codice di stato HTTP: 400

 **IncompleteSignature**   
La firma della richiesta non è conforme agli AWS standard.  
Codice di stato HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
L'elaborazione della richiesta non è riuscita a causa di un errore, un'eccezione o un guasto interno sconosciuto.  
Codice di stato HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
L'azione o l'operazione richiesta non è valida. Verifica che l'operazione sia digitata correttamente.  
Codice di stato HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Il certificato X.509 o AWS l'ID della chiave di accesso fornito non esiste nei nostri archivi.  
Codice di stato HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Non disponi delle autorizzazioni per eseguire questa azione.  
Codice di stato HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
L'ID della chiave di AWS accesso richiede un abbonamento al servizio.  
Codice di stato HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La richiesta ha raggiunto il servizio più di 15 minuti dopo la data indicata sulla richiesta o più di 15 minuti dopo la data di scadenza della richiesta (ad esempio nel caso di pre-firmata URLs), oppure la data indicata sulla richiesta è tra più di 15 minuti.  
Codice di stato HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La richiesta non è riuscita a causa di un errore temporaneo del server.  
Codice di stato HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La richiesta è stata negata a causa del throttling della richiesta.  
Codice di stato HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
L'input non soddisfa i vincoli specificati da un servizio. AWS   
Codice di stato HTTP: 400

# Parametri comuni
<a name="CommonParameters"></a>

L'elenco seguente contiene i parametri utilizzati da tutte le azioni per firmare le richieste di Signature Version 4 con una stringa di query. Qualsiasi parametro specifico di un'operazione è riportato nell'argomento relativo all'operazione. Per ulteriori informazioni sulla versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.

 **Action**   <a name="CommonParameters-Action"></a>
azione da eseguire.  
Tipo: stringa  
Campo obbligatorio: sì

 **Version**   <a name="CommonParameters-Version"></a>
La versione dell'API per cui è scritta la richiesta, espressa nel formato YYYY-MM-DD.  
Tipo: stringa  
Campo obbligatorio: sì

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Algoritmo hash utilizzato per creare la firma della richiesta.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Valori validi: `AWS4-HMAC-SHA256`   
Obbligatorio: condizionale

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Il valore dell'ambito delle credenziali, che è una stringa che include la chiave di accesso, la data, la regione di destinazione, il servizio richiesto e una stringa di terminazione ("aws4\$1request"). Il valore viene espresso nel seguente formato: *chiave\$1accesso*/*AAAAMMGG*/*regione*/*servizio*/aws4\$1request.  
Per ulteriori informazioni, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella *Guida per l'utente IAM*.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La data utilizzata per creare la firma. Il formato deve essere il formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Per esempio, la data e l'ora seguenti è un X-Amz-Date valore valido:`20120325T120000Z`.  
Condizione: X-Amz-Date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato base ISO 8601, non X-Amz-Date è obbligatoria. Quando X-Amz-Date viene utilizzata, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta [Elementi di una firma di richiesta AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) nella Guida per l'utente *IAM*.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service (AWS STS). Per un elenco di servizi che supportano le credenziali di sicurezza temporanee da AWS STS, consulta la pagina [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) nella *Guida per l'utente di IAM*.  
Condizione: se utilizzi credenziali di sicurezza temporanee di AWS STS, devi includere il token di sicurezza.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Specifica la firma con codifica esadecimale calcolata dalla stringa da firmare e dalla chiave di firma derivata.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Specifica tutte le intestazioni HTTP incluse come parte della richiesta canonica. Per ulteriori informazioni sulla specificazione delle intestazioni firmate, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella Guida per l'utente *IAM*.  
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.  
Tipo: stringa  
Obbligatorio: condizionale