DescribeRecoveryPoint - AWS Backup
Request SyntaxURI 요청 파라미터Request BodyResponse Syntax응답 요소Errors참고

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

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 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다. 백업 저장소는 소문자, 숫자, 하이픈(-)으로 구성됩니다.

패턴: ^[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",
   "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).

타입: 문자열

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 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상태는 백업 창이 닫히기 전에 복구 지점을 만들 AWS Backup 수 없음을 나타냅니다. API를 사용하여 백업 계획 기간을 늘리려면 을 참조하십시오 UpdateBackupPlan. 콘솔을 사용하여 백업 계획을 선택하고 편집하여 백업 계획 기간을 늘릴 수도 있습니다.

EXPIRED상태는 복구 지점이 보존 기간을 초과했지만 권한이 AWS Backup 없거나 삭제할 수 없는 상태임을 나타냅니다. 이러한 복구 시점을 수동으로 삭제하려면 시작하기의 리소스 정리 섹션에서 3단계: 복구 시점 삭제를 참조하세요.

STOPPED 상태는 연속 백업에서 사용자가 연속 백업을 비활성화하는 작업을 수행한 경우에 발생합니다. 권한 제거, 버전 관리 해제, 전송 대상 이벤트 해제, 적용 EventBridge 규칙 비활성화 EventBridge 등이 원인일 수 있습니다. AWS Backup

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

Errors

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.

InvalidParameterValueException

파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.

HTTP 상태 코드: 400

MissingParameterValueException

필수 파라미터가 누락되었음을 나타냅니다.

HTTP 상태 코드: 400

ResourceNotFoundException

작업에 필요한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 400

ServiceUnavailableException

요청이 서버의 일시적 장애 때문에 실패했습니다.

HTTP 상태 코드: 500

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.