本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
DescribeRecoveryPoint
傳回與復原點相關聯的中繼資料，包括 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",
"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
-
指定ARN用來建立目標復原點IAM的角色；例如
arn:aws:iam::123456789012:role/S3Access。類型：字串
- 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狀態表示 AWS Backup 無法在備份時段關閉之前建立復原點。若要使用 增加備份計劃時段API，請參閱 UpdateBackupPlan。您也可以使用主控台，透過選擇和編輯備份計畫來加長備份計畫時段。EXPIRED狀態表示復原點已超過其保留期間，但 AWS Backup 缺少許可或無法刪除它。若要手動刪除這些復原點，請參閱《入門》的《清理資源》一節中的《步驟 3：刪除復原點》。STOPPED狀態會出現在連續備份，其中使用者已採取某些動作，導致連續備份停用。這可能是由於移除許可、關閉版本控制、關閉要傳送至 的事件 EventBridge，或停用 制定的 EventBridge 規則所致 AWS Backup。對於 Amazon S3、Amazon RDS和 Amazon Aurora 資源的復原點，此狀態會在連續備份規則的保留期間變更時發生。若要解決
STOPPED狀態，請確定已具備所有必要許可，並且已在 S3 儲存貯體上啟用版本控制。一旦符合這些條件，下次執行備份規則就會建立新的連續復原點。狀態為 的復原點STOPPED不需要刪除。在 Amazon SAPHANA上，由於使用者動作、應用程式設定錯誤或備份失敗而EC2
STOPPED發生 。若要確保未來的連續備份成功，請參閱復原點狀態並檢查SAPHANA詳細資訊。類型：字串
有效值:
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
另請參閱
如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
