UpdateReportPlan - AWS Backup

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

UpdateReportPlan

更新指定的報告計劃。

請求語法

PUT /audit/report-plans/reportPlanName HTTP/1.1 Content-type: application/json { "IdempotencyToken": "string", "ReportDeliveryChannel": { "Formats": [ "string" ], "S3BucketName": "string", "S3KeyPrefix": "string" }, "ReportPlanDescription": "string", "ReportSetting": { "Accounts": [ "string" ], "FrameworkArns": [ "string" ], "NumberOfFrameworks": number, "OrganizationUnits": [ "string" ], "Regions": [ "string" ], "ReportTemplate": "string" } }

URI 請求參數

請求會使用下列 URI 參數。

reportPlanName

報告計畫的唯一名稱。此名稱的長度必須介於 1 到 256 個字元,且開頭要為英文字母,由英文字母 (a-z、A-Z)、數字 (0-9) 和底線 (_) 組成。

長度限制:長度下限為 1。長度上限為 256。

模式:[a-zA-Z][_a-zA-Z0-9]*

必要:是

請求主體

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

IdempotencyToken

客戶所選擇的字串,可用來區分在其他方面相同的 UpdateReportPlanInput 呼叫。重試具有相同等冪性字符的成功請求會導致出現成功消息,但未執行任何動作。

類型:字串

必要:否

ReportDeliveryChannel

有關在何處交付報告的資訊,特別是 Amazon S3 儲存貯體名稱、S3 key prefix 以及報告格式。

類型:ReportDeliveryChannel 物件

必要:否

ReportPlanDescription

報告計劃的選用描述,最多可包含 1,024 個字元。

類型:字串

長度限制:長度下限為 0。長度上限為 1024。

模式:.*\S.*

必要:否

ReportSetting

報告的報告範本。使用報告範本建立的報告。報告範本包括:

RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT

如果報告模板是RESOURCE_COMPLIANCE_REPORTCONTROL_COMPLIANCE_REPORT,則此 API 資源還通過 AWS 區域 和框架描述報告覆蓋範圍。

類型:ReportSetting 物件

必要:否

回應語法

HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "ReportPlanArn": "string", "ReportPlanName": "string" }

回應元素

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

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

CreationTime

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

類型:Timestamp

ReportPlanArn

可唯一識別資源的 Amazon Resource Name (ARN)。ARN 的格式取決於資源類型。

類型:字串

ReportPlanName

報告計畫的唯一名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 256。

模式:[a-zA-Z][_a-zA-Z0-9]*

錯誤

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

ConflictException

AWS Backup 在完成上一個動作之前,無法執行您要求的動作。請稍後再試。

HTTP 狀態碼:400

InvalidParameterValueException

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

HTTP 狀態碼:400

MissingParameterValueException

表示缺少必要的參數。

HTTP 狀態碼:400

ResourceNotFoundException

動作所需的資源不存在。

HTTP 狀態碼:400

ServiceUnavailableException

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

HTTP 狀態碼:500

另請參閱

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