翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateRecoveryPointLifecycle
復旧ポイントの移行ライフサイクルを設定します。
ライフサイクルは、保護されたリソースがコールドストレージに移行するタイミングと、期限切れになるタイミングを定義します。 は、定義したライフサイクルに従って自動的にバックアップ AWS Backup を移行および期限切れにします。
コールドストレージに移行できるリソースタイプは、リソーステーブルごとの特徴量の可用性に記載されています。 は、他のリソースタイプのこの式 AWS Backup を無視します。
コールドストレージに移行されたバックアップは、そこに最低 90 日保存される必要があります。したがって、「保持期間」の設定は、「コールドへの移行 (日数)」設定から 90 日以上あける必要があります。バックアップがコールドに移行された後で、「コールドへの移行 (日数)」設定を変更することはできません。
重要
ライフサイクルで現在パラメータDeleteAfterDaysと を使用している場合はMoveToColdStorageAfterDays、このオペレーションを呼び出すときに、これらのパラメータとその値を含めます。これらを含めない場合、プランが null 値で更新される可能性があります。
この操作では、連続バックアップはサポートされません。
リクエストの構文
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json
{
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
}
}URI リクエストパラメータ
リクエストは、次のURIパラメータを使用します。
- backupVaultName
-
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の AWS リージョンに一意の名前で識別されます。
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$必須：はい
- recoveryPointArn
-
リカバリポイントを一意に識別する Amazon リソースネーム (ARN）。例えば、
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。必須：はい
リクエストボディ
リクエストは、次のJSON形式のデータを受け入れます。
- Lifecycle
-
ライフサイクルは、保護されたリソースがコールドストレージに移行するタイミングと、期限切れになるタイミングを定義します。 は、定義したライフサイクルに従って自動的にバックアップ AWS Backup を移行および期限切れにします。
コールドストレージに移行されたバックアップは、そこに最低 90 日保存される必要があります。したがって、「保持期間」の設定は、「コールドへの移行 (日数)」設定から 90 日以上あける必要があります。バックアップがコールドに移行された後で、「コールドへの移行 (日数)」設定を変更することはできません。
型: Lifecycle オブジェクト
必須: いいえ
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"CalculatedLifecycle": {
"DeleteAt": number,
"MoveToColdStorageAt": number
},
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointArn": "string"
}レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- BackupVaultArn
-
バックアップボールトを一意に識別ARNする 。例:
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault。型: 文字列
- CalculatedLifecycle
-
DeleteAtおよびMoveToColdStorageAtタイムスタンプを含むCalculatedLifecycleオブジェクト型: CalculatedLifecycle オブジェクト
- Lifecycle
-
ライフサイクルは、保護されたリソースがコールドストレージに移行するタイミングと、期限切れになるタイミングを定義します。 は、定義したライフサイクルに従って自動的にバックアップ AWS Backup を移行および期限切れにします。
コールドストレージに移行されたバックアップは、そこに最低 90 日保存される必要があります。したがって、「保持期間」の設定は、「コールドへの移行 (日数)」設定から 90 日以上あける必要があります。バックアップがコールドに移行された後で、「コールドへの移行 (日数)」設定を変更することはできません。
コールドストレージに移行できるリソースタイプは、リソーステーブルごとの特徴量の可用性に記載されています。 は、他のリソースタイプに対してこの式 AWS Backup を無視します。
型: Lifecycle オブジェクト
- RecoveryPointArn
-
リカバリポイントを一意に識別する Amazon リソースネーム (ARN）。例えば、
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。型: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード: 400
- InvalidRequestException
-
リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。
HTTP ステータスコード: 400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
HTTP ステータスコード: 400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード: 500
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。
