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

CreateRestoreTestingSelection

Cette demande peut être envoyée une fois que la CreateRestoreTestingPlan demande a été renvoyée avec succès. Il s’agit de la deuxième partie de la création d’un plan de test des ressources, qui doit être réalisée de manière séquentielle.

Cela comprend RestoreTestingSelectionName, ProtectedResourceType et l’un des éléments suivants :

  • ProtectedResourceArns

  • ProtectedResourceConditions

Chaque type de ressource protégée peut avoir une seule valeur.

Une sélection de tests de la restauration peut inclure une valeur générique (« * ») pour ProtectedResourceArns avec ProtectedResourceConditions. Vous pouvez également inclure jusqu’à 30 ARN de ressources protégées spécifiques dans ProtectedResourceArns.

Impossible de sélectionner à la fois les types de ressources protégées ET les ARN spécifiques. La demande échouera si les deux sont inclus.

Syntaxe de la demande

PUT /restore-testing/plans/RestoreTestingPlanName/selections HTTP/1.1 Content-type: application/json { "CreatorRequestId": "string", "RestoreTestingSelection": { "IamRoleArn": "string", "ProtectedResourceArns": [ "string" ], "ProtectedResourceConditions": { "StringEquals": [ { "Key": "string", "Value": "string" } ], "StringNotEquals": [ { "Key": "string", "Value": "string" } ] }, "ProtectedResourceType": "string", "RestoreMetadataOverrides": { "string" : "string" }, "RestoreTestingSelectionName": "string", "ValidationWindowHours": number } }

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

RestoreTestingPlanName

Entrez le nom du plan de test de restauration renvoyé par la CreateRestoreTestingPlan demande correspondante.

Obligatoire : oui

Corps de la demande

Cette demande accepte les données suivantes au format JSON.

CreatorRequestId

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

Type : chaîne

Obligatoire : non

RestoreTestingSelection

Cela comprend RestoreTestingSelectionName, ProtectedResourceType et l’un des éléments suivants :

  • ProtectedResourceArns

  • ProtectedResourceConditions

Chaque type de ressource protégée peut avoir une seule valeur.

Une sélection de tests de la restauration peut inclure une valeur générique (« * ») pour ProtectedResourceArns avec ProtectedResourceConditions. Vous pouvez également inclure jusqu’à 30 ARN de ressources protégées spécifiques dans ProtectedResourceArns.

Type : objet RestoreTestingSelectionForCreate

Obligatoire : oui

Syntaxe de la réponse

HTTP/1.1 201 Content-type: application/json { "CreationTime": number, "RestoreTestingPlanArn": "string", "RestoreTestingPlanName": "string", "RestoreTestingSelectionName": "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 au format JSON par le service.

CreationTime

Heure à laquelle la sélection des ressources testées a été créée.

Type : Timestamp

RestoreTestingPlanArn

L'ARN du plan de test de restauration auquel la sélection de test de restauration est associée.

Type : chaîne

RestoreTestingPlanName

Nom du plan de test de 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 : chaîne

RestoreTestingSelectionName

Nom de la sélection de test de restauration pour le plan de test de restauration associé.

Type : chaîne

Erreurs

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

AlreadyExistsException

La ressource demandée existe déjà.

Code d’état HTTP : 400

InvalidParameterValueException

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

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.

Code d’état HTTP : 400

MissingParameterValueException

Indique qu'un paramètre obligatoire est manquant.

Code d’état HTTP : 400

ResourceNotFoundException

Aucune ressource requise pour l'action n'existe.

Code d’état HTTP : 400

ServiceUnavailableException

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

Code d’état HTTP : 500

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :