ApplyPendingMaintenanceAction - Amazon DocumentDB
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

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

ApplyPendingMaintenanceAction

要套用至資源的待定維護動作類型。

請求語法

POST /pending-action HTTP/1.1
Content-type: application/json

{
   "applyAction": "string",
   "applyOn": "string",
   "optInType": "string",
   "resourceArn": "string"
}

URI 請求參數

請求不會使用任何URI參數。

請求主體

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

applyAction

要套用至資源的待處理維護動作。

有效的動作為：

  • ENGINE_UPDATE

  • ENGINE_UPGRADE

  • SECURITY_UPDATE

  • OS_UPDATE

  • MASTER_USER_PASSWORD_UPDATE

類型：字串

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

必要：是

optInType

值，指定選擇使用請求的類型，或復原選擇使用請求。無法復原 IMMEDIATE 類型的選擇使用請求。

類型：字串

有效值:IMMEDIATE | NEXT_MAINTENANCE | APPLY_ON | UNDO_OPT_IN

必要：是

resourceArn

套用待定維護動作之資源的 Amazon DocumentDB Amazon Resource Name （ARN）。

類型：字串

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

必要：是

applyOn

套用待定維護動作的特定日期。在 opt-in-type 為 APPLY_ON 時需要。格式：yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm

類型：字串

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

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "resourcePendingMaintenanceAction": { 
      "pendingMaintenanceActionDetails": [ 
         { 
            "action": "string",
            "autoAppliedAfterDate": "string",
            "currentApplyDate": "string",
            "description": "string",
            "forcedApplyDate": "string",
            "optInStatus": "string"
         }
      ],
      "resourceArn": "string"
   }
}

回應元素

如果動作成功，服務會傳回 HTTP 200 個回應。

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

resourcePendingMaintenanceAction

正在套用的待定維護動作的輸出。

類型：ResourcePendingMaintenanceAction 物件

錯誤

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

AccessDeniedException

當沒有足夠的許可來執行動作時發生例外狀況。

HTTP 狀態碼：403

ConflictException

存在存取衝突。

HTTP 狀態碼：409

InternalServerException

發生內部伺服器錯誤。

HTTP 狀態碼：500

ResourceNotFoundException

找不到指定的資源。

HTTP 狀態碼：404

ThrottlingException

ThrottlingException 將在請求因請求限流而遭拒時擲回 。

HTTP 狀態碼：429

ValidationException

定義驗證例外狀況的結構。

HTTP 狀態碼：400

另請參閱

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