翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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、以下を参照してください。