翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DescribeRecoveryPoint ID、ステータス、暗号化およびライフサイクルなど、リカバリポイントに関連付けられたメタデータを返します。 ## リクエストの構文 ``` GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1 ``` ## URI リクエストパラメータリクエストでは、次の URI パラメータを使用します。 ** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) ** 指定されたバックアップボールトのアカウント ID。パターン: `^[0-9]{12}$` ** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) ** バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の AWS リージョンに一意の名前で識別されます。パターン: `^[a-zA-Z0-9\-\_]{2,50}$` 必須: はい ** [recoveryPointArn](#API_DescribeRecoveryPoint_RequestSyntax) ** `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`などのリカバリポイントを一意に識別する Amazon リソースネーム (ARN) です。必須: はい ## リクエストボディリクエストにリクエスト本文がありません。 ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "BackupSizeInBytes": number, "BackupVaultArn": "string", "BackupVaultName": "string", "CalculatedLifecycle": { "DeleteAt": number, "MoveToColdStorageAt": number }, "CompletionDate": number, "CompositeMemberIdentifier": "string", "CreatedBy": { "BackupPlanArn": "string", "BackupPlanId": "string", "BackupPlanName": "string", "BackupPlanVersion": "string", "BackupRuleCron": "string", "BackupRuleId": "string", "BackupRuleName": "string", "BackupRuleTimezone": "string" }, "CreationDate": number, "EncryptionKeyArn": "string", "EncryptionKeyType": "string", "IamRoleArn": "string", "IndexStatus": "string", "IndexStatusMessage": "string", "InitiationDate": number, "IsEncrypted": boolean, "IsParent": boolean, "LastRestoreTime": number, "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "ParentRecoveryPointArn": "string", "RecoveryPointArn": "string", "ResourceArn": "string", "ResourceName": "string", "ResourceType": "string", "ScanResults": [ { "Findings": [ "string" ], "LastScanTimestamp": number, "MalwareScanner": "string", "ScanJobState": "string" } ], "SourceBackupVaultArn": "string", "Status": "string", "StatusMessage": "string", "StorageClass": "string", "VaultType": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [BackupSizeInBytes](#API_DescribeRecoveryPoint_ResponseSyntax) ** バックアップのサイズ (バイト単位)。タイプ: Long ** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** バックアップボールトを一意に識別する ARN、例えば、`arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault` です。タイプ: 文字列 ** [BackupVaultName](#API_DescribeRecoveryPoint_ResponseSyntax) ** バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先のリージョンに一意の名前で識別されます。タイプ: 文字列パターン: `^[a-zA-Z0-9\-\_]{2,50}$` ** [CalculatedLifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) ** `DeleteAt` および `MoveToColdStorageAt` タイムスタンプを含む `CalculatedLifecycle` オブジェクト。型: [CalculatedLifecycle](API_CalculatedLifecycle.md) オブジェクト ** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) ** Unix 形式および協定世界時 (UTC)で、リカバリポイントを作成するジョブが完了した日時。`CompletionDate`の値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。タイプ: タイムスタンプ ** [CompositeMemberIdentifier](#API_DescribeRecoveryPoint_ResponseSyntax) ** 複合 (親) スタックに属するネストされた (子) 復旧ポイントなど、複合グループ内のリソースの識別子。ID はスタック内の[論理 ID](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) から転送されます。タイプ: 文字列 ** [CreatedBy](#API_DescribeRecoveryPoint_ResponseSyntax) ** 作成に使用したバックアッププランの `BackupPlanArn`、`BackupPlanId`、`BackupPlanVersion`、および `BackupRuleId` を含むリカバリポイントの作成に関する識別情報を含んでいます。型: [RecoveryPointCreator](API_RecoveryPointCreator.md) オブジェクト ** [CreationDate](#API_DescribeRecoveryPoint_ResponseSyntax) ** Unix 時刻形式および協定世界時 (UTC)で、リカバリポイントが作成された日時。`CreationDate`の値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。タイプ: タイムスタンプ ** [EncryptionKeyArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` などの、バックアップを保護するために使用されるサーバー側の暗号化キー。タイプ: 文字列 ** [EncryptionKeyType](#API_DescribeRecoveryPoint_ResponseSyntax) ** 復旧ポイントに使用される暗号化キーのタイプ。有効な値は、カスタマーマネージドキーの場合は CUSTOMER\$1MANAGED\$1KMS\$1KEY、所有キーの場合は AWS\$1OWNED\$1KMS\$1KEY AWSです。型: 文字列有効な値：`AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` ** [IamRoleArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** ターゲット復旧ポイントの作成に使用する IAM ロール ARN を指定します。例えば、`arn:aws:iam::123456789012:role/S3Access`です。タイプ: 文字列 ** [IndexStatus](#API_DescribeRecoveryPoint_ResponseSyntax) ** これは、指定された復旧ポイントに関連付けられたバックアップインデックスの現在のステータスです。ステータス: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING` ステータスが `ACTIVE` のインデックスを持つ復旧ポイントは、検索に含めることができます。型: 文字列有効な値：`PENDING | ACTIVE | FAILED | DELETING` ** [IndexStatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) ** 復旧ポイントに関連付けられたバックアップインデックスのステータスを説明する詳細なメッセージの形式の文字列。タイプ: 文字列 ** [InitiationDate](#API_DescribeRecoveryPoint_ResponseSyntax) ** この復旧ポイントを作成したバックアップジョブが開始された日時 (Unix 時刻形式および協定世界時 (UTC))。タイプ: タイムスタンプ ** [IsEncrypted](#API_DescribeRecoveryPoint_ResponseSyntax) ** 指定されたリカバリーポイントが暗号化されている場合は `TRUE` 、リカバリーポイントが暗号化されていない場合は `FALSE` として返されるブール値です。タイプ: ブール値 ** [IsParent](#API_DescribeRecoveryPoint_ResponseSyntax) ** これにより、復旧ポイントが親 (複合) ジョブであることを示すブール値が返されます。タイプ: ブール値 ** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) ** Unix 形式および協定世界時 (UTC)で、リカバリポイントが最後に復元された日時。`LastRestoreTime`の値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。タイプ: タイムスタンプ ** [Lifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) ** ライフサイクルは、保護されたリソースがコールドストレージに移行するタイミングと期限切れになるタイミングを定義します。は、定義したライフサイクルに従ってバックアップを自動的に AWS Backup 移行および期限切れにします。コールドストレージに移行されたバックアップは、そこに最低 90 日保存される必要があります。したがって、「保持期間」の設定は、「コールドへの移行 (日数)」設定から 90 日以上あける必要があります。バックアップがコールドに移行された後で、「コールドへの移行 (日数)」設定を変更することはできません。コールドストレージに移行できるリソースタイプは、「[Feature availability by resource](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) table. AWS Backup ignores this expression for other resource types」に記載されています。型: [Lifecycle](API_Lifecycle.md) オブジェクト ** [ParentRecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** これは、親 (複合) リカバリーポイントを一意に識別する ARN、例えば、`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45` です。タイプ: 文字列 ** [RecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** たとえば、`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`などのリカバリポイントを一意に識別する ARN。タイプ: 文字列 ** [ResourceArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** 保存済みのリソースを一意に識別する ARN。ARN の形式は、リソースタイプによって異なります。タイプ: 文字列 ** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) ** 指定されたバックアップに属するリソースの名前。タイプ: 文字列 ** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) ** 復旧ポイントとして保存する AWS リソースのタイプ。Amazon Elastic Block Store (Amazon EBS) ボリュームや Amazon Relational Database Service (Amazon RDS) データベースなど。タイプ: 文字列パターン: `^[a-zA-Z0-9\-\_\.]{1,50}$` ** [ScanResults](#API_DescribeRecoveryPoint_ResponseSyntax) ** 復旧ポイントに対する最新のスキャン結果が含まれ、現在 `MalwareScanner`、`ScanJobState`、`Findings`、が含まれます。 `LastScanTimestamp` 型: [ScanResult](API_ScanResult.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 5 項目です。 ** [SourceBackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) ** たとえば、`arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault` などのリソースが最初にバックアップされたソースボールトを一意に識別する Amazon リソースネーム (ARN)。復旧が同じ AWS アカウントまたはリージョンに復元された場合、この値はになります`null`。タイプ: 文字列 ** [Status](#API_DescribeRecoveryPoint_ResponseSyntax) ** リカバリポイントの状態を指定するステータスコード。詳細については、「 * AWS Backup デベロッパーガイド*」の[「復旧ポイントのステータス](https://docs.aws.amazon.com/aws-backup/latest/devguide/applicationstackbackups.html#cfnrecoverypointstatus)」を参照してください。 + `CREATING` ステータスは、リソースに対して AWS Backup ジョブが開始されたことを示します。バックアッププロセスが開始され、関連する復旧ポイントのバックアップジョブがアクティブに処理されています。 + `AVAILABLE` ステータスは、復旧ポイントのバックアップが正常に作成されたことを示します。バックアッププロセスは問題なく完了し、復旧ポイントを使用できるようになりました。 + `PARTIAL` ステータスは、複合復旧ポイントに、バックアップにないネストされた復旧ポイントが 1 つ以上あることを示します。 + `EXPIRED` status は、復旧ポイントが保持期間を超過したが、アクセス許可 AWS Backup がないか、削除できないことを示します。これらの復旧ポイントを手動で削除するには、「開始方法」の「リソースのクリーンアップ」セクションの「[ステップ 3: 復旧ポイントの削除](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups)」を参照してください。**** + `STOPPED` ステータスは、継続的バックアップが無効になるような操作をユーザーが行った場合の継続的バックアップ時に発生します。これは、アクセス許可の削除、バージョニングの無効化、EventBridge に送信されるイベントの無効化、または AWS Backupによって設定された EventBridge ルールの無効化によって発生する可能性があります。Amazon S3、Amazon RDS、Amazon Aurora リソースの復旧ポイントの場合、このステータスは、継続的バックアップルールの保持期間が変更されたときに発生します。 `STOPPED` ステータスを解決するには、要求されたアクセス許可がすべて揃っていて、S3 バケットでバージョニングが有効になっていることを確認してください。これらの条件が満たされると、実行されるバックアップルールの次のインスタンスでは、新しい継続的復旧ポイントが作成されます。停止ステータスの復旧ポイントは削除する必要はありません。 Amazon EC2 上の SAP HANA では、ユーザーアクション、アプリケーションの設定ミス、またはバックアップ障害が原因で `STOPPED` ステータスが発生します。将来の継続的バックアップを確実に成功させるには、復旧ポイントのステータスを参照し、SAP HANA で詳細を確認してください。型: 文字列有効な値：`COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING` ** [StatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) ** 復旧ポイントのステータスを説明する詳細なメッセージです。タイプ: 文字列 ** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) ** リカバリポイントのストレージクラスを指定します。有効な値は `WARM` または `COLD` です。型: 文字列有効な値：`WARM | COLD | DELETED` ** [VaultType](#API_DescribeRecoveryPoint_ResponseSyntax) ** 対象の復旧ポイントが保存されているボールトのタイプ。型: 文字列有効な値：`BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` ## エラーすべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** InvalidParameterValueException ** パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。 ** 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/DescribeRecoveryPoint) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRecoveryPoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRecoveryPoint)