UpdateReportPlan - AWS Backup
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

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 金鑰字首和報告格式。

類型：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_REPORT或 CONTROL_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

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：