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.
# CopySnapshot
Fait une copie d'un instantané existant.
## Syntaxe de la requête
```
{
"KmsKeyId": "string",
"SourceSnapshotName": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TargetBucket": "string",
"TargetSnapshotName": "string"
}
```
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [KmsKeyId](#API_CopySnapshot_RequestSyntax) **
ID de la clé KMS utilisée pour chiffrer le snapshot cible.
Type : Chaîne
Contraintes de longueur : longueur maximale de 2048.
Obligatoire : non
** [SourceSnapshotName](#API_CopySnapshot_RequestSyntax) **
Nom d'un instantané existant à partir duquel créer une copie.
Type : Chaîne
Obligatoire : oui
** [Tags](#API_CopySnapshot_RequestSyntax) **
Liste des balises à ajouter à cette ressource. Une balise est une paire clé-valeur. Une clé de balise doit être accompagnée d'une valeur de balise, bien que la valeur nulle soit acceptée.
Type : tableau d’objets [Tag](API_Tag.md)
Membres du tableau : nombre maximum de 200 éléments.
Obligatoire : non
** [TargetBucket](#API_CopySnapshot_RequestSyntax) **
Le compartiment Amazon S3 vers lequel le snapshot est exporté. Ce paramètre est utilisé uniquement lors de l'exportation d'un instantané pour un accès externe. Lorsque vous utilisez ce paramètre pour exporter un instantané, assurez-vous que MemoryDB dispose des autorisations nécessaires pour ce compartiment S3. Pour plus d'informations, consultez [Étape 2 : Accorder l'accès à MemoryDB à votre compartiment Amazon S3](https://docs.aws.amazon.com/MemoryDB/latest/devguide/snapshots-exporting.html).
Type : Chaîne
Contraintes de longueur : longueur maximale de 255.
Modèle : `^[A-Za-z0-9._-]+$`
Obligatoire : non
** [TargetSnapshotName](#API_CopySnapshot_RequestSyntax) **
Nom de la copie instantanée. MemoryDB n'autorise pas le remplacement d'un instantané. Ce nom doit donc être unique dans son contexte : MemoryDB ou un bucket Amazon S3 en cas d'exportation. Cette valeur est stockée sous la forme d’une chaîne en minuscules.
Type : Chaîne
Obligatoire : oui
## Syntaxe de la réponse
```
{
"Snapshot": {
"ARN": "string",
"ClusterConfiguration": {
"Description": "string",
"Engine": "string",
"EngineVersion": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"MultiRegionParameterGroupName": "string",
"Name": "string",
"NodeType": "string",
"NumShards": number,
"ParameterGroupName": "string",
"Port": number,
"Shards": [
{
"Configuration": {
"ReplicaCount": number,
"Slots": "string"
},
"Name": "string",
"Size": "string",
"SnapshotCreationTime": number
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SubnetGroupName": "string",
"TopicArn": "string",
"VpcId": "string"
},
"DataTiering": "string",
"KmsKeyId": "string",
"Name": "string",
"Source": "string",
"Status": "string"
}
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [Snapshot](#API_CopySnapshot_ResponseSyntax) **
Représente une copie d'un cluster entier au moment où le cliché a été pris.
Type : objet [Snapshot](API_Snapshot.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).
** InvalidParameterCombinationException **
Code d’état HTTP : 400
** InvalidParameterValueException **
Code d’état HTTP : 400
** InvalidSnapshotStateFault **
Code d’état HTTP : 400
** ServiceLinkedRoleNotFoundFault **
Code d’état HTTP : 400
** SnapshotAlreadyExistsFault **
Code d’état HTTP : 400
** SnapshotNotFoundFault **
Code d’état HTTP : 400
** SnapshotQuotaExceededFault **
Code d’état HTTP : 400
** TagQuotaPerResourceExceeded **
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/CopySnapshot)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/CopySnapshot)