ListIndexedRecoveryPoints
このオペレーションは、指定されたアカウントに属する、インデックスが関連付けられている復旧ポイントのリストを返します。
含めることができるオプションのパラメータは、MaxResults、NextToken、SourceResourceArns、CreatedBefore、CreatedAfter、ResourceType です。
リクエストの構文
GET /indexes/recovery-point/?createdAfter=CreatedAfter&createdBefore=CreatedBefore&indexStatus=IndexStatus&maxResults=MaxResults&nextToken=NextToken&resourceType=ResourceType&sourceResourceArn=SourceResourceArn HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- CreatedAfter
-
指定された日付の後に作成されたインデックス付き復旧ポイントのみを返します。
- CreatedBefore
-
指定された日付の前に作成されたインデックス付き復旧ポイントのみを返します。
- IndexStatus
-
返されたリストを指定されたステータスで絞り込むには、このパラメータを含めます。
使用できる値:
PENDING|ACTIVE|FAILED|DELETINGステータスが
ACTIVEのインデックスを持つ復旧ポイントは、検索に含めることができます。有効な値：
PENDING | ACTIVE | FAILED | DELETING - MaxResults
-
返されるリソースリストアイテムの最大数。
有効な範囲: 最小値 は 1 です。最大値は 1000 です。
- NextToken
-
返された復旧ポイントの部分的なリストに続く次の項目。
例えば、
MaxResultsの数のインデックス付き復旧ポイントを返すようにリクエストが行われた場合、NextTokenを使用すると、このトークンが指す場所から開始してさらにリストの項目を返すことができます。 - ResourceType
-
指定されたリソースタイプのインデックス付き復旧ポイントのリストを返します。
以下のような値を設定できます。
-
EBSAmazon Elastic Block Store 用の -
Amazon Simple Storage Service (Amazon S3) 用の
S3
パターン:
^[a-zA-Z0-9\-\_\.]{1,50}$ -
- SourceResourceArn
-
ソースのリソースを一意に識別する Amazon リソースネーム (ARN) の文字列。
リクエスト本文
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"IndexedRecoveryPoints": [
{
"BackupCreationDate": number,
"BackupVaultArn": "string",
"IamRoleArn": "string",
"IndexCreationDate": number,
"IndexStatus": "string",
"IndexStatusMessage": "string",
"RecoveryPointArn": "string",
"ResourceType": "string",
"SourceResourceArn": "string"
}
],
"NextToken": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- IndexedRecoveryPoints
-
これは、指定されたアカウントに属する、関連付けられたインデックスを持つ復旧ポイントのリストです。
タイプ: IndexedRecoveryPoint オブジェクトの配列
- NextToken
-
返された復旧ポイントの部分的なリストに続く次の項目。
例えば、
MaxResultsの数のインデックス付き復旧ポイントを返すようにリクエストが行われた場合、NextTokenを使用すると、このトークンが指す場所から開始してさらにリストの項目を返すことができます。タイプ: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
- Context
- Type
HTTP ステータスコード: 400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
- Context
- Type
HTTP ステータスコード: 400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
- Context
- Type
HTTP ステータスコード: 500
その他の参照資料
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
