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

CreateBackupSelection

Crée un document JSON qui spécifie un ensemble de ressources à attribuer à un plan de sauvegarde. Pour des exemples, consultez Attribution de ressources par programmation.

Syntaxe de la demande

PUT /backup/plans/backupPlanId/selections/ HTTP/1.1 Content-type: application/json { "BackupSelection": { "Conditions": { "StringEquals": [ { "ConditionKey": "string", "ConditionValue": "string" } ], "StringLike": [ { "ConditionKey": "string", "ConditionValue": "string" } ], "StringNotEquals": [ { "ConditionKey": "string", "ConditionValue": "string" } ], "StringNotLike": [ { "ConditionKey": "string", "ConditionValue": "string" } ] }, "IamRoleArn": "string", "ListOfTags": [ { "ConditionKey": "string", "ConditionType": "string", "ConditionValue": "string" } ], "NotResources": [ "string" ], "Resources": [ "string" ], "SelectionName": "string" }, "CreatorRequestId": "string" }

Paramètres de demande URI

La demande utilise les paramètres URI suivants.

backupPlanId

ID du plan de sauvegarde.

Obligatoire : oui

Corps de la demande

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

BackupSelection

Le corps d'une demande visant à affecter un ensemble de ressources à un plan de sauvegarde.

Type : objet BackupSelection

Obligatoire : oui

CreatorRequestId

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

Syntaxe de la réponse

HTTP/1.1 200 Content-type: application/json { "BackupPlanId": "string", "CreationDate": number, "SelectionId": "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.

BackupPlanId

ID du plan de sauvegarde.

Type : chaîne

CreationDate

Date et heure de création d'une sélection de sauvegarde, 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

SelectionId

Identifie de façon unique le corps d'une demande d'attribution d'un ensemble de ressources à un plan de sauvegarde.

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

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 :