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. # StartCopyJob Démarre une tâche pour créer une copie unique de la ressource spécifiée. Ne prend pas en charge les sauvegardes continues. Voir [Réessayer une tâche de copie](https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry) pour plus d'informations sur la manière dont les nouvelles AWS Backup tentatives de copie peuvent être effectuées. ## Syntaxe de la demande ``` PUT /copy-jobs HTTP/1.1 Content-type: application/json { "DestinationBackupVaultArn": "string", "IamRoleArn": "string", "IdempotencyToken": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointArn": "string", "SourceBackupVaultName": "string" } ``` ## Paramètres de demande URI La demande n’utilise pas de paramètres URI. ## Corps de la demande Cette demande accepte les données suivantes au format JSON. ** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) ** Un Amazon Resource Name (ARN) qui identifie de façon unique un coffre-fort de destination sur lequel effectuer la copie ; par exemple, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Type : Chaîne Obligatoire : oui ** [IamRoleArn](#API_StartCopyJob_RequestSyntax) ** Spécifie l'ARN du rôle IAM utilisé pour copier le point de récupération cible ; par exemple, `arn:aws:iam::123456789012:role/S3Access`. Type : Chaîne Obligatoire : oui ** [IdempotencyToken](#API_StartCopyJob_RequestSyntax) ** Chaîne choisie par le client que vous pouvez utiliser pour faire la distinction entre des appels par ailleurs identiques à `StartCopyJob`. Toute nouvelle tentative d'une demande réussie avec le même jeton d'idempotence entraîne un message de réussite sans qu'aucune action ne soit entreprise. Type : chaîne Obligatoire : non ** [Lifecycle](#API_StartCopyJob_RequestSyntax) ** Spécifie la période, en jours, avant qu'un point de restauration ne passe en stockage à froid ou ne soit supprimé. Les sauvegardes transférées vers une chambre froide doivent être stockées dans une chambre froide pendant au moins 90 jours. Par conséquent, sur la console, le paramètre de rétention doit être supérieur de 90 jours au réglage de transition vers le froid après plusieurs jours. Le paramètre de transition vers le froid après plusieurs jours ne peut pas être modifié une fois qu'une sauvegarde est passée au mode froid. Les types de ressources pouvant passer au stockage à froid sont répertoriés dans le tableau [Disponibilité des fonctionnalités par ressource](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignore cette expression pour les autres types de ressources. Pour supprimer le cycle de vie et les périodes de rétention existants et conserver vos points de restauration indéfiniment, spécifiez -1 pour `MoveToColdStorageAfterDays` et`DeleteAfterDays`. Type : objet [Lifecycle](API_Lifecycle.md) Obligatoire : non ** [RecoveryPointArn](#API_StartCopyJob_RequestSyntax) ** ARN identifiant de manière unique un point de récupération à utiliser pour la tâche de copie ; par exemple, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 B5E7-9EB0-435A-A80B-108B488B0D45. EB3 Type : Chaîne Obligatoire : oui ** [SourceBackupVaultName](#API_StartCopyJob_RequestSyntax) ** Le nom d'un conteneur source logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms propres au compte utilisé pour les créer et à la AWS région dans laquelle ils ont été créés. Type : Chaîne Modèle : `^[a-zA-Z0-9\-\_]{2,50}$` Obligatoire : oui ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "CopyJobId": "string", "CreationDate": number, "IsParent": boolean } ``` ## 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. ** [CopyJobId](#API_StartCopyJob_ResponseSyntax) ** Identifie de manière unique une tâche de copie. Type : Chaîne ** [CreationDate](#API_StartCopyJob_ResponseSyntax) ** Date et heure de création d'une tâche de copie, au format Unix et au format UTC (temps universel coordonné). La valeur de `CreationDate` est précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s. Type : Timestamp ** [IsParent](#API_StartCopyJob_ResponseSyntax) ** Il s'agit d'une valeur booléenne renvoyée indiquant qu'il s'agit d'une tâche de copie parent (composite). Type : Boolean ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md). ** InvalidParameterValueException ** Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée. ** Context ** ** Type ** Code d’état HTTP : 400 ** InvalidRequestException ** Indique une erreur dans la saisie de la demande. Par exemple, un paramètre n'est pas du bon type. ** Context ** ** Type ** Code d’état HTTP : 400 ** LimitExceededException ** Une limite de la demande a été dépassée ; par exemple, le nombre maximum d'éléments autorisés dans une demande. ** Context ** ** Type ** Code d’état HTTP : 400 ** MissingParameterValueException ** Indique qu'un paramètre obligatoire est manquant. ** Context ** ** Type ** Code d’état HTTP : 400 ** ResourceNotFoundException ** Aucune ressource requise pour l'action n'existe. ** Context ** ** Type ** Code d’état HTTP : 400 ** ServiceUnavailableException ** La demande a échoué en raison d'une défaillance temporaire du serveur. ** Context ** ** Type ** Code d’état HTTP : 500 ## 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/backup-2018-11-15/StartCopyJob) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartCopyJob) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartCopyJob) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartCopyJob) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartCopyJob) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartCopyJob) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartCopyJob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartCopyJob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartCopyJob) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartCopyJob)