リクエストの構文 URI リクエストパラメータリクエスト本文レスポンスの構文レスポンス要素エラー以下の資料も参照してください。

CreateLegalHold

復旧ポイント (バックアップ) にリーガルホールドを作成します。リーガルホールドとは、権限のあるユーザーがリーガルホールドをキャンセルするまでの間の、バックアップの変更または削除の制限です。復旧ポイントに 1 つ以上の有効なリーガルホールドがある場合、復旧ポイントを削除するまたは関連付けを解除する操作はすべてエラーで失敗します。

リクエストの構文


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

リソースタイプやバックアップボールトなど、一連のリソースを割り当てる基準。

型: 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"
}