

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

# 작업
<a name="API_Operations"></a>

다음 작업은 AWS Backup에서 지원됩니다.
+  [AssociateBackupVaultMpaApprovalTeam](API_AssociateBackupVaultMpaApprovalTeam.md) 
+  [CancelLegalHold](API_CancelLegalHold.md) 
+  [CreateBackupPlan](API_CreateBackupPlan.md) 
+  [CreateBackupSelection](API_CreateBackupSelection.md) 
+  [CreateBackupVault](API_CreateBackupVault.md) 
+  [CreateFramework](API_CreateFramework.md) 
+  [CreateLegalHold](API_CreateLegalHold.md) 
+  [CreateLogicallyAirGappedBackupVault](API_CreateLogicallyAirGappedBackupVault.md) 
+  [CreateReportPlan](API_CreateReportPlan.md) 
+  [CreateRestoreAccessBackupVault](API_CreateRestoreAccessBackupVault.md) 
+  [CreateRestoreTestingPlan](API_CreateRestoreTestingPlan.md) 
+  [CreateRestoreTestingSelection](API_CreateRestoreTestingSelection.md) 
+  [CreateTieringConfiguration](API_CreateTieringConfiguration.md) 
+  [DeleteBackupPlan](API_DeleteBackupPlan.md) 
+  [DeleteBackupSelection](API_DeleteBackupSelection.md) 
+  [DeleteBackupVault](API_DeleteBackupVault.md) 
+  [DeleteBackupVaultAccessPolicy](API_DeleteBackupVaultAccessPolicy.md) 
+  [DeleteBackupVaultLockConfiguration](API_DeleteBackupVaultLockConfiguration.md) 
+  [DeleteBackupVaultNotifications](API_DeleteBackupVaultNotifications.md) 
+  [DeleteFramework](API_DeleteFramework.md) 
+  [DeleteRecoveryPoint](API_DeleteRecoveryPoint.md) 
+  [DeleteReportPlan](API_DeleteReportPlan.md) 
+  [DeleteRestoreTestingPlan](API_DeleteRestoreTestingPlan.md) 
+  [DeleteRestoreTestingSelection](API_DeleteRestoreTestingSelection.md) 
+  [DeleteTieringConfiguration](API_DeleteTieringConfiguration.md) 
+  [DescribeBackupJob](API_DescribeBackupJob.md) 
+  [DescribeBackupVault](API_DescribeBackupVault.md) 
+  [DescribeCopyJob](API_DescribeCopyJob.md) 
+  [DescribeFramework](API_DescribeFramework.md) 
+  [DescribeGlobalSettings](API_DescribeGlobalSettings.md) 
+  [DescribeProtectedResource](API_DescribeProtectedResource.md) 
+  [DescribeRecoveryPoint](API_DescribeRecoveryPoint.md) 
+  [DescribeRegionSettings](API_DescribeRegionSettings.md) 
+  [DescribeReportJob](API_DescribeReportJob.md) 
+  [DescribeReportPlan](API_DescribeReportPlan.md) 
+  [DescribeRestoreJob](API_DescribeRestoreJob.md) 
+  [DescribeScanJob](API_DescribeScanJob.md) 
+  [DisassociateBackupVaultMpaApprovalTeam](API_DisassociateBackupVaultMpaApprovalTeam.md) 
+  [DisassociateRecoveryPoint](API_DisassociateRecoveryPoint.md) 
+  [DisassociateRecoveryPointFromParent](API_DisassociateRecoveryPointFromParent.md) 
+  [ExportBackupPlanTemplate](API_ExportBackupPlanTemplate.md) 
+  [GetBackupPlan](API_GetBackupPlan.md) 
+  [GetBackupPlanFromJSON](API_GetBackupPlanFromJSON.md) 
+  [GetBackupPlanFromTemplate](API_GetBackupPlanFromTemplate.md) 
+  [GetBackupSelection](API_GetBackupSelection.md) 
+  [GetBackupVaultAccessPolicy](API_GetBackupVaultAccessPolicy.md) 
+  [GetBackupVaultNotifications](API_GetBackupVaultNotifications.md) 
+  [GetLegalHold](API_GetLegalHold.md) 
+  [GetRecoveryPointIndexDetails](API_GetRecoveryPointIndexDetails.md) 
+  [GetRecoveryPointRestoreMetadata](API_GetRecoveryPointRestoreMetadata.md) 
+  [GetRestoreJobMetadata](API_GetRestoreJobMetadata.md) 
+  [GetRestoreTestingInferredMetadata](API_GetRestoreTestingInferredMetadata.md) 
+  [GetRestoreTestingPlan](API_GetRestoreTestingPlan.md) 
+  [GetRestoreTestingSelection](API_GetRestoreTestingSelection.md) 
+  [GetSupportedResourceTypes](API_GetSupportedResourceTypes.md) 
+  [GetTieringConfiguration](API_GetTieringConfiguration.md) 
+  [ListBackupJobs](API_ListBackupJobs.md) 
+  [ListBackupJobSummaries](API_ListBackupJobSummaries.md) 
+  [ListBackupPlans](API_ListBackupPlans.md) 
+  [ListBackupPlanTemplates](API_ListBackupPlanTemplates.md) 
+  [ListBackupPlanVersions](API_ListBackupPlanVersions.md) 
+  [ListBackupSelections](API_ListBackupSelections.md) 
+  [ListBackupVaults](API_ListBackupVaults.md) 
+  [ListCopyJobs](API_ListCopyJobs.md) 
+  [ListCopyJobSummaries](API_ListCopyJobSummaries.md) 
+  [ListFrameworks](API_ListFrameworks.md) 
+  [ListIndexedRecoveryPoints](API_ListIndexedRecoveryPoints.md) 
+  [ListLegalHolds](API_ListLegalHolds.md) 
+  [ListProtectedResources](API_ListProtectedResources.md) 
+  [ListProtectedResourcesByBackupVault](API_ListProtectedResourcesByBackupVault.md) 
+  [ListRecoveryPointsByBackupVault](API_ListRecoveryPointsByBackupVault.md) 
+  [ListRecoveryPointsByLegalHold](API_ListRecoveryPointsByLegalHold.md) 
+  [ListRecoveryPointsByResource](API_ListRecoveryPointsByResource.md) 
+  [ListReportJobs](API_ListReportJobs.md) 
+  [ListReportPlans](API_ListReportPlans.md) 
+  [ListRestoreAccessBackupVaults](API_ListRestoreAccessBackupVaults.md) 
+  [ListRestoreJobs](API_ListRestoreJobs.md) 
+  [ListRestoreJobsByProtectedResource](API_ListRestoreJobsByProtectedResource.md) 
+  [ListRestoreJobSummaries](API_ListRestoreJobSummaries.md) 
+  [ListRestoreTestingPlans](API_ListRestoreTestingPlans.md) 
+  [ListRestoreTestingSelections](API_ListRestoreTestingSelections.md) 
+  [ListScanJobs](API_ListScanJobs.md) 
+  [ListScanJobSummaries](API_ListScanJobSummaries.md) 
+  [ListTags](API_ListTags.md) 
+  [ListTieringConfigurations](API_ListTieringConfigurations.md) 
+  [PutBackupVaultAccessPolicy](API_PutBackupVaultAccessPolicy.md) 
+  [PutBackupVaultLockConfiguration](API_PutBackupVaultLockConfiguration.md) 
+  [PutBackupVaultNotifications](API_PutBackupVaultNotifications.md) 
+  [PutRestoreValidationResult](API_PutRestoreValidationResult.md) 
+  [RevokeRestoreAccessBackupVault](API_RevokeRestoreAccessBackupVault.md) 
+  [StartBackupJob](API_StartBackupJob.md) 
+  [StartCopyJob](API_StartCopyJob.md) 
+  [StartReportJob](API_StartReportJob.md) 
+  [StartRestoreJob](API_StartRestoreJob.md) 
+  [StartScanJob](API_StartScanJob.md) 
+  [StopBackupJob](API_StopBackupJob.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateBackupPlan](API_UpdateBackupPlan.md) 
+  [UpdateFramework](API_UpdateFramework.md) 
+  [UpdateGlobalSettings](API_UpdateGlobalSettings.md) 
+  [UpdateRecoveryPointIndexSettings](API_UpdateRecoveryPointIndexSettings.md) 
+  [UpdateRecoveryPointLifecycle](API_UpdateRecoveryPointLifecycle.md) 
+  [UpdateRegionSettings](API_UpdateRegionSettings.md) 
+  [UpdateReportPlan](API_UpdateReportPlan.md) 
+  [UpdateRestoreTestingPlan](API_UpdateRestoreTestingPlan.md) 
+  [UpdateRestoreTestingSelection](API_UpdateRestoreTestingSelection.md) 
+  [UpdateTieringConfiguration](API_UpdateTieringConfiguration.md) 

다음 작업은 AWS Backup gateway에서 지원됩니다.
+  [AssociateGatewayToServer](API_BGW_AssociateGatewayToServer.md) 
+  [CreateGateway](API_BGW_CreateGateway.md) 
+  [DeleteGateway](API_BGW_DeleteGateway.md) 
+  [DeleteHypervisor](API_BGW_DeleteHypervisor.md) 
+  [DisassociateGatewayFromServer](API_BGW_DisassociateGatewayFromServer.md) 
+  [GetBandwidthRateLimitSchedule](API_BGW_GetBandwidthRateLimitSchedule.md) 
+  [GetGateway](API_BGW_GetGateway.md) 
+  [GetHypervisor](API_BGW_GetHypervisor.md) 
+  [GetHypervisorPropertyMappings](API_BGW_GetHypervisorPropertyMappings.md) 
+  [GetVirtualMachine](API_BGW_GetVirtualMachine.md) 
+  [ImportHypervisorConfiguration](API_BGW_ImportHypervisorConfiguration.md) 
+  [ListGateways](API_BGW_ListGateways.md) 
+  [ListHypervisors](API_BGW_ListHypervisors.md) 
+  [ListTagsForResource](API_BGW_ListTagsForResource.md) 
+  [ListVirtualMachines](API_BGW_ListVirtualMachines.md) 
+  [PutBandwidthRateLimitSchedule](API_BGW_PutBandwidthRateLimitSchedule.md) 
+  [PutHypervisorPropertyMappings](API_BGW_PutHypervisorPropertyMappings.md) 
+  [PutMaintenanceStartTime](API_BGW_PutMaintenanceStartTime.md) 
+  [StartVirtualMachinesMetadataSync](API_BGW_StartVirtualMachinesMetadataSync.md) 
+  [TagResource](API_BGW_TagResource.md) 
+  [TestHypervisorConfiguration](API_BGW_TestHypervisorConfiguration.md) 
+  [UntagResource](API_BGW_UntagResource.md) 
+  [UpdateGatewayInformation](API_BGW_UpdateGatewayInformation.md) 
+  [UpdateGatewaySoftwareNow](API_BGW_UpdateGatewaySoftwareNow.md) 
+  [UpdateHypervisor](API_BGW_UpdateHypervisor.md) 

다음 작업은 AWS Backup 검색에서 지원됩니다.
+  [GetSearchJob](API_BKS_GetSearchJob.md) 
+  [GetSearchResultExportJob](API_BKS_GetSearchResultExportJob.md) 
+  [ListSearchJobBackups](API_BKS_ListSearchJobBackups.md) 
+  [ListSearchJobResults](API_BKS_ListSearchJobResults.md) 
+  [ListSearchJobs](API_BKS_ListSearchJobs.md) 
+  [ListSearchResultExportJobs](API_BKS_ListSearchResultExportJobs.md) 
+  [ListTagsForResource](API_BKS_ListTagsForResource.md) 
+  [StartSearchJob](API_BKS_StartSearchJob.md) 
+  [StartSearchResultExportJob](API_BKS_StartSearchResultExportJob.md) 
+  [StopSearchJob](API_BKS_StopSearchJob.md) 
+  [TagResource](API_BKS_TagResource.md) 
+  [UntagResource](API_BKS_UntagResource.md) 

# AWS Backup
<a name="API_Operations_AWS_Backup"></a>

다음 작업은 AWS Backup에서 지원됩니다.
+  [AssociateBackupVaultMpaApprovalTeam](API_AssociateBackupVaultMpaApprovalTeam.md) 
+  [CancelLegalHold](API_CancelLegalHold.md) 
+  [CreateBackupPlan](API_CreateBackupPlan.md) 
+  [CreateBackupSelection](API_CreateBackupSelection.md) 
+  [CreateBackupVault](API_CreateBackupVault.md) 
+  [CreateFramework](API_CreateFramework.md) 
+  [CreateLegalHold](API_CreateLegalHold.md) 
+  [CreateLogicallyAirGappedBackupVault](API_CreateLogicallyAirGappedBackupVault.md) 
+  [CreateReportPlan](API_CreateReportPlan.md) 
+  [CreateRestoreAccessBackupVault](API_CreateRestoreAccessBackupVault.md) 
+  [CreateRestoreTestingPlan](API_CreateRestoreTestingPlan.md) 
+  [CreateRestoreTestingSelection](API_CreateRestoreTestingSelection.md) 
+  [CreateTieringConfiguration](API_CreateTieringConfiguration.md) 
+  [DeleteBackupPlan](API_DeleteBackupPlan.md) 
+  [DeleteBackupSelection](API_DeleteBackupSelection.md) 
+  [DeleteBackupVault](API_DeleteBackupVault.md) 
+  [DeleteBackupVaultAccessPolicy](API_DeleteBackupVaultAccessPolicy.md) 
+  [DeleteBackupVaultLockConfiguration](API_DeleteBackupVaultLockConfiguration.md) 
+  [DeleteBackupVaultNotifications](API_DeleteBackupVaultNotifications.md) 
+  [DeleteFramework](API_DeleteFramework.md) 
+  [DeleteRecoveryPoint](API_DeleteRecoveryPoint.md) 
+  [DeleteReportPlan](API_DeleteReportPlan.md) 
+  [DeleteRestoreTestingPlan](API_DeleteRestoreTestingPlan.md) 
+  [DeleteRestoreTestingSelection](API_DeleteRestoreTestingSelection.md) 
+  [DeleteTieringConfiguration](API_DeleteTieringConfiguration.md) 
+  [DescribeBackupJob](API_DescribeBackupJob.md) 
+  [DescribeBackupVault](API_DescribeBackupVault.md) 
+  [DescribeCopyJob](API_DescribeCopyJob.md) 
+  [DescribeFramework](API_DescribeFramework.md) 
+  [DescribeGlobalSettings](API_DescribeGlobalSettings.md) 
+  [DescribeProtectedResource](API_DescribeProtectedResource.md) 
+  [DescribeRecoveryPoint](API_DescribeRecoveryPoint.md) 
+  [DescribeRegionSettings](API_DescribeRegionSettings.md) 
+  [DescribeReportJob](API_DescribeReportJob.md) 
+  [DescribeReportPlan](API_DescribeReportPlan.md) 
+  [DescribeRestoreJob](API_DescribeRestoreJob.md) 
+  [DescribeScanJob](API_DescribeScanJob.md) 
+  [DisassociateBackupVaultMpaApprovalTeam](API_DisassociateBackupVaultMpaApprovalTeam.md) 
+  [DisassociateRecoveryPoint](API_DisassociateRecoveryPoint.md) 
+  [DisassociateRecoveryPointFromParent](API_DisassociateRecoveryPointFromParent.md) 
+  [ExportBackupPlanTemplate](API_ExportBackupPlanTemplate.md) 
+  [GetBackupPlan](API_GetBackupPlan.md) 
+  [GetBackupPlanFromJSON](API_GetBackupPlanFromJSON.md) 
+  [GetBackupPlanFromTemplate](API_GetBackupPlanFromTemplate.md) 
+  [GetBackupSelection](API_GetBackupSelection.md) 
+  [GetBackupVaultAccessPolicy](API_GetBackupVaultAccessPolicy.md) 
+  [GetBackupVaultNotifications](API_GetBackupVaultNotifications.md) 
+  [GetLegalHold](API_GetLegalHold.md) 
+  [GetRecoveryPointIndexDetails](API_GetRecoveryPointIndexDetails.md) 
+  [GetRecoveryPointRestoreMetadata](API_GetRecoveryPointRestoreMetadata.md) 
+  [GetRestoreJobMetadata](API_GetRestoreJobMetadata.md) 
+  [GetRestoreTestingInferredMetadata](API_GetRestoreTestingInferredMetadata.md) 
+  [GetRestoreTestingPlan](API_GetRestoreTestingPlan.md) 
+  [GetRestoreTestingSelection](API_GetRestoreTestingSelection.md) 
+  [GetSupportedResourceTypes](API_GetSupportedResourceTypes.md) 
+  [GetTieringConfiguration](API_GetTieringConfiguration.md) 
+  [ListBackupJobs](API_ListBackupJobs.md) 
+  [ListBackupJobSummaries](API_ListBackupJobSummaries.md) 
+  [ListBackupPlans](API_ListBackupPlans.md) 
+  [ListBackupPlanTemplates](API_ListBackupPlanTemplates.md) 
+  [ListBackupPlanVersions](API_ListBackupPlanVersions.md) 
+  [ListBackupSelections](API_ListBackupSelections.md) 
+  [ListBackupVaults](API_ListBackupVaults.md) 
+  [ListCopyJobs](API_ListCopyJobs.md) 
+  [ListCopyJobSummaries](API_ListCopyJobSummaries.md) 
+  [ListFrameworks](API_ListFrameworks.md) 
+  [ListIndexedRecoveryPoints](API_ListIndexedRecoveryPoints.md) 
+  [ListLegalHolds](API_ListLegalHolds.md) 
+  [ListProtectedResources](API_ListProtectedResources.md) 
+  [ListProtectedResourcesByBackupVault](API_ListProtectedResourcesByBackupVault.md) 
+  [ListRecoveryPointsByBackupVault](API_ListRecoveryPointsByBackupVault.md) 
+  [ListRecoveryPointsByLegalHold](API_ListRecoveryPointsByLegalHold.md) 
+  [ListRecoveryPointsByResource](API_ListRecoveryPointsByResource.md) 
+  [ListReportJobs](API_ListReportJobs.md) 
+  [ListReportPlans](API_ListReportPlans.md) 
+  [ListRestoreAccessBackupVaults](API_ListRestoreAccessBackupVaults.md) 
+  [ListRestoreJobs](API_ListRestoreJobs.md) 
+  [ListRestoreJobsByProtectedResource](API_ListRestoreJobsByProtectedResource.md) 
+  [ListRestoreJobSummaries](API_ListRestoreJobSummaries.md) 
+  [ListRestoreTestingPlans](API_ListRestoreTestingPlans.md) 
+  [ListRestoreTestingSelections](API_ListRestoreTestingSelections.md) 
+  [ListScanJobs](API_ListScanJobs.md) 
+  [ListScanJobSummaries](API_ListScanJobSummaries.md) 
+  [ListTags](API_ListTags.md) 
+  [ListTieringConfigurations](API_ListTieringConfigurations.md) 
+  [PutBackupVaultAccessPolicy](API_PutBackupVaultAccessPolicy.md) 
+  [PutBackupVaultLockConfiguration](API_PutBackupVaultLockConfiguration.md) 
+  [PutBackupVaultNotifications](API_PutBackupVaultNotifications.md) 
+  [PutRestoreValidationResult](API_PutRestoreValidationResult.md) 
+  [RevokeRestoreAccessBackupVault](API_RevokeRestoreAccessBackupVault.md) 
+  [StartBackupJob](API_StartBackupJob.md) 
+  [StartCopyJob](API_StartCopyJob.md) 
+  [StartReportJob](API_StartReportJob.md) 
+  [StartRestoreJob](API_StartRestoreJob.md) 
+  [StartScanJob](API_StartScanJob.md) 
+  [StopBackupJob](API_StopBackupJob.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateBackupPlan](API_UpdateBackupPlan.md) 
+  [UpdateFramework](API_UpdateFramework.md) 
+  [UpdateGlobalSettings](API_UpdateGlobalSettings.md) 
+  [UpdateRecoveryPointIndexSettings](API_UpdateRecoveryPointIndexSettings.md) 
+  [UpdateRecoveryPointLifecycle](API_UpdateRecoveryPointLifecycle.md) 
+  [UpdateRegionSettings](API_UpdateRegionSettings.md) 
+  [UpdateReportPlan](API_UpdateReportPlan.md) 
+  [UpdateRestoreTestingPlan](API_UpdateRestoreTestingPlan.md) 
+  [UpdateRestoreTestingSelection](API_UpdateRestoreTestingSelection.md) 
+  [UpdateTieringConfiguration](API_UpdateTieringConfiguration.md) 

# AssociateBackupVaultMpaApprovalTeam
<a name="API_AssociateBackupVaultMpaApprovalTeam"></a>

MPA 승인 팀을 백업 저장소와 연결합니다.

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

```
PUT /backup-vaults/backupVaultName/mpaApprovalTeam HTTP/1.1
Content-type: application/json

{
   "MpaApprovalTeamArn": "string",
   "RequesterComment": "string"
}
```

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

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

 ** [backupVaultName](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-uri-BackupVaultName"></a>
MPA 승인 팀과 연결할 백업 저장소의 이름입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

## 요청 본문
<a name="API_AssociateBackupVaultMpaApprovalTeam_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MpaApprovalTeamArn](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-MpaApprovalTeamArn"></a>
백업 저장소와 연결할 MPA 승인 팀의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [RequesterComment](#API_AssociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-AssociateBackupVaultMpaApprovalTeam-request-RequesterComment"></a>
연결 요청을 설명하는 요청자가 제공하는 설명입니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_AssociateBackupVaultMpaApprovalTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_AssociateBackupVaultMpaApprovalTeam_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CancelLegalHold
<a name="API_CancelLegalHold"></a>

복구 시점에 지정된 법적 보존을 제거합니다. 이 작업은 충분한 권한이 있는 사용자만 수행할 수 있습니다.

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

```
DELETE /legal-holds/legalHoldId?cancelDescription=CancelDescription&retainRecordInDays=RetainRecordInDays HTTP/1.1
```

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

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

 ** [CancelDescription](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-CancelDescription"></a>
법적 보존을 제거하는 이유를 설명하는 문자열입니다.  
필수 항목 여부: 예

 ** [legalHoldId](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-LegalHoldId"></a>
법적 보존의 ID입니다.  
필수 항목 여부: 예

 ** [RetainRecordInDays](#API_CancelLegalHold_RequestSyntax) **   <a name="Backup-CancelLegalHold-request-uri-RetainRecordInDays"></a>
법적 보존을 제거하기 위한 일수(정수 단위)입니다.

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

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

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

```
HTTP/1.1 201
```

## Response Elements
<a name="API_CancelLegalHold_ResponseElements"></a>

작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP 201 응답을 다시 전송합니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidResourceStateException **   
 AWS Backup 가 이미이 복구 시점에 작업을 수행하고 있습니다. 첫 번째 작업이 완료될 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateBackupPlan
<a name="API_CreateBackupPlan"></a>

백업 계획 이름 및 백업 규칙을 사용하여 백업 계획을 생성합니다. 백업 계획은가 리소스에 대한 복구 시점을 생성하는 작업을 예약하는 데 AWS Backup 사용하는 정보가 포함된 문서입니다.

이미 존재하는 플랜으로 `CreateBackupPlan`을 호출하면 `AlreadyExistsException` 예외를 받습니다.

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

```
PUT /backup/plans/ HTTP/1.1
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   },
   "BackupPlanTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string"
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateBackupPlan_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-BackupPlan"></a>
백업 계획의 본문입니다. `BackupPlanName`과 하나 이상의 `Rules` 집합을 포함합니다.  
타입: [BackupPlanInput](API_BackupPlanInput.md)객체  
필수 항목 여부: 예

 ** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-BackupPlanTags"></a>
백업 계획에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) **   <a name="Backup-CreateBackupPlan-request-CreatorRequestId"></a>
요청을 식별하며 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 합니다. 요청에 기존 백업 계획과 일치하는 `CreatorRequestId`가 포함된 경우, 해당 계획이 반환됩니다. 이 파라미터는 선택 사항입니다.  
이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_CreateBackupPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "VersionId": "string"
}
```

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

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

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

 ** [AdvancedBackupSettings](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-AdvancedBackupSettings"></a>
리소스 유형에 대한 설정입니다. 이 옵션은 Windows VSS(Volume Shadow Copy Service) 백업 작업에만 사용할 수 있습니다.  
타입: [AdvancedBackupSetting](API_AdvancedBackupSetting.md)객체 배열

 ** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-BackupPlanArn"></a>
백업 계획을 고유하게 식별하는 Amazon 리소스 이름(ARN)(예: `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`)입니다.  
유형: 문자열

 ** [BackupPlanId](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-BackupPlanId"></a>
백업 계획의 ID입니다.  
유형: 문자열

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

 ** [VersionId](#API_CreateBackupPlan_ResponseSyntax) **   <a name="Backup-CreateBackupPlan-response-VersionId"></a>
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.  
유형: 문자열

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateBackupSelection
<a name="API_CreateBackupSelection"></a>

백업 계획에 할당할 리소스 집합을 지정하는 JSON 문서를 생성합니다. 예를 들어, [프로그래밍 방식으로 리소스 할당](https://docs.aws.amazon.com/aws-backup/latest/devguide/assigning-resources.html#assigning-resources-json)을 참조하세요.

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

```
PUT /backup/plans/backupPlanId/selections/ HTTP/1.1
Content-type: application/json

{
   "BackupSelection": { 
      "Conditions": { 
         "StringEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ]
      },
      "IamRoleArn": "string",
      "ListOfTags": [ 
         { 
            "ConditionKey": "string",
            "ConditionType": "string",
            "ConditionValue": "string"
         }
      ],
      "NotResources": [ "string" ],
      "Resources": [ "string" ],
      "SelectionName": "string"
   },
   "CreatorRequestId": "string"
}
```

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

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

 ** [backupPlanId](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-uri-BackupPlanId"></a>
백업 계획의 ID입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_CreateBackupSelection_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupSelection](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-BackupSelection"></a>
백업 계획에 리소스 세트를 할당하기 위한 요청 본문입니다.  
타입: [BackupSelection](API_BackupSelection.md)객체  
필수 항목 여부: 예

 ** [CreatorRequestId](#API_CreateBackupSelection_RequestSyntax) **   <a name="Backup-CreateBackupSelection-request-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다. 이 파라미터는 선택 사항입니다.  
이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_CreateBackupSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanId": "string",
   "CreationDate": number,
   "SelectionId": "string"
}
```

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

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

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

 ** [BackupPlanId](#API_CreateBackupSelection_ResponseSyntax) **   <a name="Backup-CreateBackupSelection-response-BackupPlanId"></a>
백업 계획의 ID입니다.  
유형: 문자열

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

 ** [SelectionId](#API_CreateBackupSelection_ResponseSyntax) **   <a name="Backup-CreateBackupSelection-response-SelectionId"></a>
리소스 집합을 백업 계획에 할당하는 요청의 본문을 고유하게 식별합니다.  
유형: 문자열

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateBackupVault
<a name="API_CreateBackupVault"></a>

백업이 저장되는 논리 컨테이너를 생성합니다. `CreateBackupVault` 요청에는 이름, 선택적으로 하나 이상의 리소스 태그, 암호화 키 및 요청 ID가 포함됩니다.

**참고**  
여권 번호처럼 민감한 데이터를 백업 저장소 이름에 포함하지 마세요.

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

```
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json

{
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string"
}
```

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

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

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

## 요청 본문
<a name="API_CreateBackupVault_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupVaultTags](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-BackupVaultTags"></a>
백업 저장소에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [CreatorRequestId](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다. 이 파라미터는 선택 사항입니다.  
이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [EncryptionKeyArn](#API_CreateBackupVault_RequestSyntax) **   <a name="Backup-CreateBackupVault-request-EncryptionKeyArn"></a>
백업을 보호하는 데 사용되는 서버 측 암호화 키(예: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`)입니다.  
유형: String  
필수사항: 아니요

## 응답 구문
<a name="API_CreateBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number
}
```

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

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

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

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

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

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

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateFramework
<a name="API_CreateFramework"></a>

하나 이상의 컨트롤이 있는 프레임워크를 생성합니다. 프레임워크는 백업 방식을 평가하는 데 사용할 수 있는 컨트롤의 모음입니다. 사전 구축된 사용자 지정 가능한 컨트롤을 사용하여 정책을 정의하면 백업 방식이 정책을 준수하는지 여부와 아직 준수하지 않는 리소스를 평가할 수 있습니다.

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

```
POST /audit/frameworks HTTP/1.1
Content-type: application/json

{
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "FrameworkName": "string",
   "FrameworkTags": { 
      "string" : "string" 
   },
   "IdempotencyToken": "string"
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateFramework_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [FrameworkControls](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkControls"></a>
프레임워크를 구성하는 컨트롤입니다. 목록의 각 컨트롤에는 이름, 입력 파라미터, 범위가 있습니다.  
타입: [FrameworkControl](API_FrameworkControl.md)객체 배열  
필수 항목 여부: 예

 ** [FrameworkDescription](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkDescription"></a>
프레임워크에 대한 최대 1,024자의 설명(선택 사항)입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.  
패턴: `.*\S.*`   
필수 여부: 아니요

 ** [FrameworkName](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkName"></a>
프레임워크의 고유 이름입니다. 이름은 문자로 시작하고 문자(a\$1z, A\$1Z), 숫자(0\$19) 및 밑줄(\$1)로 구성된 1\$1256자여야 합니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

 ** [FrameworkTags](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-FrameworkTags"></a>
프레임워크에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [IdempotencyToken](#API_CreateFramework_RequestSyntax) **   <a name="Backup-CreateFramework-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `CreateFrameworkInput`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_CreateFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "FrameworkArn": "string",
   "FrameworkName": "string"
}
```

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

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

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

 ** [FrameworkArn](#API_CreateFramework_ResponseSyntax) **   <a name="Backup-CreateFramework-response-FrameworkArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: 문자열

 ** [FrameworkName](#API_CreateFramework_ResponseSyntax) **   <a name="Backup-CreateFramework-response-FrameworkName"></a>
프레임워크의 고유 이름입니다. 이름은 문자로 시작하고 문자(a\$1z, A\$1Z), 숫자(0\$19) 및 밑줄(\$1)로 구성된 1\$1256자여야 합니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*` 

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateLegalHold
<a name="API_CreateLegalHold"></a>

복구 시점(백업)에 법적 보존을 생성합니다. 법적 보존은 승인된 사용자가 법적 보존을 취소할 때까지 백업을 변경하거나 삭제하는 것을 제한하는 것입니다. 복구 시점에 하나 이상의 유효한 법적 보존이 있는 경우, 복구 시점을 삭제하거나 연결을 해제하려는 작업은 오류 메시지가 표시되면서 실패합니다.

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

```
POST /legal-holds/ HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "IdempotencyToken": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Tags": { 
      "string" : "string" 
   },
   "Title": "string"
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateLegalHold_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Description](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Description"></a>
법적 보존에 대한 설명입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [IdempotencyToken](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-IdempotencyToken"></a>
이 문자열은 동일한 호출을 구분하기 위해 사용자가 선택한 문자열입니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [RecoveryPointSelection](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-RecoveryPointSelection"></a>
리소스 유형 또는 백업 저장소 같은 리소스 집합을 할당하기 위한 기준입니다.  
유형: [RecoveryPointSelection](API_RecoveryPointSelection.md)객체  
필수 여부: 아니요

 ** [Tags](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Tags"></a>
포함하려는 선택적인 태그입니다. 태그는 리소스를 관리, 필터링, 검색하는 데 사용할 수 있는 키-값 페어입니다. 허용되는 문자는 UTF-8 문자, 숫자, 공백 및 \$1 - = . \$1 : /입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [Title](#API_CreateLegalHold_RequestSyntax) **   <a name="Backup-CreateLegalHold-request-Title"></a>
법적 보존의 제목입니다.  
유형: 문자열  
필수 항목 여부: 예

## 응답 구문
<a name="API_CreateLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationDate": number,
   "Description": "string",
   "LegalHoldArn": "string",
   "LegalHoldId": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "Status": "string",
   "Title": "string"
}
```

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

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

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

 ** [CreationDate](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-CreationDate"></a>
법적 보존이 생성된 시간입니다.  
유형: 타임스탬프

 ** [Description](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Description"></a>
법적 보존에 대한 설명입니다.  
유형: 문자열

 ** [LegalHoldArn](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-LegalHoldArn"></a>
법적 보존의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열

 ** [LegalHoldId](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-LegalHoldId"></a>
법적 보존의 ID입니다.  
유형: 문자열

 ** [RecoveryPointSelection](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-RecoveryPointSelection"></a>
리소스 유형 또는 백업 저장소 같은 리소스 집합에 할당하기 위한 기준입니다.  
유형: [RecoveryPointSelection](API_RecoveryPointSelection.md)객체

 ** [Status](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Status"></a>
법적 보존의 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_CreateLegalHold_ResponseSyntax) **   <a name="Backup-CreateLegalHold-response-Title"></a>
법적 보존의 제목입니다.  
유형: 문자열

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

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

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateLogicallyAirGappedBackupVault
<a name="API_CreateLogicallyAirGappedBackupVault"></a>

백업을 복사할 수 있는 논리 컨테이너를 생성합니다.

이 요청에는 이름, 리전, 최대 보존 일수, 최소 보존 일수가 포함되며 선택에 따라 태그와 작성자 요청 ID를 포함할 수 있습니다.

**참고**  
여권 번호처럼 민감한 데이터를 백업 저장소 이름에 포함하지 마세요.

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

```
PUT /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json

{
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string",
   "MaxRetentionDays": number,
   "MinRetentionDays": number
}
```

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

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

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

## 요청 본문
<a name="API_CreateLogicallyAirGappedBackupVault_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupVaultTags](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-BackupVaultTags"></a>
저장소에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [CreatorRequestId](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-CreatorRequestId"></a>
생성 요청의 ID입니다.  
이 파라미터는 선택 사항입니다. 이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [EncryptionKeyArn](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-EncryptionKeyArn"></a>
논리적 에어 갭 백업 저장소를 암호화하는 데 사용할 고객 관리형 KMS 키의 ARN입니다. 지정하지 않으면 볼트가 AWS Backup에서 관리하는 AWS소유 키로 암호화됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [MaxRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-MaxRetentionDays"></a>
저장소가 복구 시점을 유지하는 최대 보존 기간입니다.  
타입: Long  
필수 항목 여부: 예

 ** [MinRetentionDays](#API_CreateLogicallyAirGappedBackupVault_RequestSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-request-MinRetentionDays"></a>
이 설정은 저장소가 복구 시점을 유지하는 최소 보존 기간을 지정합니다.  
허용되는 최솟값은 7일입니다.  
타입: Long  
필수 항목 여부: 예

## 응답 구문
<a name="API_CreateLogicallyAirGappedBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number,
   "VaultState": "string"
}
```

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

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

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

 ** [BackupVaultArn](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-BackupVaultArn"></a>
저장소의 ARN(Amazon 리소스 이름)입니다.  
유형: 문자열

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

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

 ** [VaultState](#API_CreateLogicallyAirGappedBackupVault_ResponseSyntax) **   <a name="Backup-CreateLogicallyAirGappedBackupVault-response-VaultState"></a>
저장소의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | AVAILABLE | FAILED` 

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateReportPlan
<a name="API_CreateReportPlan"></a>

보고서 계획을 생성합니다. 보고서 계획은 보고서의 내용과이 보고서를 전달하는 위치에 대한 정보가 포함된 문서 AWS Backup 입니다.

이미 존재하는 플랜으로 `CreateReportPlan`을 호출하면 `AlreadyExistsException` 예외를 받습니다.

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

```
POST /audit/report-plans HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string",
   "ReportDeliveryChannel": { 
      "Formats": [ "string" ],
      "S3BucketName": "string",
      "S3KeyPrefix": "string"
   },
   "ReportPlanDescription": "string",
   "ReportPlanName": "string",
   "ReportPlanTags": { 
      "string" : "string" 
   },
   "ReportSetting": { 
      "Accounts": [ "string" ],
      "FrameworkArns": [ "string" ],
      "NumberOfFrameworks": number,
      "OrganizationUnits": [ "string" ],
      "Regions": [ "string" ],
      "ReportTemplate": "string"
   }
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateReportPlan_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `CreateReportPlanInput`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [ReportDeliveryChannel](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportDeliveryChannel"></a>
보고서를 전송하는 위치와 방법, 특히 Amazon S3 버킷 이름, S3 키 접두사 및 보고서 형식에 대한 정보가 들어 있는 구조입니다.  
타입: [ReportDeliveryChannel](API_ReportDeliveryChannel.md)객체  
필수 항목 여부: 예

 ** [ReportPlanDescription](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanDescription"></a>
보고서 계획에 대한 최대 1,024자의 설명(선택 사항)입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.  
패턴: `.*\S.*`   
필수 여부: 아니요

 ** [ReportPlanName](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanName"></a>
보고서 계획의 고유 이름입니다. 이름은 문자로 시작하고 문자(a\$1z, A\$1Z), 숫자(0\$19) 및 밑줄(\$1)로 구성된 1\$1256자여야 합니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

 ** [ReportPlanTags](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanTags"></a>
보고서 계획에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportSetting"></a>
보고서에 대한 보고서 템플릿을 식별합니다. 보고서는 보고서 템플릿을 사용하여 작성됩니다. 보고서 템플릿은 다음과 같습니다.  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT `   
보고서 템플릿이 `RESOURCE_COMPLIANCE_REPORT` 또는 `CONTROL_COMPLIANCE_REPORT`인 경우이 API 리소스는 AWS 리전 및 프레임워크별 보고서 적용 범위도 설명합니다.  
타입: [ReportSetting](API_ReportSetting.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_CreateReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "string"
}
```

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

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

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

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

 ** [ReportPlanArn](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: String

 ** [ReportPlanName](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanName"></a>
보고서 계획의 고유 이름입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*` 

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateRestoreAccessBackupVault
<a name="API_CreateRestoreAccessBackupVault"></a>

MPA 승인에 따라 논리적 에어 갭 백업 저장소의 복구 시점에 대한 임시 액세스를 제공하는 복원 액세스 백업 저장소를 생성합니다.

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

```
PUT /restore-access-backup-vaults HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "BackupVaultTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string",
   "RequesterComment": "string",
   "SourceBackupVaultArn": "string"
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateRestoreAccessBackupVault_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupVaultName](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-BackupVaultName"></a>
MPA 승인 팀과 연결할 백업 저장소의 이름입니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 아니요

 ** [BackupVaultTags](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-BackupVaultTags"></a>
복원 액세스 백업 저장소에 할당할 선택적 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [CreatorRequestId](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [RequesterComment](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-RequesterComment"></a>
백업 저장소에 대한 복원 액세스를 요청하는 이유를 설명하는 설명입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [SourceBackupVaultArn](#API_CreateRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-request-SourceBackupVaultArn"></a>
임시 액세스가 요청되는 복구 시점이 포함된 소스 백업 저장소의 ARN입니다.  
유형: 문자열  
필수 항목 여부: 예

## 응답 구문
<a name="API_CreateRestoreAccessBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationDate": number,
   "RestoreAccessBackupVaultArn": "string",
   "RestoreAccessBackupVaultName": "string",
   "VaultState": "string"
}
```

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

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

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

 ** [CreationDate](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-CreationDate"></a>
>복원 액세스 백업 저장소가 생성된 날짜 및 시간(Unix 형식 및 협정 세계시)   
유형: 타임스탬프

 ** [RestoreAccessBackupVaultArn](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-RestoreAccessBackupVaultArn"></a>
생성된 복원 액세스 백업 저장소를 고유하게 식별하는 ARN입니다.  
유형: 문자열

 ** [RestoreAccessBackupVaultName](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-RestoreAccessBackupVaultName"></a>
생성된 복원 액세스 백업 저장소의 이름입니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [VaultState](#API_CreateRestoreAccessBackupVault_ResponseSyntax) **   <a name="Backup-CreateRestoreAccessBackupVault-response-VaultState"></a>
복원 액세스 백업 저장소의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | AVAILABLE | FAILED` 

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateRestoreTestingPlan
<a name="API_CreateRestoreTestingPlan"></a>

복원 테스트 계획을 생성합니다.

복원 테스트 계획을 생성하는 두 단계 중 첫 번째입니다. 이 요청이 성공하면 CreateRestoreTestingSelection을 사용하여 절차를 완료합니다.

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

```
PUT /restore-testing/plans HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "RestoreTestingPlan": { 
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "RestoreTestingPlanName": "string",
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   },
   "Tags": { 
      "string" : "string" 
   }
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateRestoreTestingPlan_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [CreatorRequestId](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다. 이 파라미터는 선택 사항입니다. 이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [RestoreTestingPlan](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-RestoreTestingPlan"></a>
복원 테스트 계획에는 사용자가 만든 고유한 `RestoreTestingPlanName` 문자열과 `ScheduleExpression` cron이 포함되어야 합니다. 선택적으로 `StartWindowHours` 정수와 `CreatorRequestId` 문자열을 포함할 수 있습니다.  
`RestoreTestingPlanName`은 복원 테스트 계획의 이름을 나타내는 고유한 문자열입니다. 이 값은 만든 후에는 변경할 수 없으며 영숫자와 밑줄로만 구성되어야 합니다.  
타입: [RestoreTestingPlanForCreate](API_RestoreTestingPlanForCreate.md)객체  
필수 항목 여부: 예

 ** [Tags](#API_CreateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-CreateRestoreTestingPlan-request-Tags"></a>
복원 테스트 계획에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreateRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string"
}
```

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

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

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

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

 ** [RestoreTestingPlanArn](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
생성된 복원 테스트 계획을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
이 고유한 문자열은 복원 테스트 계획의 이름을 나타냅니다.  
생성한 후에는 이름을 변경할 수 없습니다. 이름은 영숫자와 밑줄로만 구성해야 합니다. 최대 길이는 50자입니다.  
유형: 문자열

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateRestoreTestingSelection
<a name="API_CreateRestoreTestingSelection"></a>

이 요청은 CreateRestoreTestingPlan 요청이 성공적으로 반환된 후에 보낼 수 있습니다. 이 단계는 리소스 테스트 계획 생성의 두 번째 부분이며 순차적으로 완료해야 합니다.

이것은 `RestoreTestingSelectionName`, `ProtectedResourceType` 및 다음 중 하나로 구성됩니다.
+  `ProtectedResourceArns` 
+  `ProtectedResourceConditions` 

각 보호된 리소스 유형은 단일 값을 가질 수 있습니다.

복원 테스트 선택 항목에는 `ProtectedResourceArns`에 대한 와일드카드 값('\$1')과 함께 `ProtectedResourceConditions`를 포함할 수 있습니다. 또는 `ProtectedResourceArns`에 최대 30개의 특정 보호된 리소스 ARN을 포함할 수 있습니다.

보호된 리소스 유형과 특정 ARN 둘 다로는 선택할 수 없습니다. 둘 다 포함되면 요청이 실패합니다.

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

```
PUT /restore-testing/plans/RestoreTestingPlanName/selections HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "RestoreTestingSelection": { 
      "IamRoleArn": "string",
      "ProtectedResourceArns": [ "string" ],
      "ProtectedResourceConditions": { 
         "StringEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      },
      "ProtectedResourceType": "string",
      "RestoreMetadataOverrides": { 
         "string" : "string" 
      },
      "RestoreTestingSelectionName": "string",
      "ValidationWindowHours": number
   }
}
```

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

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

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
관련 CreateRestoreTestingPlan 요청에서 반환된 복원 테스트 계획 이름을 입력합니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_CreateRestoreTestingSelection_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [CreatorRequestId](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 선택적인 고유 문자열입니다. 이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [RestoreTestingSelection](#API_CreateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-CreateRestoreTestingSelection-request-RestoreTestingSelection"></a>
이것은 `RestoreTestingSelectionName`, `ProtectedResourceType` 및 다음 중 하나로 구성됩니다.  
+  `ProtectedResourceArns` 
+  `ProtectedResourceConditions` 
각 보호된 리소스 유형은 단일 값을 가질 수 있습니다.  
복원 테스트 선택 항목에는 `ProtectedResourceArns`에 대한 와일드카드 값('\$1')과 함께 `ProtectedResourceConditions`를 포함할 수 있습니다. 또는 `ProtectedResourceArns`에 최대 30개의 특정 보호된 리소스 ARN을 포함할 수 있습니다.  
타입: [RestoreTestingSelectionForCreate](API_RestoreTestingSelectionForCreate.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_CreateRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string",
   "RestoreTestingSelectionName": "string"
}
```

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

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

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

 ** [CreationTime](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-CreationTime"></a>
리소스 테스트 선택 항목이 생성된 시간입니다.  
유형: 타임스탬프

 ** [RestoreTestingPlanArn](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingPlanArn"></a>
복원 테스트 선택 항목이 관련된 복원 테스트 계획의 ARN입니다.  
유형: 문자열

 ** [RestoreTestingPlanName](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingPlanName"></a>
복원 테스트 계획의 이름입니다.  
생성한 후에는 이름을 변경할 수 없습니다. 이름은 영숫자와 밑줄로만 구성해야 합니다. 최대 길이는 50자입니다.  
유형: 문자열

 ** [RestoreTestingSelectionName](#API_CreateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-CreateRestoreTestingSelection-response-RestoreTestingSelectionName"></a>
관련 복원 테스트 계획에 대한 복원 테스트 선택 항목의 이름입니다.  
생성한 후에는 이름을 변경할 수 없습니다. 이름은 영숫자와 밑줄로만 구성해야 합니다. 최대 길이는 50자입니다.  
유형: 문자열

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# CreateTieringConfiguration
<a name="API_CreateTieringConfiguration"></a>

계층화 구성을 생성합니다.

계층화 구성을 사용하면 백업 볼트에 백업된 객체의 수명에 따라 백업 데이터를 더 저렴한 스토리지 계층으로 자동 이동할 수 있습니다.

각 볼트는 모든 볼트에 적용되는 글로벌 구성 외에도 하나의 볼트별 계층화 구성만 가질 수 있습니다.

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

```
PUT /tiering-configurations HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationName": "string"
   },
   "TieringConfigurationTags": { 
      "string" : "string" 
   }
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_CreateTieringConfiguration_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-CreatorRequestId"></a>
이는 요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 재시도할 수 있는 고유한 문자열입니다. 이 파라미터는 선택 사항입니다. 이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
계층화 구성에는 생성한 고유한 `TieringConfigurationName` 문자열이 포함되어야 하며 및 `BackupVaultName`가 포함되어야 합니다`ResourceSelection`. 선택적으로 `CreatorRequestId` 문자열을 포함할 수 있습니다.  
`TieringConfigurationName`는 계층화 구성의 이름인 고유한 문자열입니다. 이 값은 만든 후에는 변경할 수 없으며 영숫자와 밑줄로만 구성되어야 합니다.  
타입: [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md)객체  
필수 항목 여부: 예

 ** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
계층화 구성에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_CreateTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "string"
}
```

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

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

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

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

 ** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
생성된 계층화 구성을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
이 고유 문자열은 계층화 구성의 이름입니다.  
생성한 후에는 이름을 변경할 수 없습니다. 이름은 영숫자와 밑줄로만 구성해야 합니다. 최대 길이는 200입니다.  
유형: 문자열

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

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

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteBackupPlan
<a name="API_DeleteBackupPlan"></a>

백업 계획을 삭제합니다. 리소스의 모든 연결된 선택 항목이 삭제된 후에만 백업 계획을 삭제할 수 있습니다. 백업 계획을 삭제하면 백업 계획의 현재 버전이 삭제됩니다. 이전 버전(있는 경우)은 계속 존재합니다.

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

```
DELETE /backup/plans/backupPlanId HTTP/1.1
```

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

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

 ** [backupPlanId](#API_DeleteBackupPlan_RequestSyntax) **   <a name="Backup-DeleteBackupPlan-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "DeletionDate": number,
   "VersionId": "string"
}
```

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

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

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

 ** [BackupPlanArn](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-BackupPlanArn"></a>
백업 계획을 고유하게 식별하는 Amazon 리소스 이름(ARN)(예: `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`)입니다.  
유형: 문자열

 ** [BackupPlanId](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
유형: 문자열

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

 ** [VersionId](#API_DeleteBackupPlan_ResponseSyntax) **   <a name="Backup-DeleteBackupPlan-response-VersionId"></a>
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.  
유형: 문자열

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteBackupSelection
<a name="API_DeleteBackupSelection"></a>

`SelectionId`에서 지정한 백업 계획과 관련된 리소스 선택 항목을 삭제합니다.

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

```
DELETE /backup/plans/backupPlanId/selections/selectionId HTTP/1.1
```

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

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

 ** [backupPlanId](#API_DeleteBackupSelection_RequestSyntax) **   <a name="Backup-DeleteBackupSelection-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

 ** [selectionId](#API_DeleteBackupSelection_RequestSyntax) **   <a name="Backup-DeleteBackupSelection-request-uri-SelectionId"></a>
리소스 집합을 백업 계획에 할당하는 요청의 본문을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteBackupSelection_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteBackupSelection_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_DeleteBackupSelection_SeeAlso"></a>

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

# DeleteBackupVault
<a name="API_DeleteBackupVault"></a>

이름으로 식별되는 백업 저장소를 삭제합니다. 저장소는 비어 있는 경우에만 삭제할 수 있습니다.

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

```
DELETE /backup-vaults/backupVaultName HTTP/1.1
```

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

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

 ** [backupVaultName](#API_DeleteBackupVault_RequestSyntax) **   <a name="Backup-DeleteBackupVault-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteBackupVault_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteBackupVaultAccessPolicy
<a name="API_DeleteBackupVaultAccessPolicy"></a>

백업 저장소에 대한 권한을 관리하는 정책 문서를 삭제합니다.

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

```
DELETE /backup-vaults/backupVaultName/access-policy HTTP/1.1
```

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

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

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

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteBackupVaultAccessPolicy_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteBackupVaultAccessPolicy_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_DeleteBackupVaultAccessPolicy_SeeAlso"></a>

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

# DeleteBackupVaultLockConfiguration
<a name="API_DeleteBackupVaultLockConfiguration"></a>

백업 AWS Backup 볼트 이름으로 지정된 백업 볼트에서 볼트 잠금을 삭제합니다.

저장소 잠금 구성을 변경할 수 없는 경우 API 작업을 사용하여 저장소 잠금을 삭제할 수 없으며, 삭제하려고 할 경우 `InvalidRequestException`이 표시됩니다. 자세한 내용은 * AWS Backup 개발자 안내서*의 [볼트 잠금](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html)을 참조하세요.

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

```
DELETE /backup-vaults/backupVaultName/vault-lock HTTP/1.1
```

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

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

 ** [backupVaultName](#API_DeleteBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-DeleteBackupVaultLockConfiguration-request-uri-BackupVaultName"></a>
볼트 잠금을 삭제할 백업 AWS Backup 볼트의 이름입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteBackupVaultLockConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteBackupVaultNotifications
<a name="API_DeleteBackupVaultNotifications"></a>

지정된 백업 저장소에 대한 이벤트 알림을 삭제합니다.

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

```
DELETE /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
```

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

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

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

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteBackupVaultNotifications_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteBackupVaultNotifications_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_DeleteBackupVaultNotifications_SeeAlso"></a>

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

# DeleteFramework
<a name="API_DeleteFramework"></a>

프레임워크 이름으로 지정된 프레임워크를 삭제합니다.

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

```
DELETE /audit/frameworks/frameworkName HTTP/1.1
```

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

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

 ** [frameworkName](#API_DeleteFramework_RequestSyntax) **   <a name="Backup-DeleteFramework-request-uri-FrameworkName"></a>
프레임워크의 고유 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteFramework_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteRecoveryPoint
<a name="API_DeleteRecoveryPoint"></a>

복구 시점 ID로 지정된 복구 시점을 삭제합니다.

복구 시점 ID가 연속 백업에 속하는 경우, 이 엔드포인트를 호출하면 기존 연속 백업이 삭제되고 향후 연속 백업이 중지됩니다.

IAM 역할의 권한이 부족하여 이 API를 호출할 수 없는 경우, 서비스에서 HTTP 본문이 비어 있는 HTTP 200 응답을 다시 보내지만 복구 시점은 삭제되지 않습니다. 그 대신 `EXPIRED` 상태가 됩니다.

 IAM 역할이 `iam:CreateServiceLinkedRole` 작업을 수행하면 이 API를 사용하여 `EXPIRED` 복구 시점을 삭제할 수 있습니다. 이 역할을 추가하는 방법을 자세히 알아보려면 [수동 삭제 문제 해결](https://docs.aws.amazon.com/aws-backup/latest/devguide/deleting-backups.html#deleting-backups-troubleshooting)을 참조하세요.

사용자 또는 역할을 삭제하거나 역할 내의 권한을 제거하면 삭제에 실패하고 `EXPIRED` 상태가 됩니다.

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

```
DELETE /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
```

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

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

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

 ** [recoveryPointArn](#API_DeleteRecoveryPoint_RequestSyntax) **   <a name="Backup-DeleteRecoveryPoint-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_DeleteRecoveryPoint_RequestBody"></a>

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteRecoveryPoint_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidResourceStateException **   
 AWS Backup 가 이미이 복구 시점에 작업을 수행하고 있습니다. 첫 번째 작업이 완료될 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteReportPlan
<a name="API_DeleteReportPlan"></a>

보고서 계획 이름으로 지정된 보고서 계획을 삭제합니다.

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

```
DELETE /audit/report-plans/reportPlanName HTTP/1.1
```

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

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

 ** [reportPlanName](#API_DeleteReportPlan_RequestSyntax) **   <a name="Backup-DeleteReportPlan-request-uri-ReportPlanName"></a>
보고서 계획의 고유 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteReportPlan_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteRestoreTestingPlan
<a name="API_DeleteRestoreTestingPlan"></a>

이 요청은 지정된 복원 테스트 계획을 삭제합니다.

먼저 연결된 복원 테스트 선택 항목을 모두 삭제한 경우에만 성공적으로 삭제할 수 있습니다.

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

```
DELETE /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
```

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

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

 ** [RestoreTestingPlanName](#API_DeleteRestoreTestingPlan_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
삭제하려는 복원 테스트 계획의 필수 고유 이름입니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteRestoreTestingPlan_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

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

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteRestoreTestingSelection
<a name="API_DeleteRestoreTestingSelection"></a>

복원 테스트 계획 이름과 복원 테스트 선택 항목 이름을 입력합니다.

복원 테스트 계획을 삭제하려면 먼저 복원 테스트 계획과 연결된 모든 테스트 선택 항목을 삭제해야 합니다.

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

```
DELETE /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
```

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

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

 ** [RestoreTestingPlanName](#API_DeleteRestoreTestingSelection_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
삭제하려는 복원 테스트 선택 항목이 포함된 복원 테스트 계획의 필수 고유 이름입니다.  
필수 항목 여부: 예

 ** [RestoreTestingSelectionName](#API_DeleteRestoreTestingSelection_RequestSyntax) **   <a name="Backup-DeleteRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
삭제하려는 복원 테스트 선택 항목의 필수 고유 이름입니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DeleteRestoreTestingSelection_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DeleteTieringConfiguration
<a name="API_DeleteTieringConfiguration"></a>

계층화 구성 이름으로 지정된 계층화 구성을 삭제합니다.

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

```
DELETE /tiering-configurations/tieringConfigurationName HTTP/1.1
```

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

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

 ** [tieringConfigurationName](#API_DeleteTieringConfiguration_RequestSyntax) **   <a name="Backup-DeleteTieringConfiguration-request-uri-TieringConfigurationName"></a>
계층화 구성의 고유한 이름입니다.  
패턴: `^[a-zA-Z0-9_]{1,200}$`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DeleteTieringConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_DeleteTieringConfiguration_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_DeleteTieringConfiguration_SeeAlso"></a>

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

# DescribeBackupJob
<a name="API_DescribeBackupJob"></a>

지정된 `BackupJobId`에 대한 백업 작업 세부 정보를 반환합니다.

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

```
GET /backup-jobs/backupJobId HTTP/1.1
```

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

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

 ** [backupJobId](#API_DescribeBackupJob_RequestSyntax) **   <a name="Backup-DescribeBackupJob-request-uri-BackupJobId"></a>
에 AWS Backup 대한 리소스 백업 요청을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupJobId": "string",
   "BackupOptions": { 
      "string" : "string" 
   },
   "BackupSizeInBytes": number,
   "BackupType": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "BytesTransferred": number,
   "ChildJobsInState": { 
      "string" : number 
   },
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "ExpectedCompletionDate": number,
   "IamRoleArn": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "MessageCategory": "string",
   "NumberOfChildJobs": number,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointLifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "StartBy": number,
   "State": "string",
   "StatusMessage": "string",
   "VaultLockState": "string",
   "VaultType": "string"
}
```

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

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

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

 ** [AccountId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-AccountId"></a>
백업 작업을 소유한 계정 ID를 반환합니다.  
유형: String  
패턴: `^[0-9]{12}$` 

 ** [BackupJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupJobId"></a>
에 AWS Backup 대한 리소스 백업 요청을 고유하게 식별합니다.  
유형: 문자열

 ** [BackupOptions](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupOptions"></a>
백업 계획 또는 온디맨드 백업 작업의 일부로 지정된 옵션을 나타냅니다.  
유형: 문자열 간 맵  
키 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
값 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [BackupSizeInBytes](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupSizeInBytes"></a>
백업(복구 시점)의 바이트 단위 크기입니다.  
이 값은가 다른 AWS 서비스의 데이터 정보를 AWS Backup 가져올 때 리소스 유형에 따라 다르게 렌더링될 수 있습니다. 예를 들어 반환된 값은 `0` 값을 표시할 수 있으며, 이는 예상 값과 다를 수 있습니다.  
리소스 유형별 값에 대한 예상 동작은 다음과 같습니다.  
+ Amazon Aurora, Amazon DocumentDB 및 Amazon Neptune에는 `GetBackupJobStatus` 작업에서 이 값이 채워지지 않습니다.
+ 고급 기능이 있는 Amazon DynamoDB의 경우 이 값은 복구 시점(백업)의 크기를 나타냅니다.
+ Amazon EC2 및 Amazon EBS는 이 값의 일부로 반환된 볼륨 크기(프로비저닝된 스토리지)를 표시합니다. Amazon EBS는 백업 크기 정보를 반환하지 않습니다. 스냅샷 크기는 백업된 원래 리소스와 동일한 값을 갖습니다.
+ Amazon EFS의 경우 이 값은 백업 중에 전송된 델타 바이트를 나타냅니다.
+ Amazon EKS의 경우이 값은 중첩된 EKS 복구 시점의 크기를 나타냅니다.
+ Amazon FSx는 FSx 파일 시스템의 `GetBackupJobStatus` 작업에서 이 값을 채우지 않습니다.
+ Amazon RDS 인스턴스는 `0`로 표시됩니다.
+ VMware를 실행하는 가상 머신의 경우 이 값은 비동기 워크플로를 통해 AWS Backup 로 전달되므로 표시된 값이 실제 백업 크기보다 작게 표현될 수 있습니다.
타입: Long

 ** [BackupType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupType"></a>
백업 작업을 위해 선택한 실제 백업 유형을 나타냅니다. 예를 들어, Windows VSS(Volume Shadow Copy Service) 백업이 성공적으로 수행된 경우 `BackupType`은 `"WindowsVSS"`를 반환합니다. `BackupType`이 비어 있는 경우 백업 유형은 일반 백업입니다.  
유형: 문자열

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

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

 ** [BytesTransferred](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BytesTransferred"></a>
작업 상태를 쿼리할 때 백업 저장소로 전송된 크기(바이트)입니다.  
타입: Long

 ** [ChildJobsInState](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ChildJobsInState"></a>
포함된 하위(중첩) 백업 작업의 통계를 반환합니다.  
유형: 문자열과 Long 간의 맵  
유효한 키: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

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

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

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

 ** [EncryptionKeyArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-EncryptionKeyArn"></a>
백업을 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN)입니다. 볼트 구성에 따라 고객 관리형 키 또는 AWS 관리형 키일 수 있습니다.  
유형: 문자열

 ** [ExpectedCompletionDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ExpectedCompletionDate"></a>
리소스를 백업하는 작업이 완료될 것으로 예상되는 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `ExpectedCompletionDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

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

 ** [InitiationDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-InitiationDate"></a>
백업 작업이 시작된 날짜입니다.  
유형: 타임스탬프

 ** [IsEncrypted](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IsEncrypted"></a>
백업 암호화 여부를 나타내는 부울 값입니다. 의 모든 백업 AWS Backup 은 암호화되지만이 필드는 투명성을 위한 암호화 상태를 나타냅니다.  
유형: Boolean

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

 ** [MessageCategory](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-MessageCategory"></a>
지정된 메시지 범주의 작업 수입니다.  
예시 문자열에는 `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL`, `INVALIDPARAMETERS` 등이 있습니다. [모니터링](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)에서 허용되는 MessageCategory 문자열 목록을 확인하세요.  
유형: 문자열

 ** [NumberOfChildJobs](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-NumberOfChildJobs"></a>
하위(중첩) 백업 작업 수를 반환합니다.  
타입: Long

 ** [ParentJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ParentJobId"></a>
상위(복합) 리소스 백업 작업 ID를 반환합니다.  
유형: 문자열

 ** [PercentDone](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-PercentDone"></a>
작업 상태를 쿼리할 때 작업의 예상 완료율을 포함합니다.  
유형: 문자열

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

 ** [RecoveryPointLifecycle](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointLifecycle"></a>
복구 시점이 콜드 스토리지로 전환되거나 삭제되기 전까지의 기간(일)을 지정합니다.  
콜드 스토리지로 전환된 백업은 최소 90일 동안 콜드 스토리지에 저장해야 합니다. 따라서 콘솔에서 보존 설정은 '콜드로 전환 전 보관 일수' 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후에는 '콜드로 전환 전 보관 일수' 설정을 변경할 수 없습니다.  
콜드 스토리지로 전환할 수 있는 리소스 유형은 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 테이블에 나열됩니다. 다른 리소스 유형에 대해서는이 표현식을 AWS Backup 무시합니다.  
기존 수명 주기 및 보존 기간을 제거하고 복구 시점을 무기한 유지하려면 `MoveToColdStorageAfterDays` 및 `DeleteAfterDays`를 -1로 지정합니다.  
유형: [Lifecycle](API_Lifecycle.md)객체

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

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

 ** [ResourceType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceType"></a>
백업할 AWS 리소스 유형. 예: Amazon Elastic Block Store(Amazon EBS) 볼륨 또는 Amazon Relational Database Service(Amazon RDS) 데이터베이스.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [StartBy](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-StartBy"></a>
백업 작업을 취소하기 전에 시작해야 하는 시간을 Unix 형식 및 협정 세계시(UTC)로 지정합니다. 이 값은 시작 기간을 예약된 시간에 더하여 계산됩니다. 따라서 예약된 시간이 오후 6시이고 시작 기간이 2시간인 경우, `StartBy` 시간은 지정된 날짜의 오후 8시가 됩니다. `StartBy`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [State](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-State"></a>
백업 작업의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [StatusMessage](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-StatusMessage"></a>
리소스를 백업하기 위한 작업의 상태를 설명하는 자세한 메시지입니다.  
유형: 문자열

 ** [VaultLockState](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultLockState"></a>
백업 저장소의 잠금 상태입니다. 논리적 에어 갭 저장소의 경우, 이는 저장소가 규정 준수 모드에서 잠겨 있는지 여부를 나타냅니다. 유효한 값에는 `LOCKED` 및 `UNLOCKED`(이)가 있습니다.  
유형: 문자열

 ** [VaultType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultType"></a>
복구 지점이 저장되는 백업 저장소의 유형입니다. 유효한 값은 표준 백업 저장소의 경우 `BACKUP_VAULT`이고 논리적 에어 갭 저장소의 경우 `LOGICALLY_AIR_GAPPED_BACKUP_VAULT`입니다.  
유형: 문자열

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

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

 ** DependencyFailureException **   
종속 AWS 서비스 또는 리소스가 AWS Backup 서비스에 오류를 반환했으며 작업을 완료할 수 없습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DescribeBackupVault
<a name="API_DescribeBackupVault"></a>

이름으로 지정된 백업 저장소에 대한 메타데이터를 반환합니다.

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

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

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

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

 ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) **   <a name="Backup-DescribeBackupVault-request-uri-BackupVaultAccountId"></a>
지정된 백업 저장소에 대한 계정 ID입니다.

 ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) **   <a name="Backup-DescribeBackupVault-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "EncryptionKeyArn": "string",
   "EncryptionKeyType": "string",
   "LatestMpaApprovalTeamUpdate": { 
      "ExpiryDate": number,
      "InitiationDate": number,
      "MpaSessionArn": "string",
      "Status": "string",
      "StatusMessage": "string"
   },
   "LockDate": number,
   "Locked": boolean,
   "MaxRetentionDays": number,
   "MinRetentionDays": number,
   "MpaApprovalTeamArn": "string",
   "MpaSessionArn": "string",
   "NumberOfRecoveryPoints": number,
   "SourceBackupVaultArn": "string",
   "VaultState": "string",
   "VaultType": "string"
}
```

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

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

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

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

 ** [BackupVaultName](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
유형: 문자열

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

 ** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다. 이 파라미터는 선택 사항입니다. 이를 사용할 경우 이 파라미터에는 1\$150개의 영숫자 또는 '-\$1.' 문자를 포함해야 합니다.  
유형: 문자열

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

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

 ** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-LatestMpaApprovalTeamUpdate"></a>
이 백업 저장소의 MPA 승인 팀 연결에 대한 최신 업데이트에 대한 정보입니다.  
유형: [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md)객체

 ** [LockDate](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-LockDate"></a>
 AWS Backup 볼트 잠금 구성을 변경하거나 삭제할 수 없는 날짜와 시간입니다.  
잠금 날짜를 지정하지 않고 저장소 잠금을 저장소에 적용한 경우, 언제든지 저장소 잠금 설정을 변경하거나 저장소에서 저장소 잠금을 완전히 삭제할 수 있습니다.  
이 값은 Unix 형식의 협정 세계시(UTC)로 표시되며, 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087를 나타냅니다.  
유형: 타임스탬프

 ** [Locked](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-Locked"></a>
 AWS Backup 볼트 잠금이 현재 백업 볼트를 보호하고 있는지 여부를 나타내는 부울입니다.는 볼트 잠금으로 인해 볼트에 저장된 복구 시점에 대한 삭제 또는 업데이트 작업이 실패함을 `True` 의미합니다.  
유형: Boolean

 ** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MaxRetentionDays"></a>
 AWS Backup 볼트가 복구 시점을 유지하는 최대 보존 기간을 지정하는 볼트 잠금 설정입니다. 이 파라미터가 지정되지 않으면 저장소 잠금은 저장소의 복구 시점에 최대 보존 기간을 적용하지 않습니다(무제한 저장 가능).  
이 설정이 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최대 보존 기간보다 짧거나 같은 수명 주기 정책이 있어야 합니다. 작업의 보존 기간이 최대 보존 기간보다 길면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다. 저장소 잠금 이전에 저장소에 이미 저장된 복구 시점은 영향을 받지 않습니다.  
타입: Long

 ** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MinRetentionDays"></a>
 AWS Backup 볼트가 복구 시점을 유지하는 최소 보존 기간을 지정하는 볼트 잠금 설정입니다. 이 파라미터가 지정되지 않으면 저장소 잠금이 최소 보존 기간을 적용하지 않습니다.  
이 설정이 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최소 보존 기간보다 길거나 같은 수명 주기 정책이 있어야 합니다. 작업의 보존 기간이 최소 보존 기간보다 짧으면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다. 저장소 잠금 이전에 저장소에 이미 저장된 복구 시점은 영향을 받지 않습니다.  
타입: Long

 ** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MpaApprovalTeamArn"></a>
이 백업 저장소와 연결된 MPA 승인 팀의 ARN입니다.  
유형: 문자열

 ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-MpaSessionArn"></a>
이 백업 저장소와 연결된 MPA 세션의 ARN입니다.  
유형: 문자열

 ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-NumberOfRecoveryPoints"></a>
백업 저장소에 저장된 복구 시점의 수입니다.  
콘솔에 표시되는 복구 시점 수 값은 근사치일 수 있습니다. 정확한 수치를 얻으려면 [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html) API를 사용합니다.  
타입: Long

 ** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-SourceBackupVaultArn"></a>
이 복원 액세스 백업 저장소가 생성된 소스 백업 저장소의 ARN입니다.  
유형: 문자열

 ** [VaultState](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-VaultState"></a>
저장소의 현재 상태입니다.  
타입: 문자열  
유효 값: `CREATING | AVAILABLE | FAILED` 

 ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) **   <a name="Backup-DescribeBackupVault-response-VaultType"></a>
설명된 저장소의 유형입니다.  
타입: 문자열  
유효 값: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

## 오류
<a name="API_DescribeBackupVault_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_DescribeBackupVault_SeeAlso"></a>

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

# DescribeCopyJob
<a name="API_DescribeCopyJob"></a>

리소스의 복사본 생성과 관련된 메타데이터를 반환합니다.

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

```
GET /copy-jobs/copyJobId HTTP/1.1
```

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

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

 ** [copyJobId](#API_DescribeCopyJob_RequestSyntax) **   <a name="Backup-DescribeCopyJob-request-uri-CopyJobId"></a>
복사 작업을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "CopyJob": { 
      "AccountId": "string",
      "BackupSizeInBytes": number,
      "ChildJobsInState": { 
         "string" : number 
      },
      "CompletionDate": number,
      "CompositeMemberIdentifier": "string",
      "CopyJobId": "string",
      "CreatedBy": { 
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "BackupPlanVersion": "string",
         "BackupRuleCron": "string",
         "BackupRuleId": "string",
         "BackupRuleName": "string",
         "BackupRuleTimezone": "string"
      },
      "CreatedByBackupJobId": "string",
      "CreationDate": number,
      "DestinationBackupVaultArn": "string",
      "DestinationEncryptionKeyArn": "string",
      "DestinationRecoveryPointArn": "string",
      "DestinationRecoveryPointLifecycle": { 
         "DeleteAfterDays": number,
         "DeleteAfterEvent": "string",
         "MoveToColdStorageAfterDays": number,
         "OptInToArchiveForSupportedResources": boolean
      },
      "DestinationVaultLockState": "string",
      "DestinationVaultType": "string",
      "IamRoleArn": "string",
      "IsParent": boolean,
      "MessageCategory": "string",
      "NumberOfChildJobs": number,
      "ParentJobId": "string",
      "ResourceArn": "string",
      "ResourceName": "string",
      "ResourceType": "string",
      "SourceBackupVaultArn": "string",
      "SourceRecoveryPointArn": "string",
      "State": "string",
      "StatusMessage": "string"
   }
}
```

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

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

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

 ** [CopyJob](#API_DescribeCopyJob_ResponseSyntax) **   <a name="Backup-DescribeCopyJob-response-CopyJob"></a>
복사 작업에 대한 세부 정보를 포함합니다.  
타입: [CopyJob](API_CopyJob.md) 객체

## 오류
<a name="API_DescribeCopyJob_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_DescribeCopyJob_SeeAlso"></a>

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

# DescribeFramework
<a name="API_DescribeFramework"></a>

지정된 `FrameworkName`에 대한 프레임워크 세부 정보를 반환합니다.

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

```
GET /audit/frameworks/frameworkName HTTP/1.1
```

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

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

 ** [frameworkName](#API_DescribeFramework_RequestSyntax) **   <a name="Backup-DescribeFramework-request-uri-FrameworkName"></a>
프레임워크의 고유 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "DeploymentStatus": "string",
   "FrameworkArn": "string",
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "FrameworkName": "string",
   "FrameworkStatus": "string",
   "IdempotencyToken": "string"
}
```

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

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

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

 ** [CreationTime](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-CreationTime"></a>
프레임워크가 생성된 날짜 및 시간이며, ISO 8601 형식으로 표시됩니다. `CreationTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 2020-07-10T15:00:00.000-08:00은 UTC보다 8시간 늦은 2020년 7월 10일 오후 3시를 나타냅니다.  
유형: 타임스탬프

 ** [DeploymentStatus](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-DeploymentStatus"></a>
프레임워크의 배포 상태입니다. 상태는 다음과 같습니다.  
 `CREATE_IN_PROGRESS | UPDATE_IN_PROGRESS | DELETE_IN_PROGRESS | COMPLETED | FAILED`   
유형: 문자열

 ** [FrameworkArn](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: 문자열

 ** [FrameworkControls](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkControls"></a>
프레임워크를 구성하는 컨트롤입니다. 목록의 각 컨트롤에는 이름, 입력 파라미터, 범위가 있습니다.  
타입: [FrameworkControl](API_FrameworkControl.md)객체 배열

 ** [FrameworkDescription](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkDescription"></a>
프레임워크에 대한 설명입니다(선택 사항).  
유형: 문자열  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.  
패턴: `.*\S.*` 

 ** [FrameworkName](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkName"></a>
프레임워크의 고유 이름입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*` 

 ** [FrameworkStatus](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-FrameworkStatus"></a>
프레임워크는 하나 이상의 컨트롤로 구성됩니다. 각 컨트롤은 백업 계획, 백업 선택, 백업 저장소 또는 복구 시점과 같은 리소스를 제어합니다. 또한 각 리소스에 대한 AWS Config 기록을 켜거나 끌 수 있습니다. 상태는 다음과 같습니다.  
+  `ACTIVE` - 프레임워크가 제어하는 모든 리소스에 대해 기록이 켜진 경우입니다.
+  `PARTIALLY_ACTIVE` - 프레임워크가 제어하는 하나 이상의 리소스에 대해 기록이 꺼진 경우입니다.
+  `INACTIVE` - 프레임워크가 제어하는 모든 리소스에 대해 기록이 꺼진 경우입니다.
+  `UNAVAILABLE` AWS Backup 가 현재 기록 상태를 검증할 수 없는 경우.
유형: 문자열

 ** [IdempotencyToken](#API_DescribeFramework_ResponseSyntax) **   <a name="Backup-DescribeFramework-response-IdempotencyToken"></a>
고객이 선택한 문자열로, `DescribeFrameworkOutput`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열

## 오류
<a name="API_DescribeFramework_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_DescribeFramework_SeeAlso"></a>

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

# DescribeGlobalSettings
<a name="API_DescribeGlobalSettings"></a>

 AWS 계정이 교차 계정 백업, 다자간 승인, 위임된 관리자 등 다양한 교차 계정 관리 옵션을 활성화했는지 여부를 설명합니다. 계정이 Organizations 조직의 멤버가 아닌 경우 오류를 반환합니다. 예시: `describe-global-settings --region us-west-2` 

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

```
GET /global-settings HTTP/1.1
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_DescribeGlobalSettings_RequestBody"></a>

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "GlobalSettings": { 
      "string" : "string" 
   },
   "LastUpdateTime": number
}
```

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

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

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

 ** [GlobalSettings](#API_DescribeGlobalSettings_ResponseSyntax) **   <a name="Backup-DescribeGlobalSettings-response-GlobalSettings"></a>
플래그 `isCrossAccountBackupEnabled`, `isMpaEnabled` ('Mpa'는 다자간 승인을 의미) 및의 상태입니다`isDelegatedAdministratorEnabled`.  
+  `isCrossAccountBackupEnabled`: 조직의 계정이 백업을 다른 계정에 복사하도록 허용합니다.
+  `isMpaEnabled`: 논리적 에어 갭 저장소에 다자간 승인 팀을 할당하는 옵션을 사용하여 조직에 교차 계정 액세스를 추가합니다.
+  `isDelegatedAdministratorEnabled`: 백업이 위임된 관리자 권한을 Organizations와 자동으로 동기화하도록 허용합니다.
유형: 문자열 간 맵

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

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

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

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DescribeProtectedResource
<a name="API_DescribeProtectedResource"></a>

마지막으로 백업된 시간, Amazon 리소스 이름(ARN), 저장된 리소스의 AWS 서비스 유형을 포함하여 저장된 리소스에 대한 정보를 반환합니다.

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

```
GET /resources/resourceArn HTTP/1.1
```

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

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

 ** [resourceArn](#API_DescribeProtectedResource_RequestSyntax) **   <a name="Backup-DescribeProtectedResource-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "LastBackupTime": number,
   "LastBackupVaultArn": "string",
   "LastRecoveryPointArn": "string",
   "LatestRestoreExecutionTimeMinutes": number,
   "LatestRestoreJobCreationDate": number,
   "LatestRestoreRecoveryPointCreationDate": number,
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string"
}
```

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

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

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

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

 ** [LastBackupVaultArn](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LastBackupVaultArn"></a>
가장 최근의 백업 복구 시점이 포함된 백업 저장소의 ARN(Amazon 리소스 이름)입니다.  
유형: 문자열

 ** [LastRecoveryPointArn](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LastRecoveryPointArn"></a>
가장 최근 복구 시점의 ARN(Amazon 리소스 이름)입니다.  
유형: 문자열

 ** [LatestRestoreExecutionTimeMinutes](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreExecutionTimeMinutes"></a>
가장 최근의 복원 작업이 완료되는 데 걸린 시간(분)입니다.  
타입: Long

 ** [LatestRestoreJobCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreJobCreationDate"></a>
가장 최근의 복원 작업이 생성된 날짜입니다.  
유형: 타임스탬프

 ** [LatestRestoreRecoveryPointCreationDate](#API_DescribeProtectedResource_ResponseSyntax) **   <a name="Backup-DescribeProtectedResource-response-LatestRestoreRecoveryPointCreationDate"></a>
가장 최근의 복구 시점이 생성된 날짜입니다.  
유형: 타임스탬프

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

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

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

## 오류
<a name="API_DescribeProtectedResource_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_DescribeProtectedResource_SeeAlso"></a>

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

# 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) 

# DescribeRegionSettings
<a name="API_DescribeRegionSettings"></a>

리전에 대한 현재 서비스 옵트인 설정을 반환합니다. 서비스에 대해 서비스 옵트인이 활성화된 경우 리소스가 온디맨드 백업 또는 예약된 백업 계획에 포함된 경우는이 리전에서 해당 서비스의 리소스를 보호하려고 AWS Backup 시도합니다. 그렇지 않은 경우에는 AWS Backup 이 이 리전에서 해당 서비스의 리소스를 보호하려고 하지 않습니다.

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

```
GET /account-settings HTTP/1.1
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_DescribeRegionSettings_RequestBody"></a>

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "ResourceTypeManagementPreference": { 
      "string" : boolean 
   },
   "ResourceTypeOptInPreference": { 
      "string" : boolean 
   }
}
```

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

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

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

 ** [ResourceTypeManagementPreference](#API_DescribeRegionSettings_ResponseSyntax) **   <a name="Backup-DescribeRegionSettings-response-ResourceTypeManagementPreference"></a>
가 리소스 유형에 대한 백업을 AWS Backup 완전히 관리하는지 여부를 반환합니다.  
전체 AWS Backup 관리의 이점은 [전체 AWS Backup 관리를](https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html#full-management) 참조하세요.  
리소스 유형 목록과 각 리소스가 전체 AWS Backup 관리를 지원하는지 여부는 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 표를 참조하세요.  
인 경우 `"DynamoDB":false`의 고급 DynamoDB 백업 기능을 활성화하여 DynamoDB 백업에 대한 전체 AWS Backup 관리를 활성화할 수 있습니다. [AWS Backup DynamoDB ](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli)  
유형: String과 부울 간의 맵  
키 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ResourceTypeOptInPreference](#API_DescribeRegionSettings_ResponseSyntax) **   <a name="Backup-DescribeRegionSettings-response-ResourceTypeOptInPreference"></a>
리전의 옵트인 기본 설정과 함께 제공되는 서비스입니다.  
유형: String과 부울 간의 맵  
키 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

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

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

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

HTTP 상태 코드: 500

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

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

# DescribeReportJob
<a name="API_DescribeReportJob"></a>

`ReportJobId`에서 지정한 대로 보고서 생성과 관련된 세부 정보를 반환합니다.

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

```
GET /audit/report-jobs/reportJobId HTTP/1.1
```

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

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

 ** [reportJobId](#API_DescribeReportJob_RequestSyntax) **   <a name="Backup-DescribeReportJob-request-uri-ReportJobId"></a>
보고서 작업의 식별자입니다. 임의로 생성되는 최대 1,024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 보고서 작업 ID는 편집할 수 없습니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "ReportJob": { 
      "CompletionTime": number,
      "CreationTime": number,
      "ReportDestination": { 
         "S3BucketName": "string",
         "S3Keys": [ "string" ]
      },
      "ReportJobId": "string",
      "ReportPlanArn": "string",
      "ReportTemplate": "string",
      "Status": "string",
      "StatusMessage": "string"
   }
}
```

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

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

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

 ** [ReportJob](#API_DescribeReportJob_ResponseSyntax) **   <a name="Backup-DescribeReportJob-response-ReportJob"></a>
완료 및 생성 시간, 보고서 대상, 고유한 보고서 작업 ID, Amazon 리소스 이름(ARN), 보고서 템플릿, 상태, 상태 메시지 등 보고서 작업에 대한 정보입니다.  
타입: [ReportJob](API_ReportJob.md) 객체

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DescribeReportPlan
<a name="API_DescribeReportPlan"></a>

 AWS 계정 및에 대한 모든 보고서 계획 목록을 반환합니다 AWS 리전.

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

```
GET /audit/report-plans/reportPlanName HTTP/1.1
```

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

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

 ** [reportPlanName](#API_DescribeReportPlan_RequestSyntax) **   <a name="Backup-DescribeReportPlan-request-uri-ReportPlanName"></a>
보고서 계획의 고유 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "ReportPlan": { 
      "CreationTime": number,
      "DeploymentStatus": "string",
      "LastAttemptedExecutionTime": number,
      "LastSuccessfulExecutionTime": number,
      "ReportDeliveryChannel": { 
         "Formats": [ "string" ],
         "S3BucketName": "string",
         "S3KeyPrefix": "string"
      },
      "ReportPlanArn": "string",
      "ReportPlanDescription": "string",
      "ReportPlanName": "string",
      "ReportSetting": { 
         "Accounts": [ "string" ],
         "FrameworkArns": [ "string" ],
         "NumberOfFrameworks": number,
         "OrganizationUnits": [ "string" ],
         "Regions": [ "string" ],
         "ReportTemplate": "string"
      }
   }
}
```

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

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

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

 ** [ReportPlan](#API_DescribeReportPlan_ResponseSyntax) **   <a name="Backup-DescribeReportPlan-response-ReportPlan"></a>
이름으로 지정된 보고서 계획에 대한 세부 정보를 반환합니다. 이러한 세부 정보에는 보고서 계획의 Amazon 리소스 이름(ARN), 설명, 설정, 전송 채널, 배포 상태, 생성 시간, 마지막 시도 시간 및 성공적인 실행 시간이 포함됩니다.  
타입: [ReportPlan](API_ReportPlan.md) 객체

## 오류
<a name="API_DescribeReportPlan_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_DescribeReportPlan_SeeAlso"></a>

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

# DescribeRestoreJob
<a name="API_DescribeRestoreJob"></a>

작업 ID로 지정된 복원 작업과 관련된 메타데이터를 반환합니다.

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

```
GET /restore-jobs/restoreJobId HTTP/1.1
```

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

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

 ** [restoreJobId](#API_DescribeRestoreJob_RequestSyntax) **   <a name="Backup-DescribeRestoreJob-request-uri-RestoreJobId"></a>
복구 시점을 복원하는 작업을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "RestoreTestingPlanArn": "string"
   },
   "CreatedResourceArn": "string",
   "CreationDate": number,
   "DeletionStatus": "string",
   "DeletionStatusMessage": "string",
   "ExpectedCompletionTimeMinutes": number,
   "IamRoleArn": "string",
   "IsParent": boolean,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointCreationDate": number,
   "ResourceType": "string",
   "RestoreJobId": "string",
   "SourceResourceArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

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

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

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

 ** [AccountId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-AccountId"></a>
복원 작업을 소유한 계정 ID를 반환합니다.  
유형: String  
패턴: `^[0-9]{12}$` 

 ** [BackupSizeInBytes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupSizeInBytes"></a>
복원된 리소스의 크기(바이트 단위)입니다.  
타입: Long

 ** [BackupVaultArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-BackupVaultArn"></a>
복원 중인 복구 시점이 포함된 백업 저장소의 Amazon 리소스 이름(ARN)입니다. 이렇게 하면 저장소 액세스 정책 및 권한을 식별하는 데 도움이 됩니다.  
유형: 문자열

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

 ** [CreatedBy](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedBy"></a>
복원 작업 생성에 대한 식별 정보가 포함되어 있습니다.  
유형: [RestoreJobCreator](API_RestoreJobCreator.md)객체

 ** [CreatedResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-CreatedResourceArn"></a>
복원 작업에서 생성한 리소스의 Amazon 리소스 이름(ARN)입니다.  
ARN의 형식은 백업된 리소스의 리소스 유형에 따라 달라집니다.  
유형: 문자열

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

 ** [DeletionStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatus"></a>
복원 테스트에서 생성된 데이터의 상태입니다.  
타입: 문자열  
유효 값: `DELETING | FAILED | SUCCESSFUL` 

 ** [DeletionStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-DeletionStatusMessage"></a>
복원 작업 삭제 상태를 설명합니다.  
유형: 문자열

 ** [ExpectedCompletionTimeMinutes](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ExpectedCompletionTimeMinutes"></a>
복구 시점을 복원하는 작업에 소요될 것으로 예상되는 시간(분)입니다.  
타입: Long

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

 ** [IsParent](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-IsParent"></a>
복원 작업이 상위(복합) 복원 작업인지 여부를 나타내는 부울 값입니다.  
유형: Boolean

 ** [ParentJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ParentJobId"></a>
선택한 복원 작업에 대한 상위 복원 작업의 고유 식별자입니다.  
유형: 문자열

 ** [PercentDone](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-PercentDone"></a>
작업 상태를 쿼리할 때 작업의 예상 완료율을 포함합니다.  
유형: 문자열

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

 ** [RecoveryPointCreationDate](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RecoveryPointCreationDate"></a>
지정된 복원 작업에서 생성한 복구 시점의 생성 날짜입니다.  
유형: 타임스탬프

 ** [ResourceType](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ResourceType"></a>
복원 작업과 관련된 메타데이터를 리소스 유형별로 나열하여 반환합니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreJobId](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-RestoreJobId"></a>
복구 시점을 복원하는 작업을 고유하게 식별합니다.  
유형: 문자열

 ** [SourceResourceArn](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-SourceResourceArn"></a>
백업된 원본 리소스의 Amazon 리소스 이름(ARN)입니다. 이는 복원 중인 리소스에 대한 컨텍스트를 제공합니다.  
유형: 문자열

 ** [Status](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-Status"></a>
복구 시점을 복원하기 AWS Backup 위해에서 시작하는 작업의 상태를 지정하는 상태 코드입니다.  
타입: 문자열  
유효 값: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [StatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-StatusMessage"></a>
복구 시점을 복원하기 위한 작업의 상태를 보여 주는 메시지입니다.  
유형: 문자열

 ** [ValidationStatus](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatus"></a>
표시된 복원 작업에 대한 검증 실행 상태입니다.  
타입: 문자열  
유효 값: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING` 

 ** [ValidationStatusMessage](#API_DescribeRestoreJob_ResponseSyntax) **   <a name="Backup-DescribeRestoreJob-response-ValidationStatusMessage"></a>
상태 메시지입니다.  
유형: 문자열

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

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

 ** DependencyFailureException **   
종속 AWS 서비스 또는 리소스가 AWS Backup 서비스에 오류를 반환했으며 작업을 완료할 수 없습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DescribeScanJob
<a name="API_DescribeScanJob"></a>

지정된 ScanJobID에 대한 스캔 작업 세부 정보를 반환합니다.

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

```
GET /scan/jobs/ScanJobId HTTP/1.1
```

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

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

 ** [ScanJobId](#API_DescribeScanJob_RequestSyntax) **   <a name="Backup-DescribeScanJob-request-uri-ScanJobId"></a>
리소스를 스캔하기 AWS Backup 위한 요청을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanVersion": "string",
      "BackupRuleId": "string"
   },
   "CreationDate": number,
   "IamRoleArn": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanId": "string",
   "ScanJobId": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string",
   "ScanResult": { 
      "ScanResultStatus": "string"
   },
   "State": "string",
   "StatusMessage": "string"
}
```

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

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

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

 ** [AccountId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-AccountId"></a>
스캔 작업을 소유한 계정 ID를 반환합니다.  
패턴: `^[0-9]{12}$`   
유형: 문자열

 ** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultArn"></a>
백업 볼트를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. 예: `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`   
유형: 문자열

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

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

 ** [CreatedBy](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreatedBy"></a>
스캔을 시작한 백업 계획 및 규칙을 포함하여 스캔 작업 생성에 대한 식별 정보를 포함합니다.  
유형: [ScanJobCreator](API_ScanJobCreator.md)객체

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

 ** [IamRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-IamRoleArn"></a>
백업 저장소를 고유하게 식별하는 Amazon 리소스 이름(ARN)(예: `arn:aws:iam::123456789012:role/S3Access`)입니다.  
유형: 문자열

 ** [MalwareScanner](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-MalwareScanner"></a>
해당 스캔 작업에 사용되는 스캔 엔진입니다. 현재 `GUARDUTY`만 지원됩니다.  
타입: 문자열  
유효 값: `GUARDDUTY` 

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

 ** [ResourceArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceArn"></a>
해당 복구 시점 ARN의 소스 리소스를 고유하게 식별하는 ARN입니다.  
유형: 문자열

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

 ** [ResourceType](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceType"></a>
백업할 AWS 리소스 유형. 예: Amazon Elastic Block Store(Amazon EBS) 볼륨.  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
타입: 문자열  
유효 값: `EBS | EC2 | S3` 

 ** [ScanBaseRecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanBaseRecoveryPointArn"></a>
스캔을 위한 기본 복구 시점을 고유하게 식별하는 ARN입니다. 이 필드는 증분 스캔 작업이 수행된 경우에만 채워집니다.  
유형: 문자열

 ** [ScanId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanId"></a>
Amazon GuardDuty에서 해당 스캔 작업 ID 요청에 대해 생성한 스캔 ID입니다 AWS Backup.  
유형: 문자열

 ** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanJobId"></a>
요청을 고유하게 식별한 스캔 작업 ID입니다 AWS Backup.  
유형: 문자열

 ** [ScanMode](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanMode"></a>
스캔 작업에 사용되는 스캔 유형을 지정합니다.  
타입: 문자열  
유효 값: `FULL_SCAN | INCREMENTAL_SCAN` 

 ** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScannerRoleArn"></a>
스캔 작업에 사용되는 스캐너 IAM 역할 ARN을 지정합니다.  
유형: 문자열

 ** [ScanResult](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanResult"></a>
 스캔 작업에 `ScanResultsStatus` 대한를 포함하고 완료된 작업에 `NO_THREATS_FOUND` 대해 `THREATS_FOUND` 또는를 반환합니다.  
유형: [ScanResultInfo](API_ScanResultInfo.md)객체

 ** [State](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-State"></a>
스캔 작업의 현재 상태입니다.  
타입: 문자열  
유효 값: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-StatusMessage"></a>
리소스를 백업하기 위한 작업의 상태를 설명하는 자세한 메시지입니다.  
유형: 문자열

## 오류
<a name="API_DescribeScanJob_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_DescribeScanJob_SeeAlso"></a>

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

# DisassociateBackupVaultMpaApprovalTeam
<a name="API_DisassociateBackupVaultMpaApprovalTeam"></a>

MPA 승인 팀과 백업 저장소 간의 연결을 제거하여 복원 작업에 대한 MPA 승인 워크플로를 비활성화합니다.

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

```
POST /backup-vaults/backupVaultName/mpaApprovalTeam?delete HTTP/1.1
Content-type: application/json

{
   "RequesterComment": "string"
}
```

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

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

 ** [backupVaultName](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-DisassociateBackupVaultMpaApprovalTeam-request-uri-BackupVaultName"></a>
MPA 승인 팀의 연결을 해제할 백업 저장소의 이름입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

## 요청 본문
<a name="API_DisassociateBackupVaultMpaApprovalTeam_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [RequesterComment](#API_DisassociateBackupVaultMpaApprovalTeam_RequestSyntax) **   <a name="Backup-DisassociateBackupVaultMpaApprovalTeam-request-RequesterComment"></a>
MPA 승인 팀을 백업 저장소에서 연결 해제하는 이유를 설명하는 선택적 설명입니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_DisassociateBackupVaultMpaApprovalTeam_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DisassociateBackupVaultMpaApprovalTeam_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DisassociateRecoveryPoint
<a name="API_DisassociateRecoveryPoint"></a>

에서 지정된 연속 백업 복구 시점을 삭제 AWS Backup 하고 해당 연속 백업에 대한 제어를 Amazon RDS와 같은 소스 서비스로 릴리스합니다. 소스 서비스는 원래 백업 계획에 지정된 수명 주기를 사용하여 연속 백업을 계속 생성하고 유지합니다.

스냅샷 백업 복구 시점은 지원하지 않습니다.

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

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/disassociate HTTP/1.1
```

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

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

 ** [backupVaultName](#API_DisassociateRecoveryPoint_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPoint-request-uri-BackupVaultName"></a>
 AWS Backup 볼트의 고유한 이름입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [recoveryPointArn](#API_DisassociateRecoveryPoint_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPoint-request-uri-RecoveryPointArn"></a>
 AWS Backup 복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
```

## Response Elements
<a name="API_DisassociateRecoveryPoint_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidResourceStateException **   
 AWS Backup 가 이미이 복구 시점에 작업을 수행하고 있습니다. 첫 번째 작업이 완료될 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# DisassociateRecoveryPointFromParent
<a name="API_DisassociateRecoveryPointFromParent"></a>

특정 하위(중첩) 복구 시점에 대한 이 작업을 수행하면 지정된 복구 시점과 상위(복합) 복구 시점 간의 관계가 제거됩니다.

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

```
DELETE /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/parentAssociation HTTP/1.1
```

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

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

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

 ** [recoveryPointArn](#API_DisassociateRecoveryPointFromParent_RequestSyntax) **   <a name="Backup-DisassociateRecoveryPointFromParent-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_DisassociateRecoveryPointFromParent_RequestBody"></a>

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

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

```
HTTP/1.1 204
```

## Response Elements
<a name="API_DisassociateRecoveryPointFromParent_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# ExportBackupPlanTemplate
<a name="API_ExportBackupPlanTemplate"></a>

계획 ID로 지정된 백업 계획을 백업 템플릿으로 반환합니다.

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

```
GET /backup/plans/backupPlanId/toTemplate/ HTTP/1.1
```

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

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

 ** [backupPlanId](#API_ExportBackupPlanTemplate_RequestSyntax) **   <a name="Backup-ExportBackupPlanTemplate-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanTemplateJson": "string"
}
```

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

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

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

 ** [BackupPlanTemplateJson](#API_ExportBackupPlanTemplate_ResponseSyntax) **   <a name="Backup-ExportBackupPlanTemplate-response-BackupPlanTemplateJson"></a>
JSON 형식의 백업 계획 템플릿 본문입니다.  
이 문서는 서명된 JSON 문서이므로 `GetBackupPlanFromJSON.`에 전달되기 전에는 수정할 수 없습니다.
유형: 문자열

## 오류
<a name="API_ExportBackupPlanTemplate_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_ExportBackupPlanTemplate_SeeAlso"></a>

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

# GetBackupPlan
<a name="API_GetBackupPlan"></a>

지정된 `BackupPlanId`에 대한 `BackupPlan` 세부 정보를 반환합니다. 세부 정보는 JSON 형식의 백업 계획 본문과 계획 메타데이터입니다.

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

```
GET /backup/plans/backupPlanId/?MaxScheduledRunsPreview=MaxScheduledRunsPreview&versionId=VersionId HTTP/1.1
```

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

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

 ** [backupPlanId](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

 ** [MaxScheduledRunsPreview](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-MaxScheduledRunsPreview"></a>
미리 볼 향후 예약된 백업 실행 수입니다. 0(기본값)으로 설정하면 예약된 실행 미리 보기가 응답에 포함되지 않습니다. 유효한 범위는 1\$110입니다.  
유효 범위: 최소값은 0입니다. 최대값은 10입니다.

 ** [VersionId](#API_GetBackupPlan_RequestSyntax) **   <a name="Backup-GetBackupPlan-request-uri-VersionId"></a>
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   },
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "DeletionDate": number,
   "LastExecutionDate": number,
   "ScheduledRunsPreview": [ 
      { 
         "ExecutionTime": number,
         "RuleExecutionType": "string",
         "RuleId": "string"
      }
   ],
   "VersionId": "string"
}
```

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

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

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

 ** [AdvancedBackupSettings](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-AdvancedBackupSettings"></a>
각 리소스 유형에 대한 `BackupOptions` 목록이 포함됩니다. 백업 계획에 고급 옵션이 설정된 경우에만 목록이 채워집니다.  
타입: [AdvancedBackupSetting](API_AdvancedBackupSetting.md)객체 배열

 ** [BackupPlan](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-BackupPlan"></a>
백업 계획의 본문을 지정합니다. `BackupPlanName`과 하나 이상의 `Rules` 집합을 포함합니다.  
유형: [BackupPlan](API_BackupPlan.md)객체

 ** [BackupPlanArn](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-BackupPlanArn"></a>
백업 계획을 고유하게 식별하는 Amazon 리소스 이름(ARN)(예: `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`)입니다.  
유형: 문자열

 ** [BackupPlanId](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
유형: 문자열

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

 ** [CreatorRequestId](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다.  
유형: 문자열

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

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

 ** [ScheduledRunsPreview](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-ScheduledRunsPreview"></a>
예정된 예약된 백업 실행 목록입니다. `MaxScheduledRunsPreview` 파라미터가 0보다 큰 경우에만 포함됩니다. 예약된 시간, 실행 유형 및 관련 규칙 ID와 함께 최대 10개의 향후 백업 실행이 포함됩니다.  
타입: [ScheduledPlanExecutionMember](API_ScheduledPlanExecutionMember.md)객체 배열

 ** [VersionId](#API_GetBackupPlan_ResponseSyntax) **   <a name="Backup-GetBackupPlan-response-VersionId"></a>
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.  
유형: 문자열

## 오류
<a name="API_GetBackupPlan_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_GetBackupPlan_SeeAlso"></a>

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

# GetBackupPlanFromJSON
<a name="API_GetBackupPlanFromJSON"></a>

백업 계획 또는 오류를 지정하는 유효한 JSON 문서를 반환합니다.

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

```
POST /backup/template/json/toPlan HTTP/1.1
Content-type: application/json

{
   "BackupPlanTemplateJson": "string"
}
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_GetBackupPlanFromJSON_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupPlanTemplateJson](#API_GetBackupPlanFromJSON_RequestSyntax) **   <a name="Backup-GetBackupPlanFromJSON-request-BackupPlanTemplateJson"></a>
JSON 형식의 고객이 제공한 백업 계획 문서입니다.  
유형: 문자열  
필수 항목 여부: 예

## 응답 구문
<a name="API_GetBackupPlanFromJSON_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   }
}
```

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

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

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

 ** [BackupPlan](#API_GetBackupPlanFromJSON_ResponseSyntax) **   <a name="Backup-GetBackupPlanFromJSON-response-BackupPlan"></a>
백업 계획의 본문을 지정합니다. `BackupPlanName`과 하나 이상의 `Rules` 집합을 포함합니다.  
타입: [BackupPlan](API_BackupPlan.md) 객체

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

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

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

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# GetBackupPlanFromTemplate
<a name="API_GetBackupPlanFromTemplate"></a>

`templateId`로 지정된 템플릿을 백업 계획으로 반환합니다.

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

```
GET /backup/template/plans/templateId/toPlan HTTP/1.1
```

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

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

 ** [templateId](#API_GetBackupPlanFromTemplate_RequestSyntax) **   <a name="Backup-GetBackupPlanFromTemplate-request-uri-BackupPlanTemplateId"></a>
저장된 백업 계획 템플릿을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanDocument": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   }
}
```

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

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

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

 ** [BackupPlanDocument](#API_GetBackupPlanFromTemplate_ResponseSyntax) **   <a name="Backup-GetBackupPlanFromTemplate-response-BackupPlanDocument"></a>
계획의 이름, 규칙, 백업 저장소를 포함하여 대상 템플릿을 기반으로 백업 계획의 본문을 반환합니다.  
타입: [BackupPlan](API_BackupPlan.md) 객체

## 오류
<a name="API_GetBackupPlanFromTemplate_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_GetBackupPlanFromTemplate_SeeAlso"></a>

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

# GetBackupSelection
<a name="API_GetBackupSelection"></a>

선택 메타데이터 및 백업 계획과 관련된 리소스 목록을 지정하는 JSON 형식의 문서를 반환합니다.

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

```
GET /backup/plans/backupPlanId/selections/selectionId HTTP/1.1
```

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

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

 ** [backupPlanId](#API_GetBackupSelection_RequestSyntax) **   <a name="Backup-GetBackupSelection-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

 ** [selectionId](#API_GetBackupSelection_RequestSyntax) **   <a name="Backup-GetBackupSelection-request-uri-SelectionId"></a>
리소스 집합을 백업 계획에 할당하는 요청의 본문을 고유하게 식별합니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanId": "string",
   "BackupSelection": { 
      "Conditions": { 
         "StringEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ],
         "StringNotLike": [ 
            { 
               "ConditionKey": "string",
               "ConditionValue": "string"
            }
         ]
      },
      "IamRoleArn": "string",
      "ListOfTags": [ 
         { 
            "ConditionKey": "string",
            "ConditionType": "string",
            "ConditionValue": "string"
         }
      ],
      "NotResources": [ "string" ],
      "Resources": [ "string" ],
      "SelectionName": "string"
   },
   "CreationDate": number,
   "CreatorRequestId": "string",
   "SelectionId": "string"
}
```

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

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

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

 ** [BackupPlanId](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
유형: 문자열

 ** [BackupSelection](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-BackupSelection"></a>
백업 계획에 리소스 세트를 할당하기 위한 요청 본문을 지정합니다.  
유형: [BackupSelection](API_BackupSelection.md)객체

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

 ** [CreatorRequestId](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-CreatorRequestId"></a>
요청을 식별하고 작업을 두 번 실행할 위험 없이 실패한 요청을 다시 시도할 수 있도록 하는 고유 문자열입니다.  
유형: 문자열

 ** [SelectionId](#API_GetBackupSelection_ResponseSyntax) **   <a name="Backup-GetBackupSelection-response-SelectionId"></a>
리소스 집합을 백업 계획에 할당하는 요청의 본문을 고유하게 식별합니다.  
유형: 문자열

## 오류
<a name="API_GetBackupSelection_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_GetBackupSelection_SeeAlso"></a>

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

# GetBackupVaultAccessPolicy
<a name="API_GetBackupVaultAccessPolicy"></a>

이름이 지정된 백업 저장소와 관련된 액세스 정책 문서를 반환합니다.

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

```
GET /backup-vaults/backupVaultName/access-policy HTTP/1.1
```

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

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

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

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "Policy": "string"
}
```

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

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

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

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

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

 ** [Policy](#API_GetBackupVaultAccessPolicy_ResponseSyntax) **   <a name="Backup-GetBackupVaultAccessPolicy-response-Policy"></a>
JSON 형식의 백업 저장소 액세스 정책 문서입니다.  
유형: 문자열

## 오류
<a name="API_GetBackupVaultAccessPolicy_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_GetBackupVaultAccessPolicy_SeeAlso"></a>

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

# GetBackupVaultNotifications
<a name="API_GetBackupVaultNotifications"></a>

지정된 백업 저장소에 대한 이벤트 알림을 반환합니다.

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

```
GET /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
```

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

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

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

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "BackupVaultEvents": [ "string" ],
   "BackupVaultName": "string",
   "SNSTopicArn": "string"
}
```

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

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

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

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

 ** [BackupVaultEvents](#API_GetBackupVaultNotifications_ResponseSyntax) **   <a name="Backup-GetBackupVaultNotifications-response-BackupVaultEvents"></a>
백업 저장소에 리소스를 백업할 작업의 상태를 나타내는 이벤트 어레이입니다.  
유형: 문자열 배열  
유효한 값: `BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED | CONTINUOUS_BACKUP_INTERRUPTED | RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED` 

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

 ** [SNSTopicArn](#API_GetBackupVaultNotifications_ResponseSyntax) **   <a name="Backup-GetBackupVaultNotifications-response-SNSTopicArn"></a>
Amazon Simple Notification Service(Amazon SNS) 주제를 고유하게 식별하는 ARN(예: `arn:aws:sns:us-west-2:111122223333:MyTopic`)입니다.  
유형: 문자열

## 오류
<a name="API_GetBackupVaultNotifications_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_GetBackupVaultNotifications_SeeAlso"></a>

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

# GetLegalHold
<a name="API_GetLegalHold"></a>

이 작업을 수행하면 지정된 법적 보존에 대한 세부 정보가 반환됩니다. 세부 정보는 JSON 형식의 법적 보존 본문과 메타데이터입니다.

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

```
GET /legal-holds/legalHoldId/ HTTP/1.1
```

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

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

 ** [legalHoldId](#API_GetLegalHold_RequestSyntax) **   <a name="Backup-GetLegalHold-request-uri-LegalHoldId"></a>
법적 보존의 ID입니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "CancelDescription": "string",
   "CancellationDate": number,
   "CreationDate": number,
   "Description": "string",
   "LegalHoldArn": "string",
   "LegalHoldId": "string",
   "RecoveryPointSelection": { 
      "DateRange": { 
         "FromDate": number,
         "ToDate": number
      },
      "ResourceIdentifiers": [ "string" ],
      "VaultNames": [ "string" ]
   },
   "RetainRecordUntil": number,
   "Status": "string",
   "Title": "string"
}
```

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

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

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

 ** [CancelDescription](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancelDescription"></a>
법적 보존을 제거하는 이유입니다.  
유형: 문자열

 ** [CancellationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CancellationDate"></a>
법적 보존이 취소된 시간입니다.  
유형: 타임스탬프

 ** [CreationDate](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-CreationDate"></a>
법적 보존이 생성된 시간입니다.  
유형: 타임스탬프

 ** [Description](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Description"></a>
법적 보존에 대한 설명입니다.  
유형: 문자열

 ** [LegalHoldArn](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldArn"></a>
지정된 법적 보존에 대한 프레임워크 ARN입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: 문자열

 ** [LegalHoldId](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-LegalHoldId"></a>
법적 보존의 ID입니다.  
유형: 문자열

 ** [RecoveryPointSelection](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RecoveryPointSelection"></a>
리소스 유형 또는 백업 저장소 같은 리소스 집합을 할당하기 위한 기준입니다.  
유형: [RecoveryPointSelection](API_RecoveryPointSelection.md)객체

 ** [RetainRecordUntil](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-RetainRecordUntil"></a>
법적 보존 레코드가 유지되는 날짜 및 시간입니다.  
유형: 타임스탬프

 ** [Status](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Status"></a>
법적 보존의 상태입니다.  
타입: 문자열  
유효 값: `CREATING | ACTIVE | CANCELING | CANCELED` 

 ** [Title](#API_GetLegalHold_ResponseSyntax) **   <a name="Backup-GetLegalHold-response-Title"></a>
법적 보존의 제목입니다.  
유형: 문자열

## 오류
<a name="API_GetLegalHold_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_GetLegalHold_SeeAlso"></a>

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

# GetRecoveryPointIndexDetails
<a name="API_GetRecoveryPointIndexDetails"></a>

이 작업은 지정된 복구 시점과 연결된 백업 인덱스와 관련된 메타데이터 및 세부 정보를 반환합니다.

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

```
GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
```

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

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

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

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

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "IndexCompletionDate": number,
   "IndexCreationDate": number,
   "IndexDeletionDate": number,
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "RecoveryPointArn": "string",
   "SourceResourceArn": "string",
   "TotalItemsIndexed": number
}
```

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

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

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

 ** [BackupVaultArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-BackupVaultArn"></a>
복구 시점 인덱스가 저장되는 백업 저장소를 고유하게 식별하는 ARN입니다.  
예를 들어 `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`입니다.  
유형: 문자열

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

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

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

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

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

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

 ** [SourceResourceArn](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-SourceResourceArn"></a>
소스 리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)의 문자열입니다.  
유형: 문자열

 ** [TotalItemsIndexed](#API_GetRecoveryPointIndexDetails_ResponseSyntax) **   <a name="Backup-GetRecoveryPointIndexDetails-response-TotalItemsIndexed"></a>
복구 시점과 연결된 백업 인덱스 내의 항목 수입니다.  
타입: Long

## 오류
<a name="API_GetRecoveryPointIndexDetails_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_GetRecoveryPointIndexDetails_SeeAlso"></a>

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

# GetRecoveryPointRestoreMetadata
<a name="API_GetRecoveryPointRestoreMetadata"></a>

백업을 생성하는 데 사용된 메타데이터 키-값 페어 집합을 반환합니다.

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

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

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

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

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

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

 ** [recoveryPointArn](#API_GetRecoveryPointRestoreMetadata_RequestSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-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_GetRecoveryPointRestoreMetadata_RequestBody"></a>

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "RecoveryPointArn": "string",
   "ResourceType": "string",
   "RestoreMetadata": { 
      "string" : "string" 
   }
}
```

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

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

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

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

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

 ** [ResourceType](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-ResourceType"></a>
복구 시점의 리소스 유형입니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [RestoreMetadata](#API_GetRecoveryPointRestoreMetadata_ResponseSyntax) **   <a name="Backup-GetRecoveryPointRestoreMetadata-response-RestoreMetadata"></a>
백업된 리소스의 원래 구성을 설명하는 메타데이터 키-값 페어 집합입니다. 이러한 값은 복원 중인 서비스에 따라 달라집니다.  
유형: 문자열 간 맵

## 오류
<a name="API_GetRecoveryPointRestoreMetadata_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_GetRecoveryPointRestoreMetadata_SeeAlso"></a>

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

# GetRestoreJobMetadata
<a name="API_GetRestoreJobMetadata"></a>

이 요청은 지정된 복원 작업에 대한 메타데이터를 반환합니다.

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

```
GET /restore-jobs/restoreJobId/metadata HTTP/1.1
```

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

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

 ** [restoreJobId](#API_GetRestoreJobMetadata_RequestSyntax) **   <a name="Backup-GetRestoreJobMetadata-request-uri-RestoreJobId"></a>
복원 작업의 고유 식별자입니다 AWS Backup.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "Metadata": { 
      "string" : "string" 
   },
   "RestoreJobId": "string"
}
```

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

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

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

 ** [Metadata](#API_GetRestoreJobMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreJobMetadata-response-Metadata"></a>
여기에는 지정된 백업 작업의 메타데이터가 포함됩니다.  
유형: 문자열 간 맵

 ** [RestoreJobId](#API_GetRestoreJobMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreJobMetadata-response-RestoreJobId"></a>
복원 작업의 고유 식별자입니다 AWS Backup.  
유형: 문자열

## 오류
<a name="API_GetRestoreJobMetadata_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_GetRestoreJobMetadata_SeeAlso"></a>

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

# GetRestoreTestingInferredMetadata
<a name="API_GetRestoreTestingInferredMetadata"></a>

이 요청은 보안 기본 설정으로 복원 작업을 시작하는 데 필요한 최소한의 메타데이터 세트를 반환합니다. `BackupVaultName` 및 `RecoveryPointArn`은 필수 파라미터입니다. `BackupVaultAccountId`는 선택적인 파라미터입니다.

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

```
GET /restore-testing/inferred-metadata?BackupVaultAccountId=BackupVaultAccountId&BackupVaultName=BackupVaultName&RecoveryPointArn=RecoveryPointArn HTTP/1.1
```

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

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

 ** [BackupVaultAccountId](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-BackupVaultAccountId"></a>
지정된 백업 저장소에 대한 계정 ID입니다.

 ** [BackupVaultName](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소를 생성하는 데 사용된 계정과 백업 저장소가 생성된 AWS리전에 고유한 이름으로 식별됩니다. 백업 볼트는 문자, 숫자, 하이픈(-)으로 구성됩니다.  
필수 항목 여부: 예

 ** [RecoveryPointArn](#API_GetRestoreTestingInferredMetadata_RequestSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-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_GetRestoreTestingInferredMetadata_RequestBody"></a>

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "InferredMetadata": { 
      "string" : "string" 
   }
}
```

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

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

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

 ** [InferredMetadata](#API_GetRestoreTestingInferredMetadata_ResponseSyntax) **   <a name="Backup-GetRestoreTestingInferredMetadata-response-InferredMetadata"></a>
요청에서 추론된 메타데이터의 문자열 맵입니다.  
유형: 문자열 간 맵

## 오류
<a name="API_GetRestoreTestingInferredMetadata_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_GetRestoreTestingInferredMetadata_SeeAlso"></a>

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

# GetRestoreTestingPlan
<a name="API_GetRestoreTestingPlan"></a>

지정된 `RestoreTestingPlanName`에 대한 `RestoreTestingPlan` 세부 정보를 반환합니다. 세부 정보는 JSON 형식의 복원 테스트 계획 본문과 계획 메타데이터입니다.

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

```
GET /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
```

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

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

 ** [RestoreTestingPlanName](#API_GetRestoreTestingPlan_RequestSyntax) **   <a name="Backup-GetRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
복원 테스트 계획의 필수 고유 이름입니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreTestingPlan": { 
      "CreationTime": number,
      "CreatorRequestId": "string",
      "LastExecutionTime": number,
      "LastUpdateTime": number,
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "RestoreTestingPlanArn": "string",
      "RestoreTestingPlanName": "string",
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   }
}
```

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

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

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

 ** [RestoreTestingPlan](#API_GetRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-GetRestoreTestingPlan-response-RestoreTestingPlan"></a>
복원 테스트 계획의 본문을 지정합니다. `RestoreTestingPlanName`을 포함합니다.  
타입: [RestoreTestingPlanForGet](API_RestoreTestingPlanForGet.md) 객체

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# GetRestoreTestingSelection
<a name="API_GetRestoreTestingSelection"></a>

복원 테스트 계획의 리소스와 요소를 표시하는 RestoreTestingSelection을 반환합니다.

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

```
GET /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
```

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

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

 ** [RestoreTestingPlanName](#API_GetRestoreTestingSelection_RequestSyntax) **   <a name="Backup-GetRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
복원 테스트 계획의 필수 고유 이름입니다.  
필수 항목 여부: 예

 ** [RestoreTestingSelectionName](#API_GetRestoreTestingSelection_RequestSyntax) **   <a name="Backup-GetRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
복원 테스트 선택 항목의 필수 고유 이름입니다.  
필수 항목 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreTestingSelection": { 
      "CreationTime": number,
      "CreatorRequestId": "string",
      "IamRoleArn": "string",
      "ProtectedResourceArns": [ "string" ],
      "ProtectedResourceConditions": { 
         "StringEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      },
      "ProtectedResourceType": "string",
      "RestoreMetadataOverrides": { 
         "string" : "string" 
      },
      "RestoreTestingPlanName": "string",
      "RestoreTestingSelectionName": "string",
      "ValidationWindowHours": number
   }
}
```

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

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

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

 ** [RestoreTestingSelection](#API_GetRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-GetRestoreTestingSelection-response-RestoreTestingSelection"></a>
복원 테스트 선택 항목의 고유 이름입니다.  
타입: [RestoreTestingSelectionForGet](API_RestoreTestingSelectionForGet.md) 객체

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# GetSupportedResourceTypes
<a name="API_GetSupportedResourceTypes"></a>

에서 지원하는 AWS 리소스 유형을 반환합니다 AWS Backup.

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

```
GET /supported-resource-types HTTP/1.1
```

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

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_GetSupportedResourceTypes_RequestBody"></a>

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "ResourceTypes": [ "string" ]
}
```

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

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

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

 ** [ResourceTypes](#API_GetSupportedResourceTypes_ResponseSyntax) **   <a name="Backup-GetSupportedResourceTypes-response-ResourceTypes"></a>
지원되는 AWS 리소스 유형이 있는 문자열을 포함합니다.  
+  Amazon Aurora의 `Aurora`
+  `CloudFormation`( AWS CloudFormation 일 때) 
+  Amazon DocumentDB(MongoDB 호환)의 `DocumentDB`
+  Amazon DynamoDB의 `DynamoDB`
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Elastic Compute Cloud의 `EC2`
+  Amazon Elastic File System의 `EFS`
+  Amazon Elastic Kubernetes Service용 `EKS`
+  Amazon FSx의 `FSx`
+  Amazon Neptune의 `Neptune`
+  Amazon Relational Database Service의 `RDS`
+  Amazon Redshift의 `Redshift`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
+  Amazon Elastic Compute Cloud 인스턴스에 대한 SAP HANA 데이터베이스의 `SAP HANA on Amazon EC2`
+  `Storage Gateway`( AWS Storage Gateway 일 때) 
+  Amazon Timestream의 `Timestream`
+  VMware 가상 머신의 `VirtualMachine`
유형: 문자열 배열  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

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

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

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

HTTP 상태 코드: 500

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

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

# GetTieringConfiguration
<a name="API_GetTieringConfiguration"></a>

지정된 `TieringConfigurationName`에 대한 `TieringConfiguration` 세부 정보를 반환합니다. 세부 정보는 구성 메타데이터 외에도 JSON 형식의 계층화 구성 본문입니다.

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

```
GET /tiering-configurations/tieringConfigurationName HTTP/1.1
```

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

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

 ** [tieringConfigurationName](#API_GetTieringConfiguration_RequestSyntax) **   <a name="Backup-GetTieringConfiguration-request-uri-TieringConfigurationName"></a>
계층화 구성의 고유한 이름입니다.  
패턴: `^[a-zA-Z0-9_]{1,200}$`   
필수 여부: 예

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "CreationTime": number,
      "CreatorRequestId": "string",
      "LastUpdatedTime": number,
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationArn": "string",
      "TieringConfigurationName": "string"
   }
}
```

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

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

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

 ** [TieringConfiguration](#API_GetTieringConfiguration_ResponseSyntax) **   <a name="Backup-GetTieringConfiguration-response-TieringConfiguration"></a>
계층화 구성의 본문을 지정합니다. `TieringConfigurationName`을 포함합니다.  
타입: [TieringConfiguration](API_TieringConfiguration.md) 객체

## 오류
<a name="API_GetTieringConfiguration_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_GetTieringConfiguration_SeeAlso"></a>

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

# ListBackupJobs
<a name="API_ListBackupJobs"></a>

지난 30일간 인증된 계정의 기존 백업 작업 목록을 반환합니다. 기간이 더 긴 경우, 이러한 [모니터링 도구](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)를 사용하는 방안을 고려해 보세요.

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

```
GET /backup-jobs/?accountId=ByAccountId&backupVaultName=ByBackupVaultName&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1
```

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

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

 ** [ByAccountId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByAccountId"></a>
작업을 나열할 계정 ID입니다. 지정된 계정 ID와 관련된 백업 작업만 반환합니다.  
 AWS Organizations 관리 계정에서 사용하는 경우를 전달하면 조직 전체의 모든 작업이 `*` 반환됩니다.  
패턴: `^[0-9]{12}$` 

 ** [ByBackupVaultName](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByBackupVaultName"></a>
지정된 백업 저장소에 저장될 백업 작업만 반환합니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [ByCompleteAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteAfter"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이후에 완료된 백업 작업만 반환합니다.

 ** [ByCompleteBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteBefore"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이전에 완료된 백업 작업만 반환합니다.

 ** [ByCreatedAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedAfter"></a>
지정된 날짜 이후에 생성된 백업 작업만 반환합니다.

 ** [ByCreatedBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedBefore"></a>
지정된 날짜 이전에 생성된 백업 작업만 반환합니다.

 ** [ByMessageCategory](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByMessageCategory"></a>
입력한 값과 일치하는 MessageCategory가 있는 작업을 필터링하는 데 사용할 수 있는 선택적 파라미터입니다.  
예시 문자열에는 `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL`, `InvalidParameters` 등이 있습니다.  
[모니터링](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) 보기   
와일드카드 ()는 모든 메시지 범주의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 메시지 범주의 작업 수를 집계하고 그 합계를 반환합니다.

 ** [ByParentJobId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByParentJobId"></a>
상위 작업 ID를 기준으로 하위(중첩) 작업을 나열하는 필터입니다.

 ** [ByResourceArn](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceArn"></a>
지정된 리소스 Amazon 리소스 이름(ARN)과 일치하는 백업 작업만 반환합니다.

 ** [ByResourceType](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceType"></a>
지정된 리소스에 대한 백업 작업만 반환합니다.  
+  Amazon Aurora의 `Aurora`
+  `CloudFormation`( AWS CloudFormation 일 때) 
+  Amazon DocumentDB(MongoDB 호환)의 `DocumentDB`
+  Amazon DynamoDB의 `DynamoDB`
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Elastic Compute Cloud의 `EC2`
+  Amazon Elastic File System의 `EFS`
+  Amazon Elastic Kubernetes Service용 `EKS`
+  Amazon FSx의 `FSx`
+  Amazon Neptune의 `Neptune`
+  Amazon Relational Database Service의 `RDS`
+  Amazon Redshift의 `Redshift`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
+  Amazon Elastic Compute Cloud 인스턴스에 대한 SAP HANA 데이터베이스의 `SAP HANA on Amazon EC2`
+  `Storage Gateway`( AWS Storage Gateway 일 때) 
+  Amazon Timestream의 `Timestream`
+  VMware 가상 머신의 `VirtualMachine`
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ByState](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByState"></a>
지정된 상태에 있는 백업 작업만 반환합니다.  
 `Completed with issues`는 AWS Backup 콘솔에서만 확인할 수 있는 상태입니다. API의 경우 이 상태는 상태가 `COMPLETED`이고 `MessageCategory` 값이 `SUCCESS`가 아닌 작업을 의미합니다. 즉, 상태는 완료되었지만 상태 메시지가 함께 표시됩니다.  
`Completed with issues`에 해당하는 작업 수를 가져오려면 GET 요청 두 개를 실행하고 더 작은 두 번째 수를 뺍니다.  
GET /backup-jobs/?state=COMPLETED  
GET /backup-jobs/?messageCategory=SUCCESS&state=COMPLETED  
유효한 값: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [MaxResults](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupJobs": [ 
      { 
         "AccountId": "string",
         "BackupJobId": "string",
         "BackupOptions": { 
            "string" : "string" 
         },
         "BackupSizeInBytes": number,
         "BackupType": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "BytesTransferred": number,
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "ExpectedCompletionDate": number,
         "IamRoleArn": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "MessageCategory": "string",
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "StartBy": number,
         "State": "string",
         "StatusMessage": "string",
         "VaultLockState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BackupJobs](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-BackupJobs"></a>
JSON 형식으로 반환되는 백업 작업에 대한 메타데이터가 들어 있는 구조의 배열입니다.  
타입: [BackupJob](API_BackupJob.md)객체 배열

 ** [NextToken](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# ListBackupJobSummaries
<a name="API_ListBackupJobSummaries"></a>

최근 30일 이내에 생성되거나 실행된 백업 작업의 요약에 대한 요청입니다. AccountID, State, ResourceType, MessageCategory, AggregationPeriod, MaxResults 또는 NextToken 파라미터를 포함하여 결과를 필터링할 수 있습니다.

이 요청은 포함된 작업의 Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, Count를 포함하는 요약을 반환합니다.

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

```
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

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

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

 ** [AccountId](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AccountId"></a>
지정된 계정의 작업 수를 반환합니다.  
요청이 멤버 계정 또는 AWS Organizations에 속하지 않은 계정에서 전송되는 경우 요청자의 계정 내 작업이 반환됩니다.  
루트, 관리자 및 위임된 관리자 계정은 ANY 값을 사용하여 조직 내 모든 계정의 작업 수를 반환할 수 있습니다.  
 `AGGREGATE_ALL`은 인증된 조직 내 모든 계정의 작업 수를 집계한 다음 합계를 반환합니다.  
패턴: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY` - 지난 14일 동안의 일별 작업 수
+  `SEVEN_DAYS` - 지난 7일 동안의 집계된 작업 수
+  `FOURTEEN_DAYS` - 지난 14일 동안의 집계된 작업 수
유효한 값: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MaxResults](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
값은 정수입니다. 허용되는 값 범위는 1에서 500까지입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [MessageCategory](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-MessageCategory"></a>
이 파라미터는 지정된 메시지 범주의 작업 수를 반환합니다.  
허용되는 문자열의 예로는 `AccessDenied`, `Success`, `InvalidParameters` 등이 있습니다. [모니터링](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)에서 허용되는 MessageCategory 문자열 목록을 확인하세요.  
ANY 값은 모든 메시지 범주의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 메시지 범주의 작업 수를 집계하고 그 합계를 반환합니다.

 ** [NextToken](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [ResourceType](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-ResourceType"></a>
지정된 리소스 유형에 대한 작업 수를 반환합니다. `GetSupportedResourceTypes` 요청을 사용하여 지원되는 리소스 유형의 문자열을 가져옵니다.  
ANY 값은 모든 리소스 유형의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 리소스 유형의 작업 수를 집계하고 그 합계를 반환합니다.  
백업할 AWS 리소스 유형. 예: Amazon Elastic Block Store(Amazon EBS) 볼륨 또는 Amazon Relational Database Service(Amazon RDS) 데이터베이스.  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListBackupJobSummaries_RequestSyntax) **   <a name="Backup-ListBackupJobSummaries-request-uri-State"></a>
이 파라미터는 지정된 상태의 작업 수를 반환합니다.  
ANY 값은 모든 상태의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 상태의 작업 수를 집계하고 그 합계를 반환합니다.  
 `Completed with issues`는 AWS Backup 콘솔에서만 확인할 수 있는 상태입니다. API의 경우 이 상태는 상태가 `COMPLETED`이고 `MessageCategory` 값이 `SUCCESS`가 아닌 작업을 의미합니다. 즉, 상태는 완료되었지만 상태 메시지가 함께 표시됩니다. `Completed with issues`에 해당하는 작업 수를 가져오려면 GET 요청 두 개를 실행하고 더 작은 두 번째 수를 뺍니다.  
GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN\$1DAYS&State=COMPLETED  
GET /audit/backup-job-summaries?AggregationPeriod=FOURTEEN\$1DAYS&MessageCategory=SUCCESS&State=COMPLETED  
유효한 값: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY` 

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "BackupJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MessageCategory": "string",
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [AggregationPeriod](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY` - 지난 14일 동안의 일별 작업 수
+  `SEVEN_DAYS` - 지난 7일 동안의 집계된 작업 수
+  `FOURTEEN_DAYS` - 지난 14일 동안의 집계된 작업 수
유형: 문자열

 ** [BackupJobSummaries](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-BackupJobSummaries"></a>
요약 정보  
타입: [BackupJobSummary](API_BackupJobSummary.md)객체 배열

 ** [NextToken](#API_ListBackupJobSummaries_ResponseSyntax) **   <a name="Backup-ListBackupJobSummaries-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

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

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

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

HTTP 상태 코드: 400

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

HTTP 상태 코드: 500

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

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

# ListBackupPlans
<a name="API_ListBackupPlans"></a>

계정에 대한 활성 백업 계획을 나열합니다.

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

```
GET /backup/plans/?includeDeleted=IncludeDeleted&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

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

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

 ** [IncludeDeleted](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-IncludeDeleted"></a>
기본값이 `FALSE`인 부울 값으로, `TRUE`로 설정되면 삭제된 백업 계획을 반환합니다.

 ** [MaxResults](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListBackupPlans_RequestSyntax) **   <a name="Backup-ListBackupPlans-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlansList": [ 
      { 
         "AdvancedBackupSettings": [ 
            { 
               "BackupOptions": { 
                  "string" : "string" 
               },
               "ResourceType": "string"
            }
         ],
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "DeletionDate": number,
         "LastExecutionDate": number,
         "VersionId": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BackupPlansList](#API_ListBackupPlans_ResponseSyntax) **   <a name="Backup-ListBackupPlans-response-BackupPlansList"></a>
백업 계획에 대한 정보입니다.  
타입: [BackupPlansListMember](API_BackupPlansListMember.md)객체 배열

 ** [NextToken](#API_ListBackupPlans_ResponseSyntax) **   <a name="Backup-ListBackupPlans-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListBackupPlans_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_ListBackupPlans_SeeAlso"></a>

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

# ListBackupPlanTemplates
<a name="API_ListBackupPlanTemplates"></a>

백업 계획 템플릿을 나열합니다.

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

```
GET /backup/template/plans?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

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

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

 ** [MaxResults](#API_ListBackupPlanTemplates_RequestSyntax) **   <a name="Backup-ListBackupPlanTemplates-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListBackupPlanTemplates_RequestSyntax) **   <a name="Backup-ListBackupPlanTemplates-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanTemplatesList": [ 
      { 
         "BackupPlanTemplateId": "string",
         "BackupPlanTemplateName": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BackupPlanTemplatesList](#API_ListBackupPlanTemplates_ResponseSyntax) **   <a name="Backup-ListBackupPlanTemplates-response-BackupPlanTemplatesList"></a>
저장된 템플릿에 대한 메타데이터가 들어 있는 템플릿 목록 항목의 배열입니다.  
타입: [BackupPlanTemplatesListMember](API_BackupPlanTemplatesListMember.md)객체 배열

 ** [NextToken](#API_ListBackupPlanTemplates_ResponseSyntax) **   <a name="Backup-ListBackupPlanTemplates-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListBackupPlanTemplates_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_ListBackupPlanTemplates_SeeAlso"></a>

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

# ListBackupPlanVersions
<a name="API_ListBackupPlanVersions"></a>

Amazon 리소스 이름(ARN), 백업 계획 ID, 생성 및 삭제 날짜, 계획 이름, 버전 ID를 비롯하여, 백업 계획의 버전 메타데이터를 반환합니다.

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

```
GET /backup/plans/backupPlanId/versions/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

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

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

 ** [backupPlanId](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

 ** [MaxResults](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListBackupPlanVersions_RequestSyntax) **   <a name="Backup-ListBackupPlanVersions-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupPlanVersionsList": [ 
      { 
         "AdvancedBackupSettings": [ 
            { 
               "BackupOptions": { 
                  "string" : "string" 
               },
               "ResourceType": "string"
            }
         ],
         "BackupPlanArn": "string",
         "BackupPlanId": "string",
         "BackupPlanName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "DeletionDate": number,
         "LastExecutionDate": number,
         "VersionId": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BackupPlanVersionsList](#API_ListBackupPlanVersions_ResponseSyntax) **   <a name="Backup-ListBackupPlanVersions-response-BackupPlanVersionsList"></a>
백업 계획에 대한 메타데이터가 들어 있는 버전 목록 항목의 배열입니다.  
타입: [BackupPlansListMember](API_BackupPlansListMember.md)객체 배열

 ** [NextToken](#API_ListBackupPlanVersions_ResponseSyntax) **   <a name="Backup-ListBackupPlanVersions-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListBackupPlanVersions_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_ListBackupPlanVersions_SeeAlso"></a>

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

# ListBackupSelections
<a name="API_ListBackupSelections"></a>

대상 백업 계획과 관련된 리소스의 메타데이터가 들어 있는 배열을 반환합니다.

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

```
GET /backup/plans/backupPlanId/selections/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

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

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

 ** [backupPlanId](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
필수 항목 여부: 예

 ** [MaxResults](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListBackupSelections_RequestSyntax) **   <a name="Backup-ListBackupSelections-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupSelectionsList": [ 
      { 
         "BackupPlanId": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "IamRoleArn": "string",
         "SelectionId": "string",
         "SelectionName": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BackupSelectionsList](#API_ListBackupSelections_ResponseSyntax) **   <a name="Backup-ListBackupSelections-response-BackupSelectionsList"></a>
목록에 있는 각 리소스에 대한 메타데이터가 들어 있는 백업 선택 목록 항목의 배열입니다.  
타입: [BackupSelectionsListMember](API_BackupSelectionsListMember.md)객체 배열

 ** [NextToken](#API_ListBackupSelections_ResponseSyntax) **   <a name="Backup-ListBackupSelections-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListBackupSelections_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_ListBackupSelections_SeeAlso"></a>

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

# ListBackupVaults
<a name="API_ListBackupVaults"></a>

복구 시점 스토리지 컨테이너 목록 및 이에 대한 정보를 함께 반환합니다.

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

```
GET /backup-vaults/?maxResults=MaxResults&nextToken=NextToken&shared=ByShared&vaultType=ByVaultType HTTP/1.1
```

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

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

 ** [ByShared](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-ByShared"></a>
이 파라미터는 저장소 목록을 공유 저장소별로 정렬합니다.

 ** [ByVaultType](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-ByVaultType"></a>
이 파라미터는 저장소 목록을 저장소 유형별로 정렬합니다.  
유효한 값: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` 

 ** [MaxResults](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListBackupVaults_RequestSyntax) **   <a name="Backup-ListBackupVaults-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultList": [ 
      { 
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CreationDate": number,
         "CreatorRequestId": "string",
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "LockDate": number,
         "Locked": boolean,
         "MaxRetentionDays": number,
         "MinRetentionDays": number,
         "NumberOfRecoveryPoints": number,
         "VaultState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

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

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

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

 ** [BackupVaultList](#API_ListBackupVaults_ResponseSyntax) **   <a name="Backup-ListBackupVaults-response-BackupVaultList"></a>
Amazon 리소스 이름(ARN), 표시 이름, 생성 날짜, 저장된 복구 시점 수, 암호화 정보(백업 저장소에 저장된 리소스가 암호화된 경우) 등 저장소 메타데이터가 들어 있는 백업 저장소 목록 멤버의 배열입니다.  
타입: [BackupVaultListMember](API_BackupVaultListMember.md)객체 배열

 ** [NextToken](#API_ListBackupVaults_ResponseSyntax) **   <a name="Backup-ListBackupVaults-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListBackupVaults_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_ListBackupVaults_SeeAlso"></a>

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

# ListCopyJobs
<a name="API_ListCopyJobs"></a>

복사 작업에 대한 메타데이터를 반환합니다.

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

```
GET /copy-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&destinationVaultArn=ByDestinationVaultArn&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&sourceRecoveryPointArn=BySourceRecoveryPointArn&state=ByState HTTP/1.1
```

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

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

 ** [ByAccountId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByAccountId"></a>
작업을 나열할 계정 ID입니다. 지정된 계정 ID와 관련된 복사 작업만 반환합니다.  
패턴: `^[0-9]{12}$` 

 ** [ByCompleteAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteAfter"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이후에 완료된 복사 작업만 반환합니다.

 ** [ByCompleteBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteBefore"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이전에 완료된 복사 작업만 반환합니다.

 ** [ByCreatedAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedAfter"></a>
지정된 날짜 이후에 생성된 복사 작업만 반환합니다.

 ** [ByCreatedBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedBefore"></a>
지정된 날짜 이전에 생성된 복사 작업만 반환합니다.

 ** [ByDestinationVaultArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByDestinationVaultArn"></a>
복사하는 위치인 소스 백업 저장소를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`).

 ** [ByMessageCategory](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByMessageCategory"></a>
입력한 값과 일치하는 MessageCategory가 있는 작업을 필터링하는 데 사용할 수 있는 선택적 파라미터입니다.  
예시 문자열에는 `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL`, `INVALIDPARAMETERS` 등이 있습니다.  
[모니터링](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)에서 허용되는 문자열 목록을 확인하세요.  
ANY 값은 모든 메시지 범주의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 메시지 범주의 작업 수를 집계하고 그 합계를 반환합니다.

 ** [ByParentJobId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByParentJobId"></a>
상위 작업 ID를 기준으로 하위(중첩) 작업을 나열하는 필터입니다.

 ** [ByResourceArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceArn"></a>
지정된 리소스 Amazon 리소스 이름(ARN)과 일치하는 복사 작업만 반환합니다.

 ** [ByResourceType](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceType"></a>
지정된 리소스에 대한 백업 작업만 반환합니다.  
+  Amazon Aurora의 `Aurora`
+  `CloudFormation`( AWS CloudFormation 일 때) 
+  Amazon DocumentDB(MongoDB 호환)의 `DocumentDB`
+  Amazon DynamoDB의 `DynamoDB`
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Elastic Compute Cloud의 `EC2`
+  Amazon Elastic File System의 `EFS`
+  Amazon Elastic Kubernetes Service용 `EKS`
+  Amazon FSx의 `FSx`
+  Amazon Neptune의 `Neptune`
+  Amazon Relational Database Service의 `RDS`
+  Amazon Redshift의 `Redshift`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
+  Amazon Elastic Compute Cloud 인스턴스에 대한 SAP HANA 데이터베이스의 `SAP HANA on Amazon EC2`
+  `Storage Gateway`( AWS Storage Gateway 일 때) 
+  Amazon Timestream의 `Timestream`
+  VMware 가상 머신의 `VirtualMachine`
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [BySourceRecoveryPointArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-BySourceRecoveryPointArn"></a>
지정된 소스 복구 시점 ARN을 기준으로 복사 작업을 필터링합니다.

 ** [ByState](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByState"></a>
지정된 상태에 있는 복사 작업만 반환합니다.  
유효한 값: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL` 

 ** [MaxResults](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 MaxResults 수를 반환하기 위한 요청을 한 경우, NextToken을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

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

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "CopyJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "ChildJobsInState": { 
            "string" : number 
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CopyJobId": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreatedByBackupJobId": "string",
         "CreationDate": number,
         "DestinationBackupVaultArn": "string",
         "DestinationEncryptionKeyArn": "string",
         "DestinationRecoveryPointArn": "string",
         "DestinationRecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "DestinationVaultLockState": "string",
         "DestinationVaultType": "string",
         "IamRoleArn": "string",
         "IsParent": boolean,
         "MessageCategory": "string",
         "NumberOfChildJobs": number,
         "ParentJobId": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "string",
         "SourceRecoveryPointArn": "string",
         "State": "string",
         "StatusMessage": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListCopyJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CopyJobs](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-CopyJobs"></a>
JSON 형식으로 반환되는 복사 작업에 대한 메타데이터가 들어 있는 구조의 배열.  
타입: [CopyJob](API_CopyJob.md)객체 배열

 ** [NextToken](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 MaxResults 수를 반환하기 위한 요청을 한 경우, NextToken을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListCopyJobs_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListCopyJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobs) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobs) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobs) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobs) 

# ListCopyJobSummaries
<a name="API_ListCopyJobSummaries"></a>

이 요청은 최근 30일 이내에 생성되거나 실행된 복사 작업의 목록을 가져옵니다. AccountID, State, ResourceType, MessageCategory, AggregationPeriod, MaxResults 또는 NextToken 파라미터를 포함하여 결과를 필터링할 수 있습니다.

이 요청은 포함된 작업의 Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, Count를 포함하는 요약을 반환합니다.

## Request Syntax
<a name="API_ListCopyJobSummaries_RequestSyntax"></a>

```
GET /audit/copy-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListCopyJobSummaries_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [AccountId](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-AccountId"></a>
지정된 계정의 작업 수를 반환합니다.  
요청이 멤버 계정 또는 AWS Organizations에 속하지 않은 계정에서 전송되는 경우 요청자의 계정 내 작업이 반환됩니다.  
루트, 관리자 및 위임된 관리자 계정은 ANY 값을 사용하여 조직 내 모든 계정의 작업 수를 반환할 수 있습니다.  
 `AGGREGATE_ALL`은 인증된 조직 내 모든 계정의 작업 수를 집계한 다음 합계를 반환합니다.  
패턴: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY` - 지난 14일 동안의 일별 작업 수
+  `SEVEN_DAYS` - 지난 7일 동안의 집계된 작업 수
+  `FOURTEEN_DAYS` - 지난 14일 동안의 집계된 작업 수
유효한 값: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MaxResults](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-MaxResults"></a>
이 파라미터는 반환할 항목의 최대 수를 설정합니다.  
값은 정수입니다. 허용되는 값 범위는 1에서 500까지입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [MessageCategory](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-MessageCategory"></a>
이 파라미터는 지정된 메시지 범주의 작업 수를 반환합니다.  
허용되는 문자열의 예로는 `AccessDenied`, `Success`, `InvalidParameters` 등이 있습니다. [모니터링](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)에서 허용되는 MessageCategory 문자열 목록을 확인하세요.  
ANY 값은 모든 메시지 범주의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 메시지 범주의 작업 수를 집계하고 그 합계를 반환합니다.

 ** [NextToken](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [ResourceType](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-ResourceType"></a>
지정된 리소스 유형에 대한 작업 수를 반환합니다. `GetSupportedResourceTypes` 요청을 사용하여 지원되는 리소스 유형의 문자열을 가져옵니다.  
ANY 값은 모든 리소스 유형의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 리소스 유형의 작업 수를 집계하고 그 합계를 반환합니다.  
백업할 AWS 리소스 유형. 예: Amazon Elastic Block Store(Amazon EBS) 볼륨 또는 Amazon Relational Database Service(Amazon RDS) 데이터베이스.  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListCopyJobSummaries_RequestSyntax) **   <a name="Backup-ListCopyJobSummaries-request-uri-State"></a>
이 파라미터는 지정된 상태의 작업 수를 반환합니다.  
ANY 값은 모든 상태의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 상태의 작업 수를 집계하고 그 합계를 반환합니다.  
유효한 값: `CREATED | RUNNING | ABORTING | ABORTED | COMPLETING | COMPLETED | FAILING | FAILED | PARTIAL | AGGREGATE_ALL | ANY` 

## Request Body
<a name="API_ListCopyJobSummaries_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListCopyJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "CopyJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MessageCategory": "string",
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListCopyJobSummaries_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AggregationPeriod](#API_ListCopyJobSummaries_ResponseSyntax) **   <a name="Backup-ListCopyJobSummaries-response-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY` - 지난 14일 동안의 일별 작업 수
+  `SEVEN_DAYS` - 지난 7일 동안의 집계된 작업 수
+  `FOURTEEN_DAYS` - 지난 14일 동안의 집계된 작업 수
유형: 문자열

 ** [CopyJobSummaries](#API_ListCopyJobSummaries_ResponseSyntax) **   <a name="Backup-ListCopyJobSummaries-response-CopyJobSummaries"></a>
반환된 값은 포함된 작업의 Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, Count를 포함하는 요약을 보여줍니다.  
타입: [CopyJobSummary](API_CopyJobSummary.md)객체 배열

 ** [NextToken](#API_ListCopyJobSummaries_ResponseSyntax) **   <a name="Backup-ListCopyJobSummaries-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListCopyJobSummaries_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListCopyJobSummaries_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobSummaries) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobSummaries) 

# ListFrameworks
<a name="API_ListFrameworks"></a>

 AWS 계정 및에 대한 모든 프레임워크 목록을 반환합니다 AWS 리전.

## Request Syntax
<a name="API_ListFrameworks_RequestSyntax"></a>

```
GET /audit/frameworks?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListFrameworks_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListFrameworks_RequestSyntax) **   <a name="Backup-ListFrameworks-request-uri-MaxResults"></a>
원하는 결과 수는 1\$11,000입니다. 선택 사항. 지정하지 않으면 쿼리는 1MB 데이터를 반환합니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListFrameworks_RequestSyntax) **   <a name="Backup-ListFrameworks-request-uri-NextToken"></a>
이 작업에 대한 이전 호출에서 반환된 식별자로, 목록의 다음 항목 집합을 반환하는 데 사용할 수 있습니다.

## Request Body
<a name="API_ListFrameworks_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListFrameworks_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Frameworks": [ 
      { 
         "CreationTime": number,
         "DeploymentStatus": "string",
         "FrameworkArn": "string",
         "FrameworkDescription": "string",
         "FrameworkName": "string",
         "NumberOfControls": number
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListFrameworks_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Frameworks](#API_ListFrameworks_ResponseSyntax) **   <a name="Backup-ListFrameworks-response-Frameworks"></a>
프레임워크 이름, Amazon 리소스 이름(ARN), 설명, 컨트롤 수, 생성 시간, 배포 상태 등 각 프레임워크에 대한 세부 정보가 포함된 프레임워크입니다.  
타입: [Framework](API_Framework.md)객체 배열

 ** [NextToken](#API_ListFrameworks_ResponseSyntax) **   <a name="Backup-ListFrameworks-response-NextToken"></a>
이 작업에 대한 이전 호출에서 반환된 식별자로, 목록의 다음 항목 집합을 반환하는 데 사용할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListFrameworks_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListFrameworks_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListFrameworks) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListFrameworks) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListFrameworks) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListFrameworks) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListFrameworks) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListFrameworks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListFrameworks) 

# ListIndexedRecoveryPoints
<a name="API_ListIndexedRecoveryPoints"></a>

이 작업은 지정된 계정에 속하는 연결된 인덱스가 있는 복구 시점 목록을 반환합니다.

포함할 수 있는 선택적 파라미터는 MaxResults, NextToken, SourceResourceArns, CreatedBefore, CreatedAfter, ResourceType입니다.

## Request Syntax
<a name="API_ListIndexedRecoveryPoints_RequestSyntax"></a>

```
GET /indexes/recovery-point/?createdAfter=CreatedAfter&createdBefore=CreatedBefore&indexStatus=IndexStatus&maxResults=MaxResults&nextToken=NextToken&resourceType=ResourceType&sourceResourceArn=SourceResourceArn HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListIndexedRecoveryPoints_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [CreatedAfter](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-CreatedAfter"></a>
지정된 날짜 이후에 생성된 인덱싱된 복구 시점만 반환합니다.

 ** [CreatedBefore](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-CreatedBefore"></a>
지정된 날짜 전에 생성된 인덱싱된 복구 시점만 반환합니다.

 ** [IndexStatus](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-IndexStatus"></a>
표시된 상태를 기준으로 반환된 목록을 필터링하려면 이 파라미터를 포함합니다.  
허용되는 값: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
상태가 `ACTIVE`인 인덱스가 있는 복구 시점을 검색에 포함할 수 있습니다.  
유효한 값: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [MaxResults](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-NextToken"></a>
반환된 복구 시점의 일부 목록 다음에 나오는 다음 항목입니다.  
예를 들어, 인덱싱된 복구 시점의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [ResourceType](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-ResourceType"></a>
지정된 리소스 유형에 대한 인덱싱된 복구 시점 목록을 반환합니다.  
허용 가능한 값은 다음을 포함합니다.  
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [SourceResourceArn](#API_ListIndexedRecoveryPoints_RequestSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-request-uri-SourceResourceArn"></a>
소스 리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)의 문자열입니다.

## Request Body
<a name="API_ListIndexedRecoveryPoints_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListIndexedRecoveryPoints_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "IndexedRecoveryPoints": [ 
      { 
         "BackupCreationDate": number,
         "BackupVaultArn": "string",
         "IamRoleArn": "string",
         "IndexCreationDate": number,
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "RecoveryPointArn": "string",
         "ResourceType": "string",
         "SourceResourceArn": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListIndexedRecoveryPoints_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [IndexedRecoveryPoints](#API_ListIndexedRecoveryPoints_ResponseSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-response-IndexedRecoveryPoints"></a>
지정된 계정에 속하는 연결된 인덱스가 있는 복구 시점 목록입니다.  
타입: [IndexedRecoveryPoint](API_IndexedRecoveryPoint.md)객체 배열

 ** [NextToken](#API_ListIndexedRecoveryPoints_ResponseSyntax) **   <a name="Backup-ListIndexedRecoveryPoints-response-NextToken"></a>
반환된 복구 시점의 일부 목록 다음에 나오는 다음 항목입니다.  
예를 들어, 인덱싱된 복구 시점의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListIndexedRecoveryPoints_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListIndexedRecoveryPoints_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListIndexedRecoveryPoints) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListIndexedRecoveryPoints) 

# ListLegalHolds
<a name="API_ListLegalHolds"></a>

이 작업을 수행하면 활성화된 법적 보존 및 이전의 법적 보존에 대한 메타데이터가 반환됩니다.

## Request Syntax
<a name="API_ListLegalHolds_RequestSyntax"></a>

```
GET /legal-holds/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListLegalHolds_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListLegalHolds_RequestSyntax) **   <a name="Backup-ListLegalHolds-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListLegalHolds_RequestSyntax) **   <a name="Backup-ListLegalHolds-request-uri-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListLegalHolds_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListLegalHolds_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LegalHolds": [ 
      { 
         "CancellationDate": number,
         "CreationDate": number,
         "Description": "string",
         "LegalHoldArn": "string",
         "LegalHoldId": "string",
         "Status": "string",
         "Title": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_ListLegalHolds_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [LegalHolds](#API_ListLegalHolds_ResponseSyntax) **   <a name="Backup-ListLegalHolds-response-LegalHolds"></a>
활성화된 또는 이전의 반환된 법적 보존이 둘 다 들어 있는 배열입니다.  
타입: [LegalHold](API_LegalHold.md)객체 배열

 ** [NextToken](#API_ListLegalHolds_ResponseSyntax) **   <a name="Backup-ListLegalHolds-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_ListLegalHolds_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListLegalHolds_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListLegalHolds) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListLegalHolds) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListLegalHolds) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListLegalHolds) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListLegalHolds) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListLegalHolds) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListLegalHolds) 

# ListProtectedResources
<a name="API_ListProtectedResources"></a>

리소스가 저장된 시간, 리소스의 Amazon 리소스 이름(ARN) 및 리소스 유형을 포함하여에서 AWS Backup 생성한 복구 시점(복구 시점의 [상태에](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRecoveryPoint.html#Backup-DescribeRecoveryPoint-response-Status) 관계없이)이 있는 리소스 배열을 반환합니다.

## Request Syntax
<a name="API_ListProtectedResources_RequestSyntax"></a>

```
GET /resources/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListProtectedResources_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListProtectedResources_RequestSyntax) **   <a name="Backup-ListProtectedResources-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListProtectedResources_RequestSyntax) **   <a name="Backup-ListProtectedResources-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListProtectedResources_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListProtectedResources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { 
         "LastBackupTime": number,
         "LastBackupVaultArn": "string",
         "LastRecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListProtectedResources_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListProtectedResources_ResponseSyntax) **   <a name="Backup-ListProtectedResources-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [Results](#API_ListProtectedResources_ResponseSyntax) **   <a name="Backup-ListProtectedResources-response-Results"></a>
리소스가 저장된 시간, 리소스의 Amazon 리소스 이름(ARN) 및 리소스 유형을 AWS Backup 포함하여 성공적으로 백업된 리소스 배열입니다.  
타입: [ProtectedResource](API_ProtectedResource.md) 객체 배열

## 오류
<a name="API_ListProtectedResources_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListProtectedResources_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListProtectedResources) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListProtectedResources) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListProtectedResources) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListProtectedResources) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListProtectedResources) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListProtectedResources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListProtectedResources) 

# ListProtectedResourcesByBackupVault
<a name="API_ListProtectedResourcesByBackupVault"></a>

이 요청은 각 백업 저장소에 해당하는 보호된 리소스를 나열합니다.

## Request Syntax
<a name="API_ListProtectedResourcesByBackupVault_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/resources/?backupVaultAccountId=BackupVaultAccountId&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListProtectedResourcesByBackupVault_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [BackupVaultAccountId](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-BackupVaultAccountId"></a>
계정 ID로 지정한 저장소 내의 백업 저장소별 보호된 리소스 목록입니다.  
패턴: `^[0-9]{12}$` 

 ** [backupVaultName](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-BackupVaultName"></a>
이름으로 지정한 저장소 내의 백업 저장소별 보호된 리소스 목록입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [MaxResults](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListProtectedResourcesByBackupVault_RequestSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListProtectedResourcesByBackupVault_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListProtectedResourcesByBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { 
         "LastBackupTime": number,
         "LastBackupVaultArn": "string",
         "LastRecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListProtectedResourcesByBackupVault_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListProtectedResourcesByBackupVault_ResponseSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [Results](#API_ListProtectedResourcesByBackupVault_ResponseSyntax) **   <a name="Backup-ListProtectedResourcesByBackupVault-response-Results"></a>
ListProtectedResourcesByBackupVault 요청에 대해 반환된 결과입니다.  
타입: [ProtectedResource](API_ProtectedResource.md) 객체 배열

## 오류
<a name="API_ListProtectedResourcesByBackupVault_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListProtectedResourcesByBackupVault_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListProtectedResourcesByBackupVault) 

# ListRecoveryPointsByBackupVault
<a name="API_ListRecoveryPointsByBackupVault"></a>

백업 저장소에 저장된 복구 시점에 대한 자세한 정보를 반환합니다.

## Request Syntax
<a name="API_ListRecoveryPointsByBackupVault_RequestSyntax"></a>

```
GET /backup-vaults/backupVaultName/recovery-points/?backupPlanId=ByBackupPlanId&backupVaultAccountId=BackupVaultAccountId&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentRecoveryPointArn=ByParentRecoveryPointArn&resourceArn=ByResourceArn&resourceType=ByResourceType HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRecoveryPointsByBackupVault_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [BackupVaultAccountId](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-BackupVaultAccountId"></a>
이 파라미터는 계정 ID별로 복구 시점 목록을 정렬합니다.  
패턴: `^[0-9]{12}$` 

 ** [backupVaultName](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
지원되는 서비스가 백업을 생성할 경우 백업 저장소 이름을 사용하지 못할 수 있습니다.
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [ByBackupPlanId](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByBackupPlanId"></a>
지정된 백업 계획 ID와 일치하는 복구 시점만 반환합니다.

 ** [ByCreatedAfter](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByCreatedAfter"></a>
지정된 타임스탬프 이후에 생성된 복구 시점만 반환합니다.

 ** [ByCreatedBefore](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByCreatedBefore"></a>
지정된 타임스탬프 이전에 생성된 복구 시점만 반환합니다.

 ** [ByParentRecoveryPointArn](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByParentRecoveryPointArn"></a>
이렇게 하면 지정된 상위(복합) 복구 시점 Amazon 리소스 이름(ARN)과 일치하는 복구 시점만 반환합니다.

 ** [ByResourceArn](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByResourceArn"></a>
지정된 리소스 Amazon 리소스 이름(ARN)과 일치하는 복구 시점만 반환합니다.

 ** [ByResourceType](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-ByResourceType"></a>
지정된 리소스 유형과 일치하는 복구 시점만 반환합니다.  
+  Amazon Aurora의 `Aurora`
+  `CloudFormation`( AWS CloudFormation 일 때) 
+  Amazon DocumentDB(MongoDB 호환)의 `DocumentDB`
+  Amazon DynamoDB의 `DynamoDB`
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Elastic Compute Cloud의 `EC2`
+  Amazon Elastic File System의 `EFS`
+  Amazon Elastic Kubernetes Service용 `EKS`
+  Amazon FSx의 `FSx`
+  Amazon Neptune의 `Neptune`
+  Amazon Relational Database Service의 `RDS`
+  Amazon Redshift의 `Redshift`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
+  Amazon Elastic Compute Cloud 인스턴스에 대한 SAP HANA 데이터베이스의 `SAP HANA on Amazon EC2`
+  `Storage Gateway`( AWS Storage Gateway 일 때) 
+  Amazon Timestream의 `Timestream`
+  VMware 가상 머신의 `VirtualMachine`
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [MaxResults](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRecoveryPointsByBackupVault_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListRecoveryPointsByBackupVault_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRecoveryPointsByBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "AggregatedScanResult": { 
            "FailedScan": boolean,
            "Findings": [ "string" ],
            "LastComputed": number
         },
         "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",
         "SourceBackupVaultArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRecoveryPointsByBackupVault_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRecoveryPointsByBackupVault_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RecoveryPoints](#API_ListRecoveryPointsByBackupVault_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByBackupVault-response-RecoveryPoints"></a>
백업 저장소에 저장된 복구 시점에 대한 세부 정보가 포함된 객체 배열입니다.  
타입: [RecoveryPointByBackupVault](API_RecoveryPointByBackupVault.md) 객체 배열

## 오류
<a name="API_ListRecoveryPointsByBackupVault_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_ListRecoveryPointsByBackupVault_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByBackupVault) 

# ListRecoveryPointsByLegalHold
<a name="API_ListRecoveryPointsByLegalHold"></a>

이 작업은 지정된 법적 보존의 복구 시점 Amazon 리소스 이름(ARN)을 반환합니다.

## Request Syntax
<a name="API_ListRecoveryPointsByLegalHold_RequestSyntax"></a>

```
GET /legal-holds/legalHoldId/recovery-points?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRecoveryPointsByLegalHold_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [legalHoldId](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-LegalHoldId"></a>
법적 보존의 ID입니다.  
필수 항목 여부: 예

 ** [MaxResults](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRecoveryPointsByLegalHold_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-request-uri-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListRecoveryPointsByLegalHold_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRecoveryPointsByLegalHold_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupVaultName": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceType": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRecoveryPointsByLegalHold_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다.  
유형: 문자열

 ** [RecoveryPoints](#API_ListRecoveryPointsByLegalHold_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByLegalHold-response-RecoveryPoints"></a>
복구 시점입니다.  
타입: [RecoveryPointMember](API_RecoveryPointMember.md) 객체 배열

## 오류
<a name="API_ListRecoveryPointsByLegalHold_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListRecoveryPointsByLegalHold_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByLegalHold) 

# ListRecoveryPointsByResource
<a name="API_ListRecoveryPointsByResource"></a>

리소스 Amazon 리소스 이름(ARN)으로 지정된 유형의 모든 복구 시점에 대한 정보입니다.

**참고**  
Amazon EFS 및 Amazon EC2의 경우, 이 작업은 AWS Backup에서 생성한 복구 시점만 나열됩니다.

## Request Syntax
<a name="API_ListRecoveryPointsByResource_RequestSyntax"></a>

```
GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRecoveryPointsByResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ManagedByAWSBackupOnly](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-ManagedByAWSBackupOnly"></a>
이 속성은 소유권을 기반으로 복구 시점을 필터링합니다.  
이 속성을 `TRUE`로 설정하면, 응답은 AWS Backup에서 관리하는 선택된 리소스와 연결된 복구 시점이 포함합니다.  
이 속성을 `FALSE`로 설정하면, 응답은 선택된 리소스와 연결된 모든 복구 시점을 포함합니다.  
유형: Boolean

 ** [MaxResults](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
Amazon RDS에는 최소 20 이상의 값이 필요합니다.
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [resourceArn](#API_ListRecoveryPointsByResource_RequestSyntax) **   <a name="Backup-ListRecoveryPointsByResource-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 ARN입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
필수 항목 여부: 예

## Request Body
<a name="API_ListRecoveryPointsByResource_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRecoveryPointsByResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "AggregatedScanResult": { 
            "FailedScan": boolean,
            "Findings": [ "string" ],
            "LastComputed": number
         },
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "EncryptionKeyType": "string",
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRecoveryPointsByResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRecoveryPointsByResource_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByResource-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RecoveryPoints](#API_ListRecoveryPointsByResource_ResponseSyntax) **   <a name="Backup-ListRecoveryPointsByResource-response-RecoveryPoints"></a>
지정된 리소스 유형의 복구 시점에 대한 세부 정보가 포함된 객체 배열입니다.  
Amazon EFS 및 Amazon EC2 복구 시점만 BackupVaultName을 반환합니다.
타입: [RecoveryPointByResource](API_RecoveryPointByResource.md) 객체 배열

## 오류
<a name="API_ListRecoveryPointsByResource_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_ListRecoveryPointsByResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRecoveryPointsByResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRecoveryPointsByResource) 

# ListReportJobs
<a name="API_ListReportJobs"></a>

보고서 작업에 대한 세부 정보를 반환합니다.

## Request Syntax
<a name="API_ListReportJobs_RequestSyntax"></a>

```
GET /audit/report-jobs?CreationAfter=ByCreationAfter&CreationBefore=ByCreationBefore&MaxResults=MaxResults&NextToken=NextToken&ReportPlanName=ByReportPlanName&Status=ByStatus HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListReportJobs_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ByCreationAfter](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationAfter"></a>
Unix 형식 및 UTC(협정 세계시)로 지정된 날짜 및 시간 이후에 생성된 보고서 작업만 반환합니다. 예를 들어, 1516925490이라는 값은 2018년 1월 26일 금요일 오전 12:11:30을 나타냅니다.

 ** [ByCreationBefore](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationBefore"></a>
Unix 형식 및 UTC(협정 세계시)로 지정된 날짜 및 시간 이전에 생성된 보고서 작업만 반환합니다. 예를 들어, 1516925490이라는 값은 2018년 1월 26일 금요일 오전 12:11:30을 나타냅니다.

 ** [ByReportPlanName](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByReportPlanName"></a>
지정된 보고서 계획 이름을 가진 보고서 작업만 반환합니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*` 

 ** [ByStatus](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByStatus"></a>
지정된 상태에 있는 보고서 작업만 반환합니다. 상태는 다음과 같습니다.  
 `CREATED | RUNNING | COMPLETED | FAILED | COMPLETED_WITH_ISSUES`   
 스캔 작업만 문제와 함께 완료된 상태로 완료됩니다. 백업 작업의 경우 완료된 상태로 완료되고 상태 메시지가 있는 작업에 대한 콘솔 해석입니다.

 ** [MaxResults](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-MaxResults"></a>
원하는 결과 수는 1\$11,000입니다. 선택 사항. 지정하지 않으면 쿼리는 1MB 데이터를 반환합니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-NextToken"></a>
이 작업에 대한 이전 호출에서 반환된 식별자로, 목록의 다음 항목 집합을 반환하는 데 사용할 수 있습니다.

## Request Body
<a name="API_ListReportJobs_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListReportJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ReportJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "ReportDestination": { 
            "S3BucketName": "string",
            "S3Keys": [ "string" ]
         },
         "ReportJobId": "string",
         "ReportPlanArn": "string",
         "ReportTemplate": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListReportJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListReportJobs_ResponseSyntax) **   <a name="Backup-ListReportJobs-response-NextToken"></a>
이 작업에 대한 이전 호출에서 반환된 식별자로, 목록의 다음 항목 집합을 반환하는 데 사용할 수 있습니다.  
유형: 문자열

 ** [ReportJobs](#API_ListReportJobs_ResponseSyntax) **   <a name="Backup-ListReportJobs-response-ReportJobs"></a>
JSON 형식의 보고서 작업에 대한 세부 정보입니다.  
타입: [ReportJob](API_ReportJob.md) 객체 배열

## 오류
<a name="API_ListReportJobs_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListReportJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListReportJobs) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListReportJobs) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListReportJobs) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListReportJobs) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListReportJobs) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListReportJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListReportJobs) 

# ListReportPlans
<a name="API_ListReportPlans"></a>

보고서 계획 목록을 반환합니다. 단일 보고서 계획에 대한 자세한 내용은 `DescribeReportPlan` 섹션을 참조하세요.

## Request Syntax
<a name="API_ListReportPlans_RequestSyntax"></a>

```
GET /audit/report-plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListReportPlans_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListReportPlans_RequestSyntax) **   <a name="Backup-ListReportPlans-request-uri-MaxResults"></a>
원하는 결과 수는 1\$11,000입니다. 선택 사항. 지정하지 않으면 쿼리는 1MB 데이터를 반환합니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListReportPlans_RequestSyntax) **   <a name="Backup-ListReportPlans-request-uri-NextToken"></a>
이 작업에 대한 이전 호출에서 반환된 식별자로, 목록의 다음 항목 집합을 반환하는 데 사용할 수 있습니다.

## Request Body
<a name="API_ListReportPlans_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListReportPlans_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ReportPlans": [ 
      { 
         "CreationTime": number,
         "DeploymentStatus": "string",
         "LastAttemptedExecutionTime": number,
         "LastSuccessfulExecutionTime": number,
         "ReportDeliveryChannel": { 
            "Formats": [ "string" ],
            "S3BucketName": "string",
            "S3KeyPrefix": "string"
         },
         "ReportPlanArn": "string",
         "ReportPlanDescription": "string",
         "ReportPlanName": "string",
         "ReportSetting": { 
            "Accounts": [ "string" ],
            "FrameworkArns": [ "string" ],
            "NumberOfFrameworks": number,
            "OrganizationUnits": [ "string" ],
            "Regions": [ "string" ],
            "ReportTemplate": "string"
         }
      }
   ]
}
```

## 응답 요소
<a name="API_ListReportPlans_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListReportPlans_ResponseSyntax) **   <a name="Backup-ListReportPlans-response-NextToken"></a>
이 작업에 대한 이전 호출에서 반환된 식별자로, 목록의 다음 항목 집합을 반환하는 데 사용할 수 있습니다.  
유형: 문자열

 ** [ReportPlans](#API_ListReportPlans_ResponseSyntax) **   <a name="Backup-ListReportPlans-response-ReportPlans"></a>
각 계획에 대한 세부 정보가 포함된 보고서 계획입니다. 이 정보에는 Amazon 리소스 이름(ARN), 보고서 계획 이름, 설명, 설정, 전송 채널, 배포 상태, 생성 시간, 보고서 계획을 시도하고 성공적으로 실행한 마지막 시간이 포함됩니다.  
타입: [ReportPlan](API_ReportPlan.md) 객체 배열

## 오류
<a name="API_ListReportPlans_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListReportPlans_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListReportPlans) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListReportPlans) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListReportPlans) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListReportPlans) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListReportPlans) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListReportPlans) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListReportPlans) 

# ListRestoreAccessBackupVaults
<a name="API_ListRestoreAccessBackupVaults"></a>

지정된 백업 저장소와 연결된 복원 액세스 백업 저장소 목록을 반환합니다.

## Request Syntax
<a name="API_ListRestoreAccessBackupVaults_RequestSyntax"></a>

```
GET /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRestoreAccessBackupVaults_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-BackupVaultName"></a>
연결된 복원 액세스 백업 저장소를 나열할 백업 저장소의 이름입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [MaxResults](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-MaxResults"></a>
응답에서 반환할 총 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRestoreAccessBackupVaults_RequestSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-request-uri-NextToken"></a>
다음 번 결과 세트를 검색하기 위한 이전 요청의 페이지 매김 토큰입니다.

## Request Body
<a name="API_ListRestoreAccessBackupVaults_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRestoreAccessBackupVaults_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreAccessBackupVaults": [ 
      { 
         "ApprovalDate": number,
         "CreationDate": number,
         "LatestRevokeRequest": { 
            "ExpiryDate": number,
            "InitiationDate": number,
            "MpaSessionArn": "string",
            "Status": "string",
            "StatusMessage": "string"
         },
         "RestoreAccessBackupVaultArn": "string",
         "VaultState": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRestoreAccessBackupVaults_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-response-NextToken"></a>
후속 요청에서 다음 결과 세트를 검색하는 데 사용할 페이지 매김 토큰입니다.  
유형: 문자열

 ** [RestoreAccessBackupVaults](#API_ListRestoreAccessBackupVaults_ResponseSyntax) **   <a name="Backup-ListRestoreAccessBackupVaults-response-RestoreAccessBackupVaults"></a>
지정된 백업 저장소와 연결된 복원 액세스 백업 저장소의 목록입니다.  
타입: [RestoreAccessBackupVaultListMember](API_RestoreAccessBackupVaultListMember.md) 객체 배열

## 오류
<a name="API_ListRestoreAccessBackupVaults_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_ListRestoreAccessBackupVaults_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreAccessBackupVaults) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreAccessBackupVaults) 

# ListRestoreJobs
<a name="API_ListRestoreJobs"></a>

복구 프로세스에 대한 세부 정보를 포함하여 저장된 리소스를 복원하기 위해 AWS Backup 시작한 작업 목록을 반환합니다.

## Request Syntax
<a name="API_ListRestoreJobs_RequestSyntax"></a>

```
GET /restore-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentJobId=ByParentJobId&resourceType=ByResourceType&restoreTestingPlanArn=ByRestoreTestingPlanArn&status=ByStatus HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRestoreJobs_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ByAccountId](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByAccountId"></a>
작업을 나열할 계정 ID입니다. 지정된 계정 ID와 관련된 복원 작업만 반환합니다.  
패턴: `^[0-9]{12}$` 

 ** [ByCompleteAfter](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCompleteAfter"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이후에 완료된 복사 작업만 반환합니다.

 ** [ByCompleteBefore](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCompleteBefore"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이전에 완료된 복사 작업만 반환합니다.

 ** [ByCreatedAfter](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCreatedAfter"></a>
지정된 날짜 이후에 생성된 복원 작업만 반환합니다.

 ** [ByCreatedBefore](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByCreatedBefore"></a>
지정된 날짜 이전에 생성된 복원 작업만 반환합니다.

 ** [ByParentJobId](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByParentJobId"></a>
상위 복원 작업 ID를 기반으로 하위(중첩) 복원 작업을 나열하는 필터입니다.

 ** [ByResourceType](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByResourceType"></a>
지정된 리소스에 대한 복원 작업만 반환하려면 다음 파라미터를 포함하세요.  
+  Amazon Aurora의 `Aurora`
+  `CloudFormation`( AWS CloudFormation 일 때) 
+  Amazon DocumentDB(MongoDB 호환)의 `DocumentDB`
+  Amazon DynamoDB의 `DynamoDB`
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Elastic Compute Cloud의 `EC2`
+  Amazon Elastic File System의 `EFS`
+  Amazon Elastic Kubernetes Service용 `EKS`
+  Amazon FSx의 `FSx`
+  Amazon Neptune의 `Neptune`
+  Amazon Relational Database Service의 `RDS`
+  Amazon Redshift의 `Redshift`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
+  Amazon Elastic Compute Cloud 인스턴스에 대한 SAP HANA 데이터베이스의 `SAP HANA on Amazon EC2`
+  `Storage Gateway`( AWS Storage Gateway 일 때) 
+  Amazon Timestream의 `Timestream`
+  VMware 가상 머신의 `VirtualMachine`
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ByRestoreTestingPlanArn](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByRestoreTestingPlanArn"></a>
지정된 리소스의 Amazon 리소스 이름(ARN)과 일치하는 복원 테스트 작업만 반환합니다.

 ** [ByStatus](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-ByStatus"></a>
지정된 작업 상태와 관련된 복원 작업만 반환합니다.  
유효한 값: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [MaxResults](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRestoreJobs_RequestSyntax) **   <a name="Backup-ListRestoreJobs-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListRestoreJobs_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRestoreJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "IsParent": boolean,
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRestoreJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRestoreJobs_ResponseSyntax) **   <a name="Backup-ListRestoreJobs-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RestoreJobs](#API_ListRestoreJobs_ResponseSyntax) **   <a name="Backup-ListRestoreJobs-response-RestoreJobs"></a>
저장된 리소스를 복원하기 위한 작업에 대한 세부 정보가 포함된 객체 배열입니다.  
타입: [RestoreJobsListMember](API_RestoreJobsListMember.md) 객체 배열

## 오류
<a name="API_ListRestoreJobs_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_ListRestoreJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobs) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobs) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobs) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobs) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobs) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobs) 

# ListRestoreJobsByProtectedResource
<a name="API_ListRestoreJobsByProtectedResource"></a>

지정된 보호된 리소스가 포함되어 있는 복원 작업이 반환됩니다.

`ResourceArn`을 포함해야 합니다. 선택적으로 `NextToken`, `ByStatus`, `MaxResults`, `ByRecoveryPointCreationDateAfter` 및 `ByRecoveryPointCreationDateBefore`를 포함할 수 있습니다.

## Request Syntax
<a name="API_ListRestoreJobsByProtectedResource_RequestSyntax"></a>

```
GET /resources/resourceArn/restore-jobs/?maxResults=MaxResults&nextToken=NextToken&recoveryPointCreationDateAfter=ByRecoveryPointCreationDateAfter&recoveryPointCreationDateBefore=ByRecoveryPointCreationDateBefore&status=ByStatus HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRestoreJobsByProtectedResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ByRecoveryPointCreationDateAfter](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByRecoveryPointCreationDateAfter"></a>
지정된 날짜 후에 생성된 복구 시점의 복원 작업만 반환합니다.

 ** [ByRecoveryPointCreationDateBefore](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByRecoveryPointCreationDateBefore"></a>
지정된 날짜 전에 생성된 복구 시점의 복원 작업만 반환합니다.

 ** [ByStatus](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ByStatus"></a>
지정된 작업 상태와 관련된 복원 작업만 반환합니다.  
유효한 값: `PENDING | RUNNING | COMPLETED | ABORTED | FAILED` 

 ** [MaxResults](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [resourceArn](#API_ListRestoreJobsByProtectedResource_RequestSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-request-uri-ResourceArn"></a>
지정된 리소스의 Amazon 리소스 이름(ARN)과 일치하는 복원 작업만 반환합니다.  
필수 항목 여부: 예

## Request Body
<a name="API_ListRestoreJobsByProtectedResource_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRestoreJobsByProtectedResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "RestoreTestingPlanArn": "string"
         },
         "CreatedResourceArn": "string",
         "CreationDate": number,
         "DeletionStatus": "string",
         "DeletionStatusMessage": "string",
         "ExpectedCompletionTimeMinutes": number,
         "IamRoleArn": "string",
         "IsParent": boolean,
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointCreationDate": number,
         "ResourceType": "string",
         "RestoreJobId": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "ValidationStatus": "string",
         "ValidationStatusMessage": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRestoreJobsByProtectedResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRestoreJobsByProtectedResource_ResponseSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RestoreJobs](#API_ListRestoreJobsByProtectedResource_ResponseSyntax) **   <a name="Backup-ListRestoreJobsByProtectedResource-response-RestoreJobs"></a>
저장된 리소스를 복원하기 위한 작업에 대한 세부 정보가 포함된 객체 배열입니다.  
타입: [RestoreJobsListMember](API_RestoreJobsListMember.md) 객체 배열

## 오류
<a name="API_ListRestoreJobsByProtectedResource_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_ListRestoreJobsByProtectedResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobsByProtectedResource) 

# ListRestoreJobSummaries
<a name="API_ListRestoreJobSummaries"></a>

이 요청은 최근 30일 이내에 생성되거나 실행된 복원 작업의 요약을 가져옵니다. AccountID, State, ResourceType, AggregationPeriod, MaxResults 또는 NextToken 파라미터를 포함하여 결과를 필터링할 수 있습니다.

이 요청은 포함된 작업의 Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, Count를 포함하는 요약을 반환합니다.

## Request Syntax
<a name="API_ListRestoreJobSummaries_RequestSyntax"></a>

```
GET /audit/restore-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRestoreJobSummaries_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [AccountId](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-AccountId"></a>
지정된 계정의 작업 수를 반환합니다.  
요청이 멤버 계정 또는 AWS Organizations에 속하지 않은 계정에서 전송되는 경우 요청자의 계정 내 작업이 반환됩니다.  
루트, 관리자 및 위임된 관리자 계정은 ANY 값을 사용하여 조직 내 모든 계정의 작업 수를 반환할 수 있습니다.  
 `AGGREGATE_ALL`은 인증된 조직 내 모든 계정의 작업 수를 집계한 다음 합계를 반환합니다.  
패턴: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY` - 지난 14일 동안의 일별 작업 수
+  `SEVEN_DAYS` - 지난 7일 동안의 집계된 작업 수
+  `FOURTEEN_DAYS` - 지난 14일 동안의 집계된 작업 수
유효한 값: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MaxResults](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-MaxResults"></a>
이 파라미터는 반환할 항목의 최대 수를 설정합니다.  
값은 정수입니다. 허용되는 값 범위는 1에서 500까지입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [ResourceType](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-ResourceType"></a>
지정된 리소스 유형에 대한 작업 수를 반환합니다. `GetSupportedResourceTypes` 요청을 사용하여 지원되는 리소스 유형의 문자열을 가져옵니다.  
ANY 값은 모든 리소스 유형의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 리소스 유형의 작업 수를 집계하고 그 합계를 반환합니다.  
백업할 AWS 리소스 유형. 예: Amazon Elastic Block Store(Amazon EBS) 볼륨 또는 Amazon Relational Database Service(Amazon RDS) 데이터베이스.  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [State](#API_ListRestoreJobSummaries_RequestSyntax) **   <a name="Backup-ListRestoreJobSummaries-request-uri-State"></a>
이 파라미터는 지정된 상태의 작업 수를 반환합니다.  
ANY 값은 모든 상태의 개수를 반환합니다.  
 `AGGREGATE_ALL`은 모든 상태의 작업 수를 집계하고 그 합계를 반환합니다.  
유효한 값: `CREATED | PENDING | RUNNING | ABORTED | COMPLETED | FAILED | AGGREGATE_ALL | ANY` 

## Request Body
<a name="API_ListRestoreJobSummaries_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRestoreJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "RestoreJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "Region": "string",
         "ResourceType": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListRestoreJobSummaries_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AggregationPeriod](#API_ListRestoreJobSummaries_ResponseSyntax) **   <a name="Backup-ListRestoreJobSummaries-response-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY` - 지난 14일 동안의 일별 작업 수
+  `SEVEN_DAYS` - 지난 7일 동안의 집계된 작업 수
+  `FOURTEEN_DAYS` - 지난 14일 동안의 집계된 작업 수
유형: 문자열

 ** [NextToken](#API_ListRestoreJobSummaries_ResponseSyntax) **   <a name="Backup-ListRestoreJobSummaries-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RestoreJobSummaries](#API_ListRestoreJobSummaries_ResponseSyntax) **   <a name="Backup-ListRestoreJobSummaries-response-RestoreJobSummaries"></a>
반환된 값에는 포함된 작업의 Region, Account, State, ResourceType, MessageCategory, StartTime, EndTime, Count를 포함하는 요약이 포함되어 있습니다.  
타입: [RestoreJobSummary](API_RestoreJobSummary.md) 객체 배열

## 오류
<a name="API_ListRestoreJobSummaries_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListRestoreJobSummaries_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreJobSummaries) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreJobSummaries) 

# ListRestoreTestingPlans
<a name="API_ListRestoreTestingPlans"></a>

복원 테스트 계획의 목록을 반환합니다.

## Request Syntax
<a name="API_ListRestoreTestingPlans_RequestSyntax"></a>

```
GET /restore-testing/plans?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRestoreTestingPlans_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListRestoreTestingPlans_RequestSyntax) **   <a name="Backup-ListRestoreTestingPlans-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRestoreTestingPlans_RequestSyntax) **   <a name="Backup-ListRestoreTestingPlans-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 nexttoken이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListRestoreTestingPlans_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRestoreTestingPlans_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreTestingPlans": [ 
      { 
         "CreationTime": number,
         "LastExecutionTime": number,
         "LastUpdateTime": number,
         "RestoreTestingPlanArn": "string",
         "RestoreTestingPlanName": "string",
         "ScheduleExpression": "string",
         "ScheduleExpressionTimezone": "string",
         "StartWindowHours": number
      }
   ]
}
```

## 응답 요소
<a name="API_ListRestoreTestingPlans_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRestoreTestingPlans_ResponseSyntax) **   <a name="Backup-ListRestoreTestingPlans-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 nexttoken이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RestoreTestingPlans](#API_ListRestoreTestingPlans_ResponseSyntax) **   <a name="Backup-ListRestoreTestingPlans-response-RestoreTestingPlans"></a>
반환된 복원 테스트 계획 목록입니다.  
타입: [RestoreTestingPlanForList](API_RestoreTestingPlanForList.md) 객체 배열

## 오류
<a name="API_ListRestoreTestingPlans_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListRestoreTestingPlans_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreTestingPlans) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreTestingPlans) 

# ListRestoreTestingSelections
<a name="API_ListRestoreTestingSelections"></a>

복원 테스트 선택 항목의 목록을 반환합니다. `MaxResults` 및 `RestoreTestingPlanName`을 기준으로 필터링할 수 있습니다.

## Request Syntax
<a name="API_ListRestoreTestingSelections_RequestSyntax"></a>

```
GET /restore-testing/plans/RestoreTestingPlanName/selections?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListRestoreTestingSelections_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 nexttoken이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [RestoreTestingPlanName](#API_ListRestoreTestingSelections_RequestSyntax) **   <a name="Backup-ListRestoreTestingSelections-request-uri-RestoreTestingPlanName"></a>
지정된 복원 테스트 계획 이름을 기준으로 복원 테스트 선택 항목을 반환합니다.  
필수 항목 여부: 예

## Request Body
<a name="API_ListRestoreTestingSelections_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListRestoreTestingSelections_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RestoreTestingSelections": [ 
      { 
         "CreationTime": number,
         "IamRoleArn": "string",
         "ProtectedResourceType": "string",
         "RestoreTestingPlanName": "string",
         "RestoreTestingSelectionName": "string",
         "ValidationWindowHours": number
      }
   ]
}
```

## 응답 요소
<a name="API_ListRestoreTestingSelections_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListRestoreTestingSelections_ResponseSyntax) **   <a name="Backup-ListRestoreTestingSelections-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 nexttoken이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [RestoreTestingSelections](#API_ListRestoreTestingSelections_ResponseSyntax) **   <a name="Backup-ListRestoreTestingSelections-response-RestoreTestingSelections"></a>
복원 테스트 계획과 연결된 반환된 복원 테스트 선택 항목입니다.  
타입: [RestoreTestingSelectionForList](API_RestoreTestingSelectionForList.md) 객체 배열

## 오류
<a name="API_ListRestoreTestingSelections_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListRestoreTestingSelections_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListRestoreTestingSelections) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListRestoreTestingSelections) 

# ListScanJobs
<a name="API_ListScanJobs"></a>

지난 30일 동안 인증된 계정에 대한 기존 스캔 작업 목록을 반환합니다.

## Request Syntax
<a name="API_ListScanJobs_RequestSyntax"></a>

```
GET /scan/jobs?ByAccountId=ByAccountId&ByBackupVaultName=ByBackupVaultName&ByCompleteAfter=ByCompleteAfter&ByCompleteBefore=ByCompleteBefore&ByMalwareScanner=ByMalwareScanner&ByRecoveryPointArn=ByRecoveryPointArn&ByResourceArn=ByResourceArn&ByResourceType=ByResourceType&ByScanResultStatus=ByScanResultStatus&ByState=ByState&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListScanJobs_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ByAccountId](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByAccountId"></a>
작업을 나열할 계정 ID입니다. 지정된 계정 ID와 관련된 백업 작업만 반환합니다.  
 AWS Organizations 관리 계정에서 사용하는 경우를 전달하면 조직 전체의 모든 작업이 `*` 반환됩니다.  
패턴: `^[0-9]{12}$` 

 ** [ByBackupVaultName](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByBackupVaultName"></a>
지정된 백업 볼트에 저장될 스캔 작업만 반환합니다. 백업 저장소는 백업 저장소를 생성하는 데 사용된 계정과 백업 저장소가 생성된 AWS 리전에 고유한 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_\.]{2,50}$` 

 ** [ByCompleteAfter](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteAfter"></a>
Unix 형식 및 협정 세계시(UTC)로 표현된 날짜 이후에 완료된 스캔 작업만 반환합니다.

 ** [ByCompleteBefore](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteBefore"></a>
Unix 형식 및 협정 세계시(UTC)로 표시된 날짜 이전에 완료된 백업 작업만 반환합니다.

 ** [ByMalwareScanner](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByMalwareScanner"></a>
지정된 맬웨어 스캐너에 대한 스캔 작업만 반환합니다. 현재 `GUARDDUTY`만 지원됩니다.  
유효한 값: `GUARDDUTY` 

 ** [ByRecoveryPointArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByRecoveryPointArn"></a>
지정된 복구 시점에 대해 실행된 스캔 작업만 반환합니다.

 ** [ByResourceArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceArn"></a>
지정된 리소스 Amazon 리소스 이름(ARN)과 일치하는 스캔 작업만 반환합니다.

 ** [ByResourceType](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceType"></a>
지정된 복원 테스트 계획 이름을 기준으로 복원 테스트 선택 항목을 반환합니다.  
+  `EBS`Amazon Elastic Block Store용
+  `EC2`Amazon Elastic Compute Cloud용
+  `S3`Amazon Simple Storage Service(Amazon S3)용
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
유효한 값: `EBS | EC2 | S3` 

 ** [ByScanResultStatus](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByScanResultStatus"></a>
지정된 스캔 결과에 대한 스캔 작업만 반환합니다.  
+  `THREATS_FOUND` 
+  `NO_THREATS_FOUND` 
유효한 값: `NO_THREATS_FOUND | THREATS_FOUND` 

 ** [ByState](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByState"></a>
지정된 스캔 작업 상태에 대한 스캔 작업만 반환합니다.  
유효한 값: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [MaxResults](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListScanJobs_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListScanJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ScanJobs": [ 
      { 
         "AccountId": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "IamRoleArn": "string",
         "MalwareScanner": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "ScanBaseRecoveryPointArn": "string",
         "ScanId": "string",
         "ScanJobId": "string",
         "ScanMode": "string",
         "ScannerRoleArn": "string",
         "ScanResult": { 
            "ScanResultStatus": "string"
         },
         "State": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListScanJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListScanJobs_ResponseSyntax) **   <a name="Backup-ListScanJobs-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [ScanJobs](#API_ListScanJobs_ResponseSyntax) **   <a name="Backup-ListScanJobs-response-ScanJobs"></a>
JSON 형식으로 반환된 스캔 작업에 대한 메타데이터를 포함하는 구조 배열입니다.  
타입: [ScanJob](API_ScanJob.md) 객체 배열

## 오류
<a name="API_ListScanJobs_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListScanJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobs) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobs) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobs) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobs) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobs) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobs) 

# ListScanJobSummaries
<a name="API_ListScanJobSummaries"></a>

이는 최근 30일 이내에 생성되거나 실행된 스캔 작업의 요약에 대한 요청입니다.

## Request Syntax
<a name="API_ListScanJobSummaries_RequestSyntax"></a>

```
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListScanJobSummaries_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [AccountId](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AccountId"></a>
지정된 계정의 작업 수를 반환합니다.  
요청이 멤버 계정 또는 AWS Organizations에 속하지 않은 계정에서 전송되는 경우 요청자의 계정 내 작업이 반환됩니다.  
루트, 관리자 및 위임된 관리자 계정은 값을 사용하여 조직의 모든 계정에서 작업 수를 반환`ANY`할 수 있습니다.  
 `AGGREGATE_ALL`은 인증된 조직 내 모든 계정의 작업 수를 집계한 다음 합계를 반환합니다.  
패턴: `^[0-9]{12}$` 

 ** [AggregationPeriod](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY`이전 1일 동안의 일일 작업 수입니다.
+  `SEVEN_DAYS`이전 7일 동안의 일일 작업 수입니다.
+  `FOURTEEN_DAYS`지난 14일 동안의 일일 작업 수입니다.
유효한 값: `ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS` 

 ** [MalwareScanner](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-MalwareScanner"></a>
지정된 맬웨어 스캐너에 대한 스캔 작업만 반환합니다. 현재 유일한 MalwareScanner는 입니다`GUARDDUTY`. 그러나 필드는 `ANY`, 및 도 지원합니다`AGGREGATE_ALL`.  
유효한 값: `GUARDDUTY` 

 ** [MaxResults](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
값은 정수입니다. 허용되는 값 범위는 1에서 500까지입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [ResourceType](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-ResourceType"></a>
지정된 리소스 유형에 대한 작업 수를 반환합니다. `GetSupportedResourceTypes` 요청을 사용하여 지원되는 리소스 유형의 문자열을 가져옵니다.  
이 값은 모든 리소스 유형의 개수를 `ANY` 반환합니다.  
 `AGGREGATE_ALL`은 모든 리소스 유형의 작업 수를 집계하고 그 합계를 반환합니다.  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ScanResultStatus](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-ScanResultStatus"></a>
지정된 스캔 결과에 대한 스캔 작업만 반환합니다.  
유효한 값: `NO_THREATS_FOUND | THREATS_FOUND` 

 ** [State](#API_ListScanJobSummaries_RequestSyntax) **   <a name="Backup-ListScanJobSummaries-request-uri-State"></a>
지정된 스캔 작업 상태에 대한 스캔 작업만 반환합니다.  
유효한 값: `CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY` 

## Request Body
<a name="API_ListScanJobSummaries_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListScanJobSummaries_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AggregationPeriod": "string",
   "NextToken": "string",
   "ScanJobSummaries": [ 
      { 
         "AccountId": "string",
         "Count": number,
         "EndTime": number,
         "MalwareScanner": "string",
         "Region": "string",
         "ResourceType": "string",
         "ScanResultStatus": "string",
         "StartTime": number,
         "State": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListScanJobSummaries_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AggregationPeriod](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-AggregationPeriod"></a>
반환된 결과의 기간입니다.  
+  `ONE_DAY`이전 1일 동안의 일일 작업 수입니다.
+  `SEVEN_DAYS`이전 7일 동안의 일일 작업 수입니다.
+  `FOURTEEN_DAYS`지난 14일 동안의 일일 작업 수입니다.
유효한 값: `'ONE_DAY'` \$1 `'SEVEN_DAYS'` \$1 `'FOURTEEN_DAYS'`   
유형: 문자열

 ** [NextToken](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [ScanJobSummaries](#API_ListScanJobSummaries_ResponseSyntax) **   <a name="Backup-ListScanJobSummaries-response-ScanJobSummaries"></a>
요약 정보  
타입: [ScanJobSummary](API_ScanJobSummary.md) 객체 배열

## 오류
<a name="API_ListScanJobSummaries_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListScanJobSummaries_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobSummaries) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobSummaries) 

# ListTags
<a name="API_ListTags"></a>

대상 복구 시점, 백업 계획 또는 백업 저장소와 같이 리소스에 할당된 태그를 반환합니다.

이 작업은 `resourceArn`의 값에 사용된 리소스 유형에 따라 결과를 반환합니다. 예를 들어 고급 설정을 사용하는 Amazon DynamoDB의 복구 시점에는 `arn:aws:backup`로 시작하는 ARN(Amazon 리소스 이름)이 있습니다. 고급 설정이 활성화되지 않은 DynamoDB의 복구 시점(백업)에는 `arn:aws:dynamodb`로 시작하는 ARN이 있습니다.

이 작업을 호출하고 `arn:aws:backup` 이외의 ARN이 있는 `resourceArn`의 값을 포함하면 아래 나열된 예외 중 하나가 반환될 수 있습니다. 이 예외를 방지하려면 AWS Backup에서 완전히 관리되는 리소스 유형을 나타내는 값만 포함합니다. 이러한 리소스는 `arn:aws:backup`로 시작하는 ARN을 가지고 있으며 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 표에 기록됩니다.

## Request Syntax
<a name="API_ListTags_RequestSyntax"></a>

```
GET /tags/resourceArn/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListTags_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [resourceArn](#API_ListTags_RequestSyntax) **   <a name="Backup-ListTags-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다. `ListTags`의 유효한 대상은 복구 시점, 백업 계획, 백업 저장소입니다.  
필수 항목 여부: 예

## Request Body
<a name="API_ListTags_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListTags_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## 응답 요소
<a name="API_ListTags_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListTags_ResponseSyntax) **   <a name="Backup-ListTags-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [Tags](#API_ListTags_ResponseSyntax) **   <a name="Backup-ListTags-response-Tags"></a>
태그에 대한 정보입니다.  
유형: 문자열 간 맵

## 오류
<a name="API_ListTags_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_ListTags_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListTags) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListTags) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListTags) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListTags) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListTags) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListTags) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListTags) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListTags) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListTags) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListTags) 

# ListTieringConfigurations
<a name="API_ListTieringConfigurations"></a>

계층화 구성 목록을 반환합니다.

## Request Syntax
<a name="API_ListTieringConfigurations_RequestSyntax"></a>

```
GET /tiering-configurations/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_ListTieringConfigurations_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_ListTieringConfigurations_RequestSyntax) **   <a name="Backup-ListTieringConfigurations-request-uri-MaxResults"></a>
반환할 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_ListTieringConfigurations_RequestSyntax) **   <a name="Backup-ListTieringConfigurations-request-uri-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_ListTieringConfigurations_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_ListTieringConfigurations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "TieringConfigurations": [ 
      { 
         "BackupVaultName": "string",
         "CreationTime": number,
         "LastUpdatedTime": number,
         "TieringConfigurationArn": "string",
         "TieringConfigurationName": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_ListTieringConfigurations_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_ListTieringConfigurations_ResponseSyntax) **   <a name="Backup-ListTieringConfigurations-response-NextToken"></a>
반환된 항목의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 항목의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [TieringConfigurations](#API_ListTieringConfigurations_ResponseSyntax) **   <a name="Backup-ListTieringConfigurations-response-TieringConfigurations"></a>
`ListTieringConfigurations` 호출에 의해 반환되는 계층화 구성의 배열입니다.  
타입: [TieringConfigurationsListMember](API_TieringConfigurationsListMember.md) 객체 배열

## 오류
<a name="API_ListTieringConfigurations_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_ListTieringConfigurations_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListTieringConfigurations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListTieringConfigurations) 

# PutBackupVaultAccessPolicy
<a name="API_PutBackupVaultAccessPolicy"></a>

대상 백업 저장소에 대한 액세스 권한을 관리하는 데 사용되는 리소스 기반 정책을 설정합니다. 백업 저장소 이름과 JSON 형식의 액세스 정책 문서가 필요합니다.

## Request Syntax
<a name="API_PutBackupVaultAccessPolicy_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/access-policy HTTP/1.1
Content-type: application/json

{
   "Policy": "string"
}
```

## URI 요청 파라미터
<a name="API_PutBackupVaultAccessPolicy_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_PutBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-PutBackupVaultAccessPolicy-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

## 요청 본문
<a name="API_PutBackupVaultAccessPolicy_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Policy](#API_PutBackupVaultAccessPolicy_RequestSyntax) **   <a name="Backup-PutBackupVaultAccessPolicy-request-Policy"></a>
JSON 형식의 백업 저장소 액세스 정책 문서입니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_PutBackupVaultAccessPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutBackupVaultAccessPolicy_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutBackupVaultAccessPolicy_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_PutBackupVaultAccessPolicy_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultAccessPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultAccessPolicy) 

# PutBackupVaultLockConfiguration
<a name="API_PutBackupVaultLockConfiguration"></a>

백업 볼트에 AWS Backup 볼트 잠금을 적용하여 백업 볼트에 저장되거나 생성된 복구 시점을 삭제하려는 시도를 방지합니다. 또한 저장소 잠금은 현재 백업 저장소에 저장된 복구 시점의 보존 기간을 제어하는 수명 주기 정책을 업데이트하려는 시도를 방지합니다. 지정된 경우, 저장소 잠금은 백업 저장소를 대상으로 하는 향후 백업 및 복사 작업에 최소 및 최대 보존 기간을 적용합니다.

**참고**  
 AWS Backup 볼트 잠금은 SEC 17a-4, CFTC 및 FINRA 규정이 적용되는 환경에서 사용하기 위해 Cohasset Associates에서 평가되었습니다. AWS Backup 볼트 잠금이 이러한 규정과 어떤 관련이 있는지에 대한 자세한 내용은 [Cohasset Associates 규정 준수 평가를 참조하세요.](https://docs.aws.amazon.com/aws-backup/latest/devguide/samples/cohassetreport.zip)

자세한 내용은 [AWS Backup Vault Lock](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html)을 참조하세요.

## Request Syntax
<a name="API_PutBackupVaultLockConfiguration_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/vault-lock HTTP/1.1
Content-type: application/json

{
   "ChangeableForDays": number,
   "MaxRetentionDays": number,
   "MinRetentionDays": number
}
```

## URI 요청 파라미터
<a name="API_PutBackupVaultLockConfiguration_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-uri-BackupVaultName"></a>
보호하는 백업 AWS Backup 볼트의 이름을 지정하는 볼트 잠금 구성입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

## 요청 본문
<a name="API_PutBackupVaultLockConfiguration_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ChangeableForDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-ChangeableForDays"></a>
잠금 날짜 이전의 일수를 지정하는 AWS Backup 볼트 잠금 구성입니다. 예를 들어, 2022년 1월 1일 오후 8시 UTC에 `ChangeableForDays`를 30으로 설정하면 잠금 날짜가 2022년 1월 31일 오후 8시 UTC로 설정됩니다.  
 AWS Backup 는 볼트 잠금이 적용되어 변경할 수 없게 되기 전에 72시간의 쿨링 오프 기간을 적용합니다. 따라서 `ChangeableForDays`를 3 이상으로 설정해야 합니다.  
지정할 수 있는 최대값은 36,500일(약 100년)입니다.  
잠금 날짜 이전에 `DeleteBackupVaultLockConfiguration`을 사용하여 저장소에서 저장소 잠금을 삭제하거나 `PutBackupVaultLockConfiguration`을 사용하여 저장소 잠금 구성을 변경할 수 있습니다. 잠금 날짜 이후에는 저장소 잠금이 변경 불가능 상태가 되고 변경하거나 삭제할 수 없습니다.  
이 파라미터가 지정되지 않으면 `DeleteBackupVaultLockConfiguration`을 사용하여 저장소에서 저장소 잠금을 삭제하거나 언제든지 `PutBackupVaultLockConfiguration`을 사용하여 저장소 잠금 구성을 변경할 수 있습니다.  
유형: Long  
필수 여부: 아니요

 ** [MaxRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-MaxRetentionDays"></a>
 AWS Backup 볼트가 복구 시점을 유지하는 최대 보존 기간을 지정하는 볼트 잠금 구성입니다. 이 설정은 예를 들어, 조직의 정책에 따라 특정 데이터를 4년(1,460일) 동안 보관한 후 폐기해야 하는 경우에 유용할 수 있습니다.  
이 파라미터가 포함되지 않으면 저장소 잠금은 저장소의 복구 시점에 최대 보존 기간을 적용하지 않습니다. 이 파라미터가 값 없이 포함되면 저장소 잠금은 최대 보존 기간을 적용하지 않습니다.  
이 파라미터가 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최대 보존 기간보다 짧거나 같은 수명 주기 정책이 있어야 합니다. 작업의 보존 기간이 최대 보존 기간보다 길면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다. 지정할 수 있는 최대 보존 기간은 36,500일(약 100년)입니다. 저장소 잠금 이전에 저장소에 이미 저장된 복구 지점은 영향을 받지 않습니다.  
유형: Long  
필수 여부: 아니요

 ** [MinRetentionDays](#API_PutBackupVaultLockConfiguration_RequestSyntax) **   <a name="Backup-PutBackupVaultLockConfiguration-request-MinRetentionDays"></a>
 AWS Backup 볼트가 복구 시점을 유지하는 최소 보존 기간을 지정하는 볼트 잠금 구성입니다. 이 설정은 예를 들어, 조직의 정책에 따라 특정 데이터를 7년(2,555일) 이상 유지해야 하는 경우에 유용할 수 있습니다.  
이 파라미터는 볼트 잠금이 생성될 때 필요합니다. 그렇지 AWS CloudFormation않으면이 파라미터는 선택 사항입니다. 이 파라미터가 지정되지 않으면 저장소 잠금이 최소 보존 기간을 적용하지 않습니다.  
이 파라미터가 지정되면 저장소에 대한 모든 백업 또는 복사 작업에 보존 기간이 최소 보존 기간보다 길거나 같은 수명 주기 정책이 있어야 합니다. 작업의 보존 기간이 최소 보존 기간보다 짧으면 저장소가 백업 또는 복사 작업에 실패하므로 수명 주기 설정을 수정하거나 다른 저장소를 사용해야 합니다. 지정할 수 있는 가장 짧은 최소 보존 기간은 1일입니다. 저장소 잠금 이전에 저장소에 이미 저장된 복구 지점은 영향을 받지 않습니다.  
유형: Long  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_PutBackupVaultLockConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutBackupVaultLockConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutBackupVaultLockConfiguration_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_PutBackupVaultLockConfiguration_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultLockConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultLockConfiguration) 

# PutBackupVaultNotifications
<a name="API_PutBackupVaultNotifications"></a>

지정된 주제 및 이벤트에 대한 알림을 백업 저장소에서 켭니다.

## Request Syntax
<a name="API_PutBackupVaultNotifications_RequestSyntax"></a>

```
PUT /backup-vaults/backupVaultName/notification-configuration HTTP/1.1
Content-type: application/json

{
   "BackupVaultEvents": [ "string" ],
   "SNSTopicArn": "string"
}
```

## URI 요청 파라미터
<a name="API_PutBackupVaultNotifications_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

## 요청 본문
<a name="API_PutBackupVaultNotifications_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupVaultEvents](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-BackupVaultEvents"></a>
백업 저장소에 리소스를 백업할 작업의 상태를 나타내는 이벤트 어레이입니다. 지원되는 이벤트, 일반적인 사용 사례 및 코드 샘플 목록은 [를 사용한 알림 옵션을 AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-notifications.html) 참조하세요.  
아래 목록에는 지원되는 이벤트와 더 이상 사용되지 않는 사용 중단된 이벤트(참조용)가 모두 포함되어 있습니다. 사용 중단된 이벤트는 상태 또는 알림을 반환하지 않습니다.
유형: 문자열 배열  
유효한 값: `BACKUP_JOB_STARTED | BACKUP_JOB_COMPLETED | BACKUP_JOB_SUCCESSFUL | BACKUP_JOB_FAILED | BACKUP_JOB_EXPIRED | RESTORE_JOB_STARTED | RESTORE_JOB_COMPLETED | RESTORE_JOB_SUCCESSFUL | RESTORE_JOB_FAILED | COPY_JOB_STARTED | COPY_JOB_SUCCESSFUL | COPY_JOB_FAILED | RECOVERY_POINT_MODIFIED | BACKUP_PLAN_CREATED | BACKUP_PLAN_MODIFIED | S3_BACKUP_OBJECT_FAILED | S3_RESTORE_OBJECT_FAILED | CONTINUOUS_BACKUP_INTERRUPTED | RECOVERY_POINT_INDEX_COMPLETED | RECOVERY_POINT_INDEX_DELETED | RECOVERY_POINT_INDEXING_FAILED`   
필수 사항 여부: 예

 ** [SNSTopicArn](#API_PutBackupVaultNotifications_RequestSyntax) **   <a name="Backup-PutBackupVaultNotifications-request-SNSTopicArn"></a>
백업 저장소의 이벤트 주제를 지정하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:sns:us-west-2:111122223333:MyVaultTopic`).  
유형: 문자열  
필수 항목 여부: 예

## 응답 구문
<a name="API_PutBackupVaultNotifications_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_PutBackupVaultNotifications_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_PutBackupVaultNotifications_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_PutBackupVaultNotifications_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutBackupVaultNotifications) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutBackupVaultNotifications) 

# PutRestoreValidationResult
<a name="API_PutRestoreValidationResult"></a>

이 요청을 통해 독립적인 자체 실행 복원 테스트 검증 결과를 전송할 수 있습니다. `RestoreJobId` 및 `ValidationStatus`는 필수입니다. 선택적으로 `ValidationStatusMessage`를 입력할 수 있습니다.

## Request Syntax
<a name="API_PutRestoreValidationResult_RequestSyntax"></a>

```
PUT /restore-jobs/restoreJobId/validations HTTP/1.1
Content-type: application/json

{
   "ValidationStatus": "string",
   "ValidationStatusMessage": "string"
}
```

## URI 요청 파라미터
<a name="API_PutRestoreValidationResult_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [restoreJobId](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-uri-RestoreJobId"></a>
복원 작업의 고유 식별자입니다 AWS Backup.  
필수 항목 여부: 예

## 요청 본문
<a name="API_PutRestoreValidationResult_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ValidationStatus](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-ValidationStatus"></a>
복원 검증의 상태입니다.  
타입: 문자열  
유효 값: `FAILED | SUCCESSFUL | TIMED_OUT | VALIDATING`   
필수 사항 여부: 예

 ** [ValidationStatusMessage](#API_PutRestoreValidationResult_RequestSyntax) **   <a name="Backup-PutRestoreValidationResult-request-ValidationStatusMessage"></a>
복원 테스트 검증의 검증 상태를 설명하기 위해 입력할 수 있는 선택적 메시지 문자열입니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_PutRestoreValidationResult_ResponseSyntax"></a>

```
HTTP/1.1 204
```

## Response Elements
<a name="API_PutRestoreValidationResult_ResponseElements"></a>

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

## 오류
<a name="API_PutRestoreValidationResult_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_PutRestoreValidationResult_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/PutRestoreValidationResult) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/PutRestoreValidationResult) 

# RevokeRestoreAccessBackupVault
<a name="API_RevokeRestoreAccessBackupVault"></a>

복원 액세스 백업 저장소에 대한 액세스를 취소하여 복구 시점에서 복원할 수 있는 기능을 제거하고 저장소를 영구적으로 삭제합니다.

## Request Syntax
<a name="API_RevokeRestoreAccessBackupVault_RequestSyntax"></a>

```
DELETE /logically-air-gapped-backup-vaults/backupVaultName/restore-access-backup-vaults/restoreAccessBackupVaultArn?requesterComment=RequesterComment HTTP/1.1
```

## URI 요청 파라미터
<a name="API_RevokeRestoreAccessBackupVault_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-BackupVaultName"></a>
취소할 복원 액세스 백업 저장소와 연결된 소스 백업 저장소의 이름입니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [RequesterComment](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-RequesterComment"></a>
복원 액세스 백업 저장소에 대한 액세스를 취소하는 이유를 설명하는 코멘트입니다.

 ** [restoreAccessBackupVaultArn](#API_RevokeRestoreAccessBackupVault_RequestSyntax) **   <a name="Backup-RevokeRestoreAccessBackupVault-request-uri-RestoreAccessBackupVaultArn"></a>
취소할 복원 액세스 백업 저장소의 ARN입니다.  
필수 항목 여부: 예

## Request Body
<a name="API_RevokeRestoreAccessBackupVault_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_RevokeRestoreAccessBackupVault_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_RevokeRestoreAccessBackupVault_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_RevokeRestoreAccessBackupVault_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_RevokeRestoreAccessBackupVault_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/RevokeRestoreAccessBackupVault) 

# StartBackupJob
<a name="API_StartBackupJob"></a>

지정한 리소스에 대한 온디맨드 백업 작업을 시작합니다.

## Request Syntax
<a name="API_StartBackupJob_RequestSyntax"></a>

```
PUT /backup-jobs HTTP/1.1
Content-type: application/json

{
   "BackupOptions": { 
      "string" : "string" 
   },
   "BackupVaultName": "string",
   "CompleteWindowMinutes": number,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Index": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "LogicallyAirGappedBackupVaultArn": "string",
   "RecoveryPointTags": { 
      "string" : "string" 
   },
   "ResourceArn": "string",
   "StartWindowMinutes": number
}
```

## URI 요청 파라미터
<a name="API_StartBackupJob_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartBackupJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupOptions](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupOptions"></a>
선택한 리소스에 대한 백업 옵션입니다. 이 옵션은 Windows VSS(Volume Shadow Copy Service) 백업 작업에만 사용할 수 있습니다.  
유효한 값: `WindowsVSS` 백업 옵션을 활성화하고 Windows VSS 백업을 생성하려면 `"WindowsVSS":"enabled"`로 설정합니다. 정기 백업을 생성하려면 `"WindowsVSS""disabled"`로 설정합니다. `WindowsVSS` 옵션은 기본적으로 활성화되어 있습니다.  
유형: 문자열 간 맵  
키 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
값 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
필수 여부: 아니요

 ** [BackupVaultName](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [CompleteWindowMinutes](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-CompleteWindowMinutes"></a>
성공적으로 시작된 백업을 완료해야 하는 기간(분)입니다. 완료하지 않으면 AWS Backup 이 작업을 취소합니다. 이 값은 선택 사항입니다. 이 값은 백업이 예약된 시점부터 감소되기 시작합니다. 백업이 일정보다 늦게 시작된 경우에도 `StartWindowMinutes`에 대한 추가 시간이 추가되지 않습니다.  
`StartWindowMinutes`와 마찬가지로, 이 파라미터의 최대값은 100년(52,560,000분)입니다.  
유형: Long  
필수 여부: 아니요

 ** [IamRoleArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-IamRoleArn"></a>
대상 복구 시점을 생성하는 데 사용되는 IAM 역할 ARN을 지정합니다(예: `arn:aws:iam::123456789012:role/S3Access`).  
유형: 문자열  
필수 항목 여부: 예

 ** [IdempotencyToken](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `StartBackupJob`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [Index](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-Index"></a>
백업 작업에 백업 인덱스를 지원하는 리소스 유형이 있는 경우 인덱스 생성을 활성화하려면 이 파라미터를 포함합니다.  
백업 인덱스를 지원하는 리소스 유형은 다음과 같습니다.  
+  Amazon Elastic Block Store의 `EBS`
+  Amazon Simple Storage Service(Amazon S3)의 `S3`
인덱스에는 `ENABLED` 또는 `DISABLED`의 두 가지 가능한 값 중 하나가 있을 수 있습니다.  
아직 백업 인덱스가 없는 적격 `ACTIVE` 복구 시점에 대한 백업 인덱스를 생성하려면 값을 `ENABLED`로 설정합니다.  
백업 인덱스를 삭제하려면 값을 `DISABLED`로 설정합니다.  
타입: 문자열  
유효 값: `ENABLED | DISABLED`   
필수 여부: 아니요

 ** [Lifecycle](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-Lifecycle"></a>
수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시기를 정의합니다. AWS Backup 는 사용자가 정의한 수명 주기에 따라 백업을 자동으로 전환하고 만료합니다.  
콜드 스토리지로 전환된 백업은 최소 90일 동안 콜드 스토리지에 저장해야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.  
콜드 스토리지로 전환할 수 있는 리소스 유형은 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 테이블에 나열됩니다. 다른 리소스 유형에 대해서는이 표현식을 AWS Backup 무시합니다.  
이 파라미터의 최대값은 100년(36,500일)입니다.  
유형: [Lifecycle](API_Lifecycle.md)객체  
필수 여부: 아니요

 ** [LogicallyAirGappedBackupVaultArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-LogicallyAirGappedBackupVaultArn"></a>
논리적 에어 갭 저장소의 ARN입니다. ARN은 동일한 계정 및 리전에 있어야 합니다. 제공된 경우, 지원되는 완전 관리형 리소스는 논리적 에어 갭 저장소에 직접 백업되는 반면, 지원되는 다른 리소스는 백업 저장소에 임시(청구 가능한) 스냅샷을 생성한 다음 논리적 에어 갭 저장소에 복사합니다. 지원되지 않는 리소스는 지정된 백업 볼트에만 백업됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [RecoveryPointTags](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-RecoveryPointTags"></a>
리소스에 할당할 태그입니다.  
유형: 문자열 대 문자열 맵  
필수 여부: 아니요

 ** [ResourceArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-ResourceArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [StartWindowMinutes](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-StartWindowMinutes"></a>
백업이 예약된 후 작업이 성공적으로 시작되지 않은 경우 취소되기 전까지의 시간(분)입니다. 이 값은 선택 사항이며, 기본값은 8시간입니다. 이 값이 포함된 경우 오류를 방지하려면 60분 이상이어야 합니다.  
이 파라미터의 최대값은 100년(52,560,000분)입니다.  
시작 기간 동안에는 백업 작업이 성공적으로 시작되거나 시작 기간이 만료될 때까지 백업 작업 상태가 `CREATED` 상태로 유지됩니다. 시작 기간 내에 작업을 재시도할 수 있는 오류가 AWS Backup 수신되면 AWS Backup 는 백업이 성공적으로 시작될 때까지(작업 상태가 로 변경됨`RUNNING`) 또는 작업 상태가 로 변경될 때까지`EXPIRED`(시작 기간 시간이 끝날 때 발생할 것으로 예상됨) 최소 10분마다 작업을 자동으로 다시 시도합니다.  
유형: Long  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_StartBackupJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupJobId": "string",
   "CreationDate": number,
   "IsParent": boolean,
   "RecoveryPointArn": "string"
}
```

## 응답 요소
<a name="API_StartBackupJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [BackupJobId](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-BackupJobId"></a>
에 AWS Backup 대한 리소스 백업 요청을 고유하게 식별합니다.  
유형: 문자열

 ** [CreationDate](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-CreationDate"></a>
백업 작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [IsParent](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-IsParent"></a>
상위(복합) 백업 작업이라는 것을 나타내는 반환된 부울 값입니다.  
유형: Boolean

 ** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-RecoveryPointArn"></a>
 *참고: 이 필드는 Amazon EFS 및 고급 DynamoDB 리소스에 대해서만 반환됩니다.*  
복구 시점을 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
유형: 문자열

## 오류
<a name="API_StartBackupJob_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_StartBackupJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartBackupJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartBackupJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartBackupJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartBackupJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartBackupJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartBackupJob) 

# StartCopyJob
<a name="API_StartCopyJob"></a>

지정된 리소스의 일회성 복사본을 생성하는 작업을 시작합니다.

연속 백업은 지원하지 않습니다.

가 [복사 작업을 재시도](https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry)하는 방법에 대한 자세한 내용은 복사 작업 AWS Backup 재시도를 참조하세요.

## Request Syntax
<a name="API_StartCopyJob_RequestSyntax"></a>

```
PUT /copy-jobs HTTP/1.1
Content-type: application/json

{
   "DestinationBackupVaultArn": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string",
   "SourceBackupVaultName": "string"
}
```

## URI 요청 파라미터
<a name="API_StartCopyJob_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartCopyJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-DestinationBackupVaultArn"></a>
복사할 위치인 대상 백업 저장소를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`).  
유형: 문자열  
필수 항목 여부: 예

 ** [IamRoleArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-IamRoleArn"></a>
대상 복구 시점을 복사하는 데 사용되는 IAM 역할 ARN을 지정합니다(예: `arn:aws:iam::123456789012:role/S3Access`).  
유형: 문자열  
필수 항목 여부: 예

 ** [IdempotencyToken](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `StartCopyJob`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [Lifecycle](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-Lifecycle"></a>
복구 시점이 콜드 스토리지로 전환되거나 삭제되기 전까지의 기간(일)을 지정합니다.  
콜드 스토리지로 전환된 백업은 최소 90일 동안 콜드 스토리지에 저장해야 합니다. 따라서 콘솔에서 보존 설정은 '콜드로 전환 전 보관 일수' 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후에는 '콜드로 전환 전 보관 일수' 설정을 변경할 수 없습니다.  
콜드 스토리지로 전환할 수 있는 리소스 유형은 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 테이블에 나열됩니다. 다른 리소스 유형에 대해서는이 표현식을 AWS Backup 무시합니다.  
기존 수명 주기 및 보존 기간을 제거하고 복구 시점을 무기한 유지하려면 `MoveToColdStorageAfterDays` 및 `DeleteAfterDays`를 -1로 지정합니다.  
유형: [Lifecycle](API_Lifecycle.md)객체  
필수 여부: 아니요

 ** [RecoveryPointArn](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-RecoveryPointArn"></a>
복사 작업에 사용할 복구 시점을 고유하게 식별하는 ARN입니다(예: arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45).  
유형: 문자열  
필수 항목 여부: 예

 ** [SourceBackupVaultName](#API_StartCopyJob_RequestSyntax) **   <a name="Backup-StartCopyJob-request-SourceBackupVaultName"></a>
백업이 저장되는 논리적 소스 컨테이너의 이름입니다. 백업 저장소는 백업 저장소를 생성하는 데 사용된 계정과 백업 저장소가 생성된 AWS 리전에 고유한 이름으로 식별됩니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

## 응답 구문
<a name="API_StartCopyJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CopyJobId": "string",
   "CreationDate": number,
   "IsParent": boolean
}
```

## 응답 요소
<a name="API_StartCopyJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CopyJobId](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-CopyJobId"></a>
복사 작업을 고유하게 식별합니다.  
유형: 문자열

 ** [CreationDate](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-CreationDate"></a>
복사 작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [IsParent](#API_StartCopyJob_ResponseSyntax) **   <a name="Backup-StartCopyJob-response-IsParent"></a>
상위(복합) 복사 작업이라는 것을 나타내는 반환된 부울 값입니다.  
유형: Boolean

## 오류
<a name="API_StartCopyJob_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_StartCopyJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartCopyJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartCopyJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartCopyJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartCopyJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartCopyJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartCopyJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartCopyJob) 

# StartReportJob
<a name="API_StartReportJob"></a>

지정된 보고서 계획에 대한 온디맨드 보고서 작업을 시작합니다.

## Request Syntax
<a name="API_StartReportJob_RequestSyntax"></a>

```
POST /audit/report-jobs/reportPlanName HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string"
}
```

## URI 요청 파라미터
<a name="API_StartReportJob_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [reportPlanName](#API_StartReportJob_RequestSyntax) **   <a name="Backup-StartReportJob-request-uri-ReportPlanName"></a>
보고서 계획의 고유 이름입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

## 요청 본문
<a name="API_StartReportJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [IdempotencyToken](#API_StartReportJob_RequestSyntax) **   <a name="Backup-StartReportJob-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `StartReportJobInput`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_StartReportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ReportJobId": "string"
}
```

## 응답 요소
<a name="API_StartReportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ReportJobId](#API_StartReportJob_ResponseSyntax) **   <a name="Backup-StartReportJob-response-ReportJobId"></a>
보고서 작업의 식별자입니다. 임의로 생성되는 최대 1,024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 보고서 작업 ID는 편집할 수 없습니다.  
유형: 문자열

## 오류
<a name="API_StartReportJob_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_StartReportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartReportJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartReportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartReportJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartReportJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartReportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartReportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartReportJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartReportJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartReportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartReportJob) 

# StartRestoreJob
<a name="API_StartRestoreJob"></a>

Amazon 리소스 이름(ARN)으로 식별되는 저장된 리소스를 복구합니다.

## Request Syntax
<a name="API_StartRestoreJob_RequestSyntax"></a>

```
PUT /restore-jobs HTTP/1.1
Content-type: application/json

{
   "CopySourceTagsToRestoredResource": boolean,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Metadata": { 
      "string" : "string" 
   },
   "RecoveryPointArn": "string",
   "ResourceType": "string"
}
```

## URI 요청 파라미터
<a name="API_StartRestoreJob_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartRestoreJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [CopySourceTagsToRestoredResource](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-CopySourceTagsToRestoredResource"></a>
이는 선택 가능한 파라미터입니다. 이 파라미터가 `True`이면, 백업에 포함된 태그가 복원된 리소스에 복사됩니다.  
이는를 통해 생성된 백업에만 적용할 수 있습니다 AWS Backup.  
유형: 부울  
필수 항목 여부: 아니요

 ** [IamRoleArn](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-IamRoleArn"></a>
가 대상 리소스를 생성하는 데 AWS Backup 사용하는 IAM 역할의 Amazon 리소스 이름(ARN)입니다. 예: `arn:aws:iam::123456789012:role/S3Access`.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [IdempotencyToken](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `StartRestoreJob`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [Metadata](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-Metadata"></a>
메타데이터 키-값 페어의 집합입니다.  
`GetRecoveryPointRestoreMetadata`를 호출하여 백업했던 당시의 리소스에 대한 구성 메타데이터를 가져올 수 있습니다. 하지만 리소스를 복원하려면 `GetRecoveryPointRestoreMetadata`에서 제공한 값 외에 다른 값이 필요할 수 있습니다. 예를 들어, 원본이 이미 있는 경우 새 리소스 이름을 제공해야 할 수 있습니다.  
각 리소스의 메타데이터에 대한 자세한 내용은 다음을 참조하세요.  
+  [Amazon Aurora의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-aur.html#aur-restore-cli) 
+  [Amazon DocumentDB의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-docdb.html#docdb-restore-cli) 
+  [에 대한 메타데이터 AWS CloudFormation](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-application-stacks.html#restoring-cfn-cli) 
+  [Amazon DynamoDB의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-dynamodb.html#ddb-restore-cli) 
+  [Amazon EBS의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html#ebs-restore-cli) 
+  [Amazon EC2의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html#restoring-ec2-cli) 
+  [Amazon EFS의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html#efs-restore-cli) 
+  [Amazon EKS용 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-eks.html#eks-restore-backup-section) 
+  [Amazon FSx의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-fsx.html#fsx-restore-cli) 
+  [Amazon Neptune의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-nep.html#nep-restore-cli) 
+  [Amazon RDS의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-rds.html#rds-restore-cli) 
+  [Amazon Redshift의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/redshift-restores.html#redshift-restore-api) 
+  [에 대한 메타데이터 AWS Storage Gateway](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-storage-gateway.html#restoring-sgw-cli) 
+  [Amazon S3의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html#s3-restore-cli) 
+  [Amazon Timestream의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/timestream-restore.html#timestream-restore-api) 
+  [가상 머신의 메타데이터](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-vm.html#vm-restore-cli) 
유형: 문자열 간 맵  
필수 항목 여부: 예

 ** [RecoveryPointArn](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
유형: 문자열  
필수 항목 여부: 예

 ** [ResourceType](#API_StartRestoreJob_RequestSyntax) **   <a name="Backup-StartRestoreJob-request-ResourceType"></a>
다음 리소스 중 하나에 대한 복구 시점을 복원하는 작업을 시작합니다.  
+  `Aurora` - Amazon Aurora
+  `DocumentDB` - Amazon DocumentDB
+  `CloudFormation` - AWS CloudFormation 
+  `DynamoDB` - Amazon DynamoDB
+  `EBS` - Amazon Elastic Block Store
+  `EC2` - Amazon Elastic Compute Cloud
+  `EFS` - Amazon Elastic File System
+  `EKS` - Amazon Elastic Kubernetes Service
+  `FSx` - Amazon FSx
+  `Neptune` - Amazon Neptune
+  `RDS` - Amazon Relational Database Service
+  `Redshift` - Amazon Redshift
+  `Storage Gateway` - AWS Storage Gateway 
+  `S3` - Amazon Simple Storage Service
+  `Timestream` - Amazon Timestream
+  `VirtualMachine` - 가상 머신
유형: String  
패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
필수 여부: 아니요

## 응답 구문
<a name="API_StartRestoreJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "RestoreJobId": "string"
}
```

## 응답 요소
<a name="API_StartRestoreJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [RestoreJobId](#API_StartRestoreJob_ResponseSyntax) **   <a name="Backup-StartRestoreJob-response-RestoreJobId"></a>
복구 시점을 복원하는 작업을 고유하게 식별합니다.  
유형: 문자열

## 오류
<a name="API_StartRestoreJob_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_StartRestoreJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartRestoreJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartRestoreJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartRestoreJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartRestoreJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartRestoreJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartRestoreJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartRestoreJob) 

# StartScanJob
<a name="API_StartScanJob"></a>

특정 리소스에 대한 스캔 작업을 시작합니다.

## Request Syntax
<a name="API_StartScanJob_RequestSyntax"></a>

```
PUT /scan/job HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string"
}
```

## URI 요청 파라미터
<a name="API_StartScanJob_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_StartScanJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupVaultName](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소를 생성하는 데 사용된 계정과 백업 저장소가 생성된 AWS 리전에 고유한 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
유형: 문자열  
필수 항목 여부: 예

 ** [IamRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IamRoleArn"></a>
대상 복구 시점을 생성하는 데 사용되는 IAM 역할 ARN을 지정합니다(예: `arn:aws:iam::123456789012:role/S3Access`).  
유형: 문자열  
필수 항목 여부: 예

 ** [IdempotencyToken](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `StartScanJob`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [MalwareScanner](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-MalwareScanner"></a>
스캔 작업 중에 사용되는 맬웨어 스캐너를 지정합니다. 현재 `GUARDDUTY`만 지원됩니다.  
타입: 문자열  
유효 값: `GUARDDUTY`   
필수 사항 여부: 예

 ** [RecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. 전체 스캔의 대상 복구 시점입니다. 증분 스캔을 실행하는 경우 기본 복구 시점을 선택한 후 생성된 복구 시점이 됩니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [ScanBaseRecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanBaseRecoveryPointArn"></a>
증분 스캔에 사용할 기본 복구 시점을 고유하게 식별하는 ARN입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [ScanMode](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanMode"></a>
스캔 작업에 사용할 스캔 유형을 지정합니다.  
다음을 포함합니다.  
+  `FULL_SCAN`는 백업 내의 전체 데이터 계보를 스캔합니다.
+  `INCREMENTAL_SCAN`는 대상 복구 시점과 기본 복구 시점 ARN 간의 데이터 차이를 스캔합니다.
타입: 문자열  
유효 값: `FULL_SCAN | INCREMENTAL_SCAN`   
필수 사항 여부: 예

 ** [ScannerRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScannerRoleArn"></a>
IAM 스캐너 역할 ARN을 지정했습니다.  
유형: 문자열  
필수 항목 여부: 예

## 응답 구문
<a name="API_StartScanJob_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationDate": number,
   "ScanJobId": "string"
}
```

## 응답 요소
<a name="API_StartScanJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 201 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationDate](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-CreationDate"></a>
백업 작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [ScanJobId](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-ScanJobId"></a>
에 AWS Backup 대한 리소스 백업 요청을 고유하게 식별합니다.  
유형: 문자열

## 오류
<a name="API_StartScanJob_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_StartScanJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartScanJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartScanJob) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartScanJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartScanJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartScanJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartScanJob) 

# StopBackupJob
<a name="API_StopBackupJob"></a>

리소스의 일회성 백업을 생성하는 작업을 취소하려고 시도합니다.

다음 서비스에서는 이 작업이 지원되지 않습니다.
+ Amazon Aurora
+ Amazon DocumentDB(MongoDB 호환)
+ Amazon FSx for Lustre
+ Amazon FSx for NetApp ONTAP
+ Amazon FSx for OpenZFS
+ Amazon FSx for Windows File Server
+ Amazon Neptune
+ Amazon EC2 인스턴스의 SAP HANA 데이터베이스
+ Amazon RDS

## Request Syntax
<a name="API_StopBackupJob_RequestSyntax"></a>

```
POST /backup-jobs/backupJobId HTTP/1.1
```

## URI 요청 파라미터
<a name="API_StopBackupJob_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupJobId](#API_StopBackupJob_RequestSyntax) **   <a name="Backup-StopBackupJob-request-uri-BackupJobId"></a>
에 AWS Backup 대한 리소스 백업 요청을 고유하게 식별합니다.  
필수 항목 여부: 예

## Request Body
<a name="API_StopBackupJob_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_StopBackupJob_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_StopBackupJob_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_StopBackupJob_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_StopBackupJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StopBackupJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StopBackupJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StopBackupJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StopBackupJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StopBackupJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StopBackupJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StopBackupJob) 

# TagResource
<a name="API_TagResource"></a>

리소스에 키-값 페어 세트를 할당합니다.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_TagResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="Backup-TagResource-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 ARN입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_TagResource_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="Backup-TagResource-request-Tags"></a>
리소스를 구성하는 데 사용되는 키-값 페어입니다. 생성하는 리소스에 고유한 메타데이터를 할당할 수 있습니다. 명확하게 설명하자면, 태그를 할당하는 구조는 아래와 같습니다.  
유형: 문자열 간 맵  
필수 항목 여부: 예

## 응답 구문
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_TagResource_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_TagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/TagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/TagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/TagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/TagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/TagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Amazon 리소스 이름(ARN)으로 식별되는 복구 시점, 백업 계획 또는 백업 저장소에서 키-값 페어 집합을 제거합니다.

이 API는 다음과 같은 리소스 유형의 복구 시점에 지원되지 않습니다. 해당 유형은 Aurora, Amazon DocumentDB, Amazon EBS, Amazon FSx, Neptune, Amazon RDS를 포함합니다.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
POST /untag/resourceArn HTTP/1.1
Content-type: application/json

{
   "TagKeyList": [ "string" ]
}
```

## URI 요청 파라미터
<a name="API_UntagResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="Backup-UntagResource-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 ARN입니다. ARN의 형식은 태그가 지정된 리소스 유형에 따라 달라집니다.  
`backup`을 포함하지 않은 ARN은 태그 지정과 호환되지 않습니다. 잘못된 ARN이 포함된 `TagResource` 및 `UntagResource`를 사용하면 오류가 발생합니다. 허용 가능한 ARN 콘텐츠에는 `arn:aws:backup:us-east`가 포함될 수 있습니다. 잘못된 ARN 콘텐츠는 `arn:aws:ec2:us-east`처럼 보일 수 있습니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_UntagResource_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [TagKeyList](#API_UntagResource_RequestSyntax) **   <a name="Backup-UntagResource-request-TagKeyList"></a>
리소스에서 제거할 키 값 태그를 식별하기 위한 키입니다.  
유형: 문자열 배열  
필수 항목 여부: 예

## 응답 구문
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_UntagResource_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_UntagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UntagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UntagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UntagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UntagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UntagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UntagResource) 

# UpdateBackupPlan
<a name="API_UpdateBackupPlan"></a>

지정된 백업 계획을 업데이트합니다. 새 버전은 ID로 고유하게 식별됩니다.

## Request Syntax
<a name="API_UpdateBackupPlan_RequestSyntax"></a>

```
POST /backup/plans/backupPlanId HTTP/1.1
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "DeleteAfterEvent": "string",
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "DeleteAfterEvent": "string",
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScanActions": [ 
               { 
                  "MalwareScanner": "string",
                  "ScanMode": "string"
               }
            ],
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string",
            "TargetLogicallyAirGappedBackupVaultArn": "string"
         }
      ],
      "ScanSettings": [ 
         { 
            "MalwareScanner": "string",
            "ResourceTypes": [ "string" ],
            "ScannerRoleArn": "string"
         }
      ]
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateBackupPlan_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupPlanId](#API_UpdateBackupPlan_RequestSyntax) **   <a name="Backup-UpdateBackupPlan-request-uri-BackupPlanId"></a>
백업 계획의 ID입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_UpdateBackupPlan_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BackupPlan](#API_UpdateBackupPlan_RequestSyntax) **   <a name="Backup-UpdateBackupPlan-request-BackupPlan"></a>
백업 계획의 본문입니다. `BackupPlanName`과 하나 이상의 `Rules` 집합을 포함합니다.  
타입: [BackupPlanInput](API_BackupPlanInput.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_UpdateBackupPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "ScanSettings": [ 
      { 
         "MalwareScanner": "string",
         "ResourceTypes": [ "string" ],
         "ScannerRoleArn": "string"
      }
   ],
   "VersionId": "string"
}
```

## 응답 요소
<a name="API_UpdateBackupPlan_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [AdvancedBackupSettings](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-AdvancedBackupSettings"></a>
각 리소스 유형에 대한 `BackupOptions` 목록이 포함됩니다.  
타입: [AdvancedBackupSetting](API_AdvancedBackupSetting.md)객체 배열

 ** [BackupPlanArn](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-BackupPlanArn"></a>
백업 계획을 고유하게 식별하는 Amazon 리소스 이름(ARN)(예: `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`)입니다.  
유형: 문자열

 ** [BackupPlanId](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-BackupPlanId"></a>
백업 계획을 고유하게 식별합니다.  
유형: 문자열

 ** [CreationDate](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-CreationDate"></a>
백업 계획이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationDate`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [ScanSettings](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-ScanSettings"></a>
백업 계획에 대한 스캔 구성을 포함하고 맬웨어 스캐너, 선택한 리소스 및 스캐너 역할을 포함합니다.  
타입: [ScanSetting](API_ScanSetting.md)객체 배열

 ** [VersionId](#API_UpdateBackupPlan_ResponseSyntax) **   <a name="Backup-UpdateBackupPlan-response-VersionId"></a>
임의로 생성되는 최대 1024바이트의 UTF-8 인코딩된 고유한 Unicode 문자열입니다. 버전 ID는 편집할 수 없습니다.  
유형: 문자열

## 오류
<a name="API_UpdateBackupPlan_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_UpdateBackupPlan_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateBackupPlan) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateBackupPlan) 

# UpdateFramework
<a name="API_UpdateFramework"></a>

지정된 프레임워크를 업데이트합니다.

## Request Syntax
<a name="API_UpdateFramework_RequestSyntax"></a>

```
PUT /audit/frameworks/frameworkName HTTP/1.1
Content-type: application/json

{
   "FrameworkControls": [ 
      { 
         "ControlInputParameters": [ 
            { 
               "ParameterName": "string",
               "ParameterValue": "string"
            }
         ],
         "ControlName": "string",
         "ControlScope": { 
            "ComplianceResourceIds": [ "string" ],
            "ComplianceResourceTypes": [ "string" ],
            "Tags": { 
               "string" : "string" 
            }
         }
      }
   ],
   "FrameworkDescription": "string",
   "IdempotencyToken": "string"
}
```

## URI 요청 파라미터
<a name="API_UpdateFramework_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [frameworkName](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-uri-FrameworkName"></a>
프레임워크의 고유 이름입니다. 이 이름은 문자로 시작하고 문자(a\$1z, A\$1Z), 숫자(0\$19) 및 밑줄(\$1)로 구성된 1\$1256자 사이입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

## 요청 본문
<a name="API_UpdateFramework_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [FrameworkControls](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-FrameworkControls"></a>
프레임워크를 구성하는 컨트롤입니다. 목록의 각 컨트롤에는 이름, 입력 파라미터, 범위가 있습니다.  
타입: [FrameworkControl](API_FrameworkControl.md)객체 배열  
필수: 아니요

 ** [FrameworkDescription](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-FrameworkDescription"></a>
프레임워크에 대한 최대 1,024자의 설명(선택 사항)입니다.  
유형: String  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.  
패턴: `.*\S.*`   
필수 여부: 아니요

 ** [IdempotencyToken](#API_UpdateFramework_RequestSyntax) **   <a name="Backup-UpdateFramework-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `UpdateFrameworkInput`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수사항: 아니요

## 응답 구문
<a name="API_UpdateFramework_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "FrameworkArn": "string",
   "FrameworkName": "string"
}
```

## 응답 요소
<a name="API_UpdateFramework_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_UpdateFramework_ResponseSyntax) **   <a name="Backup-UpdateFramework-response-CreationTime"></a>
프레임워크가 생성된 날짜 및 시간이며, ISO 8601 형식으로 표시됩니다. `CreationTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 2020-07-10T15:00:00.000-08:00은 UTC보다 8시간 늦은 2020년 7월 10일 오후 3시를 나타냅니다.  
유형: 타임스탬프

 ** [FrameworkArn](#API_UpdateFramework_ResponseSyntax) **   <a name="Backup-UpdateFramework-response-FrameworkArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: 문자열

 ** [FrameworkName](#API_UpdateFramework_ResponseSyntax) **   <a name="Backup-UpdateFramework-response-FrameworkName"></a>
프레임워크의 고유 이름입니다. 이 이름은 문자로 시작하고 문자(a\$1z, A\$1Z), 숫자(0\$19) 및 밑줄(\$1)로 구성된 1\$1256자 사이입니다.  
유형: String  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*` 

## 오류
<a name="API_UpdateFramework_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateFramework_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateFramework) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateFramework) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateFramework) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateFramework) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateFramework) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateFramework) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateFramework) 

# UpdateGlobalSettings
<a name="API_UpdateGlobalSettings"></a>

 AWS 계정이 교차 계정 백업, 다자간 승인, 위임된 관리자 등 다양한 교차 계정 관리 옵션을 활성화했는지 여부를 업데이트합니다. 계정이 Organizations 관리 계정이 아닌 경우 오류가 반환됩니다. `DescribeGlobalSettings` API를 사용하여 현재 설정을 확인하세요.

## Request Syntax
<a name="API_UpdateGlobalSettings_RequestSyntax"></a>

```
PUT /global-settings HTTP/1.1
Content-type: application/json

{
   "GlobalSettings": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateGlobalSettings_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_UpdateGlobalSettings_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GlobalSettings](#API_UpdateGlobalSettings_RequestSyntax) **   <a name="Backup-UpdateGlobalSettings-request-GlobalSettings"></a>
입력에는 다음이 포함될 수 있습니다.  
의 값입니다`isCrossAccountBackupEnabled`. 값은 true 또는 false일 수 있습니다. 예시: `update-global-settings --global-settings isCrossAccountBackupEnabled=false`.  
다자간 승인에 대한 값으로, 로 스타일이 지정됩니다`isMpaEnabled`. 값은 true 또는 false일 수 있습니다. 예시: `update-global-settings --global-settings isMpaEnabled=false`.  
Backup 서비스 연결 역할 생성에 대한 값으로, 로 스타일이 지정됩니다`isDelegatedAdministratorEnabled`. 값은 true 또는 false일 수 있습니다. 예시: `update-global-settings --global-settings isDelegatedAdministratorEnabled=false`.  
유형: 문자열 대 문자열 맵  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateGlobalSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateGlobalSettings_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_UpdateGlobalSettings_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateGlobalSettings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateGlobalSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateGlobalSettings) 

# UpdateRecoveryPointIndexSettings
<a name="API_UpdateRecoveryPointIndexSettings"></a>

이 작업은 복구 시점 인덱스의 설정을 업데이트합니다.

필수: BackupVaultName, RecoveryPointArn 및 IAMRoleArn

## Request Syntax
<a name="API_UpdateRecoveryPointIndexSettings_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json

{
   "IamRoleArn": "string",
   "Index": "string"
}
```

## URI 요청 파라미터
<a name="API_UpdateRecoveryPointIndexSettings_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
허용되는 문자에는 소문자, 숫자, 하이픈이 포함됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [recoveryPointArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
필수 항목 여부: 예

## 요청 본문
<a name="API_UpdateRecoveryPointIndexSettings_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [IamRoleArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-IamRoleArn"></a>
이 작업에 사용되는 IAM 역할 ARN을 지정합니다.  
예: arn:aws:iam::123456789012:role/S3Access  
유형: 문자열  
필수 항목 여부: 아니요

 ** [Index](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-Index"></a>
인덱스에는 `ENABLED` 또는 `DISABLED`의 두 가지 가능한 값 중 하나가 있을 수 있습니다.  
아직 백업 인덱스가 없는 적격 `ACTIVE` 복구 시점에 대한 백업 인덱스를 생성하려면 값을 `ENABLED`로 설정합니다.  
백업 인덱스를 삭제하려면 값을 `DISABLED`로 설정합니다.  
타입: 문자열  
유효 값: `ENABLED | DISABLED`   
필수 여부: 예

## 응답 구문
<a name="API_UpdateRecoveryPointIndexSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultName": "string",
   "Index": "string",
   "IndexStatus": "string",
   "RecoveryPointArn": "string"
}
```

## 응답 요소
<a name="API_UpdateRecoveryPointIndexSettings_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [BackupVaultName](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
유형: String  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [Index](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-Index"></a>
인덱스에는 `ENABLED` 또는 `DISABLED`의 두 가지 가능한 값 중 하나가 있을 수 있습니다.  
값 `ENABLED`은 적격 `ACTIVE` 복구 시점에 대한 백업 인덱스가 생성되었음을 의미합니다.  
값이 `DISABLED`이면 백업 인덱스가 삭제되었음을 의미합니다.  
타입: 문자열  
유효 값: `ENABLED | DISABLED` 

 ** [IndexStatus](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-IndexStatus"></a>
지정된 복구 시점과 연결된 백업 인덱스의 현재 상태입니다.  
상태는 `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`입니다.  
상태가 `ACTIVE`인 인덱스가 있는 복구 시점을 검색에 포함할 수 있습니다.  
타입: 문자열  
유효 값: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [RecoveryPointArn](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
유형: 문자열

## 오류
<a name="API_UpdateRecoveryPointIndexSettings_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateRecoveryPointIndexSettings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRecoveryPointIndexSettings) 

# UpdateRecoveryPointLifecycle
<a name="API_UpdateRecoveryPointLifecycle"></a>

복구 시점의 전환 수명 주기를 설정합니다.

수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시기를 정의합니다.는 사용자가 정의한 수명 주기에 따라 백업을 자동으로 AWS Backup 전환하고 만료합니다.

콜드 스토리지로 전환할 수 있는 리소스 유형은 [리소스별 기능 가용성](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource) 테이블에 나열됩니다. 다른 리소스 유형에 대해서는이 표현식을 AWS Backup 무시합니다.

콜드 스토리지로 전환된 백업은 최소 90일 동안 콜드 스토리지에 저장해야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.

**중요**  
수명 주기가 현재 `DeleteAfterDays` 및 `MoveToColdStorageAfterDays` 파라미터를 사용하는 경우, 이 작업을 직접적으로 호출할 때 이러한 파라미터와 해당 값을 포함합니다. 이를 포함하지 않으면 계획이 null 값으로 업데이트될 수 있습니다.

이 작업은 연속 백업을 지원하지 않습니다.

## Request Syntax
<a name="API_UpdateRecoveryPointLifecycle_RequestSyntax"></a>

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn HTTP/1.1
Content-type: application/json

{
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateRecoveryPointLifecycle_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [backupVaultName](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-uri-BackupVaultName"></a>
백업이 저장되는 논리 컨테이너의 이름입니다. 백업 저장소는 백업 저장소가 생성된 AWS 리전 및 백업 저장소를 생성하는 데 사용된 계정에 고유 이름으로 식별됩니다.  
패턴: `^[a-zA-Z0-9\-\_]{2,50}$`   
필수 여부: 예

 ** [recoveryPointArn](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-uri-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
필수 항목 여부: 예

## 요청 본문
<a name="API_UpdateRecoveryPointLifecycle_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Lifecycle](#API_UpdateRecoveryPointLifecycle_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-request-Lifecycle"></a>
수명 주기는 보호된 리소스가 콜드 스토리지로 전환되는 시기와 만료되는 시기를 정의합니다.는 사용자가 정의한 수명 주기에 따라 백업을 자동으로 AWS Backup 전환하고 만료합니다.  
콜드 스토리지로 전환된 백업은 최소 90일 동안 콜드 스토리지에 저장해야 합니다. 따라서 ‘보존’ 설정은 ‘콜드로 전환 전 보관 일수’ 설정보다 90일 이상 커야 합니다. 백업이 콜드로 전환된 후 "콜드로 전환 전 보관 일수" 설정을 변경할 수 없습니다.  
유형: [Lifecycle](API_Lifecycle.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateRecoveryPointLifecycle_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultArn": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string"
}
```

## 응답 요소
<a name="API_UpdateRecoveryPointLifecycle_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [BackupVaultArn](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-BackupVaultArn"></a>
백업 저장소를 고유하게 식별하는 ARN입니다(예: `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`).  
유형: 문자열

 ** [CalculatedLifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-CalculatedLifecycle"></a>
`DeleteAt` 및 `MoveToColdStorageAt` 타임스탬프를 포함하는 `CalculatedLifecycle` 객체입니다.  
유형: [CalculatedLifecycle](API_CalculatedLifecycle.md)객체

 ** [Lifecycle](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-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)객체

 ** [RecoveryPointArn](#API_UpdateRecoveryPointLifecycle_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointLifecycle-response-RecoveryPointArn"></a>
복구 시점을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`).  
유형: 문자열

## 오류
<a name="API_UpdateRecoveryPointLifecycle_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidRequestException **   
요청에 대한 입력에 문제가 있음을 나타냅니다. 예를 들어, 파라미터의 유형이 잘못된 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateRecoveryPointLifecycle_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRecoveryPointLifecycle) 

# UpdateRegionSettings
<a name="API_UpdateRegionSettings"></a>

리전에 대한 현재 서비스 옵트인 설정을 업데이트합니다.

`DescribeRegionSettings` API를 사용하여 지원되는 리소스 유형을 확인하세요.

## Request Syntax
<a name="API_UpdateRegionSettings_RequestSyntax"></a>

```
PUT /account-settings HTTP/1.1
Content-type: application/json

{
   "ResourceTypeManagementPreference": { 
      "string" : boolean 
   },
   "ResourceTypeOptInPreference": { 
      "string" : boolean 
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateRegionSettings_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_UpdateRegionSettings_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceTypeManagementPreference](#API_UpdateRegionSettings_RequestSyntax) **   <a name="Backup-UpdateRegionSettings-request-ResourceTypeManagementPreference"></a>
리소스 유형에 대한 백업의 전체 AWS Backup 관리를 활성화하거나 비활성화합니다. 의 고급 DynamoDB 백업 기능과 함께 DynamoDB에 대한 전체 AWS Backup 관리를 활성화하려면 절차에 따라 [ 고급 DynamoDB 백업을 프로그래밍 방식으로 활성화합니다](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html#advanced-ddb-backup-enable-cli). [AWS Backup DynamoDB ](https://docs.aws.amazon.com/aws-backup/latest/devguide/advanced-ddb-backup.html)  
유형: String과 부울 간의 맵  
키 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
필수 여부: 아니요

 ** [ResourceTypeOptInPreference](#API_UpdateRegionSettings_RequestSyntax) **   <a name="Backup-UpdateRegionSettings-request-ResourceTypeOptInPreference"></a>
리전의 옵트인 기본 설정과 함께 서비스 목록을 업데이트합니다.  
태그만 기준으로 하여 리소스를 할당할 경우 서비스 옵트인 설정이 적용됩니다. Amazon S3, Amazon EC2 또는 Amazon RDS 같은 백업 계획에 리소스 유형이 명시적으로 할당된 경우, 이러한 특정 서비스에 대한 옵트인이 활성화되지 않아도 백업에 포함됩니다. 리소스 할당에 리소스 유형과 태그가 둘 다 지정된 경우, 백업 계획에 지정된 리소스 유형이 태그 조건보다 우선합니다. 이 경우 서비스 옵트인 설정이 무시됩니다.  
유형: String과 부울 간의 맵  
키 패턴: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateRegionSettings_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UpdateRegionSettings_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_UpdateRegionSettings_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateRegionSettings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRegionSettings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRegionSettings) 

# UpdateReportPlan
<a name="API_UpdateReportPlan"></a>

지정된 보고서 계획을 업데이트합니다.

## Request Syntax
<a name="API_UpdateReportPlan_RequestSyntax"></a>

```
PUT /audit/report-plans/reportPlanName HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string",
   "ReportDeliveryChannel": { 
      "Formats": [ "string" ],
      "S3BucketName": "string",
      "S3KeyPrefix": "string"
   },
   "ReportPlanDescription": "string",
   "ReportSetting": { 
      "Accounts": [ "string" ],
      "FrameworkArns": [ "string" ],
      "NumberOfFrameworks": number,
      "OrganizationUnits": [ "string" ],
      "Regions": [ "string" ],
      "ReportTemplate": "string"
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateReportPlan_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [reportPlanName](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-uri-ReportPlanName"></a>
보고서 계획의 고유 이름입니다. 이 이름은 문자로 시작하고 문자(a\$1z, A\$1Z), 숫자(0\$19) 및 밑줄(\$1)로 구성된 1\$1256자 사이입니다.  
길이 제약: 최소 길이 1. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*`   
필수 여부: 예

## 요청 본문
<a name="API_UpdateReportPlan_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [IdempotencyToken](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-IdempotencyToken"></a>
고객이 선택한 문자열로, `UpdateReportPlanInput`에 대한 동일한 호출을 구분하는 데 사용할 수 있습니다. 동일한 멱등성 토큰으로 성공적인 요청을 다시 시도하면 아무런 작업 없이 성공 메시지가 표시됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [ReportDeliveryChannel](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-ReportDeliveryChannel"></a>
보고서를 전송하는 위치, 특히 Amazon S3 버킷 이름, S3 키 접두사 및 보고서 형식에 대한 정보입니다.  
유형: [ReportDeliveryChannel](API_ReportDeliveryChannel.md)객체  
필수 여부: 아니요

 ** [ReportPlanDescription](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-ReportPlanDescription"></a>
보고서 계획에 대한 최대 1,024자의 설명(선택 사항)입니다.  
유형: String  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 1024입니다.  
패턴: `.*\S.*`   
필수 여부: 아니요

 ** [ReportSetting](#API_UpdateReportPlan_RequestSyntax) **   <a name="Backup-UpdateReportPlan-request-ReportSetting"></a>
보고서에 대한 보고서 템플릿입니다. 보고서는 보고서 템플릿을 사용하여 작성됩니다. 보고서 템플릿은 다음과 같습니다.  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`   
보고서 템플릿이 `RESOURCE_COMPLIANCE_REPORT` 또는 `CONTROL_COMPLIANCE_REPORT`인 경우이 API 리소스는 AWS 리전 및 프레임워크별 보고서 적용 범위도 설명합니다.  
유형: [ReportSetting](API_ReportSetting.md)객체  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_UpdateReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "string"
}
```

## 응답 요소
<a name="API_UpdateReportPlan_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_UpdateReportPlan_ResponseSyntax) **   <a name="Backup-UpdateReportPlan-response-CreationTime"></a>
보고서 계획이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [ReportPlanArn](#API_UpdateReportPlan_ResponseSyntax) **   <a name="Backup-UpdateReportPlan-response-ReportPlanArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다. ARN의 형식은 리소스 유형에 따라 달라집니다.  
유형: String

 ** [ReportPlanName](#API_UpdateReportPlan_ResponseSyntax) **   <a name="Backup-UpdateReportPlan-response-ReportPlanName"></a>
보고서 계획의 고유 이름입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `[a-zA-Z][_a-zA-Z0-9]*` 

## 오류
<a name="API_UpdateReportPlan_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateReportPlan_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateReportPlan) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateReportPlan) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateReportPlan) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateReportPlan) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateReportPlan) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateReportPlan) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateReportPlan) 

# UpdateRestoreTestingPlan
<a name="API_UpdateRestoreTestingPlan"></a>

이 요청은 지정된 복원 테스트 계획의 변경 내용을 전송합니다. 생성 후에는 `RestoreTestingPlanName`을 업데이트할 수 없습니다.

 `RecoveryPointSelection`에는 다음을 포함할 수 있습니다.
+  `Algorithm` 
+  `ExcludeVaults` 
+  `IncludeVaults` 
+  `RecoveryPointTypes` 
+  `SelectionWindowDays` 

## Request Syntax
<a name="API_UpdateRestoreTestingPlan_RequestSyntax"></a>

```
PUT /restore-testing/plans/RestoreTestingPlanName HTTP/1.1
Content-type: application/json

{
   "RestoreTestingPlan": { 
      "RecoveryPointSelection": { 
         "Algorithm": "string",
         "ExcludeVaults": [ "string" ],
         "IncludeVaults": [ "string" ],
         "RecoveryPointTypes": [ "string" ],
         "SelectionWindowDays": number
      },
      "ScheduleExpression": "string",
      "ScheduleExpressionTimezone": "string",
      "StartWindowHours": number
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateRestoreTestingPlan_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-request-uri-RestoreTestingPlanName"></a>
복원 테스트 계획의 이름입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_UpdateRestoreTestingPlan_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [RestoreTestingPlan](#API_UpdateRestoreTestingPlan_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-request-RestoreTestingPlan"></a>
복원 테스트 계획의 본문을 지정합니다.  
타입: [RestoreTestingPlanForUpdate](API_RestoreTestingPlanForUpdate.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_UpdateRestoreTestingPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string",
   "UpdateTime": number
}
```

## 응답 요소
<a name="API_UpdateRestoreTestingPlan_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-CreationTime"></a>
리소스 테스트 계획이 생성된 시간입니다.  
유형: 타임스탬프

 ** [RestoreTestingPlanArn](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-RestoreTestingPlanArn"></a>
복원 테스트 계획의 고유 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-RestoreTestingPlanName"></a>
생성한 후에는 이름을 변경할 수 없습니다. 이름은 영숫자와 밑줄로만 구성해야 합니다. 최대 길이는 50자입니다.  
유형: 문자열

 ** [UpdateTime](#API_UpdateRestoreTestingPlan_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingPlan-response-UpdateTime"></a>
복원 테스트 계획에 대한 업데이트가 완료된 시간입니다.  
유형: 타임스탬프

## 오류
<a name="API_UpdateRestoreTestingPlan_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateRestoreTestingPlan_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRestoreTestingPlan) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRestoreTestingPlan) 

# UpdateRestoreTestingSelection
<a name="API_UpdateRestoreTestingSelection"></a>

지정된 복원 테스트 선택 항목을 업데이트합니다.

`RestoreTestingSelectionName`을 제외한 대부분의 요소를 이 요청으로 업데이트할 수 있습니다.

보호된 리소스 ARN 또는 조건 중 하나를 사용할 수 있지만, 둘 다 사용할 수는 없습니다.

## Request Syntax
<a name="API_UpdateRestoreTestingSelection_RequestSyntax"></a>

```
PUT /restore-testing/plans/RestoreTestingPlanName/selections/RestoreTestingSelectionName HTTP/1.1
Content-type: application/json

{
   "RestoreTestingSelection": { 
      "IamRoleArn": "string",
      "ProtectedResourceArns": [ "string" ],
      "ProtectedResourceConditions": { 
         "StringEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ],
         "StringNotEquals": [ 
            { 
               "Key": "string",
               "Value": "string"
            }
         ]
      },
      "RestoreMetadataOverrides": { 
         "string" : "string" 
      },
      "ValidationWindowHours": number
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateRestoreTestingSelection_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-uri-RestoreTestingPlanName"></a>
표시된 테스트 계획을 업데이트하려면 복원 테스트 계획 이름이 필요합니다.  
필수 항목 여부: 예

 ** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-uri-RestoreTestingSelectionName"></a>
업데이트하려는 복원 테스트 선택 항목의 필수 복원 테스트 선택 항목 이름입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_UpdateRestoreTestingSelection_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [RestoreTestingSelection](#API_UpdateRestoreTestingSelection_RequestSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-request-RestoreTestingSelection"></a>
복원 테스트 선택 항목을 업데이트하려면 보호된 리소스 ARN 또는 조건을 사용할 수 있지만 둘 다 사용할 수는 없습니다. 즉, 선택 항목에 `ProtectedResourceArns`가 포함된 경우 `ProtectedResourceConditions` 파라미터를 사용한 업데이트 요청은 실패합니다.  
타입: [RestoreTestingSelectionForUpdate](API_RestoreTestingSelectionForUpdate.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_UpdateRestoreTestingSelection_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "RestoreTestingPlanArn": "string",
   "RestoreTestingPlanName": "string",
   "RestoreTestingSelectionName": "string",
   "UpdateTime": number
}
```

## 응답 요소
<a name="API_UpdateRestoreTestingSelection_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-CreationTime"></a>
리소스 테스트 선택 항목이 성공적으로 업데이트된 시간입니다.  
유형: 타임스탬프

 ** [RestoreTestingPlanArn](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingPlanArn"></a>
복원 테스트 계획의 이름을 나타내는 고유한 문자열입니다.  
유형: 문자열

 ** [RestoreTestingPlanName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingPlanName"></a>
업데이트된 복원 테스트 선택 항목이 관련된 복원 테스트 계획입니다.  
유형: 문자열

 ** [RestoreTestingSelectionName](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-RestoreTestingSelectionName"></a>
반환된 복원 테스트 선택 항목 이름입니다.  
유형: 문자열

 ** [UpdateTime](#API_UpdateRestoreTestingSelection_ResponseSyntax) **   <a name="Backup-UpdateRestoreTestingSelection-response-UpdateTime"></a>
복원 테스트 선택 항목에 대한 업데이트가 완료된 시간입니다.  
유형: 타임스탬프

## 오류
<a name="API_UpdateRestoreTestingSelection_Errors"></a>

모든 작업에 공통되는 오류에 대한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateRestoreTestingSelection_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateRestoreTestingSelection) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateRestoreTestingSelection) 

# UpdateTieringConfiguration
<a name="API_UpdateTieringConfiguration"></a>

이 요청은 지정된 계층화 구성에 변경 사항을 전송합니다.는 생성된 후에는 업데이트할 수 `TieringConfigurationName` 없습니다.

 `ResourceSelection`에는 다음을 포함할 수 있습니다.
+  `Resources` 
+  `TieringDownSettingsInDays` 
+  `ResourceType` 

## Request Syntax
<a name="API_UpdateTieringConfiguration_RequestSyntax"></a>

```
PUT /tiering-configurations/tieringConfigurationName HTTP/1.1
Content-type: application/json

{
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ]
   }
}
```

## URI 요청 파라미터
<a name="API_UpdateTieringConfiguration_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [tieringConfigurationName](#API_UpdateTieringConfiguration_RequestSyntax) **   <a name="Backup-UpdateTieringConfiguration-request-uri-TieringConfigurationName"></a>
업데이트할 계층화 구성의 이름입니다.  
패턴: `^[a-zA-Z0-9_]{1,200}$`   
필수 여부: 예

## 요청 본문
<a name="API_UpdateTieringConfiguration_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [TieringConfiguration](#API_UpdateTieringConfiguration_RequestSyntax) **   <a name="Backup-UpdateTieringConfiguration-request-TieringConfiguration"></a>
계층화 구성의 본문을 지정합니다.  
타입: [TieringConfigurationInputForUpdate](API_TieringConfigurationInputForUpdate.md)객체  
필수 여부: 예

## 응답 구문
<a name="API_UpdateTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "LastUpdatedTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "string"
}
```

## 응답 요소
<a name="API_UpdateTieringConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-CreationTime"></a>
계층화 구성이 생성된 날짜와 시간으로, Unix 형식과 협정 세계시(UTC) 형식입니다. `CreationTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087를 나타냅니다.  
유형: 타임스탬프

 ** [LastUpdatedTime](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-LastUpdatedTime"></a>
Unix 형식 및 협정 세계시(UTC)로 계층화 구성이 업데이트된 날짜 및 시간입니다. `LastUpdatedTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087를 나타냅니다.  
유형: 타임스탬프

 ** [TieringConfigurationArn](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-TieringConfigurationArn"></a>
업데이트된 계층화 구성을 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열

 ** [TieringConfigurationName](#API_UpdateTieringConfiguration_ResponseSyntax) **   <a name="Backup-UpdateTieringConfiguration-response-TieringConfigurationName"></a>
이 고유 문자열은 계층화 구성의 이름입니다.  
유형: String  
패턴: `^[a-zA-Z0-9_]{1,200}$` 

## 오류
<a name="API_UpdateTieringConfiguration_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AlreadyExistsException **   
필수 리소스가 이미 존재합니다.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ConflictException **   
 AWS Backup 는 이전 작업 수행을 완료할 때까지 요청한 작업을 수행할 수 없습니다. 나중에 다시 시도해 주세요.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** InvalidParameterValueException **   
파라미터의 값에 문제가 있음을 나타냅니다. 예를 들어 값이 범위를 벗어난 경우가 이에 해당합니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** LimitExceededException **   
요청의 한도가 초과되었습니다(예: 요청에 허용되는 최대 항목 수).    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** MissingParameterValueException **   
필수 파라미터가 누락되었음을 나타냅니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
작업에 필요한 리소스가 존재하지 않습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 400

 ** ServiceUnavailableException **   
요청이 서버의 일시적 장애 때문에 실패했습니다.    
 ** Context **   
  
 ** Type **   

HTTP 상태 코드: 500

## 참고
<a name="API_UpdateTieringConfiguration_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/UpdateTieringConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/UpdateTieringConfiguration) 

# AWS Backup gateway
<a name="API_Operations_AWS_Backup_Gateway"></a>

다음 작업이 AWS Backup gateway에서 지원됩니다.
+  [AssociateGatewayToServer](API_BGW_AssociateGatewayToServer.md) 
+  [CreateGateway](API_BGW_CreateGateway.md) 
+  [DeleteGateway](API_BGW_DeleteGateway.md) 
+  [DeleteHypervisor](API_BGW_DeleteHypervisor.md) 
+  [DisassociateGatewayFromServer](API_BGW_DisassociateGatewayFromServer.md) 
+  [GetBandwidthRateLimitSchedule](API_BGW_GetBandwidthRateLimitSchedule.md) 
+  [GetGateway](API_BGW_GetGateway.md) 
+  [GetHypervisor](API_BGW_GetHypervisor.md) 
+  [GetHypervisorPropertyMappings](API_BGW_GetHypervisorPropertyMappings.md) 
+  [GetVirtualMachine](API_BGW_GetVirtualMachine.md) 
+  [ImportHypervisorConfiguration](API_BGW_ImportHypervisorConfiguration.md) 
+  [ListGateways](API_BGW_ListGateways.md) 
+  [ListHypervisors](API_BGW_ListHypervisors.md) 
+  [ListTagsForResource](API_BGW_ListTagsForResource.md) 
+  [ListVirtualMachines](API_BGW_ListVirtualMachines.md) 
+  [PutBandwidthRateLimitSchedule](API_BGW_PutBandwidthRateLimitSchedule.md) 
+  [PutHypervisorPropertyMappings](API_BGW_PutHypervisorPropertyMappings.md) 
+  [PutMaintenanceStartTime](API_BGW_PutMaintenanceStartTime.md) 
+  [StartVirtualMachinesMetadataSync](API_BGW_StartVirtualMachinesMetadataSync.md) 
+  [TagResource](API_BGW_TagResource.md) 
+  [TestHypervisorConfiguration](API_BGW_TestHypervisorConfiguration.md) 
+  [UntagResource](API_BGW_UntagResource.md) 
+  [UpdateGatewayInformation](API_BGW_UpdateGatewayInformation.md) 
+  [UpdateGatewaySoftwareNow](API_BGW_UpdateGatewaySoftwareNow.md) 
+  [UpdateHypervisor](API_BGW_UpdateHypervisor.md) 

# AssociateGatewayToServer
<a name="API_BGW_AssociateGatewayToServer"></a>

백업 게이트웨이를 서버와 연결합니다. 연결 프로세스를 완료한 후 게이트웨이를 통해 VM을 백업 및 복원할 수 있습니다.

## 구문 요청
<a name="API_BGW_AssociateGatewayToServer_RequestSyntax"></a>

```
{
   "GatewayArn": "string",
   "ServerArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_AssociateGatewayToServer_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_AssociateGatewayToServer_RequestSyntax) **   <a name="Backup-BGW_AssociateGatewayToServer-request-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다. `ListGateways` 작업을 사용하여 계정 및의 게이트웨이 목록을 반환합니다 AWS 리전.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수: 예

 ** [ServerArn](#API_BGW_AssociateGatewayToServer_RequestSyntax) **   <a name="Backup-BGW_AssociateGatewayToServer-request-ServerArn"></a>
가상 머신을 호스팅하는 서버의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_AssociateGatewayToServer_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_AssociateGatewayToServer_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_AssociateGatewayToServer_ResponseSyntax) **   <a name="Backup-BGW_AssociateGatewayToServer-response-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_AssociateGatewayToServer_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_AssociateGatewayToServer_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/AssociateGatewayToServer) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/AssociateGatewayToServer) 

# CreateGateway
<a name="API_BGW_CreateGateway"></a>

백업 게이트웨이를 생성합니다. 게이트웨이를 생성한 후에는 `AssociateGatewayToServer` 작업을 사용하여 게이트웨이를 서버와 연결할 수 있습니다.

## 구문 요청
<a name="API_BGW_CreateGateway_RequestSyntax"></a>

```
{
   "ActivationKey": "string",
   "GatewayDisplayName": "string",
   "GatewayType": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_BGW_CreateGateway_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ActivationKey](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-ActivationKey"></a>
생성된 게이트웨이의 활성화 키입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이는 50.  
패턴: `[0-9a-zA-Z\-]+`   
필수 여부: 예

 ** [GatewayDisplayName](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayDisplayName"></a>
생성된 게이트웨이의 표시 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z0-9-]*`   
필수 여부: 예

 ** [GatewayType](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-GatewayType"></a>
생성된 게이트웨이 유형입니다.  
타입: 문자열  
유효 값: `BACKUP_VM`   
필수 사항 여부: 예

 ** [Tags](#API_BGW_CreateGateway_RequestSyntax) **   <a name="Backup-BGW_CreateGateway-request-Tags"></a>
게이트웨이에 할당할 최대 50개의 태그 목록입니다. 각 태그는 키-값 페어입니다.  
타입: [Tag](API_BGW_Tag.md)객체 배열  
필수: 아니요

## 응답 구문
<a name="API_BGW_CreateGateway_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_CreateGateway_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_CreateGateway_ResponseSyntax) **   <a name="Backup-BGW_CreateGateway-response-GatewayArn"></a>
생성하는 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_CreateGateway_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_CreateGateway_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/CreateGateway) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/CreateGateway) 

# DeleteGateway
<a name="API_BGW_DeleteGateway"></a>

백업 게이트웨이를 삭제합니다.

## 구문 요청
<a name="API_BGW_DeleteGateway_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_DeleteGateway_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_DeleteGateway_RequestSyntax) **   <a name="Backup-BGW_DeleteGateway-request-GatewayArn"></a>
삭제할 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_DeleteGateway_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_DeleteGateway_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_DeleteGateway_ResponseSyntax) **   <a name="Backup-BGW_DeleteGateway-response-GatewayArn"></a>
삭제한 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_DeleteGateway_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_DeleteGateway_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DeleteGateway) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DeleteGateway) 

# DeleteHypervisor
<a name="API_BGW_DeleteHypervisor"></a>

하이퍼바이저를 삭제합니다.

## 구문 요청
<a name="API_BGW_DeleteHypervisor_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_DeleteHypervisor_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [HypervisorArn](#API_BGW_DeleteHypervisor_RequestSyntax) **   <a name="Backup-BGW_DeleteHypervisor-request-HypervisorArn"></a>
삭제할 하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_DeleteHypervisor_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 응답 요소
<a name="API_BGW_DeleteHypervisor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [HypervisorArn](#API_BGW_DeleteHypervisor_ResponseSyntax) **   <a name="Backup-BGW_DeleteHypervisor-response-HypervisorArn"></a>
삭제한 하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_DeleteHypervisor_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
권한이 부족하여 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
권한이 부족한 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_DeleteHypervisor_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DeleteHypervisor) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DeleteHypervisor) 

# DisassociateGatewayFromServer
<a name="API_BGW_DisassociateGatewayFromServer"></a>

지정된 서버에서 백업 게이트웨이의 연결을 해제합니다. 연결 해제 프로세스가 끝나면 게이트웨이는 더 이상 서버의 가상 머신에 액세스할 수 없습니다.

## 구문 요청
<a name="API_BGW_DisassociateGatewayFromServer_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_DisassociateGatewayFromServer_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_DisassociateGatewayFromServer_RequestSyntax) **   <a name="Backup-BGW_DisassociateGatewayFromServer-request-GatewayArn"></a>
연결 해제할 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_DisassociateGatewayFromServer_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_DisassociateGatewayFromServer_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_DisassociateGatewayFromServer_ResponseSyntax) **   <a name="Backup-BGW_DisassociateGatewayFromServer-response-GatewayArn"></a>
연결 해제한 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_DisassociateGatewayFromServer_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_DisassociateGatewayFromServer_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/DisassociateGatewayFromServer) 

# GetBandwidthRateLimitSchedule
<a name="API_BGW_GetBandwidthRateLimitSchedule"></a>

지정된 게이트웨이의 대역폭 속도 제한 일정을 검색합니다. 기본적으로 게이트웨이에는 대역폭 속도 제한 일정이 없으므로, 대역폭 속도 제한이 적용되지 않습니다. 이를 사용하여 게이트웨이의 대역폭 속도 제한 일정을 가져올 수 있습니다.

## 구문 요청
<a name="API_BGW_GetBandwidthRateLimitSchedule_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_GetBandwidthRateLimitSchedule_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_GetBandwidthRateLimitSchedule_RequestSyntax) **   <a name="Backup-BGW_GetBandwidthRateLimitSchedule-request-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다. [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html) 작업을 사용하여 계정 및의 게이트웨이 목록을 반환합니다 AWS 리전.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax"></a>

```
{
   "BandwidthRateLimitIntervals": [ 
      { 
         "AverageUploadRateLimitInBitsPerSec": number,
         "DaysOfWeek": [ number ],
         "EndHourOfDay": number,
         "EndMinuteOfHour": number,
         "StartHourOfDay": number,
         "StartMinuteOfHour": number
      }
   ],
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_GetBandwidthRateLimitSchedule_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [BandwidthRateLimitIntervals](#API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax) **   <a name="Backup-BGW_GetBandwidthRateLimitSchedule-response-BandwidthRateLimitIntervals"></a>
게이트웨이의 대역폭 속도 제한 일정 간격이 포함된 배열입니다. 대역폭 속도 제한 간격이 예약되지 않은 경우, 배열은 비어 있습니다.  
타입: [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md)객체 배열  
배열 항목: 최소 항목 수는 0개. 최대 항목 수는 20개.

 ** [GatewayArn](#API_BGW_GetBandwidthRateLimitSchedule_ResponseSyntax) **   <a name="Backup-BGW_GetBandwidthRateLimitSchedule-response-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다. [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html) 작업을 사용하여 계정 및의 게이트웨이 목록을 반환합니다 AWS 리전.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_GetBandwidthRateLimitSchedule_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_GetBandwidthRateLimitSchedule_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetBandwidthRateLimitSchedule) 

# GetGateway
<a name="API_BGW_GetGateway"></a>

이 API는 Amazon 리소스 이름(ARN)을 제공하여 게이트웨이를 반환합니다.

## 구문 요청
<a name="API_BGW_GetGateway_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_GetGateway_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_GetGateway_RequestSyntax) **   <a name="Backup-BGW_GetGateway-request-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_GetGateway_ResponseSyntax"></a>

```
{
   "Gateway": { 
      "DeprecationDate": number,
      "GatewayArn": "string",
      "GatewayDisplayName": "string",
      "GatewayType": "string",
      "HypervisorId": "string",
      "LastSeenTime": number,
      "MaintenanceStartTime": { 
         "DayOfMonth": number,
         "DayOfWeek": number,
         "HourOfDay": number,
         "MinuteOfHour": number
      },
      "NextUpdateAvailabilityTime": number,
      "SoftwareVersion": "string",
      "VpcEndpoint": "string"
   }
}
```

## 응답 요소
<a name="API_BGW_GetGateway_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Gateway](#API_BGW_GetGateway_ResponseSyntax) **   <a name="Backup-BGW_GetGateway-response-Gateway"></a>
이 API는 Amazon 리소스 이름(ARN)을 제공하여 게이트웨이를 반환합니다.  
타입: [GatewayDetails](API_BGW_GatewayDetails.md) 객체

## 오류
<a name="API_BGW_GetGateway_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_GetGateway_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetGateway) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetGateway) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetGateway) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetGateway) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetGateway) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetGateway) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetGateway) 

# GetHypervisor
<a name="API_BGW_GetHypervisor"></a>

이 작업은 게이트웨이가 연결할 지정된 하이퍼바이저에 대한 정보를 요청합니다. 하이퍼바이저는 가상 머신을 생성 및 관리하고, 가상 머신에 리소스를 할당하는 하드웨어, 소프트웨어 또는 펌웨어입니다.

## 구문 요청
<a name="API_BGW_GetHypervisor_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_GetHypervisor_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [HypervisorArn](#API_BGW_GetHypervisor_RequestSyntax) **   <a name="Backup-BGW_GetHypervisor-request-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_GetHypervisor_ResponseSyntax"></a>

```
{
   "Hypervisor": { 
      "Host": "string",
      "HypervisorArn": "string",
      "KmsKeyArn": "string",
      "LastSuccessfulMetadataSyncTime": number,
      "LatestMetadataSyncStatus": "string",
      "LatestMetadataSyncStatusMessage": "string",
      "LogGroupArn": "string",
      "Name": "string",
      "State": "string"
   }
}
```

## 응답 요소
<a name="API_BGW_GetHypervisor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Hypervisor](#API_BGW_GetHypervisor_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisor-response-Hypervisor"></a>
요청한 하이퍼바이저에 대한 세부 정보입니다.  
타입: [HypervisorDetails](API_BGW_HypervisorDetails.md) 객체

## 오류
<a name="API_BGW_GetHypervisor_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_GetHypervisor_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetHypervisor) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetHypervisor) 

# GetHypervisorPropertyMappings
<a name="API_BGW_GetHypervisorPropertyMappings"></a>

이 작업은 지정된 하이퍼바이저의 속성 매핑을 검색합니다. 하이퍼바이저 속성 매핑은 하이퍼바이저에서 사용할 수 있는 개체 속성과에서 사용할 수 있는 속성의 관계를 표시합니다 AWS.

## 구문 요청
<a name="API_BGW_GetHypervisorPropertyMappings_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_GetHypervisorPropertyMappings_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [HypervisorArn](#API_BGW_GetHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-request-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_GetHypervisorPropertyMappings_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string",
   "IamRoleArn": "string",
   "VmwareToAwsTagMappings": [ 
      { 
         "AwsTagKey": "string",
         "AwsTagValue": "string",
         "VmwareCategory": "string",
         "VmwareTagName": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_BGW_GetHypervisorPropertyMappings_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [HypervisorArn](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-response-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

 ** [IamRoleArn](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-response-IamRoleArn"></a>
IAM 역할의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `arn:(aws|aws-cn|aws-us-gov):iam::([0-9]+):role/(\S+)` 

 ** [VmwareToAwsTagMappings](#API_BGW_GetHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_GetHypervisorPropertyMappings-response-VmwareToAwsTagMappings"></a>
 AWS 태그에 대한 VMware 태그의 매핑을 표시합니다.  
타입: [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md) 객체 배열

## 오류
<a name="API_BGW_GetHypervisorPropertyMappings_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_GetHypervisorPropertyMappings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetHypervisorPropertyMappings) 

# GetVirtualMachine
<a name="API_BGW_GetVirtualMachine"></a>

이 API는 Amazon 리소스 이름(ARN)을 제공하여 가상 머신을 반환합니다.

## 구문 요청
<a name="API_BGW_GetVirtualMachine_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_GetVirtualMachine_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_BGW_GetVirtualMachine_RequestSyntax) **   <a name="Backup-BGW_GetVirtualMachine-request-ResourceArn"></a>
가상 머신의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_GetVirtualMachine_ResponseSyntax"></a>

```
{
   "VirtualMachine": { 
      "HostName": "string",
      "HypervisorId": "string",
      "LastBackupDate": number,
      "Name": "string",
      "Path": "string",
      "ResourceArn": "string",
      "VmwareTags": [ 
         { 
            "VmwareCategory": "string",
            "VmwareTagDescription": "string",
            "VmwareTagName": "string"
         }
      ]
   }
}
```

## 응답 요소
<a name="API_BGW_GetVirtualMachine_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [VirtualMachine](#API_BGW_GetVirtualMachine_ResponseSyntax) **   <a name="Backup-BGW_GetVirtualMachine-response-VirtualMachine"></a>
이 객체에는 `GetVirtualMachine` 출력에 의해 포함된 `VirtualMachine`의 기본 속성이 들어 있습니다.  
타입: [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md) 객체

## 오류
<a name="API_BGW_GetVirtualMachine_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_GetVirtualMachine_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetVirtualMachine) 

# ImportHypervisorConfiguration
<a name="API_BGW_ImportHypervisorConfiguration"></a>

하이퍼바이저의 구성을 가져와서 하이퍼바이저에 연결합니다.

## 구문 요청
<a name="API_BGW_ImportHypervisorConfiguration_RequestSyntax"></a>

```
{
   "Host": "string",
   "KmsKeyArn": "string",
   "Name": "string",
   "Password": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "Username": "string"
}
```

## 요청 파라미터
<a name="API_BGW_ImportHypervisorConfiguration_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Host](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Host"></a>
하이퍼바이저의 서버 호스트입니다. 이는 IP 주소 또는 정규화된 도메인 이름(FQDN)일 수 있습니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 3입니다. 최대 길이 128.  
패턴: `.+`   
필수 여부: 예

 ** [KmsKeyArn](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-KmsKeyArn"></a>
하이퍼바이저의 AWS Key Management Service 입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `(^arn:(aws|aws-cn|aws-us-gov):kms:([a-zA-Z0-9-]+):([0-9]+):(key|alias)/(\S+)$)|(^alias/(\S+)$)`   
필수 여부: 아니요

 ** [Name](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Name"></a>
하이퍼바이저의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z0-9-]*`   
필수 여부: 예

 ** [Password](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Password"></a>
하이퍼바이저의 암호입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[ -~]+`   
필수 여부: 아니요

 ** [Tags](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Tags"></a>
가져오려는 하이퍼바이저 구성의 태그입니다.  
타입: [Tag](API_BGW_Tag.md)객체 배열  
필수: 아니요

 ** [Username](#API_BGW_ImportHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-request-Username"></a>
하이퍼바이저의 사용자 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`   
필수 여부: 아니요

## 응답 구문
<a name="API_BGW_ImportHypervisorConfiguration_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 응답 요소
<a name="API_BGW_ImportHypervisorConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [HypervisorArn](#API_BGW_ImportHypervisorConfiguration_ResponseSyntax) **   <a name="Backup-BGW_ImportHypervisorConfiguration-response-HypervisorArn"></a>
연결 해제한 하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_ImportHypervisorConfiguration_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
권한이 부족하여 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
권한이 부족한 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_ImportHypervisorConfiguration_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ImportHypervisorConfiguration) 

# ListGateways
<a name="API_BGW_ListGateways"></a>

 AWS 계정 에서가 소유한 백업 게이트웨이를 나열합니다 AWS 리전. 반환되는 목록은 게이트웨이 ARN(Amazon 리소스 이름) 순으로 반환됩니다.

## 구문 요청
<a name="API_BGW_ListGateways_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_BGW_ListGateways_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxResults](#API_BGW_ListGateways_RequestSyntax) **   <a name="Backup-BGW_ListGateways-request-MaxResults"></a>
나열할 최대 게이트웨이 수입니다.  
타입: 정수  
유효 범위: 최소값 1.  
필수 여부: 아니요

 ** [NextToken](#API_BGW_ListGateways_RequestSyntax) **   <a name="Backup-BGW_ListGateways-request-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_BGW_ListGateways_ResponseSyntax"></a>

```
{
   "Gateways": [ 
      { 
         "GatewayArn": "string",
         "GatewayDisplayName": "string",
         "GatewayType": "string",
         "HypervisorId": "string",
         "LastSeenTime": number
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_BGW_ListGateways_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Gateways](#API_BGW_ListGateways_ResponseSyntax) **   <a name="Backup-BGW_ListGateways-response-Gateways"></a>
게이트웨이 목록입니다.  
타입: [Gateway](API_BGW_Gateway.md)객체 배열

 ** [NextToken](#API_BGW_ListGateways_ResponseSyntax) **   <a name="Backup-BGW_ListGateways-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `maxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000입니다.  
패턴: `.+` 

## 오류
<a name="API_BGW_ListGateways_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_ListGateways_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListGateways) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListGateways) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListGateways) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListGateways) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListGateways) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListGateways) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListGateways) 

# ListHypervisors
<a name="API_BGW_ListHypervisors"></a>

하이퍼바이저를 나열합니다.

## 구문 요청
<a name="API_BGW_ListHypervisors_RequestSyntax"></a>

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_BGW_ListHypervisors_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [MaxResults](#API_BGW_ListHypervisors_RequestSyntax) **   <a name="Backup-BGW_ListHypervisors-request-MaxResults"></a>
나열할 최대 하이퍼바이저 수입니다.  
타입: 정수  
유효 범위: 최소값 1.  
필수 여부: 아니요

 ** [NextToken](#API_BGW_ListHypervisors_RequestSyntax) **   <a name="Backup-BGW_ListHypervisors-request-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `maxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_BGW_ListHypervisors_ResponseSyntax"></a>

```
{
   "Hypervisors": [ 
      { 
         "Host": "string",
         "HypervisorArn": "string",
         "KmsKeyArn": "string",
         "Name": "string",
         "State": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_BGW_ListHypervisors_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Hypervisors](#API_BGW_ListHypervisors_ResponseSyntax) **   <a name="Backup-BGW_ListHypervisors-response-Hypervisors"></a>
Amazon 리소스 이름(ARN) 순으로 정렬된 `Hypervisor` 객체 목록입니다.  
타입: [Hypervisor](API_BGW_Hypervisor.md)객체 배열

 ** [NextToken](#API_BGW_ListHypervisors_ResponseSyntax) **   <a name="Backup-BGW_ListHypervisors-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `maxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000입니다.  
패턴: `.+` 

## 오류
<a name="API_BGW_ListHypervisors_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_ListHypervisors_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListHypervisors) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListHypervisors) 

# ListTagsForResource
<a name="API_BGW_ListTagsForResource"></a>

Amazon 리소스 이름(ARN)을 기준으로 식별되는 리소스에 적용된 태그를 나열합니다.

## 구문 요청
<a name="API_BGW_ListTagsForResource_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_ListTagsForResource_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceArn](#API_BGW_ListTagsForResource_RequestSyntax) **   <a name="Backup-BGW_ListTagsForResource-request-ResourceArn"></a>
나열할 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_ListTagsForResource_ResponseSyntax"></a>

```
{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_BGW_ListTagsForResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ResourceArn](#API_BGW_ListTagsForResource_ResponseSyntax) **   <a name="Backup-BGW_ListTagsForResource-response-ResourceArn"></a>
나열한 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

 ** [Tags](#API_BGW_ListTagsForResource_ResponseSyntax) **   <a name="Backup-BGW_ListTagsForResource-response-Tags"></a>
리소스의 태그 목록입니다.  
타입: [Tag](API_BGW_Tag.md) 객체 배열

## 오류
<a name="API_BGW_ListTagsForResource_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_ListTagsForResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListTagsForResource) 

# ListVirtualMachines
<a name="API_BGW_ListVirtualMachines"></a>

가상 머신을 나열합니다.

## 구문 요청
<a name="API_BGW_ListVirtualMachines_RequestSyntax"></a>

```
{
   "HypervisorArn": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

## 요청 파라미터
<a name="API_BGW_ListVirtualMachines_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [HypervisorArn](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-HypervisorArn"></a>
가상 머신에 연결된 하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 아니요

 ** [MaxResults](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-MaxResults"></a>
나열할 최대 가상 머신 수입니다.  
타입: 정수  
유효 범위: 최소값 1.  
필수 여부: 아니요

 ** [NextToken](#API_BGW_ListVirtualMachines_RequestSyntax) **   <a name="Backup-BGW_ListVirtualMachines-request-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `maxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000입니다.  
패턴: `.+`   
필수 여부: 아니요

## 응답 구문
<a name="API_BGW_ListVirtualMachines_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "VirtualMachines": [ 
      { 
         "HostName": "string",
         "HypervisorId": "string",
         "LastBackupDate": number,
         "Name": "string",
         "Path": "string",
         "ResourceArn": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_BGW_ListVirtualMachines_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_BGW_ListVirtualMachines_ResponseSyntax) **   <a name="Backup-BGW_ListVirtualMachines-response-NextToken"></a>
반환된 리소스의 일부 목록 다음에 나오는 다음 항목입니다. 예를 들어, 리소스의 `maxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 1,000입니다.  
패턴: `.+` 

 ** [VirtualMachines](#API_BGW_ListVirtualMachines_ResponseSyntax) **   <a name="Backup-BGW_ListVirtualMachines-response-VirtualMachines"></a>
Amazon 리소스 이름(ARN) 순으로 정렬된 `VirtualMachine` 객체 목록입니다.  
타입: [VirtualMachine](API_BGW_VirtualMachine.md) 객체 배열

## 오류
<a name="API_BGW_ListVirtualMachines_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_ListVirtualMachines_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/ListVirtualMachines) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/ListVirtualMachines) 

# PutBandwidthRateLimitSchedule
<a name="API_BGW_PutBandwidthRateLimitSchedule"></a>

이 작업은 지정된 게이트웨이의 대역폭 속도 제한 일정을 설정합니다. 기본적으로 게이트웨이에는 대역폭 속도 제한 일정이 없으므로, 대역폭 속도 제한이 적용되지 않습니다. 이를 사용하여 게이트웨이의 대역폭 속도 제한 일정을 시작할 수 있습니다.

## 구문 요청
<a name="API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax"></a>

```
{
   "BandwidthRateLimitIntervals": [ 
      { 
         "AverageUploadRateLimitInBitsPerSec": number,
         "DaysOfWeek": [ number ],
         "EndHourOfDay": number,
         "EndMinuteOfHour": number,
         "StartHourOfDay": number,
         "StartMinuteOfHour": number
      }
   ],
   "GatewayArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_PutBandwidthRateLimitSchedule_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [BandwidthRateLimitIntervals](#API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax) **   <a name="Backup-BGW_PutBandwidthRateLimitSchedule-request-BandwidthRateLimitIntervals"></a>
게이트웨이의 대역폭 속도 제한 일정 간격이 포함된 배열입니다. 대역폭 속도 제한 간격이 예약되지 않은 경우, 배열은 비어 있습니다.  
타입: [BandwidthRateLimitInterval](API_BGW_BandwidthRateLimitInterval.md)객체 배열  
배열 항목: 최소 항목 수는 0개. 최대 항목 수는 20개.  
필수 항목 여부: 예

 ** [GatewayArn](#API_BGW_PutBandwidthRateLimitSchedule_RequestSyntax) **   <a name="Backup-BGW_PutBandwidthRateLimitSchedule-request-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다. [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html) 작업을 사용하여 계정 및의 게이트웨이 목록을 반환합니다 AWS 리전.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_PutBandwidthRateLimitSchedule_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_PutBandwidthRateLimitSchedule_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_PutBandwidthRateLimitSchedule_ResponseSyntax) **   <a name="Backup-BGW_PutBandwidthRateLimitSchedule-response-GatewayArn"></a>
게이트웨이의 Amazon 리소스 이름(ARN)입니다. [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_BGW_ListGateways.html) 작업을 사용하여 계정 및의 게이트웨이 목록을 반환합니다 AWS 리전.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_PutBandwidthRateLimitSchedule_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_PutBandwidthRateLimitSchedule_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutBandwidthRateLimitSchedule) 

# PutHypervisorPropertyMappings
<a name="API_BGW_PutHypervisorPropertyMappings"></a>

이 작업은 지정된 하이퍼바이저의 속성 매핑을 설정합니다. 하이퍼바이저 속성 매핑은 하이퍼바이저에서 사용할 수 있는 개체 속성과에서 사용할 수 있는 속성의 관계를 표시합니다 AWS.

## 구문 요청
<a name="API_BGW_PutHypervisorPropertyMappings_RequestSyntax"></a>

```
{
   "HypervisorArn": "string",
   "IamRoleArn": "string",
   "VmwareToAwsTagMappings": [ 
      { 
         "AwsTagKey": "string",
         "AwsTagValue": "string",
         "VmwareCategory": "string",
         "VmwareTagName": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_BGW_PutHypervisorPropertyMappings_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [HypervisorArn](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-request-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [IamRoleArn](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-request-IamRoleArn"></a>
IAM 역할의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `arn:(aws|aws-cn|aws-us-gov):iam::([0-9]+):role/(\S+)`   
필수 여부: 예

 ** [VmwareToAwsTagMappings](#API_BGW_PutHypervisorPropertyMappings_RequestSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-request-VmwareToAwsTagMappings"></a>
이 작업은 AWS 태그에 대한 VMware 태그의 매핑을 요청합니다.  
타입: [VmwareToAwsTagMapping](API_BGW_VmwareToAwsTagMapping.md)객체 배열  
필수 항목 여부: 예

## 응답 구문
<a name="API_BGW_PutHypervisorPropertyMappings_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 응답 요소
<a name="API_BGW_PutHypervisorPropertyMappings_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [HypervisorArn](#API_BGW_PutHypervisorPropertyMappings_ResponseSyntax) **   <a name="Backup-BGW_PutHypervisorPropertyMappings-response-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_PutHypervisorPropertyMappings_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
권한이 부족하여 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
권한이 부족한 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_PutHypervisorPropertyMappings_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutHypervisorPropertyMappings) 

# PutMaintenanceStartTime
<a name="API_BGW_PutMaintenanceStartTime"></a>

게이트웨이의 유지 관리 시작 시간을 설정합니다.

## 구문 요청
<a name="API_BGW_PutMaintenanceStartTime_RequestSyntax"></a>

```
{
   "DayOfMonth": number,
   "DayOfWeek": number,
   "GatewayArn": "string",
   "HourOfDay": number,
   "MinuteOfHour": number
}
```

## 요청 파라미터
<a name="API_BGW_PutMaintenanceStartTime_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [DayOfMonth](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-DayOfMonth"></a>
게이트웨이의 유지 관리를 시작하는 날짜입니다.  
사용할 수 있는 값은 `Sunday`\$1`Saturday`입니다.  
타입: 정수  
유효 범위: 최소값 1. 최대값은 31입니다.  
필수 여부: 아니요

 ** [DayOfWeek](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-DayOfWeek"></a>
게이트웨이의 유지 관리를 시작하는 요일입니다.  
유형: 정수  
유효 범위: 최소값 0. 최대값은 6입니다.  
필수 여부: 아니요

 ** [GatewayArn](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-GatewayArn"></a>
유지 관리 시작 시간을 지정하는 데 사용되는 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [HourOfDay](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-HourOfDay"></a>
게이트웨이의 유지 관리를 시작하는 시각입니다.  
유형: 정수  
유효 범위: 최소값 0. 최대값은 23입니다.  
필수 항목 여부: 예

 ** [MinuteOfHour](#API_BGW_PutMaintenanceStartTime_RequestSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-request-MinuteOfHour"></a>
게이트웨이의 유지 관리를 시작하는 시간(분)입니다.  
유형: 정수  
유효 범위: 최소값 0. 최대값은 59입니다.  
필수 항목 여부: 예

## 응답 구문
<a name="API_BGW_PutMaintenanceStartTime_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_PutMaintenanceStartTime_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_PutMaintenanceStartTime_ResponseSyntax) **   <a name="Backup-BGW_PutMaintenanceStartTime-response-GatewayArn"></a>
유지 관리 시작 시간을 설정한 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_PutMaintenanceStartTime_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_PutMaintenanceStartTime_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/PutMaintenanceStartTime) 

# StartVirtualMachinesMetadataSync
<a name="API_BGW_StartVirtualMachinesMetadataSync"></a>

이 작업은 지정된 가상 머신 전체에서 메타데이터를 동기화하라는 요청을 보냅니다.

## 구문 요청
<a name="API_BGW_StartVirtualMachinesMetadataSync_RequestSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_StartVirtualMachinesMetadataSync_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [HypervisorArn](#API_BGW_StartVirtualMachinesMetadataSync_RequestSyntax) **   <a name="Backup-BGW_StartVirtualMachinesMetadataSync-request-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_StartVirtualMachinesMetadataSync_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 응답 요소
<a name="API_BGW_StartVirtualMachinesMetadataSync_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [HypervisorArn](#API_BGW_StartVirtualMachinesMetadataSync_ResponseSyntax) **   <a name="Backup-BGW_StartVirtualMachinesMetadataSync-response-HypervisorArn"></a>
하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_StartVirtualMachinesMetadataSync_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
권한이 부족하여 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
권한이 부족한 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_StartVirtualMachinesMetadataSync_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/StartVirtualMachinesMetadataSync) 

# TagResource
<a name="API_BGW_TagResource"></a>

리소스에 태그를 지정합니다.

## 구문 요청
<a name="API_BGW_TagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_BGW_TagResource_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceARN](#API_BGW_TagResource_RequestSyntax) **   <a name="Backup-BGW_TagResource-request-ResourceARN"></a>
태그를 지정할 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [Tags](#API_BGW_TagResource_RequestSyntax) **   <a name="Backup-BGW_TagResource-request-Tags"></a>
리소스에 할당할 태그 목록입니다.  
타입: [Tag](API_BGW_Tag.md)객체 배열  
필수 항목 여부: 예

## 응답 구문
<a name="API_BGW_TagResource_ResponseSyntax"></a>

```
{
   "ResourceARN": "string"
}
```

## 응답 요소
<a name="API_BGW_TagResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ResourceARN](#API_BGW_TagResource_ResponseSyntax) **   <a name="Backup-BGW_TagResource-response-ResourceARN"></a>
태그를 지정한 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_TagResource_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_TagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/TagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/TagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/TagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/TagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/TagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/TagResource) 

# TestHypervisorConfiguration
<a name="API_BGW_TestHypervisorConfiguration"></a>

하이퍼바이저 구성을 테스트하여 백업 게이트웨이가 하이퍼바이저 및 해당 리소스와 연결할 수 있는지 확인합니다.

## 구문 요청
<a name="API_BGW_TestHypervisorConfiguration_RequestSyntax"></a>

```
{
   "GatewayArn": "string",
   "Host": "string",
   "Password": "string",
   "Username": "string"
}
```

## 요청 파라미터
<a name="API_BGW_TestHypervisorConfiguration_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-GatewayArn"></a>
테스트할 하이퍼바이저에 대한 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [Host](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-Host"></a>
하이퍼바이저의 서버 호스트입니다. 이는 IP 주소 또는 정규화된 도메인 이름(FQDN)일 수 있습니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 3입니다. 최대 길이 128.  
패턴: `.+`   
필수 여부: 예

 ** [Password](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-Password"></a>
하이퍼바이저의 암호입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[ -~]+`   
필수 여부: 아니요

 ** [Username](#API_BGW_TestHypervisorConfiguration_RequestSyntax) **   <a name="Backup-BGW_TestHypervisorConfiguration-request-Username"></a>
하이퍼바이저의 사용자 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`   
필수 여부: 아니요

## 응답 요소
<a name="API_BGW_TestHypervisorConfiguration_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_BGW_TestHypervisorConfiguration_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_TestHypervisorConfiguration_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/TestHypervisorConfiguration) 

# UntagResource
<a name="API_BGW_UntagResource"></a>

리소스에서 태그를 제거합니다.

## 구문 요청
<a name="API_BGW_UntagResource_RequestSyntax"></a>

```
{
   "ResourceARN": "string",
   "TagKeys": [ "string" ]
}
```

## 요청 파라미터
<a name="API_BGW_UntagResource_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ResourceARN](#API_BGW_UntagResource_RequestSyntax) **   <a name="Backup-BGW_UntagResource-request-ResourceARN"></a>
태그를 제거할 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [TagKeys](#API_BGW_UntagResource_RequestSyntax) **   <a name="Backup-BGW_UntagResource-request-TagKeys"></a>
제거할 태그를 지정하는 태그 키 목록입니다.  
유형: 문자열 배열  
길이 제약: 최소 길이 1. 최대 길이 128.  
패턴: `([\p{L}\p{Z}\p{N}_.:/=+\-@]*)`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_UntagResource_ResponseSyntax"></a>

```
{
   "ResourceARN": "string"
}
```

## 응답 요소
<a name="API_BGW_UntagResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ResourceARN](#API_BGW_UntagResource_ResponseSyntax) **   <a name="Backup-BGW_UntagResource-response-ResourceARN"></a>
태그를 제거한 리소스의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_UntagResource_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_UntagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UntagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UntagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UntagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UntagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UntagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UntagResource) 

# UpdateGatewayInformation
<a name="API_BGW_UpdateGatewayInformation"></a>

게이트웨이의 이름을 업데이트합니다. 요청 시 게이트웨이의 Amazon 리소스 이름(ARN)을 사용하여 업데이트할 게이트웨이를 지정합니다.

## 구문 요청
<a name="API_BGW_UpdateGatewayInformation_RequestSyntax"></a>

```
{
   "GatewayArn": "string",
   "GatewayDisplayName": "string"
}
```

## 요청 파라미터
<a name="API_BGW_UpdateGatewayInformation_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_UpdateGatewayInformation_RequestSyntax) **   <a name="Backup-BGW_UpdateGatewayInformation-request-GatewayArn"></a>
업데이트할 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [GatewayDisplayName](#API_BGW_UpdateGatewayInformation_RequestSyntax) **   <a name="Backup-BGW_UpdateGatewayInformation-request-GatewayDisplayName"></a>
게이트웨이의 업데이트된 표시 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z0-9-]*`   
필수 여부: 아니요

## 응답 구문
<a name="API_BGW_UpdateGatewayInformation_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_UpdateGatewayInformation_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_UpdateGatewayInformation_ResponseSyntax) **   <a name="Backup-BGW_UpdateGatewayInformation-response-GatewayArn"></a>
업데이트한 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_UpdateGatewayInformation_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_UpdateGatewayInformation_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateGatewayInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateGatewayInformation) 

# UpdateGatewaySoftwareNow
<a name="API_BGW_UpdateGatewaySoftwareNow"></a>

게이트웨이 가상 머신(VM) 소프트웨어를 업데이트합니다. 요청은 소프트웨어 업데이트를 즉시 트리거합니다.

**참고**  
이 요청을 할 경우, `200 OK` 성공 응답을 즉시 받게 됩니다. 그러나 업데이트가 완료되는 데 다소 시간이 걸릴 수 있습니다.

## 구문 요청
<a name="API_BGW_UpdateGatewaySoftwareNow_RequestSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 요청 파라미터
<a name="API_BGW_UpdateGatewaySoftwareNow_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [GatewayArn](#API_BGW_UpdateGatewaySoftwareNow_RequestSyntax) **   <a name="Backup-BGW_UpdateGatewaySoftwareNow-request-GatewayArn"></a>
업데이트할 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

## 응답 구문
<a name="API_BGW_UpdateGatewaySoftwareNow_ResponseSyntax"></a>

```
{
   "GatewayArn": "string"
}
```

## 응답 요소
<a name="API_BGW_UpdateGatewaySoftwareNow_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [GatewayArn](#API_BGW_UpdateGatewaySoftwareNow_ResponseSyntax) **   <a name="Backup-BGW_UpdateGatewaySoftwareNow-response-GatewayArn"></a>
업데이트한 게이트웨이의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 180입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_UpdateGatewaySoftwareNow_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_UpdateGatewaySoftwareNow_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateGatewaySoftwareNow) 

# UpdateHypervisor
<a name="API_BGW_UpdateHypervisor"></a>

호스트, 사용자 이름, 암호를 포함한 하이퍼바이저 메타데이터를 업데이트합니다. 요청 시 하이퍼바이저의 Amazon 리소스 이름(ARN)을 사용하여 업데이트할 하이퍼바이저를 지정합니다.

## 구문 요청
<a name="API_BGW_UpdateHypervisor_RequestSyntax"></a>

```
{
   "Host": "string",
   "HypervisorArn": "string",
   "LogGroupArn": "string",
   "Name": "string",
   "Password": "string",
   "Username": "string"
}
```

## 요청 파라미터
<a name="API_BGW_UpdateHypervisor_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Host](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Host"></a>
하이퍼바이저의 업데이트된 호스트입니다. 이는 IP 주소 또는 정규화된 도메인 이름(FQDN)일 수 있습니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 3입니다. 최대 길이 128.  
패턴: `.+`   
필수 여부: 아니요

 ** [HypervisorArn](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-HypervisorArn"></a>
업데이트할 하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
필수 여부: 예

 ** [LogGroupArn](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-LogGroupArn"></a>
요청한 로그 내 게이트웨이 그룹의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 2,048.  
패턴: `$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*`   
필수 여부: 아니요

 ** [Name](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Name"></a>
하이퍼바이저의 업데이트된 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[a-zA-Z0-9-]*`   
필수 여부: 아니요

 ** [Password](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Password"></a>
하이퍼바이저의 업데이트된 암호입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[ -~]+`   
필수 여부: 아니요

 ** [Username](#API_BGW_UpdateHypervisor_RequestSyntax) **   <a name="Backup-BGW_UpdateHypervisor-request-Username"></a>
하이퍼바이저의 업데이트된 사용자 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 100.  
패턴: `[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*`   
필수 여부: 아니요

## 응답 구문
<a name="API_BGW_UpdateHypervisor_ResponseSyntax"></a>

```
{
   "HypervisorArn": "string"
}
```

## 응답 요소
<a name="API_BGW_UpdateHypervisor_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [HypervisorArn](#API_BGW_UpdateHypervisor_ResponseSyntax) **   <a name="Backup-BGW_UpdateHypervisor-response-HypervisorArn"></a>
업데이트된 하이퍼바이저의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최소 길이는 50입니다. 최대 길이는 500입니다.  
패턴: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+` 

## 오류
<a name="API_BGW_UpdateHypervisor_Errors"></a>

모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
권한이 부족하여 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
권한이 부족한 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ConflictException **   
지원되지 않기 때문에 작업을 계속할 수 없습니다.    
 ** ErrorCode **   
작업이 지원되지 않는 이유에 대한 설명입니다.
HTTP 상태 코드: 400

 ** InternalServerException **   
내부 오류가 발생하여 작업에 성공하지 못했습니다. 나중에 다시 시도해 주세요.    
 ** ErrorCode **   
어떤 내부 오류가 발생했는지에 대한 설명입니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
작업에 필요한 리소스를 찾을 수 없습니다.    
 ** ErrorCode **   
찾을 수 없는 리소스에 대한 설명입니다.
HTTP 상태 코드: 400

 ** ThrottlingException **   
TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.    
 ** ErrorCode **   
오류: TPS는 의도적이거나 의도하지 않은 대량 요청으로부터 보호하기 위해 제한되었습니다.
HTTP 상태 코드: 400

 ** ValidationException **   
검증 오류가 발생하여 작업에 성공하지 못했습니다.    
 ** ErrorCode **   
유효성 검사 오류의 원인에 대한 설명입니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BGW_UpdateHypervisor_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/UpdateHypervisor) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/UpdateHypervisor) 

# AWS Backup 검색
<a name="API_Operations_AWS_Backup_Search"></a>

다음 작업은 AWS Backup 검색에서 지원됩니다.
+  [GetSearchJob](API_BKS_GetSearchJob.md) 
+  [GetSearchResultExportJob](API_BKS_GetSearchResultExportJob.md) 
+  [ListSearchJobBackups](API_BKS_ListSearchJobBackups.md) 
+  [ListSearchJobResults](API_BKS_ListSearchJobResults.md) 
+  [ListSearchJobs](API_BKS_ListSearchJobs.md) 
+  [ListSearchResultExportJobs](API_BKS_ListSearchResultExportJobs.md) 
+  [ListTagsForResource](API_BKS_ListTagsForResource.md) 
+  [StartSearchJob](API_BKS_StartSearchJob.md) 
+  [StartSearchResultExportJob](API_BKS_StartSearchResultExportJob.md) 
+  [StopSearchJob](API_BKS_StopSearchJob.md) 
+  [TagResource](API_BKS_TagResource.md) 
+  [UntagResource](API_BKS_UntagResource.md) 

# GetSearchJob
<a name="API_BKS_GetSearchJob"></a>

이 작업은 진행 상황을 포함하여 검색 작업의 메타데이터를 검색합니다.

## Request Syntax
<a name="API_BKS_GetSearchJob_RequestSyntax"></a>

```
GET /search-jobs/SearchJobIdentifier HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_GetSearchJob_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_RequestSyntax) **   <a name="Backup-BKS_GetSearchJob-request-uri-SearchJobIdentifier"></a>
검색 작업을 지정하는 필수 고유 문자열입니다.  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_GetSearchJob_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_GetSearchJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompletionTime": number,
   "CreationTime": number,
   "CurrentSearchProgress": { 
      "ItemsMatchedCount": number,
      "ItemsScannedCount": number,
      "RecoveryPointsScannedCount": number
   },
   "EncryptionKeyArn": "string",
   "ItemFilters": { 
      "EBSItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "FilePaths": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "LastModificationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ]
         }
      ],
      "S3ItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "ETags": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "ObjectKeys": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "VersionIds": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ]
         }
      ]
   },
   "Name": "string",
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string",
   "SearchScope": { 
      "BackupResourceArns": [ "string" ],
      "BackupResourceCreationTime": { 
         "CreatedAfter": number,
         "CreatedBefore": number
      },
      "BackupResourceTags": { 
         "string" : "string" 
      },
      "BackupResourceTypes": [ "string" ],
      "SourceResourceArns": [ "string" ]
   },
   "SearchScopeSummary": { 
      "TotalItemsToScanCount": number,
      "TotalRecoveryPointsToScanCount": number
   },
   "Status": "string",
   "StatusMessage": "string"
}
```

## 응답 요소
<a name="API_BKS_GetSearchJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CompletionTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CompletionTime"></a>
검색 작업이 완료된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CompletionTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [CreationTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CreationTime"></a>
검색 작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CompletionTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [CurrentSearchProgress](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CurrentSearchProgress"></a>
BackupsScannedCount, ItemsScanned 및 ItemsMatched를 나타내는 숫자를 반환합니다.  
유형: [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md)객체

 ** [EncryptionKeyArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-EncryptionKeyArn"></a>
지정된 검색 작업에 대한 암호화 키입니다.  
예시: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
유형: 문자열

 ** [ItemFilters](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-ItemFilters"></a>
항목 필터는 검색 생성 시 지정된 모든 입력 항목 속성을 나타냅니다.  
유형: [ItemFilters](API_BKS_ItemFilters.md)객체

 ** [Name](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Name"></a>
지정된 검색 작업의 반환된 이름입니다.  
유형: 문자열

 ** [SearchJobArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobArn"></a>
지정된 검색 작업의 Amazon 리소스 이름(ARN)을 식별하는 고유 문자열입니다.  
유형: 문자열

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobIdentifier"></a>
지정된 검색 작업을 식별하는 고유 문자열입니다.  
유형: 문자열

 ** [SearchScope](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScope"></a>
검색 범위는 검색에 입력되는 모든 백업 속성입니다.  
유형: [SearchScope](API_BKS_SearchScope.md)객체

 ** [SearchScopeSummary](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScopeSummary"></a>
다음을 포함하여 지정된 검색 작업 범위에 대한 요약을 반환했습니다.  
+ TotalBackupsToScanCount, 검색에서 반환된 복구 시점 수입니다.
+ TotalItemsToScanCount, 검색에서 반환된 항목의 수입니다.
유형: [SearchScopeSummary](API_BKS_SearchScopeSummary.md)객체

 ** [Status](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Status"></a>
지정된 검색 작업의 현재 상태입니다.  
검색 작업의 상태는 `RUNNING`, `COMPLETED`, `STOPPED`, `FAILED`, `TIMED_OUT` 또는 `EXPIRED` 중 하나일 수 있습니다.  
타입: 문자열  
유효 값: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [StatusMessage](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-StatusMessage"></a>
상태가 `ERRORED`인 검색 작업 또는 문제가 있는 `COMPLETED` 작업 상태에 대한 상태 메시지가 반환됩니다.  
예를 들어 권한 문제로 인해 검색에 스캔할 수 없는 복구 시점이 포함되어 있다는 메시지가 표시될 수 있습니다.  
유형: 문자열

## 오류
<a name="API_BKS_GetSearchJob_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_GetSearchJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchJob) 

# GetSearchResultExportJob
<a name="API_BKS_GetSearchResultExportJob"></a>

이 작업은 내보내기 작업의 메타데이터를 검색합니다.

내보내기 작업은 검색 작업의 결과를 .csv 파일의 지정된 S3 버킷으로 전송하는 작업입니다.

내보내기 작업을 사용하면 검색 작업의 예약된 보존 기간인 7일을 초과하여 검색 결과를 보존할 수 있습니다.

## Request Syntax
<a name="API_BKS_GetSearchResultExportJob_RequestSyntax"></a>

```
GET /export-search-jobs/ExportJobIdentifier HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_GetSearchResultExportJob_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ExportJobIdentifier](#API_BKS_GetSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-request-uri-ExportJobIdentifier"></a>
특정 내보내기 작업을 식별하는 고유한 문자열입니다.  
이 작업에 필요합니다.  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_GetSearchResultExportJob_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_GetSearchResultExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CompletionTime": number,
   "CreationTime": number,
   "ExportJobArn": "string",
   "ExportJobIdentifier": "string",
   "ExportSpecification": { ... },
   "SearchJobArn": "string",
   "Status": "string",
   "StatusMessage": "string"
}
```

## 응답 요소
<a name="API_BKS_GetSearchResultExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CompletionTime](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-CompletionTime"></a>
내보내기 작업이 완료된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [CreationTime](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-CreationTime"></a>
내보내기 작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CreationTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [ExportJobArn](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-ExportJobArn"></a>
내보내기 작업을 고유하게 식별하는 고유한 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열

 ** [ExportJobIdentifier](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-ExportJobIdentifier"></a>
지정된 내보내기 작업을 식별하는 고유한 문자열입니다.  
유형: 문자열

 ** [ExportSpecification](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-ExportSpecification"></a>
내보내기 사양은 검색 결과를 내보낸 대상 S3 버킷과 대상 접두사로 구성됩니다.  
유형: [ExportSpecification](API_BKS_ExportSpecification.md)객체  
 **참고: **이 객체는 Union입니다. 이 객체의 멤버는 하나만 지정하거나 반환할 수 있습니다.

 ** [SearchJobArn](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-SearchJobArn"></a>
지정된 검색 작업의 Amazon 리소스 이름(ARN)을 식별하는 고유 문자열입니다.  
유형: 문자열

 ** [Status](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-Status"></a>
내보내기 작업의 현재 상태입니다.  
타입: 문자열  
유효 값: `RUNNING | FAILED | COMPLETED` 

 ** [StatusMessage](#API_BKS_GetSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchResultExportJob-response-StatusMessage"></a>
상태 메시지는 작업을 수정하고 재시도하는 단계와 함께 상태가 `FAILED`인 검색 작업에 대해 반환되는 문자열입니다.  
유형: 문자열

## 오류
<a name="API_BKS_GetSearchResultExportJob_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_GetSearchResultExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchResultExportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchResultExportJob) 

# ListSearchJobBackups
<a name="API_BKS_ListSearchJobBackups"></a>

이 작업은 검색 작업에 포함된 페이지 매김 형식의 모든 백업(복구 지점) 목록을 반환합니다.

검색 결과 예상 백업이 표시되지 않는 경우 이 작업을 호출하여 검색에 포함된 각 백업을 표시할 수 있습니다. 권한 문제로 인해 `FAILED` 상태가 되어 포함되지 않은 모든 백업은 상태 메시지와 함께 표시됩니다.

백업 인덱스 상태가 `ACTIVE`인 복구 시점만 검색 결과에 포함됩니다. 인덱스에 다른 상태가 있는 경우 상태 메시지와 함께 상태가 표시됩니다.

## Request Syntax
<a name="API_BKS_ListSearchJobBackups_RequestSyntax"></a>

```
GET /search-jobs/SearchJobIdentifier/backups?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_ListSearchJobBackups_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_BKS_ListSearchJobBackups_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_BKS_ListSearchJobBackups_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-request-uri-NextToken"></a>
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [SearchJobIdentifier](#API_BKS_ListSearchJobBackups_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-request-uri-SearchJobIdentifier"></a>
검색 작업을 지정하는 고유한 문자열입니다.  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_ListSearchJobBackups_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_ListSearchJobBackups_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { 
         "BackupCreationTime": number,
         "BackupResourceArn": "string",
         "IndexCreationTime": number,
         "ResourceType": "string",
         "SourceResourceArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_BKS_ListSearchJobBackups_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_BKS_ListSearchJobBackups_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-response-NextToken"></a>
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [Results](#API_BKS_ListSearchJobBackups_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobBackups-response-Results"></a>
복구 시점이 검색 작업의 결과를 반환했습니다.  
타입: [SearchJobBackupsResult](API_BKS_SearchJobBackupsResult.md) 객체 배열

## 오류
<a name="API_BKS_ListSearchJobBackups_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_ListSearchJobBackups_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobBackups) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobBackups) 

# ListSearchJobResults
<a name="API_BKS_ListSearchJobResults"></a>

이 작업은 지정된 검색 작업의 목록을 반환합니다.

## Request Syntax
<a name="API_BKS_ListSearchJobResults_RequestSyntax"></a>

```
GET /search-jobs/SearchJobIdentifier/search-results?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_ListSearchJobResults_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_BKS_ListSearchJobResults_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobResults-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_BKS_ListSearchJobResults_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobResults-request-uri-NextToken"></a>
반환된 검색 작업 결과의 일부 목록 다음에 나오는 다음 항목입니다.  
예를 들어, 검색 작업 결과의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [SearchJobIdentifier](#API_BKS_ListSearchJobResults_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobResults-request-uri-SearchJobIdentifier"></a>
검색 작업을 지정하는 고유한 문자열입니다.  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_ListSearchJobResults_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_ListSearchJobResults_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Results": [ 
      { ... }
   ]
}
```

## 응답 요소
<a name="API_BKS_ListSearchJobResults_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_BKS_ListSearchJobResults_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobResults-response-NextToken"></a>
검색 작업 결과의 일부 목록 다음에 나오는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [Results](#API_BKS_ListSearchJobResults_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobResults-response-Results"></a>
결과는 EBSResultItem 또는 S3ResultItem으로 구성됩니다.  
타입: [ResultItem](API_BKS_ResultItem.md) 객체 배열

## 오류
<a name="API_BKS_ListSearchJobResults_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_ListSearchJobResults_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobResults) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobResults) 

# ListSearchJobs
<a name="API_BKS_ListSearchJobs"></a>

이 작업은 계정에 속한 검색 작업 목록을 반환합니다.

## Request Syntax
<a name="API_BKS_ListSearchJobs_RequestSyntax"></a>

```
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_ListSearchJobs_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-ByStatus"></a>
검색 작업 상태를 기준으로 목록을 필터링하려면 이 파라미터를 포함합니다.  
유효한 값: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-NextToken"></a>
반환된 검색 작업의 일부 목록 다음에 나오는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

## Request Body
<a name="API_BKS_ListSearchJobs_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_ListSearchJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "SearchJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "Name": "string",
         "SearchJobArn": "string",
         "SearchJobIdentifier": "string",
         "SearchScopeSummary": { 
            "TotalItemsToScanCount": number,
            "TotalRecoveryPointsToScanCount": number
         },
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## 응답 요소
<a name="API_BKS_ListSearchJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [NextToken](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-NextToken"></a>
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

 ** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-SearchJobs"></a>
반환된 검색 작업의 세부 정보가 포함된 목록의 검색 작업입니다.  
타입: [SearchJobSummary](API_BKS_SearchJobSummary.md) 객체 배열

## 오류
<a name="API_BKS_ListSearchJobs_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_ListSearchJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs) 

# ListSearchResultExportJobs
<a name="API_BKS_ListSearchResultExportJobs"></a>

이 작업은 검색 작업의 검색 결과를 지정된 대상 S3 버킷으로 내보냅니다.

## Request Syntax
<a name="API_BKS_ListSearchResultExportJobs_RequestSyntax"></a>

```
GET /export-search-jobs?MaxResults=MaxResults&NextToken=NextToken&SearchJobIdentifier=SearchJobIdentifier&Status=Status HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_ListSearchResultExportJobs_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [MaxResults](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-MaxResults"></a>
반환할 리소스 목록 항목의 최대 수입니다.  
유효한 범위: 최소값은 1입니다. 최대값은 1000입니다.

 ** [NextToken](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-NextToken"></a>
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.

 ** [SearchJobIdentifier](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-SearchJobIdentifier"></a>
검색 작업을 지정하는 고유한 문자열입니다.

 ** [Status](#API_BKS_ListSearchResultExportJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-request-uri-Status"></a>
내보내기 작업에 포함할 검색 작업은 이 파라미터를 포함하여 필터링할 수 있습니다.  
유효한 값: `RUNNING | FAILED | COMPLETED` 

## Request Body
<a name="API_BKS_ListSearchResultExportJobs_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_ListSearchResultExportJobs_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "ExportJobArn": "string",
         "ExportJobIdentifier": "string",
         "SearchJobArn": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ],
   "NextToken": "string"
}
```

## 응답 요소
<a name="API_BKS_ListSearchResultExportJobs_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExportJobs](#API_BKS_ListSearchResultExportJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-response-ExportJobs"></a>
작업은 포함된 내보내기 작업을 반환합니다.  
타입: [ExportJobSummary](API_BKS_ExportJobSummary.md)객체 배열

 ** [NextToken](#API_BKS_ListSearchResultExportJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchResultExportJobs-response-NextToken"></a>
검색 작업에 포함된 반환된 백업의 부분 목록을 따르는 다음 항목입니다.  
예를 들어, 백업의 `MaxResults` 수를 반환하기 위한 요청을 한 경우, `NextToken`을 사용하면 다음 토큰이 가리키는 위치에서 시작하여 목록에 있는 추가 항목을 반환할 수 있습니다.  
유형: 문자열

## 오류
<a name="API_BKS_ListSearchResultExportJobs_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ServiceQuotaExceededException **   
허용된 할당량 한도를 초과하여 요청이 거부되었습니다.    
 ** message **   
서비스 할당량이 한도를 초과하여 이 요청이 성공하지 못했습니다.  
 ** quotaCode **   
할당량 유형과 관련된 코드입니다.  
 ** resourceId **   
리소스의 식별자입니다.  
 ** resourceType **   
리소스의 유형입니다.  
 ** serviceCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 402

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_ListSearchResultExportJobs_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchResultExportJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchResultExportJobs) 

# ListTagsForResource
<a name="API_BKS_ListTagsForResource"></a>

이 작업은 리소스 유형에 대한 태그를 반환합니다.

## Request Syntax
<a name="API_BKS_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/ResourceArn HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_ListTagsForResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ResourceArn](#API_BKS_ListTagsForResource_RequestSyntax) **   <a name="Backup-BKS_ListTagsForResource-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.>  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_ListTagsForResource_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## 응답 요소
<a name="API_BKS_ListTagsForResource_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [Tags](#API_BKS_ListTagsForResource_ResponseSyntax) **   <a name="Backup-BKS_ListTagsForResource-response-Tags"></a>
작업으로 반환된 태그의 목록입니다.  
유형: 문자열 간 맵

## 오류
<a name="API_BKS_ListTagsForResource_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_ListTagsForResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListTagsForResource) 

# StartSearchJob
<a name="API_BKS_StartSearchJob"></a>

이 작업은 SearchScope와 ItemFilters로 필터링된 항목을 반환하는 검색 작업을 생성합니다.

선택적으로 ClientToken, EncryptionKeyArn, 이름 및/또는 태그를 포함할 수 있습니다.

## Request Syntax
<a name="API_BKS_StartSearchJob_RequestSyntax"></a>

```
PUT /search-jobs HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "EncryptionKeyArn": "string",
   "ItemFilters": { 
      "EBSItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "FilePaths": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "LastModificationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ]
         }
      ],
      "S3ItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "ETags": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "ObjectKeys": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "VersionIds": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ]
         }
      ]
   },
   "Name": "string",
   "SearchScope": { 
      "BackupResourceArns": [ "string" ],
      "BackupResourceCreationTime": { 
         "CreatedAfter": number,
         "CreatedBefore": number
      },
      "BackupResourceTags": { 
         "string" : "string" 
      },
      "BackupResourceTypes": [ "string" ],
      "SourceResourceArns": [ "string" ]
   },
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_BKS_StartSearchJob_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_BKS_StartSearchJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ClientToken](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-ClientToken"></a>
멱등성을 위해 여러 개의 동일한 호출을 허용하려면 이 파라미터를 포함합니다.  
클라이언트 토큰은 해당 토큰을 사용하는 첫 번째 요청이 완료된 후 8시간 동안 유효합니다. 이 시간 이후에는 동일한 토큰을 사용하는 모든 요청은 새로운 요청으로 처리됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [EncryptionKeyArn](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-EncryptionKeyArn"></a>
지정된 검색 작업에 대한 암호화 키입니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [ItemFilters](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-ItemFilters"></a>
항목 필터는 검색 생성 시 지정된 모든 입력 항목 속성을 나타냅니다.  
EBSItemFilters 또는 S3ItemFilters 포함  
유형: [ItemFilters](API_BKS_ItemFilters.md)객체  
필수 여부: 아니요

 ** [Name](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-Name"></a>
영숫자를 포함하여 이 검색 작업의 이름을 생성합니다.  
유형: 문자열  
길이 제한: 최소 길이는 0. 최대 길이는 500입니다.  
필수 여부: 아니요

 ** [SearchScope](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-SearchScope"></a>
이 개체에는 BackupResourceTypes, BackupResourceArns, BackupResourceCreationTime, BackupResourceTags 및 SourceResourceArns가 포함되어 검색 작업에서 반환되는 복구 시점을 필터링할 수 있습니다.  
타입: [SearchScope](API_BKS_SearchScope.md)객체  
필수 항목 여부: 예

 ** [Tags](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-Tags"></a>
작업으로 반환된 태그의 목록입니다.  
유형: 문자열 대 문자열 맵  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_BKS_StartSearchJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string"
}
```

## 응답 요소
<a name="API_BKS_StartSearchJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [CreationTime](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-CreationTime"></a>
작업이 생성된 날짜 및 시간(Unix 형식 및 협정 세계시(UTC))입니다. `CompletionTime`의 값은 밀리초 단위로 정확합니다. 예를 들어, 1516925490.087이라는 값은 2018년 1월 26일 금요일 오전 12:11:30.087을 나타냅니다.  
유형: 타임스탬프

 ** [SearchJobArn](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-SearchJobArn"></a>
지정된 검색 작업의 Amazon 리소스 이름(ARN)을 식별하는 고유 문자열입니다.  
유형: 문자열

 ** [SearchJobIdentifier](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-SearchJobIdentifier"></a>
검색 작업을 지정하는 고유한 문자열입니다.  
유형: 문자열

## 오류
<a name="API_BKS_StartSearchJob_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** ConflictException **   
이 예외는 이전에 성공한 작업과의 충돌이 감지될 때 발생합니다. 이는 일반적으로 이전 작업이 현재 요청을 처리하는 호스트로 전파할 시간이 없을 때 발생합니다.  
이 예외에 대한 권장 응답은 재시도(적절한 백오프 로직 사용)입니다.    
 ** message **   
리소스를 업데이트하거나 삭제하면 상태가 일관되지 않을 수 있습니다.  
 ** resourceId **   
영향을 받는 리소스의 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 유형입니다.
HTTP 상태 코드: 409

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ServiceQuotaExceededException **   
허용된 할당량 한도를 초과하여 요청이 거부되었습니다.    
 ** message **   
서비스 할당량이 한도를 초과하여 이 요청이 성공하지 못했습니다.  
 ** quotaCode **   
할당량 유형과 관련된 코드입니다.  
 ** resourceId **   
리소스의 식별자입니다.  
 ** resourceType **   
리소스의 유형입니다.  
 ** serviceCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 402

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_StartSearchJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchJob) 

# StartSearchResultExportJob
<a name="API_BKS_StartSearchResultExportJob"></a>

이 작업은 검색 작업 결과를 지정된 S3 버킷으로 내보내는 작업을 시작합니다.

## Request Syntax
<a name="API_BKS_StartSearchResultExportJob_RequestSyntax"></a>

```
PUT /export-search-jobs HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "ExportSpecification": { ... },
   "RoleArn": "string",
   "SearchJobIdentifier": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_BKS_StartSearchResultExportJob_RequestParameters"></a>

요청은 URI 파라미터를 사용하지 않습니다.

## 요청 본문
<a name="API_BKS_StartSearchResultExportJob_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [ClientToken](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ClientToken"></a>
멱등성을 위해 여러 개의 동일한 호출을 허용하려면 이 파라미터를 포함합니다.  
클라이언트 토큰은 해당 토큰을 사용하는 첫 번째 요청이 완료된 후 8시간 동안 유효합니다. 이 시간 이후에는 동일한 토큰을 사용하는 모든 요청은 새로운 요청으로 처리됩니다.  
유형: 문자열  
필수 항목 여부: 아니요

 ** [ExportSpecification](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ExportSpecification"></a>
이 사양에는 대상 버킷의 필수 문자열이 포함되어 있습니다. 선택적으로 대상 접두사를 포함할 수 있습니다.  
유형: [ExportSpecification](API_BKS_ExportSpecification.md)객체  
 **참고: **이 객체는 Union입니다. 이 객체의 멤버는 하나만 지정하거나 반환할 수 있습니다.  
필수 항목 여부: 예

 ** [RoleArn](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-RoleArn"></a>
이 파라미터는 검색 결과 내보내기 작업을 시작하는 데 사용되는 역할 ARN을 지정합니다.  
유형: 문자열  
길이 제약: 최소 길이는 20. 최대 길이는 2,048.  
패턴: `arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)`   
필수 여부: 아니요

 ** [SearchJobIdentifier](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-SearchJobIdentifier"></a>
검색 작업을 지정하는 고유한 문자열입니다.  
유형: 문자열  
필수 항목 여부: 예

 ** [Tags](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-Tags"></a>
포함하려는 선택적인 태그입니다. 태그는 리소스를 관리, 필터링, 검색하는 데 사용할 수 있는 키-값 페어입니다. 허용되는 문자는 UTF-8 문자, 숫자, 공백 및 \$1 - = . \$1 : /입니다.  
유형: 문자열 대 문자열 맵  
필수 항목 여부: 아니요

## 응답 구문
<a name="API_BKS_StartSearchResultExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportJobArn": "string",
   "ExportJobIdentifier": "string"
}
```

## 응답 요소
<a name="API_BKS_StartSearchResultExportJob_ResponseElements"></a>

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [ExportJobArn](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobArn"></a>
새 내보내기 작업에 속하는 고유한 ARN(Amazon 리소스 이름)입니다.  
유형: 문자열

 ** [ExportJobIdentifier](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobIdentifier"></a>
새 내보내기 작업을 지정하는 고유 식별자입니다.  
유형: 문자열

## 오류
<a name="API_BKS_StartSearchResultExportJob_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** ConflictException **   
이 예외는 이전에 성공한 작업과의 충돌이 감지될 때 발생합니다. 이는 일반적으로 이전 작업이 현재 요청을 처리하는 호스트로 전파할 시간이 없을 때 발생합니다.  
이 예외에 대한 권장 응답은 재시도(적절한 백오프 로직 사용)입니다.    
 ** message **   
리소스를 업데이트하거나 삭제하면 상태가 일관되지 않을 수 있습니다.  
 ** resourceId **   
영향을 받는 리소스의 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 유형입니다.
HTTP 상태 코드: 409

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ServiceQuotaExceededException **   
허용된 할당량 한도를 초과하여 요청이 거부되었습니다.    
 ** message **   
서비스 할당량이 한도를 초과하여 이 요청이 성공하지 못했습니다.  
 ** quotaCode **   
할당량 유형과 관련된 코드입니다.  
 ** resourceId **   
리소스의 식별자입니다.  
 ** resourceType **   
리소스의 유형입니다.  
 ** serviceCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 402

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_StartSearchResultExportJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchResultExportJob) 

# StopSearchJob
<a name="API_BKS_StopSearchJob"></a>

이 작업은 검색 작업을 종료합니다.

상태가 `RUNNING`인 검색 작업만 중지할 수 있습니다.

## Request Syntax
<a name="API_BKS_StopSearchJob_RequestSyntax"></a>

```
PUT /search-jobs/SearchJobIdentifier/actions/cancel HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_StopSearchJob_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [SearchJobIdentifier](#API_BKS_StopSearchJob_RequestSyntax) **   <a name="Backup-BKS_StopSearchJob-request-uri-SearchJobIdentifier"></a>
검색 작업을 지정하는 고유한 문자열입니다.  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_StopSearchJob_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_StopSearchJob_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_BKS_StopSearchJob_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_BKS_StopSearchJob_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** ConflictException **   
이 예외는 이전에 성공한 작업과의 충돌이 감지될 때 발생합니다. 이는 일반적으로 이전 작업이 현재 요청을 처리하는 호스트로 전파할 시간이 없을 때 발생합니다.  
이 예외에 대한 권장 응답은 재시도(적절한 백오프 로직 사용)입니다.    
 ** message **   
리소스를 업데이트하거나 삭제하면 상태가 일관되지 않을 수 있습니다.  
 ** resourceId **   
영향을 받는 리소스의 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 유형입니다.
HTTP 상태 코드: 409

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_StopSearchJob_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StopSearchJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StopSearchJob) 

# TagResource
<a name="API_BKS_TagResource"></a>

이 작업은 지정한 리소스에 태그를 지정합니다.

## Request Syntax
<a name="API_BKS_TagResource_RequestSyntax"></a>

```
POST /tags/ResourceArn HTTP/1.1
Content-type: application/json

{
   "Tags": { 
      "string" : "string" 
   }
}
```

## URI 요청 파라미터
<a name="API_BKS_TagResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ResourceArn](#API_BKS_TagResource_RequestSyntax) **   <a name="Backup-BKS_TagResource-request-uri-ResourceArn"></a>
리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.  
표시된 태그가 있는 리소스입니다.  
필수 항목 여부: 예

## 요청 본문
<a name="API_BKS_TagResource_RequestBody"></a>

요청은 JSON 형식으로 다음 데이터를 받습니다.

 ** [Tags](#API_BKS_TagResource_RequestSyntax) **   <a name="Backup-BKS_TagResource-request-Tags"></a>
포함할 필수 태그입니다. 태그는 리소스를 관리, 필터링, 검색하는 데 사용할 수 있는 키-값 페어입니다. 허용되는 문자는 UTF-8 문자, 숫자, 공백 및 \$1 - = . \$1 : /입니다.  
유형: 문자열 간 맵  
필수 항목 여부: 예

## 응답 구문
<a name="API_BKS_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_BKS_TagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_BKS_TagResource_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_TagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/TagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/TagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/TagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/TagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/TagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/TagResource) 

# UntagResource
<a name="API_BKS_UntagResource"></a>

이 작업은 지정된 리소스에서 태그를 제거합니다.

## Request Syntax
<a name="API_BKS_UntagResource_RequestSyntax"></a>

```
DELETE /tags/ResourceArn?tagKeys=TagKeys HTTP/1.1
```

## URI 요청 파라미터
<a name="API_BKS_UntagResource_RequestParameters"></a>

요청은 다음 URI 파라미터를 사용합니다.

 ** [ResourceArn](#API_BKS_UntagResource_RequestSyntax) **   <a name="Backup-BKS_UntagResource-request-uri-ResourceArn"></a>
태그를 제거할 리소스를 고유하게 식별하는 Amazon 리소스 이름(ARN)입니다.  
필수 항목 여부: 예

 ** [TagKeys](#API_BKS_UntagResource_RequestSyntax) **   <a name="Backup-BKS_UntagResource-request-uri-TagKeys"></a>
이 필수 파라미터에는 소스에서 제거하려는 태그 키가 포함되어 있습니다.  
필수 항목 여부: 예

## Request Body
<a name="API_BKS_UntagResource_RequestBody"></a>

해당 요청에는 본문이 없습니다.

## Response Syntax
<a name="API_BKS_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_BKS_UntagResource_ResponseElements"></a>

작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.

## 오류
<a name="API_BKS_UntagResource_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 [일반적인 오류 유형](CommonErrors.md) 섹션을 참조하세요.

 ** AccessDeniedException **   
이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.    
 ** message **   
사용자에게 이 작업을 수행할 수 있는 충분한 액세스 권한이 없습니다.
HTTP 상태 코드: 403

 ** InternalServerException **   
내부 서버 오류가 발생했습니다. 요청을 재시도합니다.    
 ** message **   
요청을 처리하는 동안 예상치 못한 오류가 발생했습니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.
HTTP 상태 코드: 500

 ** ResourceNotFoundException **   
이 요청에 대한 리소스를 찾을 수 없습니다.  
ARN 또는 유형과 같은 리소스 정보가 올바르고 존재하는지 확인한 다음 요청을 다시 시도합니다.    
 ** message **   
요청이 존재하지 않는 리소스를 참조합니다.  
 ** resourceId **   
영향을 받는 리소스의 가상 식별자입니다.  
 ** resourceType **   
영향을 받는 리소스의 가상 유형입니다.
HTTP 상태 코드: 404

 ** ThrottlingException **   
요청 스로틀링으로 인해 요청이 거부되었습니다.    
 ** message **   
요청 스로틀링으로 인해 요청이 실패했습니다.  
 ** quotaCode **   
할당량이 있는 원래 서비스에 고유한 코드입니다.  
 ** retryAfterSeconds **   
몇 초 후에 호출을 다시 시도합니다.  
 ** serviceCode **   
원래 서비스에 고유한 코드입니다.
HTTP 상태 코드: 429

 ** ValidationException **   
입력이 서비스에서 지정한 제약 조건을 충족하지 못합니다.    
 ** message **   
입력이 Amazon 서비스에서 지정한 제약 조건을 충족하지 못합니다.
HTTP 상태 코드: 400

## 참고
<a name="API_BKS_UntagResource_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/UntagResource) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/UntagResource) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/UntagResource) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/UntagResource) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/UntagResource) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/UntagResource) 