本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # DescribeBackupVault 傳回備份保存庫 (由其名稱所指定) 的相關中繼資料。 ## 請求語法 ``` GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1 ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) ** 指定備份保存庫的帳戶 ID。 ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) ** 存放備份的邏輯容器名稱。備份文件庫依名稱識別，這些名稱對建立文件庫的帳戶和 AWS 區域來說是唯一的。必要：是 ## 請求主體請求沒有請求主體。 ## 回應語法 ``` HTTP/1.1 200 Content-type: application/json { "BackupVaultArn": "string", "BackupVaultName": "string", "CreationDate": number, "CreatorRequestId": "string", "EncryptionKeyArn": "string", "EncryptionKeyType": "string", "LatestMpaApprovalTeamUpdate": { "ExpiryDate": number, "InitiationDate": number, "MpaSessionArn": "string", "Status": "string", "StatusMessage": "string" }, "LockDate": number, "Locked": boolean, "MaxRetentionDays": number, "MinRetentionDays": number, "MpaApprovalTeamArn": "string", "MpaSessionArn": "string", "NumberOfRecoveryPoints": number, "SourceBackupVaultArn": "string", "VaultState": "string", "VaultType": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [BackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** 可唯一識別備份文件庫的 Amazon Resource Name (ARN)，例如 `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`。類型：字串 ** [BackupVaultName](#API_DescribeBackupVault_ResponseSyntax) ** 存放備份的邏輯容器名稱。備份文件庫依名稱識別，這些名稱對用於建立文件庫的帳戶和區域來說是唯一的。類型：字串 ** [CreationDate](#API_DescribeBackupVault_ResponseSyntax) ** 建立備份保存庫時的日期和時間，以 Unix 格式和國際標準時間 (UTC) 顯示。`CreationDate` 的值精確到毫秒。例如，值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型：Timestamp ** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) ** 可識別請求的唯一字串，且允許重試失敗的請求，而不會有兩次執行操作的風險。此為選用參數。如果使用，此參數必須包含 1 至 50 個英數字元或 '-\$1'。字元。類型：字串 ** [EncryptionKeyArn](#API_DescribeBackupVault_ResponseSyntax) ** 用來保護備份的伺服器端加密金鑰，例如 `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`。類型：字串 ** [EncryptionKeyType](#API_DescribeBackupVault_ResponseSyntax) ** 用於備份保存庫的加密金鑰類型。有效值為客戶受管金鑰的 CUSTOMER\$1MANAGED\$1KMS\$1KEY 或 AWS擁有金鑰的 AWS\$1OWNED\$1KMS\$1KEY。類型：字串有效值:`AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` ** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) ** 此備份文件庫 MPA 核准團隊關聯的最新更新相關資訊。類型：[LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md) 物件 ** [LockDate](#API_DescribeBackupVault_ResponseSyntax) ** 無法變更或刪除 AWS Backup 保存庫鎖定組態的日期和時間。如果在未指定鎖定日期的情況下，將「Vault Lock 」套用至保存庫，則可隨時變更任何「Vault Lock 」設定，或從保存庫中完全刪除「Vault Lock 」。此值採用 Unix 格式、國際標準時間 (UTC)，且精確至毫秒。例如，值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。類型：Timestamp ** [Locked](#API_DescribeBackupVault_ResponseSyntax) ** 布林值，指出 AWS Backup 保存庫鎖定目前是否正在保護備份保存庫。 `True`表示保存庫鎖定會導致保存庫中存放之復原點的刪除或更新操作失敗。類型：布林值 ** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** 保存 AWS Backup 庫鎖定設定，指定保存庫保留其復原點的最長保留期間。若未指定此參數，Vault Lock 不會對保存庫中的復原點強制執行最長保留期間 (允許無限期儲存)。若經過指定，則保存庫的所有備份或複製任務皆必須具有生命週期政策，其保留期間等於或短於最長保留期間。若任務的保留期間超過該最長保留期間，則文件庫的備份或複製任務會失敗，您應修改生命週期設定或使用不同的文件庫。在執行Vault Lock 之前已儲存於保存庫的復原點不會受到影響。類型：Long ** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** 保存 AWS Backup 庫鎖定設定，指定保存庫保留其復原點的最短保留期間。若未指定此參數，Vault Lock 將不會強制執行最短保留期間。若經過指定，則保存庫的所有備份或複製任務皆必須具有生命週期政策，其保留期間等於或超過最短保留期間。若任務的保留期間未達最短保留期間，則保存庫的備份或複製任務會失敗，您應修改生命週期設定或使用不同的保存庫。在執行Vault Lock 之前已儲存於保存庫的復原點不會受到影響。類型：Long ** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) ** 與此備份保存庫相關聯的 MPA 核准團隊的 ARN。類型：字串 ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) ** 與此備份保存庫相關聯的 MPA 工作階段 ARN。類型：字串 ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) ** 儲存在備份保存庫中的復原點數目。主控台顯示的復原點計數值可能是近似值。使用 [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html) API 取得確切計數。類型：Long ** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** 建立此還原存取備份文件庫的來源備份文件庫 ARN。類型：字串 ** [VaultState](#API_DescribeBackupVault_ResponseSyntax) ** 保存庫的目前狀態。-> 類型：字串有效值:`CREATING | AVAILABLE | FAILED` ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) ** 所述的保存庫類型。類型：字串有效值:`BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** InvalidParameterValueException ** 表示參數的值出現問題。例如，值超出範圍。 ** Context ** ** Type ** HTTP 狀態碼：400 ** MissingParameterValueException ** 表示缺少必要的參數。 ** Context ** ** Type ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 動作所需的資源不存在。 ** Context ** ** Type ** HTTP 狀態碼：400 ** ServiceUnavailableException ** 由於伺服器發生臨時故障，請求失敗。 ** Context ** ** Type ** HTTP 狀態碼：500 ## 另請參閱如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupVault) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupVault)