CreateRestoreTestingPlan - AWS Backup

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.

CreateRestoreTestingPlan

Crée un plan de test de restauration.

La première des deux étapes pour créer un plan de test de restauration. Une fois cette demande réussie, terminez la procédure en utilisant CreateRestoreTestingSelection.

Syntaxe de la requête

PUT /restore-testing/plans HTTP/1.1 Content-type: application/json { "CreatorRequestId": "string", "RestoreTestingPlan": { "RecoveryPointSelection": { "Algorithm": "string", "ExcludeVaults": [ "string" ], "IncludeVaults": [ "string" ], "RecoveryPointTypes": [ "string" ], "SelectionWindowDays": number }, "RestoreTestingPlanName": "string", "ScheduleExpression": "string", "ScheduleExpressionTimezone": "string", "StartWindowHours": number }, "Tags": { "string" : "string" } }

URIParamètres de demande

La demande n'utilise aucun URI paramètre.

Corps de la requête

La demande accepte les données suivantes au JSON format suivant.

CreatorRequestId

Il s’agit d’une chaîne unique qui identifie la demande et permet de réessayer les demandes ayant échoué sans risque d’exécuter l’opération deux fois. Ce paramètre est facultatif. S'il est utilisé, ce paramètre doit contenir de 1 à 50 caractères alphanumériques ou « -_. » caractères.

Type : chaîne

Obligatoire : non

RestoreTestingPlan

Un plan de tests de la restauration doit contenir une chaîne RestoreTestingPlanName unique que vous créez et doit contenir un cron ScheduleExpression. Vous pouvez éventuellement inclure un nombre entier StartWindowHours et une chaîne CreatorRequestId.

RestoreTestingPlanName est une chaîne unique qui est le nom du plan de test de la restauration. Elle ne peut pas être modifiée après sa création et elle doit être composée uniquement de caractères alphanumériques et de traits de soulignement.

Type : objet RestoreTestingPlanForCreate

Obligatoire : oui

Tags

Les balises à attribuer au plan de test de restauration.

Type : mappage chaîne/chaîne

Obligatoire : non

Syntaxe de la réponse

HTTP/1.1 201 Content-type: application/json { "CreationTime": number, "RestoreTestingPlanArn": "string", "RestoreTestingPlanName": "string" }

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 201.

Les données suivantes sont renvoyées sous JSON forme formatée par le service.

CreationTime

Date et heure de création du plan de test de restauration, au format Unix et en temps universel coordonné (UTC). La valeur de CreationTime 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

RestoreTestingPlanArn

Nom de ressource Amazon (ARN) qui identifie de manière unique le plan de test de restauration créé.

Type : String

RestoreTestingPlanName

Cette chaîne unique est le nom du plan de test de la restauration.

Le nom ne peut pas être modifié après la création. Le nom comprend uniquement des caractères alphanumériques et des traits de soulignement. La longueur maximale est de 50.

Type : String

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

AlreadyExistsException

La ressource demandée existe déjà.

HTTPCode de statut : 400

ConflictException

AWS Backup ne peut pas exécuter l'action que vous avez demandée tant qu'il n'a pas terminé d'exécuter une action précédente. Réessayez ultérieurement.

HTTPCode de statut : 400

InvalidParameterValueException

Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.

HTTPCode de statut : 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.

HTTPCode de statut : 400

MissingParameterValueException

Indique qu'un paramètre obligatoire est manquant.

HTTPCode de statut : 400

ServiceUnavailableException

La demande a échoué en raison d'une défaillance temporaire du serveur.

HTTPCode de statut : 500

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :