

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# API d'instantanés Neptune
<a name="api-snapshots"></a>

**Actions :**
+ [Créer DBCluster un instantané (action)](#CreateDBClusterSnapshot)
+ [Supprimer DBCluster un instantané (action)](#DeleteDBClusterSnapshot)
+ [Copier DBCluster un instantané (action)](#CopyDBClusterSnapshot)
+ [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute)
+ [Restaurer DBCluster FromSnapshot (action)](#RestoreDBClusterFromSnapshot)
+ [Restaurer DBCluster ToPointInTime (action)](#RestoreDBClusterToPointInTime)
+ [Décrire les DBCluster instantanés (action)](#DescribeDBClusterSnapshots)
+ [Décrire DBCluster SnapshotAttributes (action)](#DescribeDBClusterSnapshotAttributes)

**Structures :**
+ [DBClusterInstantané (structure)](#DBClusterSnapshot)
+ [DBClusterSnapshotAttribute (structure)](#DBClusterSnapshotAttribute)
+ [DBClusterSnapshotAttributesResult (structure)](#DBClusterSnapshotAttributesResult)

## Créer DBCluster un instantané (action)
<a name="CreateDBClusterSnapshot"></a>

         Le nom de la AWS CLI pour cette API est :`create-db-cluster-snapshot`.

Crée un instantané d'un cluster de bases de données.

**Demande**
+ **DBClusterIdentifier** (dans la CLI : `--db-cluster-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant du cluster de bases de données pour lequel créer un instantané. Ce paramètre n'est pas sensible à la casse.

  Contraintes :
  + Doit correspondre à l'identifiant d'un existant DBCluster.

  Exemple : `my-cluster1`
+ **DBClusterSnapshotIdentifier** (dans la CLI : `--db-cluster-snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données. Ce paramètre est stocké sous la forme d'une chaîne en lettres minuscules.

  Contraintes :
  + Doit contenir entre 1 et 63 lettres, chiffres ou traits d'union.
  + Le premier caractère doit être une lettre.
  + Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

  Exemple : `my-cluster1-snapshot1`
+ **Tags** (dans la CLI : `--tags`) : tableau d'objets [Tag](api-other-apis.md#Tag).

  Balises à attribuer à l'instantané de cluster de bases de données.

**Réponse**

Contient les détails d'un instantané de cluster de bases de données Amazon Neptune.

Ce type de données est utilisé comme élément de réponse dans l'action [Décrire les DBCluster instantanés (action)](#DescribeDBClusterSnapshots).
+ **AllocatedStorage** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie la taille de stockage allouée en gigaoctets (Gio).
+ **AvailabilityZones** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du snapshot du cluster de base de données peuvent être restaurées.
+ **ClusterCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle le cluster de bases de données a été créé, en heure UTC (Universal Coordinated Time).
+ **DBClusterIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant du cluster de bases de données à partir duquel cet instantané de cluster de bases de données a été créé.
+ **DBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Amazon Resource Name (ARN) de l'instantané de cluster de bases de données.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant d'un instantané de cluster de bases de données. Doit correspondre à l'identifiant d'un instantané existant.

  Après avoir restauré un cluster de bases de données à l'aide d'un `DBClusterSnapshotIdentifier`, vous devez spécifier le même `DBClusterSnapshotIdentifier` pour toute mise à jour ultérieure de ce cluster. Lorsque vous spécifiez cette propriété pour une mise à jour, le cluster de bases de données n'est pas restauré de nouveau à partir de l'instantané, et les données de la base de données ne sont pas modifiées.

  Toutefois, si vous ne spécifiez pas le `DBClusterSnapshotIdentifier`, un cluster de bases de données vide est créé et le cluster de bases de données d'origine est supprimé. Si vous spécifiez une propriété différente de la propriété précédente de restauration d'instantané, le cluster de bases de données est restauré à partir de l'instantané spécifié par le `DBClusterSnapshotIdentifier`, et le cluster de bases de données d'origine est supprimé.
+ **Engine** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le nom du moteur de base de données.
+ **EngineVersion** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la version du moteur de base de données à utiliser pour cet instantané de cluster de bases de données.
+ **IAMDatabaseAuthenticationEnabled** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true (vrai) si le mappage des comptes Amazon Identity and Access Management (IAM) aux comptes de base de données est activé ; sinon, valeur false (faux).
+ **KmsKeyId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si `StorageEncrypted` a la valeur true (vrai), il s'agit de l'identifiant de clé Amazon KMS pour le cluster de bases de données chiffré.
+ **LicenseModel** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit les informations sur le modèle de licence pour cet instantané de cluster de bases de données.
+ **PercentProgress** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie une estimation du pourcentage de données transférées.
+ **Port** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie le port écouté par le cluster de bases de données au moment de l'instantané.
+ **SnapshotCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle l'instantané a été pris, au format UTC (temps universel).
+ **SnapshotType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit le type de l'instantané de cluster de bases de données.
+ **SourceDBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si l'instantané de cluster de bases de données a été copié à partir d'un instantané de cluster de bases de données source, l'Amazon Resource Name (ARN) de l'instantané de cluster de bases de données source, une valeur null dans le cas contraire.
+ **Status** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le statut de cet instantané de cluster de bases de données.
+ **StorageEncrypted** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si l'instantané de cluster de bases de données est chiffré.
+ **StorageType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de stockage associé à l’instantané de cluster de bases de données.
+ **VpcId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit l'ID de VPC associé à l'instantané de cluster de bases de données.

**Erreurs**
+ [DBClusterSnapshotAlreadyExistsFault](api-faults.md#DBClusterSnapshotAlreadyExistsFault)
+ [Non valide DBCluster StateFault](api-faults.md#InvalidDBClusterStateFault)
+ [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault)
+ [SnapshotQuotaExceededFault](api-faults.md#SnapshotQuotaExceededFault)
+ [Non valide DBCluster SnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault)

## Supprimer DBCluster un instantané (action)
<a name="DeleteDBClusterSnapshot"></a>

         Le nom de la AWS CLI pour cette API est :`delete-db-cluster-snapshot`.

Supprime un instantané de cluster de bases de données. Si l'instantané est en cours de copie, l'opération est arrêtée.

**Note**  
L'instantané de cluster de bases de données doit être dans l'état `available` pour être supprimé.

**Demande**
+ **DBClusterSnapshotIdentifier** (dans la CLI : `--db-cluster-snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données à supprimer.

  Contraintes : doit être le nom d'un instantané de cluster de bases de données existant dans l'état `available`.

**Réponse**

Contient les détails d'un instantané de cluster de bases de données Amazon Neptune.

Ce type de données est utilisé comme élément de réponse dans l'action [Décrire les DBCluster instantanés (action)](#DescribeDBClusterSnapshots).
+ **AllocatedStorage** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie la taille de stockage allouée en gigaoctets (Gio).
+ **AvailabilityZones** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du snapshot du cluster de base de données peuvent être restaurées.
+ **ClusterCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle le cluster de bases de données a été créé, en heure UTC (Universal Coordinated Time).
+ **DBClusterIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant du cluster de bases de données à partir duquel cet instantané de cluster de bases de données a été créé.
+ **DBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Amazon Resource Name (ARN) de l'instantané de cluster de bases de données.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant d'un instantané de cluster de bases de données. Doit correspondre à l'identifiant d'un instantané existant.

  Après avoir restauré un cluster de bases de données à l'aide d'un `DBClusterSnapshotIdentifier`, vous devez spécifier le même `DBClusterSnapshotIdentifier` pour toute mise à jour ultérieure de ce cluster. Lorsque vous spécifiez cette propriété pour une mise à jour, le cluster de bases de données n'est pas restauré de nouveau à partir de l'instantané, et les données de la base de données ne sont pas modifiées.

  Toutefois, si vous ne spécifiez pas le `DBClusterSnapshotIdentifier`, un cluster de bases de données vide est créé et le cluster de bases de données d'origine est supprimé. Si vous spécifiez une propriété différente de la propriété précédente de restauration d'instantané, le cluster de bases de données est restauré à partir de l'instantané spécifié par le `DBClusterSnapshotIdentifier`, et le cluster de bases de données d'origine est supprimé.
+ **Engine** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le nom du moteur de base de données.
+ **EngineVersion** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la version du moteur de base de données à utiliser pour cet instantané de cluster de bases de données.
+ **IAMDatabaseAuthenticationEnabled** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true (vrai) si le mappage des comptes Amazon Identity and Access Management (IAM) aux comptes de base de données est activé ; sinon, valeur false (faux).
+ **KmsKeyId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si `StorageEncrypted` a la valeur true (vrai), il s'agit de l'identifiant de clé Amazon KMS pour le cluster de bases de données chiffré.
+ **LicenseModel** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit les informations sur le modèle de licence pour cet instantané de cluster de bases de données.
+ **PercentProgress** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie une estimation du pourcentage de données transférées.
+ **Port** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie le port écouté par le cluster de bases de données au moment de l'instantané.
+ **SnapshotCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle l'instantané a été pris, au format UTC (temps universel).
+ **SnapshotType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit le type de l'instantané de cluster de bases de données.
+ **SourceDBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si l'instantané de cluster de bases de données a été copié à partir d'un instantané de cluster de bases de données source, l'Amazon Resource Name (ARN) de l'instantané de cluster de bases de données source, une valeur null dans le cas contraire.
+ **Status** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le statut de cet instantané de cluster de bases de données.
+ **StorageEncrypted** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si l'instantané de cluster de bases de données est chiffré.
+ **StorageType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de stockage associé à l’instantané de cluster de bases de données.
+ **VpcId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit l'ID de VPC associé à l'instantané de cluster de bases de données.

**Erreurs**
+ [Non valide DBCluster SnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault)
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)

## Copier DBCluster un instantané (action)
<a name="CopyDBClusterSnapshot"></a>

         Le nom de la AWS CLI pour cette API est :`copy-db-cluster-snapshot`.

Copie un instantané d'un cluster de bases de données.

Pour copier un instantané de cluster de bases de données à partir d'un instantané de cluster de bases de données manuel partagé, `SourceDBClusterSnapshotIdentifier` doit être l'ARN (Amazon Resource Name) de l'instantané de cluster de bases de données partagé.

**Demande**
+ **CopyTags**(dans la CLI :`--copy-tags`) — a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  La valeur est true pour copier toutes les balises de l'instantané de cluster de bases de données source vers l'instantané de cluster de bases de données cible, et false dans le cas contraire. La valeur par défaut est false.
+ **KmsKeyId** (dans la CLI : `--kms-key-id`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  ID de clé Amazon KMS pour un instantané de cluster de bases de données chiffré. L'ID de clé KMS est l'Amazon Resource Name (ARN), l'identifiant de clé KMS ou l'alias de clé KMS pour la clé de chiffrement KMS.

  Si vous copiez un instantané de cluster de bases de données chiffré à partir de votre compte Amazon, vous pouvez spécifier une valeur pour `KmsKeyId` afin de chiffrer la copie avec une nouvelle clé de chiffrement KMS. Si vous ne spécifiez pas de valeur pour `KmsKeyId`, la copie de l'instantané de cluster de bases de données est chiffrée avec la même clé KMS que l'instantané de cluster de bases de données source.

  Si vous copiez un instantané de cluster de bases de données chiffré partagé à partir d'un autre compte Amazon, vous devez spécifier une valeur pour `KmsKeyId`.

   Les clés de chiffrement KMS sont spécifiques à la région Amazon dans laquelle elles sont créées, et vous ne pouvez pas utiliser de clés de chiffrement issues d'une région Amazon dans une autre région Amazon.

  Vous ne pouvez pas chiffrer un instantané de cluster de bases de données non chiffré lorsque vous le copiez. Si vous essayez de copier un instantané de cluster de base de données non chiffré et que vous spécifiez une valeur pour le KmsKeyId paramètre, une erreur est renvoyée.
+ **PreSignedUrl** (dans la CLI : `--pre-signed-url`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Cette option n'est pas prise en charge actuellement.
+ **SourceDBClusterSnapshotIdentifier** (dans la CLI : `--source-db-cluster-snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données à copier. Ce paramètre n'est pas sensible à la casse.

  Contraintes :
  + Vous devez spécifier un instantané système valide dans l'état « available ».
  + Spécifiez un identifiant de l'instantané de base de données valide.

  Exemple : `my-cluster-snapshot1`
+ **Tags** (dans la CLI : `--tags`) : tableau d'objets [Tag](api-other-apis.md#Tag).

  Balises à attribuer à la nouvelle copie de l'instantané de cluster de bases de données.
+ **TargetDBClusterSnapshotIdentifier** (dans la CLI : `--target-db-cluster-snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant du nouvel instantané de cluster de bases de données à créer à partir de l'instantané de cluster de bases de données source. Ce paramètre n'est pas sensible à la casse.

  Contraintes :
  + Doit contenir entre 1 et 63 lettres, chiffres ou traits d'union.
  + Le premier caractère doit être une lettre.
  + Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

  Exemple : `my-cluster-snapshot2`

**Réponse**

Contient les détails d'un instantané de cluster de bases de données Amazon Neptune.

Ce type de données est utilisé comme élément de réponse dans l'action [Décrire les DBCluster instantanés (action)](#DescribeDBClusterSnapshots).
+ **AllocatedStorage** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie la taille de stockage allouée en gigaoctets (Gio).
+ **AvailabilityZones** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du snapshot du cluster de base de données peuvent être restaurées.
+ **ClusterCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle le cluster de bases de données a été créé, en heure UTC (Universal Coordinated Time).
+ **DBClusterIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant du cluster de bases de données à partir duquel cet instantané de cluster de bases de données a été créé.
+ **DBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Amazon Resource Name (ARN) de l'instantané de cluster de bases de données.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant d'un instantané de cluster de bases de données. Doit correspondre à l'identifiant d'un instantané existant.

  Après avoir restauré un cluster de bases de données à l'aide d'un `DBClusterSnapshotIdentifier`, vous devez spécifier le même `DBClusterSnapshotIdentifier` pour toute mise à jour ultérieure de ce cluster. Lorsque vous spécifiez cette propriété pour une mise à jour, le cluster de bases de données n'est pas restauré de nouveau à partir de l'instantané, et les données de la base de données ne sont pas modifiées.

  Toutefois, si vous ne spécifiez pas le `DBClusterSnapshotIdentifier`, un cluster de bases de données vide est créé et le cluster de bases de données d'origine est supprimé. Si vous spécifiez une propriété différente de la propriété précédente de restauration d'instantané, le cluster de bases de données est restauré à partir de l'instantané spécifié par le `DBClusterSnapshotIdentifier`, et le cluster de bases de données d'origine est supprimé.
+ **Engine** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le nom du moteur de base de données.
+ **EngineVersion** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la version du moteur de base de données à utiliser pour cet instantané de cluster de bases de données.
+ **IAMDatabaseAuthenticationEnabled** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true (vrai) si le mappage des comptes Amazon Identity and Access Management (IAM) aux comptes de base de données est activé ; sinon, valeur false (faux).
+ **KmsKeyId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si `StorageEncrypted` a la valeur true (vrai), il s'agit de l'identifiant de clé Amazon KMS pour le cluster de bases de données chiffré.
+ **LicenseModel** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit les informations sur le modèle de licence pour cet instantané de cluster de bases de données.
+ **PercentProgress** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie une estimation du pourcentage de données transférées.
+ **Port** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie le port écouté par le cluster de bases de données au moment de l'instantané.
+ **SnapshotCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle l'instantané a été pris, au format UTC (temps universel).
+ **SnapshotType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit le type de l'instantané de cluster de bases de données.
+ **SourceDBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si l'instantané de cluster de bases de données a été copié à partir d'un instantané de cluster de bases de données source, l'Amazon Resource Name (ARN) de l'instantané de cluster de bases de données source, une valeur null dans le cas contraire.
+ **Status** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le statut de cet instantané de cluster de bases de données.
+ **StorageEncrypted** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si l'instantané de cluster de bases de données est chiffré.
+ **StorageType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de stockage associé à l’instantané de cluster de bases de données.
+ **VpcId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit l'ID de VPC associé à l'instantané de cluster de bases de données.

**Erreurs**
+ [DBClusterSnapshotAlreadyExistsFault](api-faults.md#DBClusterSnapshotAlreadyExistsFault)
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)
+ [Non valide DBCluster StateFault](api-faults.md#InvalidDBClusterStateFault)
+ [Non valide DBCluster SnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault)
+ [SnapshotQuotaExceededFault](api-faults.md#SnapshotQuotaExceededFault)
+ [KMSKeyNotAccessibleFault](api-faults.md#KMSKeyNotAccessibleFault)

## Modifier DBCluster SnapshotAttribute (action)
<a name="ModifyDBClusterSnapshotAttribute"></a>

         Le nom de la AWS CLI pour cette API est :`modify-db-cluster-snapshot-attribute`.

Ajoute un attribut et des valeurs à un instantané de cluster de bases de données manuel, ou en supprime.

Pour partager un instantané de cluster de base de données manuel avec d'autres comptes Amazon, spécifiez `restore` comme `ValuesToAdd` paramètre `AttributeName` et utilisez le paramètre pour ajouter une liste IDs des comptes Amazon autorisés à restaurer l'instantané de cluster de base de données manuel. Utilisez la valeur `all` pour rendre l'instantané de cluster de bases de données manuel public, ce qui signifie qu'il pourra être copié ou restauré par tous les comptes Amazon. N'ajoutez pas la valeur `all` pour tous les instantanés de cluster de bases de données manuels contenant des informations privées que vous ne souhaitez pas mettre à la disposition de tous les comptes Amazon. Si un instantané de cluster de base de données manuel est chiffré, il peut être partagé, mais uniquement en spécifiant une liste de comptes Amazon autorisés IDs pour le `ValuesToAdd` paramètre. Dans ce cas, vous ne pouvez pas utiliser `all` comme une valeur pour ce paramètre.

Pour afficher les comptes Amazon autorisés à copier ou restaurer un instantané de cluster de bases de données manuel, ou pour voir si un instantané de cluster de bases de données manuel est public ou privé, utilisez l'action d'API [Décrire DBCluster SnapshotAttributes (action)](#DescribeDBClusterSnapshotAttributes).

**Demande**
+ **AttributeName** (dans la CLI : `--attribute-name`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom de l'attribut d'instantané de cluster de bases de données à modifier.

  Pour gérer l'autorisation des autres comptes Amazon à copier ou restaurer un instantané de cluster de bases de données manuel, définissez cette valeur sur `restore`.
+ **DBClusterSnapshotIdentifier** (dans la CLI : `--db-cluster-snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données pour lequel modifier les attributs.
+ **ValuesToAdd** (dans la CLI : `--values-to-add`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des attributs d'instantané de cluster de bases de données à ajouter à l'attribut spécifié par `AttributeName`.

  Pour autoriser d'autres comptes Amazon à copier ou à restaurer un instantané de cluster de base de données manuel, configurez cette liste pour inclure un ou plusieurs comptes Amazon IDs, ou `all` pour que l'instantané de cluster de base de données manuel puisse être restauré par n'importe quel compte Amazon. N'ajoutez pas la valeur `all` pour tous les instantanés de cluster de bases de données manuels contenant des informations privées que vous ne souhaitez pas mettre à la disposition de tous les comptes Amazon.
+ **ValuesToRemove** (dans la CLI : `--values-to-remove`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des attributs d'instantané de cluster de bases de données à supprimer de l'attribut spécifié par `AttributeName`.

  Pour supprimer l'autorisation d'autres comptes Amazon à copier ou restaurer un instantané de cluster de bases de données manuel, définissez cette liste afin d'inclure un ou plusieurs identifiants de compte Amazon, ou définissez `all` pour interdire à tous les comptes Amazon de copier ou restaurer l'instantané de cluster de bases de données. Si vous spécifiez `all`, un compte Amazon dont l'ID de compte est explicitement ajouté à l'attribut `restore` peut toujours copier ou restaurer un instantané de cluster de bases de données manuel.

**Réponse**

Contient les résultats d'appel réussi à l'action d'API [Décrire DBCluster SnapshotAttributes (action)](#DescribeDBClusterSnapshotAttributes).

Les attributs d'instantané de cluster de bases de données manuel sont utilisés pour autoriser d'autres comptes Amazon à copier ou restaurer un instantané de cluster de bases de données manuel. Pour plus d'informations, consultez l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).
+ **DBClusterSnapshotAttributes** : tableau d'objets [DBClusterSnapshotAttribute](#DBClusterSnapshotAttribute).

  Liste des attributs et des valeurs de l'instantané de cluster de bases de données manuel.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données manuel sur lequel s'appliquent les attributs.

**Erreurs**
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)
+ [Non valide DBCluster SnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault)
+ [SharedSnapshotQuotaExceededFault](api-faults.md#SharedSnapshotQuotaExceededFault)

## Restaurer DBCluster FromSnapshot (action)
<a name="RestoreDBClusterFromSnapshot"></a>

         Le nom de la AWS CLI pour cette API est :`restore-db-cluster-from-snapshot`.

Crée un nouveau cluster de bases de données à partir d'un instantané de base de données ou d'un instantané de cluster de bases de données.

Si un instantané de base de données est spécifié, le cluster de bases de données cible est créé à partir de l'instantané de base de données source avec une configuration par défaut et un groupe de sécurité par défaut.

Si un instantané de cluster de bases de données est spécifié, le cluster de bases de données cible est créé à partir du point de restauration du cluster de bases de données source avec la même configuration que le cluster de bases de données source original, sauf que le nouveau cluster de bases de données est créé avec le groupe de sécurité par défaut.

**Demande**
+ **AvailabilityZones** (dans la CLI : `--availability-zones`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du cluster de base de données restauré peuvent être créées.
+ **CopyTagsToSnapshot**(dans la CLI :`--copy-tags-to-snapshot`) — a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  *Si cette valeur est `true`, les balises sont copiées dans n'importe quel instantané du cluster de bases de données restauré qui est créé.*
+ **DatabaseName** (dans la CLI : `--database-name`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Non pris en charge.
+ **DBClusterIdentifier** (dans la CLI : `--db-cluster-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom du cluster de bases de données à créer à partir de l'instantané de base de données ou de l'instantané de cluster de bases de données. Ce paramètre n'est pas sensible à la casse.

  Contraintes :
  + Doit contenir entre 1 et 63 lettres, chiffres ou traits d'union
  + Le premier caractère doit être une lettre
  + Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs

  Exemple : `my-snapshot-id`
+ **DBClusterParameterGroupName** (dans la CLI : `--db-cluster-parameter-group-name`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom du groupe de paramètres de cluster de base de données à associer au nouveau cluster de base de données.

  Contraintes :
  + S'il est fourni, il doit correspondre au nom d'un existant DBClusterParameterGroup.
+ **DBSubnetGroupName** (dans la CLI : `--db-subnet-group-name`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom du groupe de sous-réseaux de base de données à utiliser pour le nouveau cluster de bases de données.

  Contraintes : s'il est indiqué, il doit correspondre au nom d'un DBSubnet groupe existant.

  Exemple : `mySubnetgroup`
+ **DeletionProtection**(dans la CLI :`--deletion-protection`) — a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Valeur qui indique si la protection contre la suppression est activée pour le cluster de bases de données. La base de données ne peut pas être supprimée lorsque la protection contre la suppression est activée. Par défaut, la protection contre la suppression est désactivée. 
+ **EnableCloudwatchLogsExports** (dans la CLI : `--enable-cloudwatch-logs-exports`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des journaux que le cluster de base de données restauré doit exporter vers Amazon CloudWatch Logs.
+ **EnableIAMDatabaseAuthentication**(dans la CLI :`--enable-iam-database-authentication`) — a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Valeur true pour activer le mappage des comptes Amazon Identity and Access Management (IAM) avec les comptes de base de données ; sinon, valeur false.

  Par défaut : `false`
+ **Engine** (dans la CLI : `--engine`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Moteur de base de données à utiliser pour le nouveau cluster de base de données.

  Par défaut : identique à la source

  Contrainte : doit être compatible avec le moteur de la source
+ **EngineVersion** (dans la CLI : `--engine-version`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Version du moteur de base de données à utiliser pour le nouveau cluster de bases de données.
+ **KmsKeyId** (dans la CLI : `--kms-key-id`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de clé Amazon KMS à utiliser lors de la restauration d'un cluster de bases de données chiffré à partir d'un instantané de base de données ou d'un instantané de cluster de bases de données.

  L'identifiant de clé KMS est l'Amazon Resource Name (ARN) de la clé de chiffrement KMS. Si vous restaurez un cluster de bases de données avec le compte Amazon qui possède la clé de chiffrement KMS utilisée pour chiffrer le nouveau cluster de bases de données, vous pouvez utiliser l'alias de clé KMS au lieu de l'ARN de la clé de chiffrement KMS.

  Si vous ne spécifiez pas de valeur pour le paramètre `KmsKeyId` :
  + Si l'instantané de base de données ou l'instantané de cluster de bases de données dans `SnapshotIdentifier` est chiffré, le cluster de bases de données restauré est chiffré à l'aide de la clé KMS utilisée pour chiffrer l'instantané de base de données ou l'instantané de cluster de bases de données.
  + Si l'instantané de base de données ou l'instantané de cluster de bases de données dans `SnapshotIdentifier` n'est pas chiffré, le cluster de base de données restauré n'est pas chiffré.
+ **Port**(dans la CLI :`--port`) — un IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Le numéro de port sur lequel le nouveau cluster de bases de données accepte des connexions.

  Contraintes : La valeur doit être comprise dans la plage `1150-65535`

  Valeur par défaut : port du cluster de bases de données d'origine.
+ **ServerlessV2ScalingConfiguration** (dans la CLI : `--serverless-v2-scaling-configuration`) : objet [Serverless V2 ScalingConfiguration](api-datatypes.md#ServerlessV2ScalingConfiguration).

  Contient la configuration de mise à l'échelle d'un cluster de bases de données Neptune sans serveur.

  Pour plus d'informations, consultez [Utilisation d'Amazon Neptune sans serveur](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html) dans le *Guide de l'utilisateur Amazon Neptune*.
+ **SnapshotIdentifier** (dans la CLI : `--snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de base de données ou de l'instantané de cluster de bases de données à partir duquel restaurer.

  Vous pouvez utiliser le nom ou l'Amazon Resource Name (ARN) pour spécifier un instantané de cluster de bases de données. Cependant, vous pouvez utiliser uniquement l'ARN pour spécifier un instantané de base de données.

  Contraintes :
  + Doit correspondre à l'identifiant d'un instantané existant.
+ **StorageType** (dans la CLI : `--storage-type`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le type de stockage à associer au cluster de base de données.

  Valeurs valides : `standard`, `iopt1`

  Par défaut : `standard`
+ **Tags** (dans la CLI : `--tags`) : tableau d'objets [Tag](api-other-apis.md#Tag).

  Balises à attribuer au cluster de bases de données restauré.
+ **VpcSecurityGroupIds** (dans la CLI : `--vpc-security-group-ids`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des groupes de sécurité VPC auxquels appartiendra le nouveau cluster de bases de données.

**Réponse**

Contient les détails d'un cluster de bases de données Amazon Neptune.

Ce type de données est utilisé comme élément de réponse dans [Décrire DBClusters (action)](api-clusters.md#DescribeDBClusters).
+ **AllocatedStorage**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  `AllocatedStorage` renvoie toujours la valeur 1, car la taille de stockage d'un cluster de bases de données Neptune n'est pas fixe ; elle s'ajuste automatiquement en fonction des besoins.
+ **AssociatedRoles** : tableau d'objets [DBClusterRôle](api-clusters.md#DBClusterRole).

  Fournit la liste des rôles Amazon Identity and Access Management (IAM) associés au cluster de bases de données. Les rôles IAM associés à un cluster de bases de données autorisent celui-ci à accéder aux autres services Amazon en votre nom.
+ **AutomaticRestartTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Heure à laquelle le cluster de bases de données sera automatiquement redémarré.
+ **AvailabilityZones** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du cluster de base de données peuvent être créées.
+ **BacktrackConsumedChangeRecords**— a LongOptional, de type : `long` (un entier signé de 64 bits).

  Non pris en charge par Neptune.
+ **BacktrackWindow**— a LongOptional, de type : `long` (un entier signé de 64 bits).

  Non pris en charge par Neptune.
+ **BackupRetentionPeriod**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Spécifie le nombre de jours de conservation des instantanés de base de données automatiques.
+ **Capacity**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Non pris en charge par Neptune.
+ **CloneGroupId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifie le groupe de clones auquel est associé le cluster de bases de données.
+ **ClusterCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle le cluster de bases de données a été créé, en heure UTC (Universal Coordinated Time).
+ **CopyTagsToSnapshot**— a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  *Si cette valeur est définie sur `true`, les balises sont copiées dans n'importe quel instantané du cluster de bases de données créé.*
+ **CrossAccountClone**— a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Si cette valeur est définie sur `true`, le cluster de bases de données peut être cloné sur plusieurs comptes.
+ **DatabaseName** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Contient le nom de la base de données initiale de ce cluster de bases de données qui a été fourni au moment de la création, dans la mesure où un nom a été spécifié au moment de créer le cluster de bases de données. Ce même nom est renvoyé pendant la durée de vie du cluster de bases de données.
+ **DBClusterArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Amazon Resource Name (ARN) du cluster de bases de données.
+ **DBClusterIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Contient un identifiant de cluster de bases de données fourni par l'utilisateur. Cet identifiant est la clé unique qui identifie un cluster de bases de données.
+ **DBClusterMembers** : tableau d'objets [DBClusterMembre](api-clusters.md#DBClusterMember).

  Fournit la liste des instances qui composent le cluster de bases de données.
+ **DBClusterParameterGroup** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le nom du groupe de paramètres de cluster de base de données pour le cluster de base de données.
+ **DbClusterResourceId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant immuable et propre à la région Amazon du cluster de bases de données. Cet identifiant se trouve dans les entrées du CloudTrail journal Amazon chaque fois que la clé Amazon KMS du cluster de base de données est consultée.
+ **DBSubnetGroup** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie les informations sur le groupe de sous-réseaux associé au cluster de bases de données, notamment le nom, la description et les sous-réseaux du groupe de sous-réseaux.
+ **DeletionProtection**— a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Indique si la protection contre la suppression est activée pour le cluster de bases de données. La base de données ne peut pas être supprimée lorsque la protection contre la suppression est activée.
+ **EarliestBacktrackTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Non pris en charge par Neptune.
+ **EarliestRestorableTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie la première heure à laquelle une base de données peut être restaurée par point-in-time restauration.
+ **EnabledCloudwatchLogsExports** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des types de journaux que ce cluster de base de données est configuré pour exporter vers CloudWatch Logs. Les types de journaux valides sont les suivants : `audit` (pour publier les journaux d'audit CloudWatch) et slowquery (pour publier les journaux de requêtes lentes). CloudWatch Consultez la section [Publication des journaux Neptune sur Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html).
+ **Endpoint** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le point de terminaison de connexion pour l'instance principale du cluster de bases de données.
+ **Engine** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit le nom du moteur de base de données à utiliser pour ce cluster de bases de données.
+ **EngineVersion** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Indique la version du moteur de base de données.
+ **GlobalClusterIdentifier**— a GlobalClusterIdentifier, de type : `string` (une chaîne codée en UTF-8), pas moins de 1 ou plus de 255 ? 1er ? s, correspondant à cette expression régulière :`[A-Za-z][0-9A-Za-z-:._]*`.

  Contient un identifiant de cluster de bases de données globale fourni par l'utilisateur. Cet identifiant est la clé unique qui identifie une base de données globale.
+ **HostedZoneId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'ID attribué par Amazon Route 53 lorsque vous créez une zone hébergée.
+ **IAMDatabaseAuthenticationEnabled** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true (vrai) si le mappage des comptes Amazon Identity and Access Management (IAM) aux comptes de base de données est activé ; sinon, valeur false (faux).
+ **IOOptimizedNextAllowedModificationTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  La prochaine fois, vous pourrez modifier le cluster de bases de données de façon à utiliser le type de stockage `iopt1`.
+ **KmsKeyId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si `StorageEncrypted` a la valeur true (vrai), identifiant de clé Amazon KMS pour le cluster de bases de données chiffré.
+ **LatestRestorableTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure limite à laquelle une base de données peut être restaurée par point-in-time restauration.
+ **MultiAZ** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si le cluster de bases de données possède des instances dans plusieurs zones de disponibilité.
+ **PendingModifiedValues** : objet [ClusterPendingModifiedValues](api-clusters.md#ClusterPendingModifiedValues).

  Ce type de données est utilisé comme élément de réponse dans l'opération `ModifyDBCluster` et contient les modifications qui seront appliquées lors de la fenêtre de maintenance suivante.
+ **PercentProgress** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie la progression de l'opération sous forme de pourcentage.
+ **Port**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Spécifie le port sur lequel le moteur de base de données est à l'écoute.
+ **PreferredBackupWindow** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie la plage de temps quotidienne au cours de laquelle des sauvegardes automatiques sont créées si cette fonctionnalité est activée, comme déterminé par la propriété `BackupRetentionPeriod`.
+ **PreferredMaintenanceWindow** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'intervalle de temps hebdomadaire, au format Universal Coordinated Time (UTC), pendant lequel a lieu la maintenance du système.
+ **ReaderEndpoint** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Point de terminaison du lecteur pour le cluster de bases de données. Le point de terminaison du lecteur d'un cluster de bases de données équilibre la charge des connexions entre les réplicas en lecture qui sont disponibles dans un cluster de bases de données. À mesure que les clients demandent de nouvelles connexions au point de terminaison du lecteur, Neptune répartit les demandes de connexion entre les réplicas en lecture du cluster de bases de données. Cette fonctionnalité peut contribuer à équilibrer votre charge de travail entre les différents réplicas en lecture de votre cluster de bases de données.

  Si un basculement se produit et que le réplica en lecture auquel vous êtes connecté est promu en instance principale, votre connexion est supprimée. Pour continuer à envoyer votre charge de travail de lecture à d'autres réplicas en lecture du cluster, vous pouvez alors vous reconnecter au point de terminaison du lecteur.
+ **ReadReplicaIdentifiers** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Contient un ou plusieurs identifiants des réplicas en lecture associés à ce cluster de bases de données.
+ **ReplicationSourceIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Non pris en charge par Neptune.
+ **ReplicationType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Non pris en charge par Neptune.
+ **ServerlessV2ScalingConfiguration** : objet [Serverless V2 ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo).

  Affiche la configuration de mise à l'échelle pour un cluster de bases de données Neptune sans serveur.

  Pour plus d'informations, consultez [Utilisation d'Amazon Neptune sans serveur](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html) dans le *Guide de l'utilisateur Amazon Neptune*.
+ **Status** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'état actuel de ce cluster de base de données.
+ **StorageEncrypted** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si le cluster de base de données est chiffré.
+ **StorageType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de stockage utilisé par le cluster de bases de données.

  Valeurs valides :
  + **`standard`**— (*valeur par défaut*) Fournit un stockage de base de données économique pour les applications dont l' I/O utilisation est modérée à faible.
  + **`iopt1`**— Permet un [stockage optimisé pour les E/S](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage), conçu pour répondre aux besoins de I/O-intensive graph workloads that require predictable pricing with low I/O latency and consistent I/O débit.

    Le stockage optimisé pour les E/S Neptune n’est disponible qu’à partir de la version 1.3.0.0 du moteur.
+ **VpcSecurityGroups** : tableau d'objets [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership).

  Fournit la liste des groupes de sécurité VPC auxquels appartient le cluster de base de données.

**Erreurs**
+ [DBClusterAlreadyExistsFault](api-faults.md#DBClusterAlreadyExistsFault)
+ [DBClusterQuotaExceededFault](api-faults.md#DBClusterQuotaExceededFault)
+ [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault)
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)
+ [DBSnapshotNotFoundFault](api-faults.md#DBSnapshotNotFoundFault)
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)
+ [Insuffisant DBCluster CapacityFault](api-faults.md#InsufficientDBClusterCapacityFault)
+ [InsufficientStorageClusterCapacityFault](api-faults.md#InsufficientStorageClusterCapacityFault)
+ [Non valide DBSnapshot StateFault](api-faults.md#InvalidDBSnapshotStateFault)
+ [Non valide DBCluster SnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault)
+ [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault)
+ [Non valide VPCNetwork StateFault](api-faults.md#InvalidVPCNetworkStateFault)
+ [InvalidRestoreFault](api-faults.md#InvalidRestoreFault)
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)
+ [OptionGroupNotFoundFault](api-faults.md#OptionGroupNotFoundFault)
+ [KMSKeyNotAccessibleFault](api-faults.md#KMSKeyNotAccessibleFault)
+ [DBClusterParameterGroupNotFoundFault](api-faults.md#DBClusterParameterGroupNotFoundFault)

## Restaurer DBCluster ToPointInTime (action)
<a name="RestoreDBClusterToPointInTime"></a>

         Le nom de la AWS CLI pour cette API est :`restore-db-cluster-to-point-in-time`.

Restaure un cluster de bases de données à un moment donné arbitraire. Les utilisateurs peuvent restaurer à tout moment avant `LatestRestorableTime` pendant `BackupRetentionPeriod` jours. Le cluster de bases de données cible est créé à partir du cluster de bases de données source avec la même configuration que le cluster de bases de données original, sauf que le nouveau cluster de bases de données est créé avec le groupe de sécurité de base de données par défaut.

**Note**  
Cette action restaure uniquement le cluster de bases de données, mais pas les instances de base de données de ce cluster de bases de données. Vous devez invoquer l'action [Créer DBInstance (action)](api-instances.md#CreateDBInstance) pour créer des instances de bases de données pour le cluster de bases de données restauré, en spécifiant l'identifiant du cluster de bases de données restauré dans `DBClusterIdentifier`. Vous pouvez créer des instances de base de données uniquement après la fin de l'action `RestoreDBClusterToPointInTime` et lorsque le cluster de bases de données est disponible.

**Demande**
+ **DBClusterIdentifier** (dans la CLI : `--db-cluster-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom du nouveau cluster de bases de données à créer.

  Contraintes :
  + Doit contenir entre 1 et 63 lettres, chiffres ou traits d'union
  + Le premier caractère doit être une lettre
  + Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs
+ **DBClusterParameterGroupName** (dans la CLI : `--db-cluster-parameter-group-name`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom du groupe de paramètres de cluster de base de données à associer au nouveau cluster de base de données.

  Contraintes :
  + S'il est fourni, il doit correspondre au nom d'un existant DBClusterParameterGroup.
+ **DBSubnetGroupName** (dans la CLI : `--db-subnet-group-name`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom du groupe de sous-réseaux de base de données à utiliser pour le nouveau cluster de bases de données.

  Contraintes : s'il est indiqué, il doit correspondre au nom d'un DBSubnet groupe existant.

  Exemple : `mySubnetgroup`
+ **DeletionProtection**(dans la CLI :`--deletion-protection`) — a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Valeur qui indique si la protection contre la suppression est activée pour le cluster de bases de données. La base de données ne peut pas être supprimée lorsque la protection contre la suppression est activée. Par défaut, la protection contre la suppression est désactivée. 
+ **EnableCloudwatchLogsExports** (dans la CLI : `--enable-cloudwatch-logs-exports`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  La liste des journaux que le cluster de base de données restauré doit exporter vers CloudWatch Logs.
+ **EnableIAMDatabaseAuthentication**(dans la CLI :`--enable-iam-database-authentication`) — a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Valeur true pour activer le mappage des comptes Amazon Identity and Access Management (IAM) avec les comptes de base de données ; sinon, valeur false.

  Par défaut : `false`
+ **KmsKeyId** (dans la CLI : `--kms-key-id`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de clé Amazon KMS à utiliser lors de la restauration d'un cluster de bases de données chiffré à partir d'un cluster de bases de données chiffré.

  L'identifiant de clé KMS est l'Amazon Resource Name (ARN) de la clé de chiffrement KMS. Si vous restaurez un cluster de bases de données avec le compte Amazon qui possède la clé de chiffrement KMS utilisée pour chiffrer le nouveau cluster de bases de données, vous pouvez utiliser l'alias de clé KMS au lieu de l'ARN de la clé de chiffrement KMS.

  Vous pouvez restaurer vers un nouveau cluster de bases de données et chiffrer le nouveau cluster de bases de données avec une clé KMS différente de la clé KMS utilisée pour chiffrer le cluster de bases de données source. Le nouveau cluster de bases de données est chiffré avec la clé KMS identifiée par le paramètre `KmsKeyId`.

  Si vous ne spécifiez pas de valeur pour le paramètre `KmsKeyId` :
  + Si le cluster de bases de données est chiffré, le cluster de bases de données restauré est chiffré à l'aide de la clé KMS utilisée pour chiffrer le cluster de bases de données source.
  + Si le cluster de bases de données n'est pas chiffré, le cluster de bases de données restauré n'est pas chiffré.

  Si `DBClusterIdentifier` fait référence à un cluster de base de données non chiffré, la demande de restauration est rejetée.
+ **Port**(dans la CLI :`--port`) — un IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Le numéro de port sur lequel le nouveau cluster de bases de données accepte des connexions.

  Contraintes : La valeur doit être comprise dans la plage `1150-65535`

  Valeur par défaut : port du cluster de bases de données d'origine.
+ **RestoreToTime**(dans la CLI :`--restore-to-time`) — a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Date et heure auxquelles restaurer le cluster de bases de données.

  Valeurs Valides : doit être une heure au format UTC (temps universel)

  Contraintes :
  + Doit se situer avant l'heure de restauration la plus récente pour l'instance de base de données.
  + Doit être indiqué si le paramètre `UseLatestRestorableTime` n'est pas fourni.
  + Ne peut pas être spécifié si le paramètre `UseLatestRestorableTime` est true.
  + Ne peut pas être spécifié si le paramètre `RestoreType` est `copy-on-write`.

  Exemple : `2015-03-07T23:45:00Z`
+ **RestoreType** (dans la CLI : `--restore-type`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de restauration à exécuter. Vous pouvez spécifier l’une des valeurs suivantes :
  +  `full-copy` - Le nouveau cluster de base de données est restauré sous la forme d'une copie intégrale du cluster de base de données source.
  +  `copy-on-write` - Le nouveau cluster de base de données est restauré sous la forme d'un clone du cluster de base de données source.

  Si vous ne spécifiez pas de valeur pour `RestoreType`, le nouveau cluster de base de données est restauré sous la forme d'une copie intégrale du cluster de base de données source.
+ **ServerlessV2ScalingConfiguration** (dans la CLI : `--serverless-v2-scaling-configuration`) : objet [Serverless V2 ScalingConfiguration](api-datatypes.md#ServerlessV2ScalingConfiguration).

  Contient la configuration de mise à l'échelle d'un cluster de bases de données Neptune sans serveur.

  Pour plus d'informations, consultez [Utilisation d'Amazon Neptune sans serveur](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html) dans le *Guide de l'utilisateur Amazon Neptune*.
+ **SourceDBClusterIdentifier** (dans la CLI : `--source-db-cluster-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant du cluster de base de données source à partir duquel effectuer la restauration.

  Contraintes :
  + Doit correspondre à l'identifiant d'un existant DBCluster.
+ **StorageType** (dans la CLI : `--storage-type`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le type de stockage à associer au cluster de base de données.

  Valeurs valides : `standard`, `iopt1`

  Par défaut : `standard`
+ **Tags** (dans la CLI : `--tags`) : tableau d'objets [Tag](api-other-apis.md#Tag).

  Balises à appliquer au cluster de bases de données restauré.
+ **UseLatestRestorableTime** (dans la CLI : `--use-latest-restorable-time`) : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur défini sur `true` pour restaurer le cluster de bases de données à l'heure de sauvegarde de restauration la plus récente, et `false` dans le cas contraire.

  Par défaut : `false`

  Contraintes : ne doit pas être spécifié si le paramètre `RestoreToTime` est fourni.
+ **VpcSecurityGroupIds** (dans la CLI : `--vpc-security-group-ids`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des groupes de sécurité VPC auxquels appartient le nouveau cluster de bases de données.

**Réponse**

Contient les détails d'un cluster de bases de données Amazon Neptune.

Ce type de données est utilisé comme élément de réponse dans [Décrire DBClusters (action)](api-clusters.md#DescribeDBClusters).
+ **AllocatedStorage**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  `AllocatedStorage` renvoie toujours la valeur 1, car la taille de stockage d'un cluster de bases de données Neptune n'est pas fixe ; elle s'ajuste automatiquement en fonction des besoins.
+ **AssociatedRoles** : tableau d'objets [DBClusterRôle](api-clusters.md#DBClusterRole).

  Fournit la liste des rôles Amazon Identity and Access Management (IAM) associés au cluster de bases de données. Les rôles IAM associés à un cluster de bases de données autorisent celui-ci à accéder aux autres services Amazon en votre nom.
+ **AutomaticRestartTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Heure à laquelle le cluster de bases de données sera automatiquement redémarré.
+ **AvailabilityZones** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du cluster de base de données peuvent être créées.
+ **BacktrackConsumedChangeRecords**— a LongOptional, de type : `long` (un entier signé de 64 bits).

  Non pris en charge par Neptune.
+ **BacktrackWindow**— a LongOptional, de type : `long` (un entier signé de 64 bits).

  Non pris en charge par Neptune.
+ **BackupRetentionPeriod**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Spécifie le nombre de jours de conservation des instantanés de base de données automatiques.
+ **Capacity**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Non pris en charge par Neptune.
+ **CloneGroupId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifie le groupe de clones auquel est associé le cluster de bases de données.
+ **ClusterCreateTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle le cluster de bases de données a été créé, en heure UTC (Universal Coordinated Time).
+ **CopyTagsToSnapshot**— a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  *Si cette valeur est définie sur `true`, les balises sont copiées dans n'importe quel instantané du cluster de bases de données créé.*
+ **CrossAccountClone**— a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Si cette valeur est définie sur `true`, le cluster de bases de données peut être cloné sur plusieurs comptes.
+ **DatabaseName** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Contient le nom de la base de données initiale de ce cluster de bases de données qui a été fourni au moment de la création, dans la mesure où un nom a été spécifié au moment de créer le cluster de bases de données. Ce même nom est renvoyé pendant la durée de vie du cluster de bases de données.
+ **DBClusterArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Amazon Resource Name (ARN) du cluster de bases de données.
+ **DBClusterIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Contient un identifiant de cluster de bases de données fourni par l'utilisateur. Cet identifiant est la clé unique qui identifie un cluster de bases de données.
+ **DBClusterMembers** : tableau d'objets [DBClusterMembre](api-clusters.md#DBClusterMember).

  Fournit la liste des instances qui composent le cluster de bases de données.
+ **DBClusterParameterGroup** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le nom du groupe de paramètres de cluster de base de données pour le cluster de base de données.
+ **DbClusterResourceId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant immuable et propre à la région Amazon du cluster de bases de données. Cet identifiant se trouve dans les entrées du CloudTrail journal Amazon chaque fois que la clé Amazon KMS du cluster de base de données est consultée.
+ **DBSubnetGroup** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie les informations sur le groupe de sous-réseaux associé au cluster de bases de données, notamment le nom, la description et les sous-réseaux du groupe de sous-réseaux.
+ **DeletionProtection**— a BooleanOptional, de type : `boolean` (une valeur booléenne (vraie ou fausse)).

  Indique si la protection contre la suppression est activée pour le cluster de bases de données. La base de données ne peut pas être supprimée lorsque la protection contre la suppression est activée.
+ **EarliestBacktrackTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Non pris en charge par Neptune.
+ **EarliestRestorableTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie la première heure à laquelle une base de données peut être restaurée par point-in-time restauration.
+ **EnabledCloudwatchLogsExports** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Liste des types de journaux que ce cluster de base de données est configuré pour exporter vers CloudWatch Logs. Les types de journaux valides sont les suivants : `audit` (pour publier les journaux d'audit CloudWatch) et slowquery (pour publier les journaux de requêtes lentes). CloudWatch Consultez la section [Publication des journaux Neptune sur Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html).
+ **Endpoint** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le point de terminaison de connexion pour l'instance principale du cluster de bases de données.
+ **Engine** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit le nom du moteur de base de données à utiliser pour ce cluster de bases de données.
+ **EngineVersion** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Indique la version du moteur de base de données.
+ **GlobalClusterIdentifier**— a GlobalClusterIdentifier, de type : `string` (une chaîne codée en UTF-8), pas moins de 1 ou plus de 255 ? 1er ? s, correspondant à cette expression régulière :`[A-Za-z][0-9A-Za-z-:._]*`.

  Contient un identifiant de cluster de bases de données globale fourni par l'utilisateur. Cet identifiant est la clé unique qui identifie une base de données globale.
+ **HostedZoneId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'ID attribué par Amazon Route 53 lorsque vous créez une zone hébergée.
+ **IAMDatabaseAuthenticationEnabled** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true (vrai) si le mappage des comptes Amazon Identity and Access Management (IAM) aux comptes de base de données est activé ; sinon, valeur false (faux).
+ **IOOptimizedNextAllowedModificationTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  La prochaine fois, vous pourrez modifier le cluster de bases de données de façon à utiliser le type de stockage `iopt1`.
+ **KmsKeyId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si `StorageEncrypted` a la valeur true (vrai), identifiant de clé Amazon KMS pour le cluster de bases de données chiffré.
+ **LatestRestorableTime**— a TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure limite à laquelle une base de données peut être restaurée par point-in-time restauration.
+ **MultiAZ** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si le cluster de bases de données possède des instances dans plusieurs zones de disponibilité.
+ **PendingModifiedValues** : objet [ClusterPendingModifiedValues](api-clusters.md#ClusterPendingModifiedValues).

  Ce type de données est utilisé comme élément de réponse dans l'opération `ModifyDBCluster` et contient les modifications qui seront appliquées lors de la fenêtre de maintenance suivante.
+ **PercentProgress** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie la progression de l'opération sous forme de pourcentage.
+ **Port**— an IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Spécifie le port sur lequel le moteur de base de données est à l'écoute.
+ **PreferredBackupWindow** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie la plage de temps quotidienne au cours de laquelle des sauvegardes automatiques sont créées si cette fonctionnalité est activée, comme déterminé par la propriété `BackupRetentionPeriod`.
+ **PreferredMaintenanceWindow** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'intervalle de temps hebdomadaire, au format Universal Coordinated Time (UTC), pendant lequel a lieu la maintenance du système.
+ **ReaderEndpoint** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Point de terminaison du lecteur pour le cluster de bases de données. Le point de terminaison du lecteur d'un cluster de bases de données équilibre la charge des connexions entre les réplicas en lecture qui sont disponibles dans un cluster de bases de données. À mesure que les clients demandent de nouvelles connexions au point de terminaison du lecteur, Neptune répartit les demandes de connexion entre les réplicas en lecture du cluster de bases de données. Cette fonctionnalité peut contribuer à équilibrer votre charge de travail entre les différents réplicas en lecture de votre cluster de bases de données.

  Si un basculement se produit et que le réplica en lecture auquel vous êtes connecté est promu en instance principale, votre connexion est supprimée. Pour continuer à envoyer votre charge de travail de lecture à d'autres réplicas en lecture du cluster, vous pouvez alors vous reconnecter au point de terminaison du lecteur.
+ **ReadReplicaIdentifiers** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Contient un ou plusieurs identifiants des réplicas en lecture associés à ce cluster de bases de données.
+ **ReplicationSourceIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Non pris en charge par Neptune.
+ **ReplicationType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Non pris en charge par Neptune.
+ **ServerlessV2ScalingConfiguration** : objet [Serverless V2 ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo).

  Affiche la configuration de mise à l'échelle pour un cluster de bases de données Neptune sans serveur.

  Pour plus d'informations, consultez [Utilisation d'Amazon Neptune sans serveur](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html) dans le *Guide de l'utilisateur Amazon Neptune*.
+ **Status** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'état actuel de ce cluster de base de données.
+ **StorageEncrypted** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si le cluster de base de données est chiffré.
+ **StorageType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de stockage utilisé par le cluster de bases de données.

  Valeurs valides :
  + **`standard`**— (*valeur par défaut*) Fournit un stockage de base de données économique pour les applications dont l' I/O utilisation est modérée à faible.
  + **`iopt1`**— Permet un [stockage optimisé pour les E/S](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage), conçu pour répondre aux besoins de I/O-intensive graph workloads that require predictable pricing with low I/O latency and consistent I/O débit.

    Le stockage optimisé pour les E/S Neptune n’est disponible qu’à partir de la version 1.3.0.0 du moteur.
+ **VpcSecurityGroups** : tableau d'objets [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership).

  Fournit la liste des groupes de sécurité VPC auxquels appartient le cluster de base de données.

**Erreurs**
+ [DBClusterAlreadyExistsFault](api-faults.md#DBClusterAlreadyExistsFault)
+ [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault)
+ [DBClusterQuotaExceededFault](api-faults.md#DBClusterQuotaExceededFault)
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)
+ [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault)
+ [Insuffisant DBCluster CapacityFault](api-faults.md#InsufficientDBClusterCapacityFault)
+ [InsufficientStorageClusterCapacityFault](api-faults.md#InsufficientStorageClusterCapacityFault)
+ [Non valide DBCluster SnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault)
+ [Non valide DBCluster StateFault](api-faults.md#InvalidDBClusterStateFault)
+ [Non valide DBSnapshot StateFault](api-faults.md#InvalidDBSnapshotStateFault)
+ [InvalidRestoreFault](api-faults.md#InvalidRestoreFault)
+ [InvalidSubnet](api-faults.md#InvalidSubnet)
+ [Non valide VPCNetwork StateFault](api-faults.md#InvalidVPCNetworkStateFault)
+ [KMSKeyNotAccessibleFault](api-faults.md#KMSKeyNotAccessibleFault)
+ [OptionGroupNotFoundFault](api-faults.md#OptionGroupNotFoundFault)
+ [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault)
+ [DBClusterParameterGroupNotFoundFault](api-faults.md#DBClusterParameterGroupNotFoundFault)

## Décrire les DBCluster instantanés (action)
<a name="DescribeDBClusterSnapshots"></a>

         Le nom de la AWS CLI pour cette API est :`describe-db-cluster-snapshots`.

Renvoie des informations sur des instantanés de cluster de bases de données. Cette action d'API prend en charge la pagination.

**Demande**
+ **DBClusterIdentifier** (dans la CLI : `--db-cluster-identifier`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  ID du cluster de bases de données auprès duquel récupérer la liste des instantanés de cluster de bases de données. Ce paramètre ne peut pas être utilisé avec le paramètre `DBClusterSnapshotIdentifier`. Ce paramètre n'est pas sensible à la casse.

  Contraintes :
  + S'il est fourni, il doit correspondre à l'identifiant d'un existant DBCluster.
+ **DBClusterSnapshotIdentifier** (dans la CLI : `--db-cluster-snapshot-identifier`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant d'instantané de cluster de bases de données spécifique à décrire. Ce paramètre ne peut pas être utilisé avec le paramètre `DBClusterIdentifier`. Cette valeur est stockée sous la forme d'une chaîne en minuscules.

  Contraintes :
  + S'il est fourni, il doit correspondre à l'identifiant d'un DBCluster instantané existant.
  + Si cet identifiant est destinée à un instantané automatisé, le paramètre `SnapshotType` doit également être spécifié.
+ **Filters** (dans la CLI : `--filters`) : tableau d'objets [Filtre](api-datatypes.md#Filter).

  Ce paramètre n'est actuellement pas pris en charge.
+ **IncludePublic** (dans la CLI : `--include-public`) : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true pour inclure les instantanés de cluster de bases de données manuels publics et qui peuvent être copiés ou restaurés par tous les comptes Amazon, et false dans le cas contraire. L’argument par défaut est `false`. La valeur par défaut est false.

  Vous pouvez partager un instantané de cluster de bases de données manuel comme public à l'aide de l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).
+ **IncludeShared** (dans la CLI : `--include-shared`) : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true pour inclure les instantanés de cluster de bases de données manuels partagés à partir d'autres comptes Amazon attestant que ce compte Amazon a reçu l'autorisation de copier ou restaurer, et false dans le cas contraire. L’argument par défaut est `false`.

  Vous pouvez autoriser un compte Amazon à restaurer un instantané de cluster de bases de données manuel à partir d'un autre compte Amazon par l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).
+ **Marker** (dans la CLI : `--marker`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Jeton de pagination facultatif fourni par une demande `DescribeDBClusterSnapshots` précédente. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par `MaxRecords`. 
+ **MaxRecords**(dans la CLI :`--max-records`) — un IntegerOptional, de type : `integer` (un entier signé de 32 bits).

  Nombre maximal d'enregistrements à inclure dans la réponse. Si le nombre d'enregistrements existants est supérieur à la valeur `MaxRecords` spécifiée, un jeton de pagination appelé marqueur est inclus dans la réponse pour permettre la récupération des résultats restants.

  Par défaut : 100

  Contraintes : Minimum 20, maximum 100.
+ **SnapshotType** (dans la CLI : `--snapshot-type`) : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type d'instantanés de cluster de bases de données à renvoyer. Vous pouvez spécifier l’une des valeurs suivantes :
  +  `automated` : renvoie tous les instantanés de cluster de bases de données automatiquement créés par Amazon Neptune pour mon compte Amazon.
  +  `manual` : renvoie tous les instantanés de cluster de bases de données créés par mon compte Amazon.
  +  `shared` : renvoie tous les instantanés de cluster de bases de données manuels partagés avec mon compte AWS.
  +  `public` - Renvoie tous les instantanés de cluster de bases de données marqués comme publics.

  Si vous ne spécifiez pas de valeur `SnapshotType`, les deux instantanés de cluster de bases de données manuels et automatiques sont renvoyés. Vous pouvez inclure des instantanés de cluster de bases de données partagés avec ces résultats en définissant le paramètre `IncludeShared` sur `true`. Vous pouvez inclure des instantanés de cluster de bases de données publics avec ces résultats en définissant le paramètre `IncludePublic` sur `true`.

  Les paramètres `IncludeShared` et `IncludePublic` ne s'appliquent pas pour les valeurs `SnapshotType` de `manual` ou `automated`. Le paramètre `IncludePublic` ne s'applique pas lorsque `SnapshotType` est défini sur `shared`. Le paramètre `IncludeShared` ne s'applique pas lorsque `SnapshotType` est défini sur `public`.

**Réponse**
+ **DBClusterSnapshots** : tableau d'objets [DBClusterInstantané](#DBClusterSnapshot).

  Fournit une liste des instantanés de cluster de bases de données pour l'utilisateur.
+ **Marker** : chaîne de type : `string` (chaîne encodée en UTF-8).

   Jeton de pagination facultatif fourni par une demande [Décrire les DBCluster instantanés (action)](#DescribeDBClusterSnapshots) précédente. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par `MaxRecords`. 

**Erreurs**
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)

## Décrire DBCluster SnapshotAttributes (action)
<a name="DescribeDBClusterSnapshotAttributes"></a>

         Le nom de la AWS CLI pour cette API est :`describe-db-cluster-snapshot-attributes`.

Renvoie une liste de noms et de valeurs d'attributs d'instantané de cluster de bases de données pour un instantané de cluster de bases de données manuel.

Lorsque vous partagez des instantanés avec d'autres comptes Amazon, `DescribeDBClusterSnapshotAttributes` renvoie l'`restore`attribut et une liste IDs des comptes Amazon autorisés à copier ou à restaurer l'instantané manuel du cluster de base de données. Si le paramètre `all` est inclus dans la liste des valeurs pour l'attribut `restore`, l'instantané de cluster de bases de données manuel est public et peut être copié ou restauré par tous les comptes Amazon.

Pour ajouter ou supprimer l'accès d'un compte Amazon afin de copier ou de restaurer un instantané de cluster de bases de données manuel, ou de rendre l'instantané de cluster de bases de données manuel public ou privé, utilisez l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).

**Demande**
+ **DBClusterSnapshotIdentifier** (dans la CLI : `--db-cluster-snapshot-identifier`) : *obligatoire :* chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données pour lequel décrire les attributs.

**Réponse**

Contient les résultats d'appel réussi à l'action d'API [Décrire DBCluster SnapshotAttributes (action)](#DescribeDBClusterSnapshotAttributes).

Les attributs d'instantané de cluster de bases de données manuel sont utilisés pour autoriser d'autres comptes Amazon à copier ou restaurer un instantané de cluster de bases de données manuel. Pour plus d'informations, consultez l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).
+ **DBClusterSnapshotAttributes** : tableau d'objets [DBClusterSnapshotAttribute](#DBClusterSnapshotAttribute).

  Liste des attributs et des valeurs de l'instantané de cluster de bases de données manuel.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données manuel sur lequel s'appliquent les attributs.

**Erreurs**
+ [DBClusterSnapshotNotFoundFault](api-faults.md#DBClusterSnapshotNotFoundFault)

## *Structures :*
<a name="api-snapshots-structures-spacer"></a>

## DBClusterInstantané (structure)
<a name="DBClusterSnapshot"></a>

Contient les détails d'un instantané de cluster de bases de données Amazon Neptune.

Ce type de données est utilisé comme élément de réponse dans l'action [Décrire les DBCluster instantanés (action)](#DescribeDBClusterSnapshots).

**Champs**
+ **AllocatedStorage** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie la taille de stockage allouée en gigaoctets (Gio).
+ **AvailabilityZones** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la liste des zones de EC2 disponibilité dans lesquelles les instances du snapshot du cluster de base de données peuvent être restaurées.
+ **ClusterCreateTime**— Il s'agit d'un TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle le cluster de bases de données a été créé, en heure UTC (Universal Coordinated Time).
+ **DBClusterIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant du cluster de bases de données à partir duquel cet instantané de cluster de bases de données a été créé.
+ **DBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Amazon Resource Name (ARN) de l'instantané de cluster de bases de données.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie l'identifiant d'un instantané de cluster de bases de données. Doit correspondre à l'identifiant d'un instantané existant.

  Après avoir restauré un cluster de bases de données à l'aide d'un `DBClusterSnapshotIdentifier`, vous devez spécifier le même `DBClusterSnapshotIdentifier` pour toute mise à jour ultérieure de ce cluster. Lorsque vous spécifiez cette propriété pour une mise à jour, le cluster de bases de données n'est pas restauré de nouveau à partir de l'instantané, et les données de la base de données ne sont pas modifiées.

  Toutefois, si vous ne spécifiez pas le `DBClusterSnapshotIdentifier`, un cluster de bases de données vide est créé et le cluster de bases de données d'origine est supprimé. Si vous spécifiez une propriété différente de la propriété précédente de restauration d'instantané, le cluster de bases de données est restauré à partir de l'instantané spécifié par le `DBClusterSnapshotIdentifier`, et le cluster de bases de données d'origine est supprimé.
+ **Engine** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le nom du moteur de base de données.
+ **EngineVersion** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit la version du moteur de base de données à utiliser pour cet instantané de cluster de bases de données.
+ **IAMDatabaseAuthenticationEnabled** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Valeur true (vrai) si le mappage des comptes Amazon Identity and Access Management (IAM) aux comptes de base de données est activé ; sinon, valeur false (faux).
+ **KmsKeyId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si `StorageEncrypted` a la valeur true (vrai), il s'agit de l'identifiant de clé Amazon KMS pour le cluster de bases de données chiffré.
+ **LicenseModel** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit les informations sur le modèle de licence pour cet instantané de cluster de bases de données.
+ **PercentProgress** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie une estimation du pourcentage de données transférées.
+ **Port** : entier de type : `integer` (entier signé de 32 bits).

  Spécifie le port écouté par le cluster de bases de données au moment de l'instantané.
+ **SnapshotCreateTime**— Il s'agit d'un TStamp, de type : `timestamp` (un point dans le temps, généralement défini comme un décalage par rapport à minuit le 01/01/1970).

  Spécifie l'heure à laquelle l'instantané a été pris, au format UTC (temps universel).
+ **SnapshotType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit le type de l'instantané de cluster de bases de données.
+ **SourceDBClusterSnapshotArn** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Si l'instantané de cluster de bases de données a été copié à partir d'un instantané de cluster de bases de données source, l'Amazon Resource Name (ARN) de l'instantané de cluster de bases de données source, une valeur null dans le cas contraire.
+ **Status** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Spécifie le statut de cet instantané de cluster de bases de données.
+ **StorageEncrypted** : valeur booléenne de type : `boolean` (valeur booléenne : true ou false).

  Indique si l'instantané de cluster de bases de données est chiffré.
+ **StorageType** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Type de stockage associé à l’instantané de cluster de bases de données.
+ **VpcId** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Fournit l'ID de VPC associé à l'instantané de cluster de bases de données.

`DBClusterSnapshot` est utilisé comme élément de réponse pour :
+ [Créer un DBCluster instantané](#CreateDBClusterSnapshot)
+ [Copier DBCluster un instantané](#CopyDBClusterSnapshot)
+ [Supprimer DBCluster un instantané](#DeleteDBClusterSnapshot)

## DBClusterSnapshotAttribute (structure)
<a name="DBClusterSnapshotAttribute"></a>

Contient le nom et les valeurs d'un attribut d'instantané de cluster de bases de données manuel.

Les attributs d'instantané de cluster de bases de données manuel sont utilisés pour autoriser d'autres comptes Amazon à restaurer un instantané de cluster de bases de données manuel. Pour plus d'informations, consultez l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).

**Champs**
+ **AttributeName** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Nom de l'attribut d'instantané de cluster de bases de données manuel.

  L'attribut nommé `restore` fait référence à la liste des comptes Amazon autorisés à copier ou restaurer l'instantané de cluster de bases de données manuel. Pour plus d'informations, consultez l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).
+ **AttributeValues** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Valeur(s) de l'attribut d'instantané de cluster de bases de données manuel.

  Si le `AttributeName` champ est défini sur`restore`, cet élément renvoie une liste IDs des comptes Amazon autorisés à copier ou à restaurer l'instantané manuel du cluster de base de données. Si une valeur `all` se trouve dans la liste, l'instantané de cluster de bases de données manuel est public et disponible pour la copie ou la restauration des comptes Amazon.

## DBClusterSnapshotAttributesResult (structure)
<a name="DBClusterSnapshotAttributesResult"></a>

Contient les résultats d'appel réussi à l'action d'API [Décrire DBCluster SnapshotAttributes (action)](#DescribeDBClusterSnapshotAttributes).

Les attributs d'instantané de cluster de bases de données manuel sont utilisés pour autoriser d'autres comptes Amazon à copier ou restaurer un instantané de cluster de bases de données manuel. Pour plus d'informations, consultez l'action d'API [Modifier DBCluster SnapshotAttribute (action)](#ModifyDBClusterSnapshotAttribute).

**Champs**
+ **DBClusterSnapshotAttributes** : tableau d'objets [DBClusterSnapshotAttribute](#DBClusterSnapshotAttribute).

  Liste des attributs et des valeurs de l'instantané de cluster de bases de données manuel.
+ **DBClusterSnapshotIdentifier** : chaîne de type : `string` (chaîne encodée en UTF-8).

  Identifiant de l'instantané de cluster de bases de données manuel sur lequel s'appliquent les attributs.

`DBClusterSnapshotAttributesResult` est utilisé comme élément de réponse pour :
+ [Décrivez DBCluster SnapshotAttributes](#DescribeDBClusterSnapshotAttributes)
+ [Modifier DBCluster SnapshotAttribute](#ModifyDBClusterSnapshotAttribute)