本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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 RDS 需要至少為 20 的值。
有效範圍：最小值為 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"
}
]
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- NextToken
-
傳回項目之部分列表後的下一個項目。例如，如果請求傳回
MaxResults個數量的項目，則NextToken允許您從下一個字符指向的位置開始傳回列表中的更多項目。類型：字串
- RecoveryPoints
-
物件陣列，其中包含指定資源類型之復原點的詳細資訊。
注意
只有 Amazon EFS 和 Amazon EC2 恢復點返回 BackupVaultName。
類型：RecoveryPointByResource 物件陣列
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterValueException
-
表示參數的值出現問題。例如，值超出範圍。
HTTP 狀態碼：400
- MissingParameterValueException
-
表示缺少必要的參數。
HTTP 狀態碼：400
- ResourceNotFoundException
-
動作所需的資源不存在。
HTTP 狀態碼：400
- ServiceUnavailableException
-
由於伺服器發生臨時故障，請求失敗。
HTTP 狀態碼：500
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
