기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeRecoveryPoint
ID, 상태, 암호화, 수명 주기 등 복구 시점과 관련된 메타데이터를 반환합니다.
Request Syntax
GET /backup-vaults/backupVaultName
/recovery-points/recoveryPointArn
?backupVaultAccountId=BackupVaultAccountId
HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- BackupVaultAccountId
-
지정된 백업 저장소에 대한 계정 ID입니다.
패턴:
^[0-9]{12}$
- backupVaultName
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$
필수 여부: 예
- recoveryPointArn
-
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예:
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
).필수 여부: 예
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
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
-
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.
유형: String
패턴:
^[a-zA-Z0-9\-\_]{2,50}$
- CalculatedLifecycle
-
DeleteAt
및MoveToColdStorageAt
타임스탬프를 포함하는CalculatedLifecycle
객체입니다.유형: CalculatedLifecycle 객체
- CompletionDate
-
복구 시점을 생성하기 위한 작업이 완료된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CompletionDate
의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- CompositeMemberIdentifier
-
복합(상위) 스택에 속하는 중첩된(하위) 복구 시점 같은 복합 그룹 내 리소스의 식별자입니다. ID는 스택 내의 논리적 ID 전송됩니다.
유형: 문자열
- CreatedBy
-
복구 시점을 생성하는 데 사용되는 백업 계획의
BackupPlanArn
,BackupPlanId
,BackupPlanVersion
,BackupRuleId
를 비롯하여, 복구 시점의 생성에 대한 식별 정보를 포함합니다.유형: RecoveryPointCreator 객체
- CreationDate
-
복구 시점이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다.
CreationDate
의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.유형: 타임스탬프
- 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을 나타냅니다.유형: 타임스탬프
- 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) 데이터베이스.
유형: String
패턴:
^[a-zA-Z0-9\-\_\.]{1,50}$
- SourceBackupVaultArn
-
리소스가 원래 백업되었던 소스 저장소를 고유하게 식별하는 Amazon 리소스 이름(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