

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

# 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) 