ListRecoveryPointsByResource - AWS Backup

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ListRecoveryPointsByResource

リソース Amazon リソースネーム () で指定されたタイプのリカバリポイントに関する情報ARN。

注記

Amazon EFSおよび Amazon の場合EC2、このアクションは によって作成されたリカバリポイントのみを一覧表示します AWS Backup。

リクエストの構文

GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1

URI リクエストパラメータ

リクエストは、次のURIパラメータを使用します。

ManagedByAWSBackupOnly

この属性は、所有権に基づいて復旧ポイントをフィルタリングします。

これが に設定されている場合TRUE、レスポンスには、 によって管理される選択したリソースに関連付けられたリカバリポイントが含まれます AWS Backup。

これが に設定されている場合FALSE、レスポンスには、選択したリソースに関連付けられたすべてのリカバリポイントが含まれます。

型: ブール値

MaxResults

返されるアイテムの最大数。

注記

Amazon には 20 以上の値RDSが必要です。

有効範囲: 最小値は 1 です。最大値は 1000 です。

NextToken

返された項目の一部リストに続く次の項目。たとえば、MaxResults アイテム数のリクエストが行われるようにされた場合、NextToken では、次のトークンが指すロケーションから開始して、リスト内のより多くのアイテムを返すことができます。

resourceArn

リソースを一意に識別ARNする 。の形式は、リソースタイプARNによって異なります。

必須:はい

リクエストボディ

リクエストにリクエスト本文がありません。

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "RecoveryPoints": [ { "BackupSizeBytes": number, "BackupVaultName": "string", "CreationDate": number, "EncryptionKeyArn": "string", "IsParent": boolean, "ParentRecoveryPointArn": "string", "RecoveryPointArn": "string", "ResourceName": "string", "Status": "string", "StatusMessage": "string", "VaultType": "string" } ] }

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。

次のデータは、 サービスによって JSON 形式で返されます。

NextToken

返された項目の一部リストに続く次の項目。たとえば、MaxResults アイテム数のリクエストが行われるようにされた場合、NextToken では、次のトークンが指すロケーションから開始して、リスト内のより多くのアイテムを返すことができます。

型: 文字列

RecoveryPoints

指定されたリソースタイプのリカバリポイントに関する詳細情報を含むオブジェクトの配列。

注記

Amazon EFSおよび Amazon EC2リカバリポイントのみが を返します BackupVaultName。

型: RecoveryPointByResource オブジェクトの配列

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

InvalidParameterValueException

パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。

HTTP ステータスコード: 400

MissingParameterValueException

必須パラメータがないことを示します。

HTTP ステータスコード: 400

ResourceNotFoundException

アクションに必要なリソースは存在しません。

HTTP ステータスコード: 400

ServiceUnavailableException

サーバーの一時的障害のため、リクエストは失敗しました。

HTTP ステータスコード: 500

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。