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