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

# DescribeRecoveryPoint
<a name="API_DescribeRecoveryPoint"></a>

ID, 상태, 암호화, 수명 주기 등 복구 시점과 관련된 메타데이터를 반환합니다.

## Request Syntax
<a name="API_DescribeRecoveryPoint_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1
```

## URI 요청 파라미터
<a name="API_DescribeRecoveryPoint_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultAccountId"></a>
지정된 백업 저장소에 대한 계정 ID입니다.  
패턴: `^[0-9]{12}$` 

 ** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [recoveryPointArn](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
필수 항목 여부: 예

## Request Body
<a name="API_DescribeRecoveryPoint_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_DescribeRecoveryPoint_ResponseSyntax"></a>

```
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",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "EncryptionKeyType": "string",
   "IamRoleArn": "string",
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "LastRestoreTime": number,
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ParentRecoveryPointArn": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanResults": [ 
      { 
         "Findings": [ "string" ],
         "LastScanTimestamp": number,
         "MalwareScanner": "string",
         "ScanJobState": "string"
      }
   ],
   "SourceBackupVaultArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "StorageClass": "string",
   "VaultType": "string"
}
```

## 응답 요소
<a name="API_DescribeRecoveryPoint_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [BackupSizeInBytes](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupSizeInBytes"></a>
백업의 크기(바이트 단위)입니다.  
타입: Long

 ** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultArn"></a>
백업 저장소를 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`).  
유형: 문자열

 ** [BackupVaultName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [CalculatedLifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CalculatedLifecycle"></a>
`DeleteAt` 및 `MoveToColdStorageAt` 타임스탬프를 포함하는 `CalculatedLifecycle` 객체입니다.  
유형: [CalculatedLifecycle](API_CalculatedLifecycle.md)객체

 ** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompletionDate"></a>
복구 시점을 생성하기 위한 작업이 완료된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CompletionDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [CompositeMemberIdentifier](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompositeMemberIdentifier"></a>
복합(상위) 스택에 속하는 중첩된(하위) 복구 시점 같은 복합 그룹 내 리소스의 식별자입니다. ID는 스택 내의 [논리적 ID](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) 전송됩니다.  
유형: 문자열

 ** [CreatedBy](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CreatedBy"></a>
복구 시점을 생성하는 데 사용되는 백업 계획의 `BackupPlanArn`, `BackupPlanId`, `BackupPlanVersion`, `BackupRuleId`를 비롯하여, 복구 시점의 생성에 대한 식별 정보를 포함합니다.  
유형: [RecoveryPointCreator](API_RecoveryPointCreator.md)객체

 ** [CreationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CreationDate"></a>
복구 시점이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [EncryptionKeyArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyArn"></a>
백업을 보호하는 데 사용되는 서버 측 암호화 키입니다(예: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`).  
유형: 문자열

 ** [EncryptionKeyType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyType"></a>
복구 시점에 사용되는 암호화 키의 유형입니다. 유효한 값은 고객 관리형 키의 경우 CUSTOMER\$1MANAGED\$1KMS\$1KEY, AWS소유 키의 경우 AWS\$1OWNED\$1KMS\$1KEY입니다.  
타입: 문자열  
유효 값: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` 

 ** [IamRoleArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IamRoleArn"></a>
대상 복구 시점을 생성하는 데 사용되는 IAM 역할 ARN을 지정합니다(예: `arn:aws:iam::123456789012:role/S3Access`).  
유형: 문자열

 ** [IndexStatus](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatus"></a>
지정된 복구 시점과 연결된 백업 인덱스의 현재 상태입니다.  
상태는 `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`입니다.  
상태가 `ACTIVE`인 인덱스가 있는 복구 시점을 검색에 포함할 수 있습니다.  
타입: 문자열  
유효 값: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [IndexStatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatusMessage"></a>
복구 시점과 연관된 백업 인덱스의 상태를 설명하는 자세한 메시지 형식의 문자열입니다.  
유형: 문자열

 ** [InitiationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-InitiationDate"></a>
이 복구 시점을 생성한 백업 작업이 시작된 날짜와 시간(Unix 형식 및 협정 세계시(UTC))입니다.  
유형: 타임스탬프

 ** [IsEncrypted](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IsEncrypted"></a>
지정된 복구 시점이 암호화된 경우 `TRUE`로 반환되거나, 복구 시점이 암호화되지 않은 경우 `FALSE`로 반환되는 부울 값입니다.  
유형: Boolean

 ** [IsParent](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IsParent"></a>
복구 시점이 상위(복합) 작업인 부울 값을 반환합니다.  
유형: Boolean

 ** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-LastRestoreTime"></a>
복구 시점이 마지막으로 복원된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `LastRestoreTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [Lifecycle](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-Lifecycle"></a>
수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시기를 정의합니다.는 사용자가 정의한 수명 주기에 따라 백업을 자동으로 AWS Backup 전환하고 만료합니다.  
콜드 스토리지로 전환된 백업은 콜드 스토리지에서 최소 90일 이상 저장되어야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.  
콜드 스토리지로 전환할 수 있는 리소스 유형은 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 테이블에 나열됩니다. 다른 리소스 유형에 대해서는이 표현식을 AWS Backup 무시합니다.  
유형: [Lifecycle](API_Lifecycle.md)객체

 ** [ParentRecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ParentRecoveryPointArn"></a>
상위(복합) 복구 시점을 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
유형: 문자열

 ** [RecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
유형: 문자열

 ** [ResourceArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceArn"></a>
저장된 리소스를 고유하게 식별하는 ARN입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: 문자열

 ** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceName"></a>
지정된 백업에 속하는 리소스의 이름입니다.  
유형: 문자열

 ** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceType"></a>
Amazon Elastic Block Store(Amazon EBS) 볼륨 또는 Amazon Relational Database Service(Amazon RDS) 데이터베이스와 같이 복구 시점으로 저장할 AWS 리소스 유형입니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ScanResults](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ScanResults"></a>
복구 시점에 대한 최신 스캔 결과를 포함하며 현재 `MalwareScanner`, `ScanJobState`, `Findings`및를 포함합니다. `LastScanTimestamp`   
타입: [ScanResult](API_ScanResult.md)객체 배열  
배열 멤버: 최소 항목 수 0개. 최대 항목 수 5개.

 ** [SourceBackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-SourceBackupVaultArn"></a>
리소스가 원래 백업되었던 소스 저장소를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`). 복구가 동일한 AWS 계정 또는 리전으로 복원되는 경우이 값은가 됩니다`null`.  
유형: 문자열

 ** [Status](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-Status"></a>
복구 시점의 상태를 지정하는 상태 코드입니다. 자세한 내용은 * AWS Backup 개발자 안내서*의 [ 복구 시점 상태를](https://docs.aws.amazon.com/aws-backup/latest/devguide/applicationstackbackups.html#cfnrecoverypointstatus) 참조하세요.  
+  `CREATING` 상태는 리소스에 대한 AWS Backup 작업이 시작되었음을 나타냅니다. 백업 프로세스가 시작되었으며 연결된 복구 시점에 대한 백업 작업을 적극적으로 처리하고 있습니다.
+  `AVAILABLE` 상태는 복구 시점에 백업이 성공적으로 생성되었음을 나타냅니다. 백업 프로세스가 문제 없이 완료되었으며 이제 복구 시점을 사용할 준비가 되었습니다.
+  `PARTIAL` 상태는 복합 복구 시점에 백업에 없는 중첩 복구 시점이 하나 이상 있음을 나타냅니다.
+  `EXPIRED` 상태는 복구 시점이 보존 기간을 초과했지만 권한이 AWS Backup 없거나 삭제할 수 없음을 나타냅니다. 이러한 복구 시점을 수동으로 삭제하려면 **시작하기의 **리소스 정리 섹션에서 [3단계: 복구 시점 삭제](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups)를 참조하세요.
+  `STOPPED` 상태는 연속 백업에서 사용자가 연속 백업을 비활성화하는 작업을 수행한 경우에 발생합니다. 이는 권한을 제거하거나, 버전 관리를 비활성화하거나, EventBridge로 전송되는 이벤트를 중단하거나, AWS Backup에서 설정한 EventBridge 규칙을 비활성화한 경우 발생할 수 있습니다. Amazon S3, Amazon RDS 및 Amazon Aurora 리소스에 대한 복구 시점의 경우, 이 상태는 연속 백업 규칙의 보존 기간이 변경될 때 발생합니다.

  `STOPPED` 상태를 해결하려면 요청된 모든 권한이 부여되고 S3 버킷에서 버전 관리가 활성화되어 있는지 확인합니다. 이러한 조건이 충족되면 백업 규칙의 다음 인스턴스를 실행하면 새로운 연속 복구 시점이 생성될 것입니다. 중지됨 상태인 복구 시점은 삭제할 필요가 없습니다.

  Amazon EC2에 대한 SAP HANA의 경우 사용자 작업, 애플리케이션 구성 오류 또는 백업 실패로 인해 `STOPPED` 상태가 발생합니다. 향후 연속 백업이 성공하도록 보장하려면 복구 시점 상태를 살펴보고 SAP HANA의 세부 사항을 확인하세요.
타입: 문자열  
유효 값: `COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING` 

 ** [StatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StatusMessage"></a>
복구 시점의 상태를 설명하는 상태 메시지입니다.  
유형: 문자열

 ** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StorageClass"></a>
복구 시점의 스토리지 클래스를 지정합니다. 유효한 값은 `WARM` 또는 `COLD`입니다.  
타입: 문자열  
유효 값: `WARM | COLD | DELETED` 

 ** [VaultType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-VaultType"></a>
설명된 복구 시점이 저장되는 저장소 유형입니다.  
타입: 문자열  
유효 값: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

## 오류
<a name="API_DescribeRecoveryPoint_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

## 참고
<a name="API_DescribeRecoveryPoint_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRecoveryPoint)