翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
PutBackupVaultLockConfiguration
AWS Backup ボールトロックをバックアップボールトに適用し、 に保存されている、またはバックアップボールトに作成されたリカバリポイントを削除しようとしません。また、Vault Lock では、バックアップボールトに現在保存されているリカバリポイントの保持期間を制御するライフサイクルポリシーの更新も防止されます。指定した場合、Vault Lock は、バックアップボールトを対象とする将来のバックアップジョブおよびコピージョブに対して、最小および最大保持期間を適用します。
注記
AWS Backup ボールトロックは、Cohasset Associates SEC によって、17a-4、、CFTCおよび FINRA規制の対象となる環境での使用について評価されています。 AWS Backup ボールトロックがこれらの規制にどのように関連しているかの詳細については、「Cohasset Associates Compliance Assessment」を参照してください。
詳細については、「AWS Backup ボールトロック」を参照してください。
リクエストの構文
PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1
Content-type: application/json
{
"ChangeableForDays": number,
"MaxRetentionDays": number,
"MinRetentionDays": number
}URI リクエストパラメータ
リクエストは、次のURIパラメータを使用します。
- backupVaultName
-
保護するバックアップ AWS Backup ボールトの名前を指定するボールトロック設定。
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$必須: はい
リクエストボディ
リクエストは、次のJSON形式のデータを受け入れます。
- ChangeableForDays
-
ロック日より前の日数を指定するボール AWS Backup トロック設定。例えば、2022 年 1 月 1 日午後 8 時に を 30
ChangeableForDaysに設定すると、ロック日UTCは 2022 年 1 月 31 日午後 8 時に設定されますUTC。AWS Backup は、ボールトロックが有効になりイミュータブルになる前に 72 時間のクーリングオフ期間を適用します。したがって、
ChangeableForDaysを 3 以上に設定する必要があります。ロック日より前には、
DeleteBackupVaultLockConfigurationを使用して ボールトロックをボールトから削除でき、また、PutBackupVaultLockConfigurationを使用してボールトロックの構成を変更します。ロック日以降では、ボールトロックは不変になり、変更や削除はできません。このパラメータを指定しない場合は、
DeleteBackupVaultLockConfigurationを使用してボールトからボールトロックを削除でき、または、PutBackupVaultLockConfigurationを使用して、いつでもボールトロックの設定を変更できます。型: Long
必須：いいえ
- MaxRetentionDays
-
AWS Backup ボールトがリカバリポイントを保持する最大保持期間を指定するボールトロック設定。この設定は、たとえば、組織のポリシーで 4 年間（1460 日）保持した後に特定のデータを破棄する必要がある場合などに便利です。
このパラメータを指定しない場合、ボールトロックはボールト内のリカバリポイントに最大保持期間を強制しません。このパラメータが値なしで含まれている場合、ボールトロックは最大保持期間を適用しません。
このパラメータを指定した場合、ボールトへのバックアップジョブまたはコピージョブには、保存期間が最大保存期間以下のライフサイクル・ポリシーを持つ必要があります。ジョブの保持期間がその最大保存期間よりも長い場合、ボールトはバックアップジョブまたはコピージョブに失敗するため、ライフサイクル設定を変更するか、別のボールトを使用する必要があります。指定できる最長の最大保持期間は 36500 日 (約 100 年) です。ボールトロックの前にボールトにすでに保存されている復旧ポイントは影響を受けません。
型: Long
必須：いいえ
- MinRetentionDays
-
AWS Backup ボールトがリカバリポイントを保持する最小保持期間を指定するボールトロック設定。この設定は、たとえば、組織のポリシーで特定のデータを少なくとも 7 年間（2555 日）保持する必要がある場合に便利です。
このパラメータは、 を通じてボールトロックを作成する場合に必要です AWS CloudFormation。それ以外の場合は、このパラメータはオプションです。このパラメータを指定しない場合、ボールトロックは最小保持期間を強制しません。
このパラメータを指定した場合、ボールトへのバックアップジョブまたはコピージョブには、最小保存期間以上の保存期間を持つライフサイクルポリシーが必要です。ジョブの保持期間がその最小保存期間よりも短い場合、ボールトはそのバックアップジョブまたはコピージョブに失敗するため、ライフサイクル設定を変更するか、別のボールトを使用する必要があります。指定できる最小保持期間は 1 日です。ボールトロックの前にボールトにすでに保存されている復旧ポイントは影響を受けません。
型: Long
必須：いいえ
レスポンスの構文
HTTP/1.1 200
レスポンス要素
アクションが成功すると、サービスは空のHTTP本文で 200 HTTP レスポンスを送り返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード: 400
- InvalidRequestException
-
リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。
HTTP ステータスコード: 400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
HTTP ステータスコード: 400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
