DescribeRecoveryPoint - AWS Backup

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

DeleteAtMoveToColdStorageAt 타임스탬프를 포함하는 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