本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
UpdateBackupPlan
更新指定的備份計畫。新版本會以其 ID 唯一識別。
請求語法
POST /backup/plans/backupPlanId
HTTP/1.1
Content-type: application/json
{
"BackupPlan": {
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string
" : "string
"
},
"ResourceType": "string
"
}
],
"BackupPlanName": "string
",
"Rules": [
{
"CompletionWindowMinutes": number
,
"CopyActions": [
{
"DestinationBackupVaultArn": "string
",
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
,
"OptInToArchiveForSupportedResources": boolean
}
}
],
"EnableContinuousBackup": boolean
,
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointTags": {
"string
" : "string
"
},
"RuleName": "string
",
"ScheduleExpression": "string
",
"ScheduleExpressionTimezone": "string
",
"StartWindowMinutes": number
,
"TargetBackupVaultName": "string
"
}
]
}
}
URI 請求參數
請求使用以下URI參數。
- backupPlanId
-
備份計畫的 ID。
必要:是
請求主體
請求接受下列JSON格式的資料。
- BackupPlan
-
備份計畫的內文。包括一個
BackupPlanName
和一或多組Rules
。類型:BackupPlanInput 物件
必要:是
回應語法
HTTP/1.1 200
Content-type: application/json
{
"AdvancedBackupSettings": [
{
"BackupOptions": {
"string" : "string"
},
"ResourceType": "string"
}
],
"BackupPlanArn": "string",
"BackupPlanId": "string",
"CreationDate": number,
"VersionId": "string"
}
回應元素
如果動作成功,服務會傳回 HTTP 200 個回應。
服務會以 JSON 格式傳回下列資料。
- AdvancedBackupSettings
-
包含每種資源類型的
BackupOptions
清單。類型:AdvancedBackupSetting 物件陣列
- BackupPlanArn
-
可唯一識別備份計劃的 Amazon Resource Name (ARN);例如
arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50
。類型:字串
- BackupPlanId
-
唯一識別備份計畫。
類型:字串
- CreationDate
-
建立備份計畫的日期和時間,採用 Unix 格式和國際標準時間 (UTC)。
CreationDate
的值精確到毫秒。例如,值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型:Timestamp
- VersionId
-
唯一、隨機產生的 Unicode UTF編碼字串,長度最多為 1,024 個位元組。版本 ID 不能編輯。
類型:字串
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InvalidParameterValueException
-
表示參數的值出現問題。例如,值超出範圍。
HTTP 狀態碼:400
- MissingParameterValueException
-
表示缺少必要的參數。
HTTP 狀態碼:400
- ResourceNotFoundException
-
動作所需的資源不存在。
HTTP 狀態碼:400
- ServiceUnavailableException
-
由於伺服器發生臨時故障,請求失敗。
HTTP 狀態碼:500
另請參閱
如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: