CreateBackupSelection - AWS Backup

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

CreateBackupSelection

建立 JSON 文件,可指定要指派給備份計畫的一組資源。如需範例,請參閱《Assigning resources programmatically》。

請求語法

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" }

URI 請求參數

請求會使用下列 URI 參數。

backupPlanId

備份計畫的識別碼。

必要:是

請求主體

請求接受採用 JSON 格式的下列資料。

BackupSelection

將一組資源指派給備份計劃的要求主體。

類型:BackupSelection 物件

必要:是

CreatorRequestId

可識別請求的唯一字串,且允許重試失敗的請求,而不會有兩次執行操作的風險。此為選用參數。

如果使用,此參數必須包含 1 至 50 個英數字元或 '-_'。字元。

類型:字串

必要:否

回應語法

HTTP/1.1 200 Content-type: application/json { "BackupPlanId": "string", "CreationDate": number, "SelectionId": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

BackupPlanId

備份計畫的識別碼。

類型:字串

CreationDate

建立備份選擇時的日期和時間,以 Unix 格式和國際標準時間 (UTC) 顯示。CreationDate 的值精確到毫秒。例如,值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。

類型:Timestamp

SelectionId

可唯一識別請求本文,將一組資源指派給備份計畫。

類型:字串

錯誤

如需所有動作常見的錯誤資訊,請參閱《常見錯誤》。

AlreadyExistsException

所需資源已存在。

HTTP 狀態碼:400

InvalidParameterValueException

表示參數的值出現問題。例如,值超出範圍。

HTTP 狀態碼:400

LimitExceededException

請求已超過限制;例如,請求中允許的最大項目數量。

HTTP 狀態碼:400

MissingParameterValueException

表示缺少必要的參數。

HTTP 狀態碼:400

ServiceUnavailableException

由於伺服器發生臨時故障,請求失敗。

HTTP 狀態碼:500

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: