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

# CreateAgent
<a name="API_CreateAgent"></a>

스토리지 환경에 배포하는 AWS DataSync 에이전트를 활성화합니다. 활성화 프로세스는 에이전트를와 연결합니다 AWS 계정.

아직 에이전트를 배포하지 않은 경우 [Do I need a DataSync agent?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 섹션을 참조하세요.

## 구문 요청
<a name="API_CreateAgent_RequestSyntax"></a>

```
{
   "ActivationKey": "string",
   "AgentName": "string",
   "SecurityGroupArns": [ "string" ],
   "SubnetArns": [ "string" ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VpcEndpointId": "string"
}
```

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

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

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

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
사용자 DataSync 에이전트의 활성화 키를 지정합니다. 활성화 키가 없는 경우 [에이전트 활성화](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html)를 참조하세요.  
유형: 문자열  
길이 제약 조건: 최대 길이는 29.  
패턴: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
필수 여부: 예

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
사용자 에이전트의 이름을 지정합니다. 기억할 수 있는 이름을 지정하는 것이 좋습니다.  
유형: 문자열  
길이 제약: 최소 길이는 0. 최대 길이는 256입니다.  
패턴: `^[a-zA-Z0-9\s+=._:@/-]+$`   
필수 여부: 아니요

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
에이전트와 VPC 서비스 엔드포인트 간의 트래픽을 허용하는 보안 그룹의 Amazon 리소스 이름(ARN)을 지정합니다. 하나의 ARN만 지정할 수 있습니다.  
유형: 문자열 배열  
배열 멤버: 고정된 항목 수는 1개입니다.  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
필수 여부: 아니요

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
VPC 서비스 엔드포인트가 위치한 서브넷의 ARN을 지정합니다. 하나의 ARN만 지정할 수 있습니다.  
유형: 문자열 배열  
배열 멤버: 고정된 항목 수는 1개입니다.  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
필수 여부: 아니요

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
 AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 에이전트에 대한 태그를 적어도 하나 이상 만드는 것이 좋습니다.  
타입: [TagListEntry](API_TagListEntry.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대수 50개.  
필수 여부: 아니요

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
사용 중인 [VPC 서비스 엔드포인트](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc)의 ID를 지정합니다. 예를 들어 VPC 엔드포인트 ID는 `vpce-01234d5aff67890e1`과 같습니다.   
사용하는 VPC 서비스 엔드포인트에는 DataSync 서비스 이름(예: `com.amazonaws.us-east-2.datasync`)이 포함되어야 합니다.
유형: String  
패턴: `^vpce-[0-9a-f]{17}$`   
필수 여부: 아니요

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

```
{
   "AgentArn": "string"
}
```

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

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

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

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
방금 활성화한 에이전트의 ARN. [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html) 작업을 사용하여 AWS 계정 및의 에이전트 목록을 반환합니다 AWS 리전.  
유형: 문자열  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` 

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

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

 ** InternalException **   
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다.  
HTTP 상태 코드: 500

 ** InvalidRequestException **   
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.  
HTTP 상태 코드: 400

## 예
<a name="API_CreateAgent_Examples"></a>

### 예 요청
<a name="API_CreateAgent_Example_1"></a>

다음 예제는 DataSync 에이전트를 활성화합니다.

```
{
    "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE",
    "AgentName": "MyAgent",
    "Tags": [{
        "Key": "Job",
        "Value": "TransferJob-1"
    }]
}
```

### 샘플 응답
<a name="API_CreateAgent_Example_2"></a>

응답은 활성화된 에이전트의 ARN을 반환합니다.

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3"
}
```

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

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