CreateLegalHold

對復原點 (備份) 建立合法訴訟保留。法務保存是在授權使用者取消法務保存之前，針對變更或刪除備份所進行的限制。如果復原點上有一或多個有效的法務保存，則刪除或取消關聯復原點的任何動作都會失敗，並顯示錯誤。

請求語法


POST /legal-holds/ HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "IdempotencyToken": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Tags": { 
      "string" : "string" 
   },
   "Title": "string"
}

URI 請求參數

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

請求主體

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

Description

合法持有的說明。

類型：字串

必要：是

IdempotencyToken

這是使用者選擇的字符，可用於區分在其他方面相同的呼叫。重試具有相同等冪性字符的成功請求會導致出現成功消息，但未執行任何動作。

類型：字串

必要：否

RecoveryPointSelection

指定一組資源的準則，例如資源類型或備份 Vault。

類型：RecoveryPointSelection 物件

必要：否

Tags

要包含的選用標籤。標籤是可用於管理、篩選和搜尋資源的鍵值對。允許使用的字元包括 UTF-8 字母、數字、空格，以及下列字元：+ - = . _ : /。

類型：字串到字串映射

必要：否

Title

合法持有權的所有權。

類型：字串

必要：是

回應語法


HTTP/1.1 200
Content-type: application/json

{
   "CreationDate": number,
   "Description": "string",
   "LegalHoldArn": "string",
   "LegalHoldId": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Status": "string",
   "Title": "string"
}