本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
傳回與復原點相關聯的中繼資料，包括 ID、狀態、加密和生命週期。
請求語法
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
URI 請求參數
請求會使用下列 URI 參數。
- BackupVaultAccountId
-
指定備份保存庫的帳戶 ID。
模式：
^[0-9]{12}$ - backupVaultName
-
存放備份的邏輯容器的名稱。備份文件庫依名稱識別，這些名稱對建立文件庫的帳戶和 AWS 區域來說是唯一的。
模式：
^[a-zA-Z0-9\-\_]{2,50}$必要：是
- recoveryPointArn
-
可唯一識別復原點的 Amazon Resource Name (ARN)，例如
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。必要：是
請求主體
請求沒有請求主體。
回應語法
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",
"BackupPlanVersion": "string",
"BackupRuleId": "string"
},
"CreationDate": number,
"EncryptionKeyArn": "string",
"IamRoleArn": "string",
"IndexStatus": "string",
"IndexStatusMessage": "string",
"IsEncrypted": boolean,
"IsParent": boolean,
"LastRestoreTime": number,
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"ParentRecoveryPointArn": "string",
"RecoveryPointArn": "string",
"ResourceArn": "string",
"ResourceName": "string",
"ResourceType": "string",
"SourceBackupVaultArn": "string",
"Status": "string",
"StatusMessage": "string",
"StorageClass": "string",
"VaultType": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- BackupSizeInBytes
-
備份的大小，以位元組為單位。
類型：Long
- BackupVaultArn
-
可唯一識別備份文件庫的 ARN，例如
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault。類型：字串
- BackupVaultName
-
存放備份的邏輯容器的名稱。備份文件庫依名稱識別，這些名稱對用於建立文件庫的帳戶和區域來說是唯一的。
類型：字串
模式：
^[a-zA-Z0-9\-\_]{2,50}$ - CalculatedLifecycle
-
包含
DeleteAt和MoveToColdStorageAt時間戳記的CalculatedLifecycle物件。類型：CalculatedLifecycle 物件
- CompletionDate
-
建立復原點任務的完成日期和時間，以 Unix 格式和國際標準時間 (UTC) 顯示。
CompletionDate的值精確到毫秒。例如，值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型：Timestamp
- CompositeMemberIdentifier
-
複合群組中資源的識別符，例如屬於複合 （父） 堆疊的巢狀 （子） 復原點。ID 會從堆疊中的邏輯 ID 傳輸。
類型：字串
- CreatedBy
-
含有建立復原點的相關識別資訊，包括用於建立復原點之備份計畫的
BackupPlanArn、BackupPlanId、BackupPlanVersion和BackupRuleId。類型：RecoveryPointCreator 物件
- CreationDate
-
建立復原點的日期和時間，以 Unix 格式和國際標準時間 (UTC) 顯示。
CreationDate的值精確到毫秒。例如，值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型：Timestamp
- EncryptionKeyArn
-
用來保護備份的伺服器端加密金鑰，例如
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab。類型：字串
- IamRoleArn
-
指定用來建立目標復原點的 IAM 角色 ARN，例如
arn:aws:iam::123456789012:role/S3Access。類型：字串
- IndexStatus
-
這是與指定復原點相關聯之備份索引的目前狀態。
狀態為：
PENDING|ACTIVE|FAILED|DELETING狀態為 的索引復原點
ACTIVE可以包含在搜尋中。類型：字串
有效值:
PENDING | ACTIVE | FAILED | DELETING - IndexStatusMessage
-
以詳細訊息形式顯示的字串，說明與復原點相關聯的備份索引狀態。
類型：字串
- IsEncrypted
-
如果指定的復原點已加密，則傳回的布林值為
TRUE；如果復原點未加密，則為FALSE。類型：布林值
- IsParent
-
這會傳回復原點為父項 (複合) 任務的布林值。
類型：布林值
- LastRestoreTime
-
最後還原復原點的日期和時間，以 Unix 格式和國際標準時間 (UTC) 格式顯示。
LastRestoreTime的值精確到毫秒。例如，值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型：Timestamp
- Lifecycle
-
生命週期會定義受保護資源何時轉換為冷儲存，以及何時過期。 會根據您定義的生命週期自動 AWS Backup 轉換和過期備份。
轉移至冷儲存的備份必須在冷儲存中存放至少 90 天。因此，「保留期」設定必須比「轉移至冷儲存前所需天數」設定長 90 天。「轉移至冷儲存前所需天數」設定在已有備份轉移至冷儲存後就無法再加以變更。
可轉換為冷儲存的資源類型會列在資源資料表的功能可用性中。 會 AWS Backup 忽略其他資源類型的此表達式。
類型：Lifecycle 物件
- ParentRecoveryPointArn
-
可唯一識別父項 (複合) 復原點的 ARN，例如
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。類型：字串
- RecoveryPointArn
-
可唯一識別復原點的 ARN；例如
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45。類型：字串
- ResourceArn
-
可唯一識別已儲存資源的 ARN。ARN 的格式取決於資源類型。
類型：字串
- ResourceName
-
屬於指定備份的資源名稱。
類型：字串
- ResourceType
-
要儲存為復原點 AWS 的資源類型；例如，Amazon Elastic Block Store (Amazon EBS) 磁碟區或 Amazon Relational Database Service (Amazon RDS) 資料庫。
類型：字串
模式：
^[a-zA-Z0-9\-\_\.]{1,50}$ - SourceBackupVaultArn
-
可唯一識別原始備份資源之來源保存庫的 Amazon Resource Name (ARN)，例如
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault。如果復原還原至相同的 AWS 帳戶或區域，則此值將為null。類型：字串
- Status
-
指定復原點狀態的狀態碼。
PARTIAL狀態表示複合復原點有一或多個不在備份中的巢狀復原點。EXPIRED狀態表示復原點已超過其保留期間，但 AWS Backup 缺少許可或無法刪除它。若要手動刪除這些復原點，請參閱《入門》的《清理資源》一節中的《步驟 3：刪除復原點》。STOPPED狀態會出現在連續備份，其中使用者已採取某些動作，導致連續備份停用。這可能是因為移除許可、關閉版本控制、關閉傳送至 EventBridge 的事件，或停用 AWS Backup設定的 EventBridge 規則所造成。對於 Amazon S3、Amazon RDS 和 Amazon Aurora 資源的復原點，此狀態會在連續備份規則的保留期間變更時發生。若要解決
STOPPED狀態，請確定已具備所有必要許可，並且已在 S3 儲存貯體上啟用版本控制。一旦符合這些條件，下次執行備份規則就會建立新的連續復原點。不需要刪除狀態為「已停止」的復原點。至於 Amazon EC2 上的 SAP HANA，
STOPPED會因為使用者動作、應用程式設定錯誤或備份失敗而發生。為確保未來的連續備份成功，請查看復原點狀態並檢查 SAP HANA 以取得詳細資訊。類型：字串
有效值:
COMPLETED | PARTIAL | DELETING | EXPIRED - StatusMessage
-
說明還原復原點狀態的狀態訊息。
類型：字串
- StorageClass
-
指定復原點的儲存體方案。有效值為
WARM或COLD。類型：字串
有效值:
WARM | COLD | DELETED - VaultType
-
存放所述復原點的保存庫類型。
類型：字串
有效值:
BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterValueException
-
表示參數的值出現問題。例如，值超出範圍。
HTTP 狀態碼：400
- MissingParameterValueException
-
表示缺少必要的參數。
HTTP 狀態碼：400
- ResourceNotFoundException
-
動作所需的資源不存在。
HTTP 狀態碼：400
- ServiceUnavailableException
-
由於伺服器發生臨時故障，請求失敗。
HTTP 狀態碼：500
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
