기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeBackupVault
이름으로 지정된 백업 저장소에 대한 메타데이터를 반환합니다.
Request Syntax
GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- BackupVaultAccountId
-
지정된 백업 볼트의 계정 ID입니다.
- backupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.
필수 여부: 예
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"CreatorRequestId": "string",
"EncryptionKeyArn": "string",
"LockDate": number,
"Locked": boolean,
"MaxRetentionDays": number,
"MinRetentionDays": number,
"NumberOfRecoveryPoints": number,
"VaultState": "string",
"VaultType": "string"
}Response Elements
작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.
다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.
- BackupVaultArn
-
백업 볼트를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. 예:
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.유형: 문자열
- BackupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.
유형: 문자열
- CreationDate
-
Unix 형식 및 Coordinated Universal Time()으로 백업 볼트가 생성된 날짜 및 시간입니다UTC.
CreationDate의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- CreatorRequestId
-
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다. 이 파라미터는 선택 사항입니다. 이를 사용할 경우 이 파라미터에는 1~50개의 영숫자 또는 '-_.' 문자를 포함해야 합니다.
유형: 문자열
- EncryptionKeyArn
-
백업을 보호하는 데 사용되는 서버 측 암호화 키(예:
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab)입니다.유형: 문자열
- LockDate
-
AWS Backup 볼트 잠금 구성을 변경하거나 삭제할 수 없는 날짜 및 시간입니다.
잠금 날짜를 지정하지 않고 저장소 잠금을 저장소에 적용한 경우, 언제든지 저장소 잠금 설정을 변경하거나 저장소에서 저장소 잠금을 완전히 삭제할 수 있습니다.
이 값은 Unix 형식, Coordinated Universal Time(UTC)이며 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087를 나타냅니다.
유형: 타임스탬프
- Locked
-
AWS Backup 볼트 잠금이 현재 백업 볼트를 보호하고 있는지 여부를 나타내는 부울입니다. 는 볼트 잠금이 볼트에 저장된 복구 지점에 대한 삭제 또는 업데이트 작업을 실패하게 함을
True의미합니다.타입: 부울
- MaxRetentionDays
-
AWS Backup 볼트가 복구 시점을 유지하는 최대 보존 기간을 지정하는 볼트 잠금 설정입니다. 이 파라미터가 지정되지 않으면 저장소 잠금은 저장소의 복구 시점에 최대 보존 기간을 적용하지 않습니다(무제한 저장 가능).
이 설정이 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최대 보존 기간보다 짧거나 같은 수명 주기 정책이 있어야 합니다. 작업의 보존 기간이 최대 보존 기간보다 길면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다. 저장소 잠금 이전에 저장소에 이미 저장된 복구 시점은 영향을 받지 않습니다.
타입: Long
- MinRetentionDays
-
AWS Backup 볼트가 복구 시점을 유지하는 최소 보존 기간을 지정하는 볼트 잠금 설정입니다. 이 파라미터가 지정되지 않으면 저장소 잠금이 최소 보존 기간을 적용하지 않습니다.
이 설정이 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최소 보존 기간보다 길거나 같은 수명 주기 정책이 있어야 합니다. 작업의 보존 기간이 최소 보존 기간보다 짧으면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다. 저장소 잠금 이전에 저장소에 이미 저장된 복구 시점은 영향을 받지 않습니다.
타입: Long
- NumberOfRecoveryPoints
-
백업 저장소에 저장된 복구 시점의 수입니다.
타입: Long
- VaultState
-
볼트의 현재 상태.->
타입: 문자열
유효 값:
CREATING | AVAILABLE | FAILED - VaultType
-
설명된 볼트 유형입니다.
타입: 문자열
유효 값:
BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterValueException
-
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.
HTTP 상태 코드: 400
- MissingParameterValueException
-
필수 파라미터가 누락되었음을 나타냅니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
작업에 필요한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
요청이 서버의 일시적 장애 때문에 실패했습니다.
HTTP 상태 코드: 500
참고
언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.
