Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Mengaktifkan AWS DataSync agen yang Anda gunakan di lingkungan penyimpanan Anda. Proses aktivasi mengaitkan agen dengan Anda Akun AWS.

Jika Anda belum menggunakan agen, lihat [Apakah saya memerlukan DataSync agen?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 

## Sintaksis Permintaan
<a name="API_CreateAgent_RequestSyntax"></a>

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

## Parameter Permintaan
<a name="API_CreateAgent_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
Menentukan kunci aktivasi DataSync agen Anda. Jika Anda tidak memiliki kunci aktivasi, lihat [Mengaktifkan agen Anda](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 29.  
Pola: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
Wajib: Ya

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
Menentukan nama untuk agen Anda. Kami merekomendasikan untuk menentukan nama yang dapat Anda ingat.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Wajib: Tidak

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari grup keamanan yang memungkinkan lalu lintas antara agen Anda dan titik akhir layanan VPC. Anda hanya dapat menentukan satu ARN.  
Tipe: Array string  
Anggota Array: Jumlah tetap 1 item.  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^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]+$`   
Wajib: Tidak

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
Menentukan ARN subnet tempat titik akhir layanan VPC Anda berada. Anda hanya dapat menentukan satu ARN.  
Tipe: Array string  
Anggota Array: Jumlah tetap 1 item.  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^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]+$`   
Wajib: Tidak

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
Menentukan label yang membantu Anda mengkategorikan, memfilter, dan mencari sumber daya Anda. AWS Sebaiknya buat setidaknya satu tag untuk agen Anda.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Wajib: Tidak

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
Menentukan ID titik akhir [layanan VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) yang Anda gunakan. Misalnya, ID titik akhir VPC terlihat seperti. `vpce-01234d5aff67890e1`  
Titik akhir layanan VPC yang Anda gunakan harus menyertakan nama DataSync layanan (misalnya,). `com.amazonaws.us-east-2.datasync`
Tipe: String  
Pola: `^vpce-[0-9a-f]{17}$`   
Diperlukan: Tidak

## Sintaksis Respons
<a name="API_CreateAgent_ResponseSyntax"></a>

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

## Elemen Respons
<a name="API_CreateAgent_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
ARN dari agen yang baru saja Anda aktifkan. Gunakan [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operasi untuk mengembalikan daftar agen di Akun AWS dan Wilayah AWS.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^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}$` 

## Kesalahan
<a name="API_CreateAgent_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InternalException **   
Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .  
Kode Status HTTP: 500

 ** InvalidRequestException **   
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.  
Kode Status HTTP: 400

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

### Permintaan Sampel
<a name="API_CreateAgent_Example_1"></a>

Contoh berikut mengaktifkan DataSync agen.

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

### Contoh Respons
<a name="API_CreateAgent_Example_2"></a>

Respons mengembalikan ARN dari agen yang diaktifkan.

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

## Lihat Juga
<a name="API_CreateAgent_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for .NET V4](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 SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK untuk Python](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)