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

# AWS DataSync API
<a name="API_Reference"></a>

Selain Konsol Manajemen AWS dan AWS CLI, Anda dapat menggunakan AWS DataSync API untuk mengkonfigurasi dan mengelola DataSync dengan [AWS SDKs](https://aws.amazon.com/developer/tools/).

**Topics**
+ [

# Tindakan
](API_Operations.md)
+ [

# Tipe Data
](API_Types.md)
+ [

# Kesalahan Umum
](CommonErrors.md)
+ [

# Parameter Umum
](CommonParameters.md)

# Tindakan
<a name="API_Operations"></a>

Tindakan berikut didukung:
+  [CancelTaskExecution](API_CancelTaskExecution.md) 
+  [CreateAgent](API_CreateAgent.md) 
+  [CreateLocationAzureBlob](API_CreateLocationAzureBlob.md) 
+  [CreateLocationEfs](API_CreateLocationEfs.md) 
+  [CreateLocationFsxLustre](API_CreateLocationFsxLustre.md) 
+  [CreateLocationFsxOntap](API_CreateLocationFsxOntap.md) 
+  [CreateLocationFsxOpenZfs](API_CreateLocationFsxOpenZfs.md) 
+  [CreateLocationFsxWindows](API_CreateLocationFsxWindows.md) 
+  [CreateLocationHdfs](API_CreateLocationHdfs.md) 
+  [CreateLocationNfs](API_CreateLocationNfs.md) 
+  [CreateLocationObjectStorage](API_CreateLocationObjectStorage.md) 
+  [CreateLocationS3](API_CreateLocationS3.md) 
+  [CreateLocationSmb](API_CreateLocationSmb.md) 
+  [CreateTask](API_CreateTask.md) 
+  [DeleteAgent](API_DeleteAgent.md) 
+  [DeleteLocation](API_DeleteLocation.md) 
+  [DeleteTask](API_DeleteTask.md) 
+  [DescribeAgent](API_DescribeAgent.md) 
+  [DescribeLocationAzureBlob](API_DescribeLocationAzureBlob.md) 
+  [DescribeLocationEfs](API_DescribeLocationEfs.md) 
+  [DescribeLocationFsxLustre](API_DescribeLocationFsxLustre.md) 
+  [DescribeLocationFsxOntap](API_DescribeLocationFsxOntap.md) 
+  [DescribeLocationFsxOpenZfs](API_DescribeLocationFsxOpenZfs.md) 
+  [DescribeLocationFsxWindows](API_DescribeLocationFsxWindows.md) 
+  [DescribeLocationHdfs](API_DescribeLocationHdfs.md) 
+  [DescribeLocationNfs](API_DescribeLocationNfs.md) 
+  [DescribeLocationObjectStorage](API_DescribeLocationObjectStorage.md) 
+  [DescribeLocationS3](API_DescribeLocationS3.md) 
+  [DescribeLocationSmb](API_DescribeLocationSmb.md) 
+  [DescribeTask](API_DescribeTask.md) 
+  [DescribeTaskExecution](API_DescribeTaskExecution.md) 
+  [ListAgents](API_ListAgents.md) 
+  [ListLocations](API_ListLocations.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ListTaskExecutions](API_ListTaskExecutions.md) 
+  [ListTasks](API_ListTasks.md) 
+  [StartTaskExecution](API_StartTaskExecution.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateAgent](API_UpdateAgent.md) 
+  [UpdateLocationAzureBlob](API_UpdateLocationAzureBlob.md) 
+  [UpdateLocationEfs](API_UpdateLocationEfs.md) 
+  [UpdateLocationFsxLustre](API_UpdateLocationFsxLustre.md) 
+  [UpdateLocationFsxOntap](API_UpdateLocationFsxOntap.md) 
+  [UpdateLocationFsxOpenZfs](API_UpdateLocationFsxOpenZfs.md) 
+  [UpdateLocationFsxWindows](API_UpdateLocationFsxWindows.md) 
+  [UpdateLocationHdfs](API_UpdateLocationHdfs.md) 
+  [UpdateLocationNfs](API_UpdateLocationNfs.md) 
+  [UpdateLocationObjectStorage](API_UpdateLocationObjectStorage.md) 
+  [UpdateLocationS3](API_UpdateLocationS3.md) 
+  [UpdateLocationSmb](API_UpdateLocationSmb.md) 
+  [UpdateTask](API_UpdateTask.md) 
+  [UpdateTaskExecution](API_UpdateTaskExecution.md) 

# CancelTaskExecution
<a name="API_CancelTaskExecution"></a>

Menghentikan eksekusi AWS DataSync tugas yang sedang berlangsung. Transfer beberapa file tiba-tiba terputus. Konten file yang ditransfer ke tujuan mungkin tidak lengkap atau tidak konsisten dengan file sumber.

Namun, jika Anda memulai eksekusi tugas baru menggunakan tugas yang sama dan membiarkannya selesai, konten file di tujuan akan lengkap dan konsisten. Hal ini berlaku untuk kegagalan tak terduga lainnya yang mengganggu eksekusi tugas. Dalam semua kasus ini, DataSync berhasil menyelesaikan transfer ketika Anda memulai eksekusi tugas berikutnya.

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

```
{
   "TaskExecutionArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [TaskExecutionArn](#API_CancelTaskExecution_RequestSyntax) **   <a name="DataSync-CancelTaskExecution-request-TaskExecutionArn"></a>
Nama Sumber Daya Amazon (ARN) dari eksekusi tugas untuk berhenti.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_CancelTaskExecution_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

## Lihat Juga
<a name="API_CancelTaskExecution_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/CancelTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CancelTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CancelTaskExecution) 

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

# CreateLocationAzureBlob
<a name="API_CreateLocationAzureBlob"></a>

Membuat *lokasi transfer untuk wadah* Microsoft Azure Blob Storage. AWS DataSync dapat menggunakan lokasi ini sebagai sumber transfer atau tujuan. Anda dapat melakukan transfer dengan atau tanpa [DataSync agen](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) yang terhubung ke wadah Anda.

[Sebelum memulai, pastikan Anda tahu [cara DataSync mengakses Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access) dan bekerja dengan [tingkatan akses](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) dan jenis gumpalan.](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types)

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

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "ContainerUrl": "string",
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SasConfiguration": { 
      "Token": "string"
   },
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AccessTier"></a>
Menentukan tingkat akses yang Anda inginkan objek atau file ditransfer ke. Ini hanya berlaku ketika menggunakan lokasi sebagai tujuan transfer. Untuk informasi selengkapnya, lihat [Tingkat akses.](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)  
Tipe: String  
Nilai yang Valid: `HOT | COOL | ARCHIVE`   
Wajib: Tidak

 ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AgentArns"></a>
(Opsional) Menentukan Nama Sumber Daya Amazon (ARN) agen yang dapat terhubung dengan wadah Penyimpanan Azure Blob Anda. DataSync Jika Anda menyiapkan transfer lintas cloud tanpa agen, Anda tidak perlu menentukan nilai untuk parameter ini.  
Anda dapat menentukan lebih dari satu agen. Untuk informasi selengkapnya, lihat [Menggunakan beberapa agen untuk transfer Anda](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html).  
Pastikan Anda mengonfigurasi parameter ini dengan benar saat pertama kali membuat lokasi penyimpanan. Anda tidak dapat menambah atau menghapus agen dari lokasi penyimpanan setelah Anda membuatnya.
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-AuthenticationType"></a>
Menentukan metode otentikasi yang DataSync digunakan untuk mengakses Penyimpanan Azure Blob Anda. DataSync dapat mengakses penyimpanan gumpalan menggunakan tanda tangan akses bersama (SAS).  
Tipe: String  
Nilai yang Valid: `SAS | NONE`   
Wajib: Ya

 ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-BlobType"></a>
Menentukan jenis gumpalan yang Anda inginkan objek atau file Anda ketika mentransfer mereka ke Azure Blob Storage. Saat ini, DataSync hanya mendukung pemindahan data ke Azure Blob Storage sebagai blob blok. Untuk informasi selengkapnya tentang jenis gumpalan, lihat dokumentasi [Azure Blob](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Storage.  
Tipe: String  
Nilai yang Valid: `BLOCK`   
Wajib: Tidak

 ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia DataSync -managed, yang mencakup token otentikasi yang DataSync digunakan untuk mengakses lokasi AzureBlob penyimpanan tertentu, dengan yang dikelola pelanggan. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationAzureBlob` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan token otentikasi yang Anda tentukan `SasConfiguration` untuk membuat rahasia yang DataSync dikelola untuk menyimpan kredensil akses lokasi.  
Pastikan bahwa DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang dikelola layanan yang dienkripsi](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key  
Anda dapat menggunakan `CmkSecretConfig` (with`SasConfiguration`) atau `CustomSecretConfig` (without`SasConfiguration`) untuk memberikan kredensi untuk permintaan. `CreateLocationAzureBlob` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-ContainerUrl"></a>
Menentukan URL wadah Penyimpanan Azure Blob yang terlibat dalam transfer Anda.  
Tipe: String  
Kendala Panjang: Panjang maksimum 325.  
Pola: `^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$`   
Wajib: Ya

 ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana token otentikasi untuk lokasi AzureBlob penyimpanan disimpan dalam teks biasa, di Secrets Manager. Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Anda dapat menggunakan `CmkSecretConfig` (with`SasConfiguration`) atau `CustomSecretConfig` (without`SasConfiguration`) untuk memberikan kredensi untuk permintaan. `CreateLocationAzureBlob` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-SasConfiguration"></a>
Menentukan konfigurasi SAS yang memungkinkan DataSync untuk mengakses Penyimpanan Azure Blob Anda.  
Jika Anda memberikan token otentikasi menggunakan`SasConfiguration`, tetapi tidak memberikan detail konfigurasi rahasia menggunakan `CmkSecretConfig` atau`CustomSecretConfig`, kemudian DataSync menyimpan token menggunakan rahasia manajer rahasia AWS akun Anda.
Tipe: Objek [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)  
Wajib: Tidak

 ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-CreateLocationAzureBlob-request-Subdirectory"></a>
Menentukan segmen jalur jika Anda ingin membatasi transfer Anda ke direktori virtual dalam wadah Anda (misalnya,`/my/images`).  
Tipe: String  
Batasan Panjang: Panjang maksimum 1024.  
Pola: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
Wajib: Tidak

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

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-CreateLocationAzureBlob-response-LocationArn"></a>
ARN dari lokasi transfer Penyimpanan Azure Blob yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationAzureBlob_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

## Lihat Juga
<a name="API_CreateLocationAzureBlob_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/CreateLocationAzureBlob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob) 

# CreateLocationEfs
<a name="API_CreateLocationEfs"></a>

Membuat *lokasi* transfer untuk sistem file Amazon EFS. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum memulai, pastikan Anda memahami cara DataSync [mengakses sistem file Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access).

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

```
{
   "AccessPointArn": "string",
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "EfsFilesystemArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-AccessPointArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari titik akses DataSync yang digunakan untuk memasang sistem file Amazon EFS Anda.  
Untuk informasi selengkapnya, lihat [Mengakses sistem file terbatas](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$`   
Wajib: Tidak

 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Ec2Config"></a>
Menentukan subnet dan grup keamanan yang DataSync digunakan untuk terhubung ke salah satu target [pemasangan](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) sistem file Amazon EFS Anda.  
Tipe: Objek [Ec2Config](API_Ec2Config.md)  
Wajib: Ya

 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-EfsFilesystemArn"></a>
Menentukan ARN untuk sistem file Amazon EFS Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$`   
Wajib: Ya

 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-FileSystemAccessRoleArn"></a>
Menentukan peran AWS Identity and Access Management (IAM) yang memungkinkan DataSync untuk mengakses sistem file Amazon EFS Anda.  
Untuk informasi tentang membuat peran ini, lihat [Membuat peran DataSync IAM untuk akses sistem file](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Wajib: Tidak

 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-InTransitEncryption"></a>
Menentukan apakah Anda DataSync ingin menggunakan enkripsi Transport Layer Security (TLS) 1.2 saat mentransfer data ke atau dari sistem file Amazon EFS Anda.  
Jika Anda menentukan titik akses menggunakan `AccessPointArn` atau peran IAM menggunakan`FileSystemAccessRoleArn`, Anda harus mengatur parameter ini ke`TLS1_2`.  
Tipe: String  
Nilai yang Valid: `NONE | TLS1_2`   
Wajib: Tidak

 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Subdirectory"></a>
Menentukan jalur pemasangan untuk sistem file Amazon EFS Anda. Di sinilah DataSync membaca atau menulis data pada sistem file Anda (tergantung pada apakah ini adalah lokasi sumber atau tujuan).  
Secara default, DataSync gunakan direktori root (atau [titik akses](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) jika Anda menyediakannya dengan menggunakan`AccessPointArn`). Anda juga dapat menyertakan subdirektori menggunakan garis miring maju (misalnya,). `/path/to/folder`  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Wajib: Tidak

 ** [Tags](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Tags"></a>
Menentukan pasangan kunci-nilai yang mewakili tag yang ingin Anda tambahkan ke sumber daya. Nilai dapat berupa string kosong. Nilai ini membantu Anda mengelola, mem-filter, dan mencari sumber daya Anda. Kami merekomendasikan agar Anda membuat tanda nama untuk lokasi Anda.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Diperlukan: Tidak

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) **   <a name="DataSync-CreateLocationEfs-response-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi sistem file Amazon EFS yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationEfs_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_CreateLocationEfs_Examples"></a>

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

Contoh berikut membuat lokasi untuk sistem file Amazon EFS.

```
{
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2"
        ]
    },
    "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### Permintaan Sampel: Membuat lokasi untuk sistem file Amazon EFS terbatas
<a name="API_CreateLocationEfs_Example_2"></a>

Contoh berikut membuat lokasi untuk sistem file Amazon EFS dengan akses terbatas. Dalam skenario semacam ini, Anda mungkin harus menentukan nilai untuk`AccessPointArn`,`FileSystemAccessRoleArn`, dan `InTransitEncryption` dalam permintaan Anda.

```
{
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

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

Respons mengembalikan lokasi ARN dari sistem file Amazon EFS.

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

## Lihat Juga
<a name="API_CreateLocationEfs_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/CreateLocationEfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs) 

# CreateLocationFsxLustre
<a name="API_CreateLocationFsxLustre"></a>

Membuat *lokasi* transfer untuk sistem file Amazon FSx untuk Lustre. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [akses FSx untuk sistem file Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html#create-lustre-location-access).

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

```
{
   "FsxFilesystemArn": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [FsxFilesystemArn](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-FsxFilesystemArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari sistem file for FSx Lustre.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Wajib: Ya

 ** [SecurityGroupArns](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-SecurityGroupArns"></a>
Menentukan Nama Sumber Daya Amazon (ARNs) hingga lima grup keamanan yang menyediakan akses ke sistem file Lustre Anda FSx .  
Grup keamanan harus dapat mengakses port sistem file. Sistem file juga harus memungkinkan akses dari grup keamanan. Untuk informasi tentang akses sistem file, lihat [https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/LustreGuide/limit-access-security-groups.html).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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: Ya

 ** [Subdirectory](#API_CreateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-CreateLocationFsxLustre-request-Subdirectory"></a>
Menentukan jalur mount untuk sistem file Lustre Anda FSx . Path dapat mencakup subdirektori.  
Saat lokasi digunakan sebagai sumber, DataSync membaca data dari jalur pemasangan. Saat lokasi digunakan sebagai tujuan, DataSync tulis data ke jalur pemasangan. Jika Anda tidak menyertakan parameter ini, DataSync gunakan direktori root sistem file (`/`).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Tidak

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

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxLustre-response-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi sistem file FSx untuk Lustre yang Anda buat.   
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationFsxLustre_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

## Lihat Juga
<a name="API_CreateLocationFsxLustre_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/CreateLocationFsxLustre) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxLustre) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxLustre) 

# CreateLocationFsxOntap
<a name="API_CreateLocationFsxOntap"></a>

Membuat *lokasi* transfer untuk Amazon FSx untuk sistem file NetApp ONTAP. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [mengakses FSx untuk sistem file ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

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

```
{
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Protocol"></a>
Menentukan protokol transfer data yang AWS DataSync digunakan untuk mengakses sistem FSx file Amazon Anda.  
Tipe: Objek [FsxProtocol](API_FsxProtocol.md)  
Wajib: Ya

 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-SecurityGroupArns"></a>
Menentukan grup keamanan Amazon EC2 yang menyediakan akses ke subnet pilihan sistem file Anda.  
Grup keamanan harus mengizinkan lalu lintas keluar pada port berikut (tergantung pada protokol yang Anda gunakan):  
+  **Sistem File Jaringan (NFS)**: Port TCP 111, 635, dan 2049
+  **Blok Pesan Server (SMB): Port** TCP 445
Grup keamanan sistem file Anda juga harus mengizinkan lalu lintas masuk pada port yang sama.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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: Ya

 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-StorageVirtualMachineArn"></a>
Menentukan ARN dari mesin virtual penyimpanan (SVM) dalam sistem file Anda di mana Anda ingin menyalin data ke atau dari.  
Tipe: String  
Kendala Panjang: Panjang maksimum 162.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$`   
Wajib: Ya

 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Subdirectory"></a>
Menentukan jalur untuk berbagi file di SVM di mana Anda ingin mentransfer data ke atau dari.  
Anda dapat menentukan jalur persimpangan (juga dikenal sebagai titik pemasangan), jalur qtree (untuk berbagi file NFS), atau nama berbagi (untuk berbagi file SMB). Misalnya, jalur pemasangan Anda mungkin`/vol1`,`/vol1/tree1`, atau`/share1`.  
Jangan tentukan jalur persimpangan di volume root SVM. Untuk informasi selengkapnya, lihat [Mengelola FSx mesin virtual penyimpanan ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) di *Amazon FSx untuk Panduan Pengguna NetApp ONTAP*.
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Wajib: Tidak

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

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOntap-response-LocationArn"></a>
Menentukan ARN untuk lokasi sistem file ONTAP yang Anda buat. FSx   
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationFsxOntap_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

## Lihat Juga
<a name="API_CreateLocationFsxOntap_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/CreateLocationFsxOntap) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOntap) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOntap) 

# CreateLocationFsxOpenZfs
<a name="API_CreateLocationFsxOpenZfs"></a>

Membuat *lokasi* transfer untuk Amazon FSx untuk sistem file OpenZFS. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [akses FSx untuk sistem file OpenZFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html#create-openzfs-access).

**catatan**  
Parameter permintaan yang terkait dengan `SMB` tidak didukung dengan `CreateLocationFsxOpenZfs` operasi.

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

```
{
   "FsxFilesystemArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [FsxFilesystemArn](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-FsxFilesystemArn"></a>
Nama Sumber Daya Amazon (ARN) dari sistem file FSx untuk OpenZFS.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Wajib: Ya

 ** [Protocol](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Protocol"></a>
Jenis protokol yang AWS DataSync digunakan untuk mengakses sistem file Anda.  
Tipe: Objek [FsxProtocol](API_FsxProtocol.md)  
Wajib: Ya

 ** [SecurityGroupArns](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-SecurityGroupArns"></a>
Grup keamanan ARNs yang digunakan untuk mengkonfigurasi sistem file FSx untuk OpenZFS.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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: Ya

 ** [Subdirectory](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Subdirectory"></a>
Sebuah subdirektori di jalur lokasi yang harus dimulai dengan`/fsx`. DataSync menggunakan subdirektori ini untuk membaca atau menulis data (tergantung pada apakah sistem file adalah lokasi sumber atau tujuan).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$`   
Wajib: Tidak

 ** [Tags](#API_CreateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-request-Tags"></a>
Pasangan nilai kunci yang mewakili tanda yang ingin Anda tambahkan ke sumber daya. Nilai dapat berupa string kosong. Nilai ini membantu Anda mengelola, mem-filter, dan mencari sumber daya Anda. Kami merekomendasikan agar Anda membuat tanda nama untuk lokasi Anda.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Diperlukan: Tidak

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOpenZfs-response-LocationArn"></a>
ARN dari lokasi sistem file FSx untuk OpenZFS yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationFsxOpenZfs_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

## Lihat Juga
<a name="API_CreateLocationFsxOpenZfs_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/CreateLocationFsxOpenZfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxOpenZfs) 

# CreateLocationFsxWindows
<a name="API_CreateLocationFsxWindows"></a>

Membuat *lokasi* transfer untuk sistem file Amazon FSx untuk Windows File Server. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [mengakses FSx untuk sistem file Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access).

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

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "FsxFilesystemArn": "string",
   "Password": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, yang mencakup kata sandi yang DataSync digunakan untuk mengakses lokasi penyimpanan FSx Windows tertentu, dengan yang dikelola pelanggan. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationFsxWindows` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan yang `Password` Anda tentukan untuk membuat rahasia DataSync -managed untuk menyimpan kredenal akses lokasi.  
Pastikan bahwa DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang dikelola layanan yang dienkripsi](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key  
Anda dapat menggunakan `CmkSecretConfig` (with`Password`) atau `CustomSecretConfig` (without`Password`) untuk memberikan kredensi untuk permintaan. `CreateLocationFsxWindows` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kata sandi untuk lokasi penyimpanan Windows File Server disimpan dalam teks biasa, di Secrets Manager. FSx Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Anda dapat menggunakan `CmkSecretConfig` (with`Password`) atau `CustomSecretConfig` (without`Password`) untuk memberikan kredensi untuk permintaan. `CreateLocationFsxWindows` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Domain"></a>
Menentukan nama domain Windows yang dimiliki oleh FSx sistem file Windows File Server.  
Jika Anda memiliki beberapa domain Active Directory di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke sistem file yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Wajib: Tidak

 ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-FsxFilesystemArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) untuk FSx sistem file Windows File Server.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Wajib: Ya

 ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Password"></a>
Menentukan kata sandi pengguna dengan izin untuk memasang dan mengakses file, folder, dan metadata file di sistem file Windows File FSx Server Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Wajib: Tidak

 ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-SecurityGroupArns"></a>
Menentukan ARN dari grup keamanan Amazon EC2 yang menyediakan akses ke subnet pilihan sistem file Anda.  
Grup keamanan yang Anda tentukan harus dapat berkomunikasi dengan grup keamanan sistem file Anda. Untuk informasi tentang mengonfigurasi grup keamanan untuk akses sistem file, lihat [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html).  
Jika Anda memilih grup keamanan yang tidak mengizinkan koneksi dari dalam dirinya sendiri, lakukan salah satu hal berikut:  
+ Konfigurasikan grup keamanan untuk memungkinkannya berkomunikasi di dalam dirinya sendiri.
+ Pilih grup keamanan lain yang dapat berkomunikasi dengan grup keamanan target mount.
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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: Ya

 ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Subdirectory"></a>
Menentukan jalur mount untuk sistem file Anda menggunakan garis miring maju. Di sinilah DataSync membaca atau menulis data (tergantung pada apakah ini adalah lokasi sumber atau tujuan).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Tidak

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

 ** [User](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-User"></a>
Menentukan pengguna dengan izin untuk me-mount dan mengakses file, folder, dan metadata file dalam sistem file Windows File FSx Server Anda.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [izin yang diperlukan](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx untuk lokasi Windows File Server.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Diperlukan: Ya

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxWindows-response-LocationArn"></a>
ARN dari lokasi sistem file FSx untuk Windows File Server yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationFsxWindows_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

## Lihat Juga
<a name="API_CreateLocationFsxWindows_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/CreateLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows) 

# CreateLocationHdfs
<a name="API_CreateLocationHdfs"></a>

Membuat *lokasi* transfer untuk Hadoop Distributed File System (HDFS). AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [mengakses klaster HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs).

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
Amazon Resource Names (ARNs) dari DataSync agen yang dapat terhubung ke klaster HDFS Anda.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Ya

 ** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
Jenis otentikasi yang digunakan untuk menentukan identitas pengguna.   
Tipe: String  
Nilai yang Valid: `SIMPLE | KERBEROS`   
Wajib: Ya

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
Ukuran blok data untuk ditulis ke dalam cluster HDFS. Ukuran blok harus kelipatan 512 byte. Ukuran blok default adalah 128 mebibytes (MiB).  
Jenis: Integer  
Rentang Valid: Nilai minimum 1048576. Nilai maksimum 1073741824.  
Wajib: Tidak

 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia DataSync -managed, yang mencakup keytab Kerberos yang DataSync digunakan untuk mengakses lokasi penyimpanan Hadoop Distributed File System (HDFS) tertentu, dengan yang dikelola pelanggan. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationHdfs` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan yang `KerberosKeytab` Anda tentukan untuk membuat rahasia DataSync -managed untuk menyimpan kredensyal akses lokasi.  
Pastikan bahwa DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang dikelola layanan yang dienkripsi](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key  
Anda dapat menggunakan `CmkSecretConfig` (dengan`KerberosKeytab`) atau `CustomSecretConfig` (tanpa`KerberosKeytab`) untuk memberikan kredensyal untuk permintaan. `CreateLocationHdfs` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana tab kunci Kerberos untuk lokasi penyimpanan HDFS disimpan dalam biner, di Secrets Manager. Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Anda dapat menggunakan `CmkSecretConfig` (dengan`KerberosKeytab`) atau `CustomSecretConfig` (tanpa`KerberosKeytab`) untuk memberikan kredensyal untuk permintaan. `CreateLocationHdfs` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
Tabel kunci Kerberos (keytab) yang berisi pemetaan antara prinsipal Kerberos yang ditentukan dan kunci terenkripsi. Anda dapat memuat tab tombol dari file dengan memberikan alamat file.  
Jika `KERBEROS` ditentukan untuk`AuthenticationType`, parameter ini diperlukan. 
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 65536.  
Wajib: Tidak

 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
`krb5.conf`File yang berisi informasi konfigurasi Kerberos. Anda dapat memuat `krb5.conf` file dengan memberikan alamat file. Jika Anda menggunakan AWS CLI, ia melakukan pengkodean base64 untuk Anda. Jika tidak, berikan teks yang dikodekan base64.   
Jika `KERBEROS` ditentukan untuk`AuthenticationType`, parameter ini diperlukan.
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 131072.  
Wajib: Tidak

 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
Kepala sekolah Kerberos dengan akses ke file dan folder pada cluster HDFS.   
Jika `KERBEROS` ditentukan untuk`AuthenticationType`, parameter ini diperlukan.
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^.+$`   
Wajib: Tidak

 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
URI dari Server Manajemen Kunci (KMS) klaster HDFS.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
Wajib: Tidak

 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
 NameNode Yang mengelola namespace HDFS. NameNode Melakukan operasi seperti membuka, menutup, dan mengganti nama file dan direktori. NameNode Berisi informasi untuk memetakan blok data ke file DataNodes. Anda hanya dapat menggunakan satu NameNode.  
Tipe: Array objek [HdfsNameNode](API_HdfsNameNode.md)  
Anggota Array: Jumlah minimum 1 item.  
Wajib: Ya

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
Konfigurasi Quality of Protection (QOP) menentukan pengaturan Remote Procedure Call (RPC) dan perlindungan transfer data yang dikonfigurasi pada cluster Hadoop Distributed File System (HDFS). Jika `QopConfiguration` tidak ditentukan, `RpcProtection` dan `DataTransferProtection` default ke`PRIVACY`. Jika Anda menetapkan `RpcProtection` atau`DataTransferProtection`, parameter lain mengasumsikan nilai yang sama.   
Tipe: Objek [QopConfiguration](API_QopConfiguration.md)  
Wajib: Tidak

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
Jumlah DataNodes untuk mereplikasi data saat menulis ke cluster HDFS. Secara default, data direplikasi menjadi tiga DataNodes.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 512.  
Wajib: Tidak

 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
Nama pengguna yang digunakan untuk mengidentifikasi klien pada sistem operasi host.   
Jika `SIMPLE` ditentukan untuk`AuthenticationType`, parameter ini diperlukan. 
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Wajib: Tidak

 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
Sebuah subdirektori di cluster HDFS. Subdirektori ini digunakan untuk membaca data dari atau menulis data ke cluster HDFS. Jika subdirektori tidak ditentukan, itu akan default ke`/`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Tidak

 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
Pasangan nilai kunci yang mewakili tanda yang ingin Anda tambahkan ke lokasi. Nilai dapat berupa string kosong. Sebaiknya gunakan tanda untuk memberi nama sumber daya Anda.   
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Diperlukan: Tidak

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
ARN dari lokasi cluster HDFS sumber yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationHdfs_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

## Lihat Juga
<a name="API_CreateLocationHdfs_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/CreateLocationHdfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs) 

# CreateLocationNfs
<a name="API_CreateLocationNfs"></a>

Membuat *lokasi* transfer untuk server file Network File System (NFS). AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [mengakses server file NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).

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

```
{
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-MountOptions"></a>
Menentukan opsi yang DataSync dapat digunakan untuk me-mount server file NFS Anda.  
Tipe: Objek [NfsMountOptions](API_NfsMountOptions.md)  
Wajib: Tidak

 ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-OnPremConfig"></a>
Menentukan Nama Sumber Daya Amazon (ARN) agen yang DataSync dapat terhubung ke server file NFS Anda.  
Anda dapat menentukan lebih dari satu agen. Untuk informasi selengkapnya, lihat [Menggunakan beberapa DataSync agen](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents).  
Tipe: Objek [OnPremConfig](API_OnPremConfig.md)  
Wajib: Ya

 ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-ServerHostname"></a>
Menentukan nama DNS atau alamat IP (IPv4 atau IPv6) dari server file NFS yang terhubung dengan DataSync agen Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Wajib: Ya

 ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Subdirectory"></a>
Menentukan jalur ekspor di server file NFS Anda yang DataSync ingin Anda mount.  
Jalur ini (atau subdirektori jalur) adalah tempat DataSync mentransfer data ke atau dari. Untuk informasi tentang mengonfigurasi ekspor DataSync, lihat [Mengakses server file NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
Wajib: Ya

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

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) **   <a name="DataSync-CreateLocationNfs-response-LocationArn"></a>
ARN dari lokasi transfer yang Anda buat untuk server file NFS Anda.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationNfs_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_CreateLocationNfs_Examples"></a>

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

Contoh berikut membuat lokasi DataSync transfer untuk server file NFS.

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

```
{
  "MountOptions": {
     "Version": : "NFS4_0"
     },
  "OnPremConfig": {
    "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
          },
          
           "ServerHostname": "MyServer@amazon.com",
           "Subdirectory": "/MyFolder",
           "Tags": [
              {
                "Key": "Name",
                "Value": "FileSystem-1"
              }
           ]
}
```

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

Respons mengembalikan ARN dari lokasi NFS.

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

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
```

## Lihat Juga
<a name="API_CreateLocationNfs_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/CreateLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs) 

# CreateLocationObjectStorage
<a name="API_CreateLocationObjectStorage"></a>

Membuat *lokasi* transfer untuk sistem penyimpanan objek. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data. Anda dapat melakukan transfer dengan atau tanpa [DataSyncagen](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required).

Sebelum Anda mulai, pastikan Anda memahami [prasyarat](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) DataSync untuk bekerja dengan sistem penyimpanan objek.

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

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "BucketName": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AccessKey"></a>
Menentukan kunci akses (misalnya, nama pengguna) jika kredensil diperlukan untuk mengautentikasi dengan server penyimpanan objek.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.  
Pola: `^.*$`   
Wajib: Tidak

 ** [AgentArns](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-AgentArns"></a>
(Opsional) Menentukan Nama Sumber Daya Amazon (ARNs) dari DataSync agen yang dapat terhubung dengan sistem penyimpanan objek Anda. Jika Anda menyiapkan transfer lintas cloud tanpa agen, Anda tidak perlu menentukan nilai untuk parameter ini.  
Pastikan Anda mengonfigurasi parameter ini dengan benar saat pertama kali membuat lokasi penyimpanan. Anda tidak dapat menambah atau menghapus agen dari lokasi penyimpanan setelah Anda membuatnya.
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-BucketName"></a>
Menentukan nama bucket penyimpanan objek yang terlibat dalam transfer.  
Tipe: String  
Batasan Panjang: Panjang minimum 3. Panjang maksimum 63.  
Pola: `^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$`   
Wajib: Ya

 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia DataSync -managed, yang mencakup `SecretKey` yang DataSync digunakan untuk mengakses lokasi penyimpanan objek tertentu, dengan yang dikelola pelanggan. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationObjectStorage` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan nilai yang Anda tentukan untuk `SecretKey` parameter untuk membuat rahasia DataSync -managed untuk menyimpan kredenal akses lokasi.  
Pastikan bahwa DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang dikelola layanan yang dienkripsi](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key  
Anda dapat menggunakan `CmkSecretConfig` (with`SecretKey`) atau `CustomSecretConfig` (without`SecretKey`) untuk memberikan kredensi untuk permintaan. `CreateLocationObjectStorage` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kunci rahasia untuk lokasi penyimpanan objek tertentu disimpan dalam teks biasa, di Secrets Manager. Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Anda dapat menggunakan `CmkSecretConfig` (with`SecretKey`) atau `CustomSecretConfig` (without`SecretKey`) untuk memberikan kredensi untuk permintaan. `CreateLocationObjectStorage` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-SecretKey"></a>
Menentukan kunci rahasia (misalnya, kata sandi) jika kredensil diperlukan untuk mengautentikasi dengan server penyimpanan objek.  
Jika Anda memberikan rahasia menggunakan`SecretKey`, tetapi tidak memberikan rincian konfigurasi rahasia menggunakan `CmkSecretConfig` atau`CustomSecretConfig`, kemudian DataSync menyimpan token menggunakan rahasia Secrets Manager AWS akun Anda.
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.  
Pola: `^.*$`   
Wajib: Tidak

 ** [ServerCertificate](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerCertificate"></a>
Menentukan rantai sertifikat DataSync untuk mengautentikasi dengan sistem penyimpanan objek Anda jika sistem menggunakan otoritas sertifikat pribadi atau yang ditandatangani sendiri (CA). Anda harus menentukan satu `.pem` file dengan rantai sertifikat lengkap (misalnya,`file:///home/user/.ssh/object_storage_certificates.pem`).  
Rantai sertifikat mungkin termasuk:  
+ Sertifikat sistem penyimpanan objek
+ Semua sertifikat perantara (jika ada)
+ Sertifikat root dari CA penandatanganan
Anda dapat menggabungkan sertifikat Anda ke dalam `.pem` file (yang dapat mencapai 32768 byte sebelum pengkodean base64). Contoh `cat` perintah berikut membuat `object_storage_certificates.pem` file yang mencakup tiga sertifikat:  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
Untuk menggunakan parameter ini, konfigurasikan `ServerProtocol` ke`HTTPS`.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 32768.  
Wajib: Tidak

 ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerHostname"></a>
Menentukan nama domain atau alamat IP (IPv4 atau IPv6) dari server penyimpanan objek yang terhubung dengan DataSync agen Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Wajib: Ya

 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerPort"></a>
Menentukan port tempat server penyimpanan objek Anda menerima lalu lintas jaringan masuk (misalnya, port 443).  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 65536.  
Wajib: Tidak

 ** [ServerProtocol](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerProtocol"></a>
Menentukan protokol yang digunakan server penyimpanan objek Anda untuk berkomunikasi. Jika tidak ditentukan, nilai defaultnya adalah`HTTPS`.  
Tipe: String  
Nilai yang Valid: `HTTPS | HTTP`   
Wajib: Tidak

 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Subdirectory"></a>
Menentukan awalan objek untuk server penyimpanan objek Anda. Jika ini adalah lokasi sumber, DataSync hanya menyalin objek dengan awalan ini. Jika ini adalah lokasi tujuan, DataSync tulis semua objek dengan awalan ini.   
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Wajib: Tidak

 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Tags"></a>
Menentukan pasangan kunci-nilai yang mewakili tag yang ingin Anda tambahkan ke sumber daya. Tag dapat membantu Anda mengelola, memfilter, dan mencari sumber daya Anda. Sebaiknya buat tag nama untuk lokasi Anda.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Diperlukan: Tidak

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-CreateLocationObjectStorage-response-LocationArn"></a>
Menentukan ARN dari lokasi sistem penyimpanan objek yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationObjectStorage_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

## Lihat Juga
<a name="API_CreateLocationObjectStorage_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/CreateLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage) 

# CreateLocationS3
<a name="API_CreateLocationS3"></a>

Membuat *lokasi* transfer untuk bucket Amazon S3. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

**penting**  
Sebelum Anda mulai, pastikan Anda membaca topik-topik berikut:  
 [Pertimbangan kelas penyimpanan dengan lokasi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Mengevaluasi biaya permintaan S3 saat menggunakan DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

 Untuk informasi selengkapnya, lihat [Mengonfigurasi transfer dengan Amazon](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html) S3.

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

```
{
   "AgentArns": [ "string" ],
   "S3BucketArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArns](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-AgentArns"></a>
(Amazon S3 hanya di Outposts) Menentukan Nama Sumber Daya Amazon (ARN) agen di Outpost Anda. DataSync   
Untuk informasi selengkapnya, lihat [Menyebarkan DataSync agen Anda di AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3BucketArn"></a>
Menentukan ARN bucket S3 yang ingin Anda gunakan sebagai lokasi. (Saat membuat DataSync tugas nanti, Anda menentukan apakah lokasi ini adalah sumber transfer atau tujuan.)   
Jika bucket S3 Anda terletak di AWS Outposts sumber daya, Anda harus menentukan jalur akses Amazon S3. Untuk informasi selengkapnya, lihat [Mengelola akses data dengan jalur akses Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) di Panduan Pengguna *Amazon S3*.  
Tipe: String  
Kendala Panjang: Panjang maksimum 268.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
Wajib: Ya

 ** [S3Config](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3Config"></a>
Menentukan Nama Sumber Daya Amazon (ARN) peran (IAM) DataSync yang digunakan untuk mengakses bucket S3 Anda. AWS Identity and Access Management   
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke bucket S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipe: Objek [S3Config](API_S3Config.md)  
Wajib: Ya

 ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-S3StorageClass"></a>
Menentukan kelas penyimpanan yang Anda ingin objek Anda gunakan saat Amazon S3 adalah tujuan transfer.  
Untuk bucket masuk Wilayah AWS, kelas penyimpanan default ke. `STANDARD` Untuk bucket aktif AWS Outposts, kelas penyimpanan default ke. `OUTPOSTS`  
Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipe: String  
Nilai yang Valid: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Wajib: Tidak

 ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) **   <a name="DataSync-CreateLocationS3-request-Subdirectory"></a>
Menentukan awalan di bucket S3 yang DataSync membaca dari atau menulis ke (tergantung pada apakah bucket adalah lokasi sumber atau tujuan).  
DataSync tidak dapat mentransfer objek dengan awalan yang dimulai dengan garis miring (`/`) atau termasuk`//`,`/./`, atau `/../` pola. Contoh:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Wajib: Tidak

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

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationS3_ResponseSyntax) **   <a name="DataSync-CreateLocationS3-response-LocationArn"></a>
ARN dari lokasi S3 yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationS3_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

## Lihat Juga
<a name="API_CreateLocationS3_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/CreateLocationS3) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3) 

# CreateLocationSmb
<a name="API_CreateLocationSmb"></a>

Membuat *lokasi* transfer untuk server file Server Message Block (SMB). AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync mengakses server file SMB. Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "Password": "string",
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AgentArns"></a>
Menentukan DataSync agen (atau agen) yang dapat terhubung ke server file SMB Anda. Anda menentukan agen dengan menggunakan Nama Sumber Daya Amazon (ARN).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Ya

 ** [AuthenticationType](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-AuthenticationType"></a>
Menentukan protokol otentikasi yang DataSync digunakan untuk terhubung ke server file SMB Anda. DataSync mendukung `NTLM` (default) dan `KERBEROS` otentikasi.  
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipe: String  
Nilai yang Valid: `NTLM | KERBEROS`   
Wajib: Tidak

 ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia DataSync -managed, baik `Password` atau `KerberosKeytab` (untuk `NTLM` (default) dan jenis `KERBEROS` otentikasi, masing-masing) yang DataSync digunakan untuk mengakses lokasi penyimpanan SMB tertentu, dengan pelanggan yang dikelola. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationSmbRequest` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan salah satu `Password` atau yang `KerberosKeytab` Anda tentukan untuk membuat rahasia DataSync -managed untuk menyimpan kredensyal akses lokasi.  
Pastikan bahwa DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang dikelola layanan yang dienkripsi](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key  
Anda dapat menggunakan salah satu `CmkSecretConfig` (dengan salah satu `Password` atau`KerberosKeytab`) atau `CustomSecretConfig` (tanpa `Password` dan`KerberosKeytab`) untuk memberikan kredensyal untuk permintaan. `CreateLocationSmbRequest` Jangan berikan keduanya `CmkSecretConfig` dan `CustomSecretConfig` parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kredensyal lokasi penyimpanan SMB disimpan di Secrets Manager sebagai teks biasa (untuk) atau biner (untuk`Password`). `KerberosKeytab` Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Anda dapat menggunakan `CmkSecretConfig` (dengan`SasConfiguration`) atau `CustomSecretConfig` (tanpa`SasConfiguration`) untuk memberikan kredensyal untuk permintaan. `CreateLocationSmbRequest` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-DnsIpAddresses"></a>
Menentukan IPv4 atau IPv6 alamat untuk server DNS yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`KERBEROS`.  
Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke server file SMB yang tepat.  
Tipe: Array string  
Anggota Array: Jumlah maksimum 2 item.  
Batasan Panjang: Panjang minimum 7. Panjang maksimum 39.  
Pola: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z`   
Wajib: Tidak

 ** [Domain](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Domain"></a>
Menentukan nama domain Windows yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke server file yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Wajib: Tidak

 ** [KerberosKeytab](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKeytab"></a>
Menentukan file tabel kunci Kerberos (keytab) Anda, yang mencakup pemetaan antara kunci utama Kerberos dan kunci enkripsi Anda.  
Untuk menghindari kesalahan eksekusi tugas, pastikan bahwa prinsip Kerberos yang Anda gunakan untuk membuat file tab tombol cocok persis dengan apa yang Anda tentukan. `KerberosPrincipal`   
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 65536.  
Wajib: Tidak

 ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosKrb5Conf"></a>
Menentukan file konfigurasi Kerberos (`krb5.conf`) yang mendefinisikan konfigurasi ranah Kerberos Anda.  
File harus dikodekan base64. Jika Anda menggunakan AWS CLI, pengkodean dilakukan untuk Anda.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 131072.  
Wajib: Tidak

 ** [KerberosPrincipal](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-KerberosPrincipal"></a>
Menentukan prinsipal Kerberos, yang merupakan identitas di ranah Kerberos Anda yang memiliki izin untuk mengakses file, folder, dan metadata file di server file SMB Anda.  
Kepala sekolah Kerberos mungkin terlihat seperti. `HOST/kerberosuser@MYDOMAIN.ORG`  
Nama-nama utama bersifat case sensitive. Eksekusi DataSync tugas Anda akan gagal jika prinsipal yang Anda tentukan untuk parameter ini tidak sama persis dengan prinsipal yang Anda gunakan untuk membuat file tab tombol.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^.+$`   
Wajib: Tidak

 ** [MountOptions](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-MountOptions"></a>
Menentukan versi protokol SMB yang DataSync digunakan untuk mengakses server file SMB Anda.  
Tipe: Objek [SmbMountOptions](API_SmbMountOptions.md)  
Wajib: Tidak

 ** [Password](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Password"></a>
Menentukan kata sandi pengguna yang dapat me-mount server file SMB Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Wajib: Tidak

 ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-ServerHostname"></a>
Menentukan nama domain atau alamat IP (IPv4 atau IPv6) dari server file SMB yang terhubung dengan DataSync agen Anda.  
Jika Anda menggunakan otentikasi Kerberos, Anda harus menentukan nama domain.
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Wajib: Ya

 ** [Subdirectory](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-Subdirectory"></a>
Menentukan nama saham yang diekspor oleh server file SMB Anda di mana DataSync akan membaca atau menulis data. Anda dapat menyertakan subdirektori di jalur berbagi (misalnya,`/path/to/subdirectory`). Pastikan bahwa klien SMB lain di jaringan Anda juga dapat memasang jalur ini.  
Untuk menyalin semua data dalam subdirektori, DataSync harus dapat me-mount berbagi SMB dan mengakses semua datanya. Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Ya

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

 ** [User](#API_CreateLocationSmb_RequestSyntax) **   <a name="DataSync-CreateLocationSmb-request-User"></a>
Menentukan pengguna yang dapat me-mount dan mengakses file, folder, dan metadata file di server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Diperlukan: Tidak

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

```
{
   "LocationArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationSmb_ResponseSyntax) **   <a name="DataSync-CreateLocationSmb-response-LocationArn"></a>
ARN dari lokasi SMB yang Anda buat.  
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}:location/loc-[0-9a-z]{17}$` 

## Kesalahan
<a name="API_CreateLocationSmb_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_CreateLocationSmb_Examples"></a>

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

Contoh berikut membuat lokasi untuk server file SMB.

```
{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3"
   ],
   "Domain":"AMAZON",
   "MountOptions":{
      "Version":"SMB3"
   },
   "Password":"string",
   "ServerHostname":"MyServer.amazon.com",
   "Subdirectory":"share",
   "Tags":[
      {
         "Key":"department",
         "Value":"finance"
      }
   ],
   "User":"user-1"
}
```

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

Respons mengembalikan ARN lokasi server file SMB Anda.

```
{
    "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

## Lihat Juga
<a name="API_CreateLocationSmb_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/CreateLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb) 

# CreateTask
<a name="API_CreateTask"></a>

Mengkonfigurasi *tugas*, yang menentukan di mana dan bagaimana AWS DataSync mentransfer data Anda.

Tugas mencakup lokasi sumber, lokasi tujuan, dan opsi transfer (seperti batas bandwidth, penjadwalan, dan lainnya).

**penting**  
Jika Anda berencana untuk mentransfer data ke atau dari lokasi Amazon S3, tinjau [bagaimana DataSync dapat memengaruhi biaya permintaan S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) dan [halaman DataSync harga sebelum memulai](https://aws.amazon.com/datasync/pricing/).

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

```
{
   "CloudWatchLogGroupArn": "string",
   "DestinationLocationArn": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "SourceLocationArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [CloudWatchLogGroupArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-CloudWatchLogGroupArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari grup log CloudWatch Amazon untuk memantau tugas Anda.  
Untuk tugas mode Enhanced, Anda tidak perlu menentukan apa pun. DataSyncsecara otomatis mengirimkan log ke grup CloudWatch log bernama`/aws/datasync`.  
Untuk informasi selengkapnya, lihat [Memantau transfer data dengan CloudWatch Log](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 562.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
Wajib: Tidak

 ** [DestinationLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-DestinationLocationArn"></a>
Menentukan ARN lokasi tujuan transfer Anda.   
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Excludes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Excludes"></a>
Menentukan mengecualikan filter yang menentukan file, objek, dan folder di lokasi sumber yang tidak DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [Includes](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Includes"></a>
Menentukan termasuk filter yang menentukan file, objek, dan folder di lokasi sumber yang DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [ManifestConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-ManifestConfig"></a>
Mengkonfigurasi manifes, yang merupakan daftar file atau objek yang DataSync ingin Anda transfer. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Saat menggunakan parameter ini, identitas penelepon Anda (peran yang Anda gunakan DataSync ) harus memiliki `iam:PassRole` izin. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini.  
Tipe: Objek [ManifestConfig](API_ManifestConfig.md)  
Wajib: Tidak

 ** [Name](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Name"></a>
Menentukan nama tugas Anda.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Wajib: Tidak

 ** [Options](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Options"></a>
Menentukan pengaturan tugas Anda, seperti melestarikan metadata file, memverifikasi integritas data, di antara opsi lainnya.  
Tipe: Objek [Options](API_Options.md)  
Wajib: Tidak

 ** [Schedule](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Schedule"></a>
Menentukan jadwal untuk ketika Anda ingin tugas Anda untuk menjalankan. Untuk informasi selengkapnya, lihat [Menjadwalkan tugas Anda](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipe: Objek [TaskSchedule](API_TaskSchedule.md)  
Wajib: Tidak

 ** [SourceLocationArn](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-SourceLocationArn"></a>
Menentukan ARN lokasi sumber transfer Anda.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Tags](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-Tags"></a>
Menentukan tag yang ingin Anda terapkan untuk tugas Anda.  
 *Tag* adalah pasangan nilai kunci yang membantu Anda mengelola, memfilter, dan mencari sumber daya Anda DataSync .  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Wajib: Tidak

 ** [TaskMode](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskMode"></a>
Menentukan salah satu mode tugas berikut untuk transfer data Anda:  
+  `ENHANCED`- Transfer jumlah objek yang hampir tidak terbatas dengan kinerja lebih tinggi dari mode Dasar. Tugas mode yang disempurnakan mengoptimalkan proses transfer data dengan mencantumkan, menyiapkan, mentransfer, dan memverifikasi data secara paralel. Mode yang disempurnakan saat ini tersedia untuk transfer antara lokasi Amazon S3, transfer antara Azure Blob dan Amazon S3 tanpa agen, dan transfer antara cloud lain dan Amazon S3 tanpa agen.
**catatan**  
Untuk membuat tugas mode Enhanced, peran IAM yang Anda gunakan untuk memanggil `CreateTask` operasi harus memiliki `iam:CreateServiceLinkedRole` izin.
+  `BASIC`(default) - Transfer file atau objek antara AWS penyimpanan dan semua DataSync lokasi lain yang didukung. Tugas mode dasar tunduk pada [kuota](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-limits.html) pada jumlah file, objek, dan direktori dalam kumpulan data. Mode dasar secara berurutan menyiapkan, mentransfer, dan memverifikasi data, membuatnya lebih lambat dari mode Enhanced untuk sebagian besar beban kerja.
Untuk informasi selengkapnya, lihat [Memahami perbedaan mode tugas](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences).  
Tipe: String  
Nilai yang Valid: `BASIC | ENHANCED`   
Wajib: Tidak

 ** [TaskReportConfig](#API_CreateTask_RequestSyntax) **   <a name="DataSync-CreateTask-request-TaskReportConfig"></a>
Menentukan bagaimana Anda ingin mengkonfigurasi laporan tugas, yang memberikan informasi rinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Memantau DataSync transfer Anda dengan laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Saat menggunakan parameter ini, identitas penelepon Anda (peran yang Anda gunakan DataSync ) harus memiliki `iam:PassRole` izin. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini.  
Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md)  
Wajib: Tidak

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

```
{
   "TaskArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [TaskArn](#API_CreateTask_ResponseSyntax) **   <a name="DataSync-CreateTask-response-TaskArn"></a>
Amazon Resource Name (ARN) tugas.  
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}:task/task-[0-9a-f]{17}$` 

## Kesalahan
<a name="API_CreateTask_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_CreateTask_Examples"></a>

### Contoh Permintaan untuk tugas mode yang Ditingkatkan
<a name="API_CreateTask_Example_1"></a>

Contoh berikut membuat DataSync tugas yang menggunakan mode Enhanced.

Tidak seperti saat membuat tugas mode Dasar, Anda tidak perlu menentukan grup CloudWatch log Amazon. Dengan tugas mode Enhanced, DataSync secara otomatis mengirimkan log tugas ke grup log bernama`/aws/datasync`. Jika grup log itu tidak ada di Anda Wilayah AWS, DataSync buat grup log atas nama Anda saat Anda membuat tugas.

```
{
  "SourceLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/1111aaaa2222bbbb3",
  "DestinationLocationArn": "arn:aws:datasync:us-east-1:111222333444:location/0000zzzz1111yyyy2",
  "Name": "My Enhanced mode task",
  "TaskMode": "ENHANCED",
  "Options": {
    "TransferMode": "CHANGED",
    "VerifyMode": "ONLY_FILES_TRANSFERRED",
    "ObjectTags": "PRESERVE",
    "LogLevel": "TRANSFER"
  }
}
```

### Contoh Permintaan untuk tugas mode Dasar
<a name="API_CreateTask_Example_2"></a>

Contoh berikut membuat DataSync tugas yang menggunakan mode Dasar.

```
{
    "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3",
    "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2",
    "Name": "My Basic mode task",
    "TaskMode": "BASIC",
    "Options": {
        "Atime": "BEST_EFFORT",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "ONLY_FILES_TRANSFERRED"
    },
    "Schedule": {
        "ScheduleExpression": "0 12 ? * SUN,WED *"
    },
    "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*",
    "Tags": [
        {
            "Key": "Name",
            "Value": "Migration-wave-1"
        }
    ]
}
```

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

Tanggapan berikut mencakup ARN dari tugas yang dibuat.

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

## Lihat Juga
<a name="API_CreateTask_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/CreateTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateTask) 

# DeleteAgent
<a name="API_DeleteAgent"></a>

Menghapus sumber daya AWS DataSync agen dari Anda Akun AWS.

Perlu diingat bahwa operasi ini (yang tidak dapat dibatalkan) tidak menghapus mesin virtual agen (VM) atau instans Amazon EC2 dari lingkungan penyimpanan Anda. Untuk langkah selanjutnya, Anda dapat menghapus VM atau instance dari lingkungan penyimpanan Anda atau menggunakannya kembali untuk [mengaktifkan agen baru](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).

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

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

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArn](#API_DeleteAgent_RequestSyntax) **   <a name="DataSync-DeleteAgent-request-AgentArn"></a>
Amazon Resource Name (ARN) agen yang akan dihapus. Gunakan `ListAgents` operasi untuk mengembalikan daftar agen untuk akun Anda 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}$`   
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_DeleteAgent_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

## Lihat Juga
<a name="API_DeleteAgent_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/DeleteAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteAgent) 

# DeleteLocation
<a name="API_DeleteLocation"></a>

Menghapus sumber daya lokasi transfer dari AWS DataSync. 

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DeleteLocation_RequestSyntax) **   <a name="DataSync-DeleteLocation-request-LocationArn"></a>
Amazon Resource Name (ARN) lokasi yang akan dihapus.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_DeleteLocation_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

## Lihat Juga
<a name="API_DeleteLocation_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/DeleteLocation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteLocation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteLocation) 

# DeleteTask
<a name="API_DeleteTask"></a>

Menghapus sumber daya tugas transfer dari AWS DataSync.

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

```
{
   "TaskArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [TaskArn](#API_DeleteTask_RequestSyntax) **   <a name="DataSync-DeleteTask-request-TaskArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari tugas yang ingin Anda hapus.  
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}:task/task-[0-9a-f]{17}$`   
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_DeleteTask_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

## Lihat Juga
<a name="API_DeleteTask_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/DeleteTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DeleteTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DeleteTask) 

# DescribeAgent
<a name="API_DescribeAgent"></a>

Mengembalikan informasi tentang AWS DataSync agen, seperti namanya, jenis titik akhir layanan, dan status.

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

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

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArn](#API_DescribeAgent_RequestSyntax) **   <a name="DataSync-DescribeAgent-request-AgentArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari agen DataSync yang Anda inginkan informasi tentang.  
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}$`   
Diperlukan: Ya

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

```
{
   "AgentArn": "string",
   "CreationTime": number,
   "EndpointType": "string",
   "LastConnectionTime": number,
   "Name": "string",
   "Platform": { 
      "Version": "string"
   },
   "PrivateLinkConfig": { 
      "PrivateLinkEndpoint": "string",
      "SecurityGroupArns": [ "string" ],
      "SubnetArns": [ "string" ],
      "VpcEndpointId": "string"
   },
   "Status": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AgentArn](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-AgentArn"></a>
ARN dari agen.  
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}$` 

 ** [CreationTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-CreationTime"></a>
Waktu agen [diaktifkan](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Tipe: Timestamp

 ** [EndpointType](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-EndpointType"></a>
Jenis [titik akhir layanan](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html) yang terhubung dengan agen Anda.  
Tipe: String  
Nilai yang Valid: `PUBLIC | PRIVATE_LINK | FIPS | FIPS_PRIVATE_LINK` 

 ** [LastConnectionTime](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-LastConnectionTime"></a>
Terakhir kali agen berkomunikasi dengan DataSync layanan.  
Tipe: Timestamp

 ** [Name](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Name"></a>
Nama Agen.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Platform](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Platform"></a>
Detail terkait platform tentang agen, seperti nomor versi.  
Tipe: Objek [Platform](API_Platform.md)

 ** [PrivateLinkConfig](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-PrivateLinkConfig"></a>
Konfigurasi jaringan yang digunakan agen saat menghubungkan ke titik akhir [layanan VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc).  
Tipe: Objek [PrivateLinkConfig](API_PrivateLinkConfig.md)

 ** [Status](#API_DescribeAgent_ResponseSyntax) **   <a name="DataSync-DescribeAgent-response-Status"></a>
Status agen.  
+ Jika statusnya`ONLINE`, agen dikonfigurasi dengan benar dan siap digunakan.
+ Jika statusnya`OFFLINE`, agen telah keluar dari kontak DataSync selama lima menit atau lebih. Ini bisa terjadi karena beberapa alasan. Untuk informasi selengkapnya, lihat [Apa yang harus saya lakukan jika agen saya offline?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 
Tipe: String  
Nilai yang Valid: `ONLINE | OFFLINE` 

## Kesalahan
<a name="API_DescribeAgent_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_DescribeAgent_Examples"></a>

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

Contoh berikut mengembalikan informasi tentang agen yang ditentukan dalam permintaan.

```
{
  "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0"
}
```

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

Contoh respon berikut menjelaskan agen yang menggunakan endpoint layanan publik.

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0",
    "Name": "Data center migration agent",
    "Status": "ONLINE",
    "LastConnectionTime": "2022-10-17T17:21:35.540000+00:00",
    "CreationTime": "2022-10-05T20:52:29.499000+00:00",
    "EndpointType": "PUBLIC",
    "Platform": {
        "Version": "2"
    }
}
```

## Lihat Juga
<a name="API_DescribeAgent_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/DescribeAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeAgent) 

# DescribeLocationAzureBlob
<a name="API_DescribeLocationAzureBlob"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk Microsoft Azure Blob Storage dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationAzureBlob_RequestSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi transfer Penyimpanan Azure Blob Anda.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AccessTier](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AccessTier"></a>
Tingkat akses yang Anda inginkan objek atau file Anda ditransfer ke. Ini hanya berlaku ketika menggunakan lokasi sebagai tujuan transfer. Untuk informasi selengkapnya, lihat [Tingkat akses.](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)  
Tipe: String  
Nilai yang Valid: `HOT | COOL | ARCHIVE` 

 ** [AgentArns](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AgentArns"></a>
 DataSync Agen ARNs yang dapat terhubung dengan wadah Penyimpanan Azure Blob Anda.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$` 

 ** [AuthenticationType](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-AuthenticationType"></a>
Metode otentikasi DataSync digunakan untuk mengakses Penyimpanan Azure Blob Anda. DataSync dapat mengakses penyimpanan gumpalan menggunakan tanda tangan akses bersama (SAS).  
Tipe: String  
Nilai yang Valid: `SAS | NONE` 

 ** [BlobType](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-BlobType"></a>
Jenis gumpalan yang Anda inginkan objek atau file Anda saat mentransfernya ke Azure Blob Storage. Saat ini, DataSync hanya mendukung pemindahan data ke Azure Blob Storage sebagai blob blok. Untuk informasi selengkapnya tentang jenis gumpalan, lihat dokumentasi [Azure Blob](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Storage.  
Tipe: String  
Nilai yang Valid: `BLOCK` 

 ** [CmkSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CmkSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CreationTime"></a>
Waktu lokasi transfer Azure Blob Storage Anda dibuat.  
Tipe: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-CustomSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti token otentikasi yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [LocationArn](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationArn"></a>
ARN lokasi transfer Azure Blob Storage Anda.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-LocationUri"></a>
URL wadah Penyimpanan Azure Blob yang terlibat dalam transfer Anda.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationAzureBlob_ResponseSyntax) **   <a name="DataSync-DescribeLocationAzureBlob-response-ManagedSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager  
Tipe: Objek [ManagedSecretConfig](API_ManagedSecretConfig.md)

## Kesalahan
<a name="API_DescribeLocationAzureBlob_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

## Lihat Juga
<a name="API_DescribeLocationAzureBlob_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/DescribeLocationAzureBlob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationAzureBlob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationAzureBlob) 

# DescribeLocationEfs
<a name="API_DescribeLocationEfs"></a>

Memberikan detail tentang bagaimana lokasi AWS DataSync transfer untuk sistem file Amazon EFS dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) **   <a name="DataSync-DescribeLocationEfs-request-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi sistem file Amazon EFS yang Anda inginkan informasinya.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "AccessPointArn": "string",
   "CreationTime": number,
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "LocationUri": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-AccessPointArn"></a>
ARN dari jalur akses yang DataSync digunakan untuk mengakses sistem file Amazon EFS.  
Untuk informasi selengkapnya, lihat [Mengakses sistem file terbatas](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` 

 ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-CreationTime"></a>
Waktu lokasi itu dibuat.  
Tipe: Timestamp

 ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-Ec2Config"></a>
Subnet dan grup keamanan yang AWS DataSync digunakan untuk terhubung ke salah satu [target pemasangan](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) sistem file Amazon EFS Anda.  
Tipe: Objek [Ec2Config](API_Ec2Config.md)

 ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-FileSystemAccessRoleArn"></a>
Peran AWS Identity and Access Management (IAM) yang memungkinkan DataSync untuk mengakses sistem file Amazon EFS Anda.  
Untuk informasi selengkapnya, lihat [Membuat peran DataSync IAM untuk akses sistem file](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 

 ** [InTransitEncryption](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-InTransitEncryption"></a>
Menunjukkan apakah DataSync menggunakan enkripsi Transport Layer Security (TLS) saat mentransfer data ke atau dari sistem file Amazon EFS.  
Tipe: String  
Nilai yang Valid: `NONE | TLS1_2` 

 ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationArn"></a>
ARN dari lokasi sistem file Amazon EFS.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationEfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationEfs-response-LocationUri"></a>
URL lokasi sistem file Amazon EFS.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

## Kesalahan
<a name="API_DescribeLocationEfs_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_DescribeLocationEfs_Examples"></a>

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

Contoh berikut menunjukkan cara mendapatkan informasi tentang lokasi sistem file Amazon EFS tertentu.

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

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

Contoh berikut mengembalikan detail lokasi tentang sistem file Amazon EFS.

```
{
    "CreationTime": 1653319021.353,
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/"
}
```

### Sampel Respons: Menjelaskan lokasi untuk sistem file Amazon EFS terbatas
<a name="API_DescribeLocationEfs_Example_3"></a>

Contoh berikut menampilkan detail lokasi tentang sistem file Amazon EFS dengan akses terbatas, termasuk`AccessPointArn`,`FileSystemAccessRoleArn`, dan `InTransitEncryption` elemen.

```
{
    "CreationTime": 1653319021.353,
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

## Lihat Juga
<a name="API_DescribeLocationEfs_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/DescribeLocationEfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs) 

# DescribeLocationFsxLustre
<a name="API_DescribeLocationFsxLustre"></a>

Memberikan detail tentang bagaimana lokasi AWS DataSync transfer untuk sistem file Amazon FSx untuk Lustre dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationFsxLustre_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-request-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi FSx for Lustre untuk dijelaskan.   
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "SecurityGroupArns": [ "string" ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationTime](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-CreationTime"></a>
Waktu lokasi FSx for Lustre dibuat.  
Tipe: Timestamp

 ** [LocationArn](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi FSx for Lustre yang dijelaskan.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-LocationUri"></a>
URI lokasi FSx for Lustre yang dijelaskan.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [SecurityGroupArns](#API_DescribeLocationFsxLustre_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxLustre-response-SecurityGroupArns"></a>
Amazon Resource Names (ARNs) dari grup keamanan yang dikonfigurasi untuk sistem file FSx for Lustre.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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]+$` 

## Kesalahan
<a name="API_DescribeLocationFsxLustre_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

## Lihat Juga
<a name="API_DescribeLocationFsxLustre_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/DescribeLocationFsxLustre) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxLustre) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxLustre) 

# DescribeLocationFsxOntap
<a name="API_DescribeLocationFsxOntap"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk Amazon FSx untuk sistem file NetApp ONTAP dikonfigurasi.

**catatan**  
Jika lokasi Anda menggunakan SMB, `DescribeLocationFsxOntap` operasi tidak benar-benar mengembalikan file. `Password`

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationFsxOntap_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) untuk lokasi sistem file ONTAP yang ingin Anda informasikan. FSx   
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "CreationTime": number,
   "FsxFilesystemArn": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationTime](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-CreationTime"></a>
Waktu lokasi itu dibuat.  
Tipe: Timestamp

 ** [FsxFilesystemArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-FsxFilesystemArn"></a>
ARN dari sistem file FSx untuk ONTAP.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$` 

 ** [LocationArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-LocationArn"></a>
ARN FSx untuk lokasi sistem file ONTAP.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-LocationUri"></a>
Uniform Resource Identifier (URI) FSx untuk lokasi sistem file ONTAP.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-Protocol"></a>
Menentukan protokol transfer data yang AWS DataSync digunakan untuk mengakses sistem FSx file Amazon Anda.  
Tipe: Objek [FsxProtocol](API_FsxProtocol.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-SecurityGroupArns"></a>
Grup keamanan yang DataSync digunakan untuk mengakses sistem file ONTAP Anda FSx .  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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]+$` 

 ** [StorageVirtualMachineArn](#API_DescribeLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOntap-response-StorageVirtualMachineArn"></a>
ARN dari mesin virtual penyimpanan (SVM) pada sistem file ONTAP Anda FSx tempat Anda menyalin data ke atau dari.  
Tipe: String  
Kendala Panjang: Panjang maksimum 162.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$` 

## Kesalahan
<a name="API_DescribeLocationFsxOntap_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

## Lihat Juga
<a name="API_DescribeLocationFsxOntap_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/DescribeLocationFsxOntap) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOntap) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOntap) 

# DescribeLocationFsxOpenZfs
<a name="API_DescribeLocationFsxOpenZfs"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk Amazon FSx untuk sistem file OpenZFS dikonfigurasi.

**catatan**  
Elemen respons yang terkait dengan `SMB` tidak didukung dengan `DescribeLocationFsxOpenZfs` operasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-request-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi FSx untuk OpenZFS untuk dijelaskan.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationTime](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-CreationTime"></a>
Waktu lokasi FSx untuk OpenZFS dibuat.  
Tipe: Timestamp

 ** [LocationArn](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationArn"></a>
ARN dari FSx untuk lokasi OpenZFS yang dijelaskan.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-LocationUri"></a>
Uniform resource identifier (URI) FSx untuk lokasi OpenZFS yang telah dijelaskan.  
Contoh: `fsxz://us-west-2.fs-1234567890abcdef02/fsx/folderA/folder`   
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [Protocol](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-Protocol"></a>
Jenis protokol yang AWS DataSync digunakan untuk mengakses sistem file Anda.  
Tipe: Objek [FsxProtocol](API_FsxProtocol.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxOpenZfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxOpenZfs-response-SecurityGroupArns"></a>
Grup keamanan ARNs yang dikonfigurasi untuk sistem file FSx for OpenZFS.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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]+$` 

## Kesalahan
<a name="API_DescribeLocationFsxOpenZfs_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

## Lihat Juga
<a name="API_DescribeLocationFsxOpenZfs_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/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxOpenZfs) 

# DescribeLocationFsxWindows
<a name="API_DescribeLocationFsxWindows"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk sistem file Amazon FSx untuk Windows File Server dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationFsxWindows_RequestSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) untuk lokasi FSx Server File Windows.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "SecurityGroupArns": [ "string" ],
   "User": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CmkSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CmkSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan yang dikelola pelanggan AWS KMS key.  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CreationTime"></a>
Waktu lokasi FSx untuk Windows File Server dibuat.  
Tipe: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-CustomSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti `Password` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [Domain](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-Domain"></a>
Nama domain Microsoft Active Directory yang FSx dimiliki oleh sistem file Windows File Server.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [LocationArn](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationArn"></a>
ARN FSx untuk lokasi Server File Windows.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-LocationUri"></a>
Uniform resource identifier (URI) FSx untuk lokasi Server File Windows.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-ManagedSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager  
Tipe: Objek [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [SecurityGroupArns](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-SecurityGroupArns"></a>
ARN dari grup keamanan Amazon EC2 yang menyediakan akses ke subnet pilihan sistem file Anda.  
Untuk informasi tentang mengonfigurasi grup keamanan untuk akses sistem file, lihat [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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]+$` 

 ** [User](#API_DescribeLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-DescribeLocationFsxWindows-response-User"></a>
Pengguna dengan izin untuk me-mount dan mengakses sistem file Windows File Server FSx untuk Windows.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Kesalahan
<a name="API_DescribeLocationFsxWindows_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

## Lihat Juga
<a name="API_DescribeLocationFsxWindows_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/DescribeLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationFsxWindows) 

# DescribeLocationHdfs
<a name="API_DescribeLocationHdfs"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk Hadoop Distributed File System (HDFS) dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) **   <a name="DataSync-DescribeLocationHdfs-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi HDFS.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AgentArns"></a>
 DataSync Agen ARNs yang dapat terhubung dengan cluster HDFS Anda.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$` 

 ** [AuthenticationType](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-AuthenticationType"></a>
Jenis otentikasi yang digunakan untuk menentukan identitas pengguna.   
Tipe: String  
Nilai yang Valid: `SIMPLE | KERBEROS` 

 ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-BlockSize"></a>
Ukuran blok data untuk ditulis ke dalam cluster HDFS.   
Jenis: Integer  
Rentang Valid: Nilai minimum 1048576. Nilai maksimum 1073741824.

 ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CmkSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `KerberosKeytab` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan yang dikelola pelanggan AWS KMS key.  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CreationTime"></a>
Waktu lokasi HDFS dibuat.  
Tipe: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-CustomSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti `KerberosKeytab` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KerberosPrincipal"></a>
Kepala sekolah Kerberos dengan akses ke file dan folder pada cluster HDFS. Parameter ini digunakan jika `AuthenticationType` didefinisikan sebagai`KERBEROS`.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^.+$` 

 ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-KmsKeyProviderUri"></a>
 URI dari Server Manajemen Kunci (KMS) klaster HDFS.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$` 

 ** [LocationArn](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationArn"></a>
ARN dari lokasi HDFS.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-LocationUri"></a>
URI dari lokasi HDFS.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ManagedSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `KerberosKeytab` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager  
Tipe: Objek [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-NameNodes"></a>
 NameNode Yang mengelola namespace HDFS.   
Tipe: Array objek [HdfsNameNode](API_HdfsNameNode.md)  
Anggota Array: Jumlah minimum 1 item.

 ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-QopConfiguration"></a>
Konfigurasi Quality of Protection (QOP), yang menentukan pengaturan Remote Procedure Call (RPC) dan perlindungan transfer data yang dikonfigurasi pada cluster HDFS.   
Tipe: Objek [QopConfiguration](API_QopConfiguration.md)

 ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-ReplicationFactor"></a>
Jumlah DataNodes untuk mereplikasi data saat menulis ke cluster HDFS.   
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 512.

 ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationHdfs-response-SimpleUser"></a>
Nama pengguna untuk mengidentifikasi klien pada sistem operasi host. Parameter ini digunakan jika `AuthenticationType` didefinisikan sebagai`SIMPLE`.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 

## Kesalahan
<a name="API_DescribeLocationHdfs_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

## Lihat Juga
<a name="API_DescribeLocationHdfs_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/DescribeLocationHdfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs) 

# DescribeLocationNfs
<a name="API_DescribeLocationNfs"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk server file Network File System (NFS) dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationNfs_RequestSyntax) **   <a name="DataSync-DescribeLocationNfs-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi NFS yang ingin Anda informasikan.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationTime](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-CreationTime"></a>
Waktu ketika lokasi NFS dibuat.  
Tipe: Timestamp

 ** [LocationArn](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationArn"></a>
ARN dari lokasi NFS.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-LocationUri"></a>
URI dari lokasi NFS.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [MountOptions](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-MountOptions"></a>
Opsi pemasangan yang DataSync digunakan untuk me-mount server file NFS Anda.  
Tipe: Objek [NfsMountOptions](API_NfsMountOptions.md)

 ** [OnPremConfig](#API_DescribeLocationNfs_ResponseSyntax) **   <a name="DataSync-DescribeLocationNfs-response-OnPremConfig"></a>
 AWS DataSync Agen yang dapat terhubung ke server file Network File System (NFS) Anda.  
Tipe: Objek [OnPremConfig](API_OnPremConfig.md)

## Kesalahan
<a name="API_DescribeLocationNfs_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_DescribeLocationNfs_Examples"></a>

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

Contoh berikut mengembalikan informasi tentang lokasi NFS yang ditentukan dalam contoh permintaan.

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

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}
```

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

Contoh ini menggambarkan salah satu penggunaan. DescribeLocationNfs

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

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa",
   "LocationUri": "hostname.amazon.com",
   "OnPremConfig": { 
      "AgentArns": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
   }
}
```

## Lihat Juga
<a name="API_DescribeLocationNfs_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/DescribeLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationNfs) 

# DescribeLocationObjectStorage
<a name="API_DescribeLocationObjectStorage"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk sistem penyimpanan objek dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationObjectStorage_RequestSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi sistem penyimpanan objek.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "ServerCertificate": blob,
   "ServerPort": number,
   "ServerProtocol": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AccessKey](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AccessKey"></a>
Kunci akses (misalnya, nama pengguna) diperlukan untuk mengautentikasi dengan sistem penyimpanan objek.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.  
Pola: `^.*$` 

 ** [AgentArns](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-AgentArns"></a>
 DataSync Agen ARNs yang dapat terhubung dengan sistem penyimpanan objek Anda.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$` 

 ** [CmkSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CmkSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi atau kumpulan kredenal yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CreationTime"></a>
Waktu lokasi itu dibuat.  
Tipe: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-CustomSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti token otentikasi atau kumpulan kredensi yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [LocationArn](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationArn"></a>
ARN dari lokasi sistem penyimpanan objek.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-LocationUri"></a>
URI dari lokasi sistem penyimpanan objek.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ManagedSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi atau kumpulan kredenal yang DataSync digunakan untuk mengakses lokasi transfer tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager  
Tipe: Objek [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [ServerCertificate](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerCertificate"></a>
Rantai sertifikat DataSync untuk mengautentikasi dengan sistem penyimpanan objek Anda jika sistem menggunakan otoritas sertifikat pribadi atau yang ditandatangani sendiri (CA).  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 32768.

 ** [ServerPort](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerPort"></a>
Port tempat server penyimpanan objek Anda menerima lalu lintas jaringan masuk (misalnya, port 443).  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 65536.

 ** [ServerProtocol](#API_DescribeLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-DescribeLocationObjectStorage-response-ServerProtocol"></a>
Protokol yang digunakan sistem penyimpanan objek Anda untuk berkomunikasi.  
Tipe: String  
Nilai yang Valid: `HTTPS | HTTP` 

## Kesalahan
<a name="API_DescribeLocationObjectStorage_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

## Lihat Juga
<a name="API_DescribeLocationObjectStorage_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/DescribeLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationObjectStorage) 

# DescribeLocationS3
<a name="API_DescribeLocationS3"></a>

Memberikan detail tentang bagaimana lokasi AWS DataSync transfer untuk bucket S3 dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) **   <a name="DataSync-DescribeLocationS3-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi Amazon S3.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "AgentArns": [ "string" ],
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AgentArns](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-AgentArns"></a>
 DataSync Agen ARNs yang dikerahkan di Outpost Anda saat menggunakan bekerja dengan Amazon S3 di Outposts.  
Untuk informasi selengkapnya, lihat [Menerapkan DataSync agen Anda di AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$` 

 ** [CreationTime](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-CreationTime"></a>
Waktu lokasi Amazon S3 dibuat.  
Tipe: Timestamp

 ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationArn"></a>
ARN dari lokasi Amazon S3.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationUri"></a>
URL dari lokasi Amazon S3 yang telah dijelaskan.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [S3Config](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3Config"></a>
Menentukan Nama Sumber Daya Amazon (ARN) peran (IAM) DataSync yang digunakan untuk mengakses bucket S3 Anda. AWS Identity and Access Management   
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke bucket S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipe: Objek [S3Config](API_S3Config.md)

 ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3StorageClass"></a>
Ketika Amazon S3 adalah lokasi tujuan, ini adalah kelas penyimpanan yang Anda pilih untuk objek Anda.  
Beberapa kelas penyimpanan memiliki perilaku yang dapat memengaruhi biaya penyimpanan Amazon S3 Anda. Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipe: String  
Nilai yang Valid: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 

## Kesalahan
<a name="API_DescribeLocationS3_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_DescribeLocationS3_Examples"></a>

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

Contoh berikut mengembalikan informasi tentang lokasi Amazon S3 yang ditentukan dalam permintaan sampel.

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

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}
```

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

Contoh ini menggambarkan satu penggunaan DescribeLocation S3.

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

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
   "LocationUri": "s3://amzn-s3-demo-bucket",
   "S3Config": { 
      "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
   }
    "S3StorageClass": "STANDARD"
}
```

## Lihat Juga
<a name="API_DescribeLocationS3_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/DescribeLocationS3) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3) 

# DescribeLocationSmb
<a name="API_DescribeLocationSmb"></a>

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk server file Server Message Block (SMB) dikonfigurasi.

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

```
{
   "LocationArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi SMB yang ingin Anda informasikan.  
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}:location/loc-[0-9a-z]{17}$`   
Diperlukan: Ya

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "MountOptions": { 
      "Version": "string"
   },
   "User": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
 DataSync Agen ARNs yang dapat terhubung dengan server file SMB Anda.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$` 

 ** [AuthenticationType](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AuthenticationType"></a>
Protokol otentikasi yang DataSync digunakan untuk terhubung ke server file SMB Anda.  
Tipe: String  
Nilai yang Valid: `NTLM | KERBEROS` 

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` atau `KerberosKeytab` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan yang dikelola pelanggan AWS KMS key.  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
Waktu lokasi SMB dibuat.  
Tipe: Timestamp

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti `Password` atau `KerberosKeytab` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
 IPv6 Alamat IPv4 atau untuk server DNS yang dimiliki server file SMB Anda. Elemen ini hanya berlaku jika `AuthenticationType` diatur ke`KERBEROS`.  
Tipe: Array string  
Anggota Array: Jumlah maksimum 2 item.  
Batasan Panjang: Panjang minimum 7. Panjang maksimum 39.  
Pola: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 

 ** [Domain](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-Domain"></a>
Nama domain Windows yang dimiliki server file SMB. Elemen ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
Kepala sekolah Kerberos yang memiliki izin untuk mengakses file, folder, dan metadata file di server file SMB Anda.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^.+$` 

 ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
ARN lokasi SMB.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationUri"></a>
URI lokasi SMB.  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` atau `KerberosKeytab` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager  
Tipe: Objek [ManagedSecretConfig](API_ManagedSecretConfig.md)

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
Versi protokol SMB yang DataSync digunakan untuk mengakses server file SMB Anda.  
Tipe: Objek [SmbMountOptions](API_SmbMountOptions.md)

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
Pengguna yang dapat me-mount dan mengakses file, folder, dan metadata file di server file SMB Anda. Elemen ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## Kesalahan
<a name="API_DescribeLocationSmb_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_DescribeLocationSmb_Examples"></a>

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

Contoh ini menggambarkan salah satu penggunaan. DescribeLocationSmb

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

```
{
  "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

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

Contoh ini menggambarkan salah satu penggunaan. DescribeLocationSmb

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

```
{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
   ],
   "CreationTime":"1532660733.39",
   "Domain":"AMAZON",
   "LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
   "LocationUri":"smb://hostname.amazon.com/share",
   "MountOptions":{
      "Version":"SMB3"
   },
   "User":"user-1"
}
```

## Lihat Juga
<a name="API_DescribeLocationSmb_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/DescribeLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb) 

# DescribeTask
<a name="API_DescribeTask"></a>

Memberikan informasi tentang *tugas*, yang menentukan di mana dan bagaimana AWS DataSync mentransfer data Anda.

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

```
{
   "TaskArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [TaskArn](#API_DescribeTask_RequestSyntax) **   <a name="DataSync-DescribeTask-request-TaskArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari tugas transfer yang Anda inginkan informasi tentang.  
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}:task/task-[0-9a-f]{17}$`   
Diperlukan: Ya

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

```
{
   "CloudWatchLogGroupArn": "string",
   "CreationTime": number,
   "CurrentTaskExecutionArn": "string",
   "DestinationLocationArn": "string",
   "DestinationNetworkInterfaceArns": [ "string" ],
   "ErrorCode": "string",
   "ErrorDetail": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "ScheduleDetails": { 
      "DisabledBy": "string",
      "DisabledReason": "string",
      "StatusUpdateTime": number
   },
   "SourceLocationArn": "string",
   "SourceNetworkInterfaceArns": [ "string" ],
   "Status": "string",
   "TaskArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CloudWatchLogGroupArn"></a>
Nama Sumber Daya Amazon (ARN) dari grup CloudWatch log Amazon untuk memantau tugas Anda.  
Untuk informasi selengkapnya, lihat [Memantau transfer data dengan CloudWatch Log](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 562.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 

 ** [CreationTime](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CreationTime"></a>
Waktu tugas dibuat.  
Tipe: Timestamp

 ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CurrentTaskExecutionArn"></a>
ARN dari eksekusi tugas terbaru.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [DestinationLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationLocationArn"></a>
ARN lokasi tujuan transfer Anda.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [DestinationNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationNetworkInterfaceArns"></a>
[Antarmuka jaringan](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) yang DataSync dibuat untuk lokasi tujuan Anda. ARNs   
Tipe: Array string  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` 

 ** [ErrorCode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorCode"></a>
Jika ada masalah dengan tugas Anda, Anda dapat menggunakan kode kesalahan untuk membantu Anda memecahkan masalah. Untuk informasi selengkapnya, lihat [Memecahkan masalah dengan DataSync transfer](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipe: String

 ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorDetail"></a>
Jika ada masalah dengan tugas Anda, Anda dapat menggunakan detail kesalahan untuk membantu Anda memecahkan masalah. Untuk informasi selengkapnya, lihat [Memecahkan masalah dengan DataSync transfer](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipe: String

 ** [Excludes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Excludes"></a>
Filter pengecualian yang menentukan file, objek, dan folder di lokasi sumber yang tidak DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.

 ** [Includes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Includes"></a>
Termasuk filter yang menentukan file, objek, dan folder di lokasi sumber yang DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.

 ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ManifestConfig"></a>
Konfigurasi manifes yang mencantumkan file atau objek yang DataSync ingin Anda transfer. Untuk informasi selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipe: Objek [ManifestConfig](API_ManifestConfig.md)

 ** [Name](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Name"></a>
Nama tugas Anda.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Options](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Options"></a>
Pengaturan tugas. Misalnya, metadata file apa yang dipertahankan, bagaimana integritas data diverifikasi di akhir transfer Anda, batas bandwidth, di antara opsi lainnya.  
Tipe: Objek [Options](API_Options.md)

 ** [Schedule](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Schedule"></a>
Jadwal kapan Anda ingin tugas Anda berjalan. Untuk informasi selengkapnya, lihat [Menjadwalkan tugas Anda](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipe: Objek [TaskSchedule](API_TaskSchedule.md)

 ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ScheduleDetails"></a>
Detail tentang [jadwal tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) Anda.  
Tipe: Objek [TaskScheduleDetails](API_TaskScheduleDetails.md)

 ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceLocationArn"></a>
ARN lokasi sumber transfer Anda.  
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}:location/loc-[0-9a-z]{17}$` 

 ** [SourceNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceNetworkInterfaceArns"></a>
[Antarmuka jaringan](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) yang DataSync dibuat untuk lokasi sumber Anda. ARNs   
Tipe: Array string  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$` 

 ** [Status](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Status"></a>
Status tugas Anda. Untuk informasi tentang arti setiap status, lihat [Status tugas](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses).  
Tipe: String  
Nilai yang Valid: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` 

 ** [TaskArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskArn"></a>
ARN tugas Anda.  
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}:task/task-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskMode"></a>
Mode tugas yang Anda gunakan. Untuk informasi selengkapnya, lihat [Memilih mode tugas untuk transfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipe: String  
Nilai yang Valid: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskReportConfig"></a>
Konfigurasi laporan tugas Anda, yang memberikan informasi rinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Memantau DataSync transfer Anda dengan laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md)

## Kesalahan
<a name="API_DescribeTask_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_DescribeTask_Examples"></a>

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

Contoh berikut menentukan ARN tugas untuk mendapatkan DataSync informasi tentang.

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

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

Contoh berikut menunjukkan `DescribeTask` respons.

```
{
  "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026",
  "Name": "MyTask",
  "TaskMode": "BASIC",
  "Status": "RUNNING",
  "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3",
  "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2",
  "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f",
  "CreationTime": 1532660733.39,
  "Options": { 
    "Atime": "BEST_EFFORT",
    "BytesPerSecond": 1000,
    "Gid": "NONE",
    "Mtime": "PRESERVE",
    "PosixPermissions": "PRESERVE",
    "PreserveDevices": "NONE",
    "PreserveDeletedFiles": "PRESERVE",
    "Uid": "NONE",
    "VerifyMode": "POINT_IN_TIME_CONSISTENT"
  },
  "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*"
}
```

## Lihat Juga
<a name="API_DescribeTask_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/DescribeTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask) 

# DescribeTaskExecution
<a name="API_DescribeTaskExecution"></a>

Memberikan informasi tentang pelaksanaan AWS DataSync tugas Anda. Anda dapat menggunakan operasi ini untuk membantu memantau kemajuan transfer data yang sedang berlangsung atau memeriksa hasil transfer.

**catatan**  
Beberapa elemen `DescribeTaskExecution` respons hanya relevan dengan mode tugas tertentu. Untuk selengkapnya, lihat [Memahami perbedaan mode tugas](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences) dan [Memahami penghitung kinerja transfer data](https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html).

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

```
{
   "TaskExecutionArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [TaskExecutionArn](#API_DescribeTaskExecution_RequestSyntax) **   <a name="DataSync-DescribeTaskExecution-request-TaskExecutionArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari eksekusi tugas yang Anda inginkan informasi tentang.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Diperlukan: Ya

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

```
{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EndTime": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToDelete": number,
   "EstimatedFilesToTransfer": number,
   "EstimatedFoldersToDelete": number,
   "EstimatedFoldersToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesDeleted": number,
   "FilesFailed": { 
      "Delete": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FilesListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FilesPrepared": number,
   "FilesSkipped": number,
   "FilesTransferred": number,
   "FilesVerified": number,
   "FoldersDeleted": number,
   "FoldersFailed": { 
      "Delete": number,
      "List": number,
      "Prepare": number,
      "Transfer": number,
      "Verify": number
   },
   "FoldersListed": { 
      "AtDestinationForDelete": number,
      "AtSource": number
   },
   "FoldersPrepared": number,
   "FoldersSkipped": number,
   "FoldersTransferred": number,
   "FoldersVerified": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "LaunchTime": number,
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "ReportResult": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "Status": "string"
   },
   "Result": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "PrepareDuration": number,
      "PrepareStatus": "string",
      "TotalDuration": number,
      "TransferDuration": number,
      "TransferStatus": "string",
      "VerifyDuration": number,
      "VerifyStatus": "string"
   },
   "StartTime": number,
   "Status": "string",
   "TaskExecutionArn": "string",
   "TaskMode": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [BytesCompressed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesCompressed"></a>
Jumlah byte fisik yang DataSync ditransfer melalui jaringan setelah kompresi (jika kompresi dimungkinkan). Jumlah ini biasanya kurang dari [BytesTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesTransferred)kecuali data tidak dapat dimampatkan.  
Tipe: Long

 ** [BytesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesTransferred"></a>
Jumlah byte yang DataSync dikirim ke jaringan sebelum kompresi (jika kompresi dimungkinkan). Untuk jumlah byte yang ditransfer melalui jaringan, lihat [BytesCompressed](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-BytesCompressed).   
Tipe: Long

 ** [BytesWritten](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-BytesWritten"></a>
Jumlah byte logis yang DataSync benar-benar menulis ke lokasi tujuan.  
Tipe: Long

 ** [EndTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EndTime"></a>
Waktu tugas transfer berakhir.  
Tipe: Timestamp

 ** [EstimatedBytesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedBytesToTransfer"></a>
Jumlah byte logis yang DataSync mengharapkan untuk menulis ke lokasi tujuan.  
Tipe: Long

 ** [EstimatedFilesToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToDelete"></a>
Jumlah file, objek, dan direktori yang DataSync diharapkan untuk dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.  
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [EstimatedFoldersToDelete](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete) 
Tipe: Long

 ** [EstimatedFilesToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFilesToTransfer"></a>
Jumlah file, objek, dan direktori yang DataSync diharapkan untuk ditransfer melalui jaringan. Nilai ini dihitung saat DataSync [menyiapkan](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) transfer.  
Bagaimana ini dihitung terutama tergantung pada konfigurasi [mode transfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) tugas Anda:  
+ Jika `TranserMode` diatur ke `CHANGED` - Perhitungan didasarkan pada membandingkan konten lokasi sumber dan tujuan dan menentukan perbedaan yang perlu ditransfer. Perbedaannya dapat mencakup:
  + Apa pun yang ditambahkan atau dimodifikasi di lokasi sumber.
  + Apa pun yang ada di kedua lokasi dan dimodifikasi di tujuan setelah transfer awal (kecuali [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)diatur ke`NEVER`).
  +  **(Hanya mode tugas dasar)** Jumlah item yang DataSync diharapkan untuk dihapus (jika [PreserveDeletedFiles](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-PreserveDeletedFiles)diatur ke`REMOVE`).
+ Jika `TranserMode` diatur ke `ALL` - Perhitungan hanya didasarkan pada item yang DataSync ditemukan di lokasi sumber.
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [EstimatedFoldersToTransfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer) 
Tipe: Long

 ** [EstimatedFoldersToDelete](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToDelete"></a>
Jumlah direktori yang DataSync diharapkan untuk dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long

 ** [EstimatedFoldersToTransfer](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-EstimatedFoldersToTransfer"></a>
Jumlah direktori yang DataSync mengharapkan untuk mentransfer melalui jaringan. Nilai ini dihitung sebagai DataSync [mempersiapkan](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses) direktori untuk ditransfer.  
Bagaimana ini dihitung terutama tergantung pada konfigurasi [mode transfer](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-TransferMode) tugas Anda:  
+ Jika `TranserMode` diatur ke `CHANGED` - Perhitungan didasarkan pada membandingkan konten lokasi sumber dan tujuan dan menentukan perbedaan yang perlu ditransfer. Perbedaannya dapat mencakup:
  + Apa pun yang ditambahkan atau dimodifikasi di lokasi sumber.
  + Apa pun yang ada di kedua lokasi dan dimodifikasi di tujuan setelah transfer awal (kecuali [OverwriteMode](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-OverwriteMode)diatur ke`NEVER`).
+ Jika `TranserMode` diatur ke `ALL` - Perhitungan hanya didasarkan pada item yang DataSync ditemukan di lokasi sumber.
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long

 ** [Excludes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Excludes"></a>
Daftar aturan filter yang mengecualikan data tertentu selama transfer Anda. Untuk informasi dan contoh selengkapnya, lihat [Memfilter data yang ditransfer oleh DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.

 ** [FilesDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesDeleted"></a>
Jumlah file, objek, dan direktori yang DataSync benar-benar dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.  
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersDeleted](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersDeleted) 
Tipe: Long

 ** [FilesFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesFailed"></a>
Jumlah file atau objek yang DataSync gagal untuk mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md)

 ** [FilesListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesListed"></a>
Jumlah file atau objek yang DataSync ditemukan di lokasi Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md)

 ** [FilesPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesPrepared"></a>
Jumlah file atau objek yang DataSync akan mencoba mentransfer setelah membandingkan lokasi sumber dan tujuan Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Penghitung ini tidak berlaku jika Anda mengonfigurasi tugas Anda untuk [mentransfer semua data](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Dalam skenario itu DataSync , salin semuanya dari sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.  
Tipe: Long

 ** [FilesSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesSkipped"></a>
Jumlah file, objek, dan direktori yang DataSync dilewati selama transfer Anda.  
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersSkipped](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersSkipped) 
Tipe: Long

 ** [FilesTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesTransferred"></a>
Jumlah file, objek, dan direktori yang DataSync benar-benar ditransfer melalui jaringan. Nilai ini diperbarui secara berkala selama eksekusi tugas Anda ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan.  
Jika DataSync gagal mentransfer sesuatu, nilai ini bisa kurang dari`EstimatedFilesToTransfer`. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari`EstimatedFilesToTransfer`. Elemen ini khusus implementasi untuk beberapa jenis lokasi, jadi jangan gunakan sebagai indikasi yang tepat tentang apa yang ditransfer atau untuk memantau eksekusi tugas Anda.  
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersTransferred](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersTransferred) 
Tipe: Long

 ** [FilesVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FilesVerified"></a>
Jumlah file, objek, dan direktori yang DataSync memverifikasi selama transfer Anda.  
Ketika Anda mengonfigurasi tugas Anda untuk [memverifikasi hanya data yang ditransfer](https://docs.aws.amazon.com/datasync/latest/userguide/configure-data-verification-options.html), DataSync tidak memverifikasi direktori dalam beberapa situasi atau file yang gagal ditransfer.  
Untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html), penghitung ini hanya menyertakan file atau objek. Direktori dihitung dalam. [FoldersVerified](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html#DataSync-DescribeTaskExecution-response-FoldersVerified) 
Tipe: Long

 ** [FoldersDeleted](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersDeleted"></a>
Jumlah direktori yang DataSync benar-benar dihapus di lokasi tujuan Anda. Jika Anda tidak mengonfigurasi tugas Anda untuk [menghapus data di tujuan yang tidak ada di sumber](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html), nilainya selalu`0`.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long

 ** [FoldersFailed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersFailed"></a>
Jumlah direktori yang DataSync gagal untuk daftar, mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md)

 ** [FoldersListed](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersListed"></a>
Jumlah direktori yang DataSync ditemukan di lokasi Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Objek [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md)

 ** [FoldersPrepared](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersPrepared"></a>
Jumlah direktori yang DataSync akan mencoba mentransfer setelah membandingkan lokasi sumber dan tujuan Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Penghitung ini tidak berlaku jika Anda mengonfigurasi tugas Anda untuk [mentransfer semua data](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-transfer-mode). Dalam skenario itu DataSync , salin semuanya dari sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.  
Tipe: Long

 ** [FoldersSkipped](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersSkipped"></a>
Jumlah direktori yang DataSync melompati selama transfer Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long

 ** [FoldersTransferred](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersTransferred"></a>
Jumlah direktori yang DataSync benar-benar mentransfer melalui jaringan. Nilai ini diperbarui secara berkala selama eksekusi tugas Anda ketika sesuatu dibaca dari sumber dan dikirim melalui jaringan.  
Jika DataSync gagal mentransfer sesuatu, nilai ini bisa kurang dari`EstimatedFoldersToTransfer`. Dalam beberapa kasus, nilai ini juga bisa lebih besar dari`EstimatedFoldersToTransfer`.   
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long

 ** [FoldersVerified](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-FoldersVerified"></a>
Jumlah direktori yang DataSync memverifikasi selama transfer Anda.  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).
Tipe: Long

 ** [Includes](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Includes"></a>
Daftar aturan filter yang menyertakan data spesifik selama transfer Anda. Untuk informasi dan contoh selengkapnya, lihat [Memfilter data yang ditransfer oleh DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.

 ** [LaunchTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-LaunchTime"></a>
Waktu pelaksanaan tugas benar-benar dimulai. Untuk tugas non-antrian, `LaunchTime` dan `StartTime` biasanya sama. Untuk tugas antrian, `LaunchTime` biasanya lebih lambat dari `StartTime` karena tugas antrian sebelumnya harus selesai berjalan sebelum tugas yang lebih baru dapat dimulai.  
Tipe: Timestamp

 ** [ManifestConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ManifestConfig"></a>
Konfigurasi manifes yang mencantumkan file atau objek yang akan ditransfer. Untuk informasi selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipe: Objek [ManifestConfig](API_ManifestConfig.md)

 ** [Options](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Options"></a>
Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.  
Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin `LogLevel` menyesuaikan eksekusi individual.  
Tipe: Objek [Options](API_Options.md)

 ** [ReportResult](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-ReportResult"></a>
Menunjukkan apakah DataSync menghasilkan [laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) lengkap untuk transfer Anda.  
Tipe: Objek [ReportResult](API_ReportResult.md)

 ** [Result](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Result"></a>
Hasil eksekusi tugas.  
Tipe: Objek [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md)

 ** [StartTime](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-StartTime"></a>
Waktu yang DataSync mengirimkan permintaan untuk memulai eksekusi tugas. Untuk tugas non-antrian, `LaunchTime` dan `StartTime` biasanya sama. Untuk tugas antrian, `LaunchTime` biasanya lebih lambat dari `StartTime` karena tugas antrian sebelumnya harus selesai berjalan sebelum tugas yang lebih baru dapat dimulai.  
Tipe: Timestamp

 ** [Status](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-Status"></a>
Status tugas.   
Untuk informasi rinci tentang status eksekusi tugas, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipe: String  
Nilai yang Valid: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR` 

 ** [TaskExecutionArn](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskExecutionArn"></a>
ARN dari eksekusi tugas yang Anda inginkan informasi tentang. `TaskExecutionArn`bersifat hierarkis dan termasuk `TaskArn` untuk tugas yang dieksekusi.   
Misalnya, nilai `TaskExecution` dengan ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b` mengeksekusi tugas dengan ARN `arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2`.   
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskMode"></a>
Mode tugas yang Anda gunakan. Untuk informasi selengkapnya, lihat [Memilih mode tugas untuk transfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipe: String  
Nilai yang Valid: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTaskExecution_ResponseSyntax) **   <a name="DataSync-DescribeTaskExecution-response-TaskReportConfig"></a>
Konfigurasi laporan tugas Anda, yang memberikan informasi terperinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Membuat laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md)

## Kesalahan
<a name="API_DescribeTaskExecution_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_DescribeTaskExecution_Examples"></a>

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

Contoh ini menggambarkan `DescribeTaskExecution` permintaan.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1"
}
```

### Sample Response 1 untuk eksekusi tugas mode Enhanced
<a name="API_DescribeTaskExecution_Example_2"></a>

Contoh berikut menjelaskan eksekusi DataSync tugas yang menggunakan mode Enhanced. Eksekusi juga mentransfer data tertentu dengan menggunakan exclude dan include filter.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "BASIC",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/archive-files"
    }],
    "Includes": [{
        "FilterType": "SIMPLE_PATTERN",
        "Value": "/files"
    }],
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "EstimatedFilesToTransfer": 7,
    "EstimatedFoldersToTransfer": 2,
    "EstimatedBytesToTransfer": 30,
    "FilesTransferred": 7,
    "FoldersTransferred": 2,
    "BytesWritten": 30,
    "BytesTransferred": 30,
    "BytesCompressed": 30,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3310,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 7,
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 7,
    "FilesListed": {
        "AtSource": 7,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 2,
    "FoldersPrepared": 2,
    "FoldersListed": {
        "AtSource": 2,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
}
```

### Sample Response 2 untuk eksekusi tugas mode Enhanced
<a name="API_DescribeTaskExecution_Example_3"></a>

Contoh berikut menjelaskan eksekusi DataSync tugas lain yang menggunakan mode Enhanced. Dalam situasi ini, eksekusi mentransfer data tertentu dengan menggunakan manifes alih-alih filter.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "Status": "SUCCESS",
    "Options": {
        "VerifyMode": "ONLY_FILES_TRANSFERRED",
        "OverwriteMode": "ALWAYS",
        "Atime": "BEST_EFFORT",
        "Mtime": "PRESERVE",
        "Uid": "NONE",
        "Gid": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "PreserveDevices": "NONE",
        "PosixPermissions": "NONE",
        "BytesPerSecond": -1,
        "TaskQueueing": "ENABLED",
        "LogLevel": "TRANSFER",
        "TransferMode": "CHANGED",
        "SecurityDescriptorCopyFlags": "NONE",
        "ObjectTags": "PRESERVE"
    },
    "Excludes": [],
    "Includes": [],
    "ManifestConfig": {
        "Action": "TRANSFER",
        "Format": "CSV",
        "S3AccessRoleArn": "arn:aws:iam::111222333444:role/service-role/DataSyncS3ManifestAccess",
        "S3Bucket": "arn:aws:s3:::manifests-datasync",
        "VersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG",
        "Source": {
            "S3": {
                "ManifestObjectPath": "manifest-folder/manifest-versioned-files",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-manifest-role/DataSyncS3ManifestAccess",
                "S3BucketArn": "arn:aws:s3:::manifests-datasync",
                "ManifestObjectVersionId": "Ixs7NQzEOj8BkL9r4ywX2FtDh_cPf3mG"
            }
        }
    },
    "StartTime": "2024-10-16T09:29:56.757000-04:00",
    "EstimatedFilesToTransfer": 1,
    "EstimatedFoldersToTransfer": 0,
    "EstimatedBytesToTransfer": 6,
    "FilesTransferred": 1,
    "FoldersTransferred": 1,
    "BytesWritten": 6,
    "BytesTransferred": 6,
    "BytesCompressed": 6,
    "Result": {
        "PrepareDuration": 0,
        "PrepareStatus": "SUCCESS",
        "TotalDuration": 3089,
        "TransferDuration": 0,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 0,
        "VerifyStatus": "SUCCESS"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "Subdirectory": "reports/",
                "S3BucketArn": "arn:aws:s3:::my-task-report",
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-task-report-role/DataSyncTaskReportS3BucketAccess"
            }
        },
        "OutputType": "STANDARD",
        "ReportLevel": "SUCCESSES_AND_ERRORS",
        "ObjectVersionIds": "INCLUDE"
    },
    "FilesDeleted": 0,
    "FilesSkipped": 0,
    "FilesVerified": 1,
    "ReportResult": {
        "Status": "SUCCESS"
    },
    "EstimatedFilesToDelete": 0,
    "TaskMode": "ENHANCED",
    "FilesPrepared": 1,
    "FilesListed": {
        "AtSource": 1,
        "AtDestinationForDelete": 0
    },
    "FilesFailed": {
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    },
    "FoldersDeleted": 0,
    "FoldersSkipped": 0,
    "FoldersVerified": 0,
    "FoldersPrepared": 0,
    "FoldersListed": {
        "AtSource": 0,
        "AtDestinationForDelete": 0
    },
    "FoldersFailed": {
        "List": 0,
        "Prepare": 0,
        "Transfer": 0,
        "Verify": 0,
        "Delete": 0
    }
  }
```

### Contoh Respons untuk eksekusi tugas mode Dasar
<a name="API_DescribeTaskExecution_Example_4"></a>

Contoh berikut menjelaskan eksekusi DataSync tugas yang menggunakan mode Dasar.

```
{
    "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1",
    "BytesCompressed": 3500,
    "BytesTransferred": 5000,
    "BytesWritten": 5000,
    "EstimatedBytesToTransfer": 5000,
    "EstimatedFilesToDelete": 10,
    "EstimatedFilesToTransfer": 100,
    "FilesDeleted": 10,
    "FilesSkipped": 0,
    "FilesTransferred": 100,
    "FilesVerified": 100,
    "Result": {
        "PrepareDuration": 100,
        "PrepareStatus": "SUCCESS",
        "TransferDuration": 60,
        "TransferStatus": "SUCCESS",
        "VerifyDuration": 30,
        "VerifyStatus": "SUCCESS"
    },
    "StartTime": "2024-10-16T11:19:56.844000-04:00",
    "Status": "SUCCESS",
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": "1000",
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskReportConfig": {
        "Destination": {
            "S3": {
                "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role",
                "S3BucketArn": "arn:aws:s3:::my-task-reports-bucket/*",
                "Subdirectory": "reports"
            }
        },
        "ObjectVersionIds": "INCLUDE",
        "OutputType": "STANDARD",
        "Overrides": {
            "Deleted": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Skipped": {
                "ReportLevel": "SUCCESSES_AND_ERRORS"
            },
            "Transferred": {
                "ReportLevel": "ERRORS_ONLY"
            },
            "Verified": {
                "ReportLevel": "ERRORS_ONLY"
            }
        },
        "ReportLevel": "ERRORS_ONLY"
    }
}
```

## Lihat Juga
<a name="API_DescribeTaskExecution_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/DescribeTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTaskExecution) 

# ListAgents
<a name="API_ListAgents"></a>

Mengembalikan daftar AWS DataSync agen yang termasuk Akun AWS dalam yang Wilayah AWS ditentukan dalam permintaan.

Dengan pagination, Anda dapat mengurangi jumlah agen yang dikembalikan sebagai respons. Jika Anda mendapatkan daftar agen yang terpotong dalam respons, respons berisi penanda yang dapat Anda tentukan dalam permintaan berikutnya untuk mengambil halaman agen berikutnya.

 `ListAgents`Akhirnya konsisten. Ini berarti hasil dari menjalankan operasi mungkin tidak mencerminkan bahwa Anda baru saja membuat atau menghapus agen. Misalnya, jika Anda membuat agen dengan [CreateAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateAgent.html)dan kemudian segera menjalankannya`ListAgents`, agen itu mungkin tidak langsung muncul dalam daftar. Dalam situasi seperti ini, Anda selalu dapat mengonfirmasi apakah agen telah dibuat (atau dihapus) dengan menggunakan [DescribeAgent](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeAgent.html).

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

```
{
   "MaxResults": number,
   "NextToken": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [MaxResults](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-MaxResults"></a>
Menentukan jumlah maksimum DataSync agen untuk daftar dalam respon. Secara default, respons menunjukkan maksimum 100 agen.  
Jenis: Integer  
Rentang Valid: Nilai minimum 0. Nilai maksimum 100.  
Wajib: Tidak

 ** [NextToken](#API_ListAgents_RequestSyntax) **   <a name="DataSync-ListAgents-request-NextToken"></a>
Menentukan string buram yang menunjukkan posisi untuk memulai daftar berikutnya dari hasil dalam respon.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+`   
Diperlukan: Tidak

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

```
{
   "Agents": [ 
      { 
         "AgentArn": "string",
         "Name": "string",
         "Platform": { 
            "Version": "string"
         },
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Agents](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-Agents"></a>
Daftar DataSync agen di Anda Akun AWS dalam yang Wilayah AWS ditentukan dalam permintaan. Daftar ini diurutkan oleh Amazon Resource Names () ARNs agen.  
Tipe: Array objek [AgentListEntry](API_AgentListEntry.md)

 ** [NextToken](#API_ListAgents_ResponseSyntax) **   <a name="DataSync-ListAgents-response-NextToken"></a>
String buram yang menunjukkan posisi untuk memulai daftar hasil berikutnya dalam respons.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+` 

## Kesalahan
<a name="API_ListAgents_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

## Lihat Juga
<a name="API_ListAgents_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/ListAgents) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListAgents) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListAgents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListAgents) 

# ListLocations
<a name="API_ListLocations"></a>

Mengembalikan daftar sumber dan lokasi tujuan.

Jika Anda memiliki lebih banyak lokasi daripada yang dikembalikan dalam respons (yaitu, respons yang hanya mengembalikan daftar agen Anda yang terpotong), respons tersebut berisi token yang dapat Anda tentukan dalam permintaan berikutnya untuk mengambil halaman lokasi berikutnya.

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

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [Filters](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-Filters"></a>
Anda dapat menggunakan filter API untuk mempersempit daftar sumber daya yang dikembalikan oleh `ListLocations`. Misalnya, untuk mengambil semua tugas di lokasi sumber tertentu, Anda dapat menggunakan `ListLocations` dengan nama filter `LocationType S3` dan `Operator Equals`.  
Tipe: Array objek [LocationFilter](API_LocationFilter.md)  
Wajib: Tidak

 ** [MaxResults](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-MaxResults"></a>
Jumlah maksimum lokasi yang akan dikembalikan.  
Tipe: Bilangan Bulat  
Rentang Valid: Nilai minimum 0. Nilai maksimum 100.  
Wajib: Tidak

 ** [NextToken](#API_ListLocations_RequestSyntax) **   <a name="DataSync-ListLocations-request-NextToken"></a>
String buram yang menunjukkan posisi untuk memulai daftar lokasi berikutnya.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+`   
Diperlukan: Tidak

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

```
{
   "Locations": [ 
      { 
         "LocationArn": "string",
         "LocationUri": "string"
      }
   ],
   "NextToken": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Locations](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-Locations"></a>
Array yang berisi daftar lokasi.  
Tipe: Array objek [LocationListEntry](API_LocationListEntry.md)

 ** [NextToken](#API_ListLocations_ResponseSyntax) **   <a name="DataSync-ListLocations-response-NextToken"></a>
String buram yang menunjukkan posisi untuk mulai mengembalikan daftar lokasi berikutnya.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+` 

## Kesalahan
<a name="API_ListLocations_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

## Lihat Juga
<a name="API_ListLocations_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/ListLocations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListLocations) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListLocations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListLocations) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Mengembalikan semua tag yang terkait dengan AWS sumber daya.

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

```
{
   "MaxResults": number,
   "NextToken": "string",
   "ResourceArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [MaxResults](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-MaxResults"></a>
Menentukan berapa banyak hasil yang Anda inginkan dalam respon.  
Jenis: Integer  
Rentang Valid: Nilai minimum 0. Nilai maksimum 100.  
Wajib: Tidak

 ** [NextToken](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-NextToken"></a>
Menentukan string buram yang menunjukkan posisi untuk memulai daftar berikutnya dari hasil dalam respon.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+`   
Wajib: Tidak

 ** [ResourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="DataSync-ListTagsForResource-request-ResourceArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari sumber daya yang ingin Anda beri tag informasi.  
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|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
Diperlukan: Ya

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

```
{
   "NextToken": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-NextToken"></a>
String buram yang menunjukkan posisi untuk memulai daftar hasil berikutnya dalam respons.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+` 

 ** [Tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="DataSync-ListTagsForResource-response-Tags"></a>
Array tag diterapkan ke sumber daya yang ditentukan.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 55 item.

## Kesalahan
<a name="API_ListTagsForResource_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

## Lihat Juga
<a name="API_ListTagsForResource_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/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTagsForResource) 

# ListTaskExecutions
<a name="API_ListTaskExecutions"></a>

Mengembalikan daftar eksekusi untuk tugas AWS DataSync transfer.

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

```
{
   "MaxResults": number,
   "NextToken": "string",
   "TaskArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [MaxResults](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-MaxResults"></a>
Menentukan berapa banyak hasil yang Anda inginkan dalam respon.  
Jenis: Integer  
Rentang Valid: Nilai minimum 0. Nilai maksimum 100.  
Wajib: Tidak

 ** [NextToken](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-NextToken"></a>
Menentukan string buram yang menunjukkan posisi di mana untuk memulai daftar berikutnya dari hasil dalam respon.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+`   
Wajib: Tidak

 ** [TaskArn](#API_ListTaskExecutions_RequestSyntax) **   <a name="DataSync-ListTaskExecutions-request-TaskArn"></a>
Menentukan Amazon Resource Name (ARN) dari tugas yang Anda inginkan informasi eksekusi tentang.  
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}:task/task-[0-9a-f]{17}$`   
Diperlukan: Tidak

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

```
{
   "NextToken": "string",
   "TaskExecutions": [ 
      { 
         "Status": "string",
         "TaskExecutionArn": "string",
         "TaskMode": "string"
      }
   ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-NextToken"></a>
String buram yang menunjukkan posisi untuk memulai daftar hasil berikutnya dalam respons.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+` 

 ** [TaskExecutions](#API_ListTaskExecutions_ResponseSyntax) **   <a name="DataSync-ListTaskExecutions-response-TaskExecutions"></a>
Daftar eksekusi tugas.  
Tipe: Array objek [TaskExecutionListEntry](API_TaskExecutionListEntry.md)

## Kesalahan
<a name="API_ListTaskExecutions_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

## Lihat Juga
<a name="API_ListTaskExecutions_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/ListTaskExecutions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTaskExecutions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTaskExecutions) 

# ListTasks
<a name="API_ListTasks"></a>

Mengembalikan daftar AWS DataSync tugas yang Anda buat.

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

```
{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [Filters](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-Filters"></a>
Anda dapat menggunakan filter API untuk mempersempit daftar sumber daya yang dikembalikan oleh `ListTasks`. Misalnya, untuk mengambil semua tugas di lokasi sumber tertentu, Anda dapat menggunakan `ListTasks` dengan nama filter `LocationId` dan `Operator Equals` dengan ARN untuk lokasi.  
Tipe: Array objek [TaskFilter](API_TaskFilter.md)  
Wajib: Tidak

 ** [MaxResults](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-MaxResults"></a>
Jumlah maksimum tugas yang akan dikembalikan.  
Tipe: Bilangan Bulat  
Rentang Valid: Nilai minimum 0. Nilai maksimum 100.  
Wajib: Tidak

 ** [NextToken](#API_ListTasks_RequestSyntax) **   <a name="DataSync-ListTasks-request-NextToken"></a>
String buram yang menunjukkan posisi untuk memulai daftar tugas berikutnya.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+`   
Diperlukan: Tidak

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

```
{
   "NextToken": "string",
   "Tasks": [ 
      { 
         "Name": "string",
         "Status": "string",
         "TaskArn": "string",
         "TaskMode": "string"
      }
   ]
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [NextToken](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-NextToken"></a>
String buram yang menunjukkan posisi untuk mulai mengembalikan daftar tugas berikutnya.  
Tipe: String  
Batasan Panjang: Panjang maksimum 65535.  
Pola: `[a-zA-Z0-9=_-]+` 

 ** [Tasks](#API_ListTasks_ResponseSyntax) **   <a name="DataSync-ListTasks-response-Tasks"></a>
Daftar semua tugas yang dikembalikan.  
Tipe: Array objek [TaskListEntry](API_TaskListEntry.md)

## Kesalahan
<a name="API_ListTasks_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

## Lihat Juga
<a name="API_ListTasks_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/ListTasks) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ListTasks) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/ListTasks) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ListTasks) 

# StartTaskExecution
<a name="API_StartTaskExecution"></a>

Memulai tugas AWS DataSync transfer. Untuk setiap tugas, Anda hanya dapat menjalankan satu eksekusi tugas pada satu waktu.

Ada beberapa langkah untuk eksekusi tugas. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/working-with-task-executions.html#understand-task-execution-statuses).

**penting**  
Jika Anda berencana untuk mentransfer data ke atau dari lokasi Amazon S3, tinjau [bagaimana DataSync dapat memengaruhi biaya permintaan S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) dan [halaman DataSync harga sebelum memulai](https://aws.amazon.com/datasync/pricing/).

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

```
{
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "OverrideOptions": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TaskArn": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [Excludes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Excludes"></a>
Menentukan daftar aturan filter yang menentukan file mana yang akan dikecualikan dari tugas. Daftar ini berisi string filter tunggal yang terdiri dari pola untuk dikecualikan. Pola dibatasi oleh "\$1" (yaitu, pipa), misalnya, `"/folder1|/folder2"`.   
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [Includes](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Includes"></a>
Menentukan daftar aturan filter yang menentukan file mana yang akan disertakan saat menjalankan tugas. Pola harus berisi string filter tunggal yang terdiri dari pola yang akan disertakan. Pola dibatasi oleh "\$1" (yaitu, pipa), misalnya, `"/folder1|/folder2"`.   
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [ManifestConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-ManifestConfig"></a>
Mengkonfigurasi manifes, yang merupakan daftar file atau objek yang DataSync ingin Anda transfer. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Saat menggunakan parameter ini, identitas penelepon Anda (peran yang Anda gunakan DataSync ) harus memiliki `iam:PassRole` izin. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini.  
Untuk menghapus konfigurasi manifes, tentukan parameter ini dengan nilai kosong.  
Tipe: Objek [ManifestConfig](API_ManifestConfig.md)  
Wajib: Tidak

 ** [OverrideOptions](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-OverrideOptions"></a>
Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.  
Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin `LogLevel` menyesuaikan eksekusi individual.  
Tipe: Objek [Options](API_Options.md)  
Wajib: Tidak

 ** [Tags](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-Tags"></a>
Menentukan tag yang ingin Anda terapkan ke Amazon Resource Name (ARN) yang mewakili eksekusi tugas.  
 *Tag* adalah pasangan nilai kunci yang membantu Anda mengelola, memfilter, dan mencari sumber daya Anda DataSync .  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Wajib: Tidak

 ** [TaskArn](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari tugas yang ingin Anda mulai.  
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}:task/task-[0-9a-f]{17}$`   
Wajib: Ya

 ** [TaskReportConfig](#API_StartTaskExecution_RequestSyntax) **   <a name="DataSync-StartTaskExecution-request-TaskReportConfig"></a>
Menentukan bagaimana Anda ingin mengkonfigurasi laporan tugas, yang memberikan informasi rinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Memantau DataSync transfer Anda dengan laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Saat menggunakan parameter ini, identitas penelepon Anda (peran yang Anda gunakan DataSync ) harus memiliki `iam:PassRole` izin. [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini.  
Untuk menghapus konfigurasi laporan tugas, tentukan parameter ini sebagai kosong.  
Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md)  
Wajib: Tidak

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

```
{
   "TaskExecutionArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [TaskExecutionArn](#API_StartTaskExecution_ResponseSyntax) **   <a name="DataSync-StartTaskExecution-response-TaskExecutionArn"></a>
ARN dari eksekusi tugas yang sedang berjalan.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$` 

## Kesalahan
<a name="API_StartTaskExecution_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_StartTaskExecution_Examples"></a>

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

Contoh berikut memulai eksekusi tugas menggunakan opsi default untuk tugas yang ditentukan.

```
{
    "OverrideOptions": {
        "Atime": "BEST_EFFORT",
        "BytesPerSecond": 1000,
        "Gid": "NONE",
        "Mtime": "PRESERVE",
        "PosixPermissions": "PRESERVE",
        "PreserveDevices": "NONE",
        "PreserveDeletedFiles": "PRESERVE",
        "Uid": "NONE",
        "VerifyMode": "POINT_IN_TIME_CONSISTENT"
    },
    "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
```

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

Contoh ini menggambarkan salah satu penggunaan. StartTaskExecution

```
{
  "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}
```

## Lihat Juga
<a name="API_StartTaskExecution_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/StartTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/StartTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/StartTaskExecution) 

# TagResource
<a name="API_TagResource"></a>

*Menerapkan tag* ke AWS sumber daya. Tag adalah pasangan nilai kunci yang dapat membantu Anda mengelola, memfilter, dan mencari sumber daya Anda.

Ini termasuk AWS DataSync sumber daya, seperti lokasi, tugas, dan eksekusi tugas.

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

```
{
   "ResourceArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [ResourceArn](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-ResourceArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari sumber daya untuk menerapkan tag.  
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|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
Wajib: Ya

 ** [Tags](#API_TagResource_RequestSyntax) **   <a name="DataSync-TagResource-request-Tags"></a>
Menentukan tag yang ingin Anda terapkan ke sumber daya.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_TagResource_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

## Lihat Juga
<a name="API_TagResource_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/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagResource) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/TagResource) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Menghapus tag dari sumber AWS daya.

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

```
{
   "Keys": [ "string" ],
   "ResourceArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [Keys](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-Keys"></a>
Menentukan kunci dalam tag yang ingin Anda hapus.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:/-]+$`   
Wajib: Ya

 ** [ResourceArn](#API_UntagResource_RequestSyntax) **   <a name="DataSync-UntagResource-request-ResourceArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari sumber daya untuk menghapus tag dari.  
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|task|location)/(agent|task|loc)-[a-z0-9]{17}(/execution/exec-[a-f0-9]{17})?)|(system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}(/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})?))$`   
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UntagResource_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

## Lihat Juga
<a name="API_UntagResource_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/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UntagResource) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UntagResource) 

# UpdateAgent
<a name="API_UpdateAgent"></a>

Memperbarui nama AWS DataSync agen.

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

```
{
   "AgentArn": "string",
   "Name": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArn](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-AgentArn"></a>
Amazon Resource Name (ARN) agen yang akan diperbarui.  
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}$`   
Wajib: Ya

 ** [Name](#API_UpdateAgent_RequestSyntax) **   <a name="DataSync-UpdateAgent-request-Name"></a>
Nama yang ingin Anda gunakan untuk mengonfigurasi agen.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateAgent_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

## Lihat Juga
<a name="API_UpdateAgent_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/UpdateAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateAgent) 

# UpdateLocationAzureBlob
<a name="API_UpdateLocationAzureBlob"></a>

Memodifikasi konfigurasi lokasi transfer Microsoft Azure Blob Storage berikut yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan Azure Blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html) Storage.

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

```
{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SasConfiguration": { 
      "Token": "string"
   },
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessTier](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AccessTier"></a>
Menentukan tingkat akses yang Anda inginkan objek atau file ditransfer ke. Ini hanya berlaku ketika menggunakan lokasi sebagai tujuan transfer. Untuk informasi selengkapnya, lihat [Tingkat akses.](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers)  
Tipe: String  
Nilai yang Valid: `HOT | COOL | ARCHIVE`   
Wajib: Tidak

 ** [AgentArns](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AgentArns"></a>
(Opsional) Menentukan Nama Sumber Daya Amazon (ARN) agen yang dapat terhubung dengan wadah Penyimpanan Azure Blob Anda. DataSync Jika Anda menyiapkan transfer lintas cloud tanpa agen, Anda tidak perlu menentukan nilai untuk parameter ini.  
Anda dapat menentukan lebih dari satu agen. Untuk informasi selengkapnya, lihat [Menggunakan beberapa agen untuk transfer Anda](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html).  
Anda tidak dapat menambah atau menghapus agen dari lokasi penyimpanan setelah Anda pertama kali membuatnya.
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [AuthenticationType](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-AuthenticationType"></a>
Menentukan metode otentikasi yang DataSync digunakan untuk mengakses Penyimpanan Azure Blob Anda. DataSync dapat mengakses penyimpanan gumpalan menggunakan tanda tangan akses bersama (SAS).  
Tipe: String  
Nilai yang Valid: `SAS | NONE`   
Wajib: Tidak

 ** [BlobType](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-BlobType"></a>
Menentukan jenis gumpalan yang Anda inginkan objek atau file Anda saat mentransfernya ke Azure Blob Storage. Saat ini, DataSync hanya mendukung pemindahan data ke Azure Blob Storage sebagai blob blok. Untuk informasi selengkapnya tentang jenis gumpalan, lihat dokumentasi [Azure Blob](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Storage.  
Tipe: String  
Nilai yang Valid: `BLOCK`   
Wajib: Tidak

 ** [CmkSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi atau kumpulan kredensil yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti token otentikasi atau kumpulan kredensil yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-LocationArn"></a>
Menentukan ARN dari lokasi transfer Penyimpanan Azure Blob yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [SasConfiguration](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-SasConfiguration"></a>
Menentukan konfigurasi SAS yang memungkinkan DataSync untuk mengakses Penyimpanan Azure Blob Anda.  
Tipe: Objek [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md)  
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationAzureBlob_RequestSyntax) **   <a name="DataSync-UpdateLocationAzureBlob-request-Subdirectory"></a>
Menentukan segmen jalur jika Anda ingin membatasi transfer Anda ke direktori virtual dalam wadah Anda (misalnya,`/my/images`).  
Tipe: String  
Batasan Panjang: Panjang maksimum 1024.  
Pola: `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationAzureBlob_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

## Lihat Juga
<a name="API_UpdateLocationAzureBlob_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/UpdateLocationAzureBlob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationAzureBlob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationAzureBlob) 

# UpdateLocationEfs
<a name="API_UpdateLocationEfs"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Amazon EFS yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html).

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

```
{
   "AccessPointArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessPointArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-AccessPointArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari titik akses DataSync yang digunakan untuk memasang sistem file Amazon EFS Anda.  
Untuk informasi selengkapnya, lihat [Mengakses sistem file Amazon EFS terbatas](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$)|(^$)`   
Wajib: Tidak

 ** [FileSystemAccessRoleArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-FileSystemAccessRoleArn"></a>
Menentukan peran AWS Identity and Access Management (IAM) yang memungkinkan DataSync untuk mengakses sistem file Amazon EFS Anda.  
Untuk informasi tentang cara membuat peran ini, lihat [Membuat peran DataSync IAM untuk akses sistem file Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `(^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$)|(^$)`   
Wajib: Tidak

 ** [InTransitEncryption](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-InTransitEncryption"></a>
Menentukan apakah Anda DataSync ingin menggunakan enkripsi Transport Layer Security (TLS) 1.2 saat mentransfer data ke atau dari sistem file Amazon EFS Anda.  
Jika Anda menentukan titik akses menggunakan `AccessPointArn` atau peran IAM menggunakan`FileSystemAccessRoleArn`, Anda harus mengatur parameter ini ke`TLS1_2`.  
Tipe: String  
Nilai yang Valid: `NONE | TLS1_2`   
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi transfer Amazon EFS yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Subdirectory](#API_UpdateLocationEfs_RequestSyntax) **   <a name="DataSync-UpdateLocationEfs-request-Subdirectory"></a>
Menentukan jalur pemasangan untuk sistem file Amazon EFS Anda. Di sinilah DataSync membaca atau menulis data pada sistem file Anda (tergantung pada apakah ini adalah lokasi sumber atau tujuan).  
Secara default, DataSync gunakan direktori root (atau [titik akses](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) jika Anda menyediakannya dengan menggunakan`AccessPointArn`). Anda juga dapat menyertakan subdirektori menggunakan garis miring maju (misalnya,). `/path/to/folder`  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationEfs_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

## Lihat Juga
<a name="API_UpdateLocationEfs_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/UpdateLocationEfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationEfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationEfs) 

# UpdateLocationFsxLustre
<a name="API_UpdateLocationFsxLustre"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Amazon FSx for Lustre yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan FSx for Lustre](https://docs.aws.amazon.com/datasync/latest/userguide/create-lustre-location.html).

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

```
{
   "LocationArn": "string",
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari FSx lokasi transfer untuk Lustre yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Subdirectory](#API_UpdateLocationFsxLustre_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxLustre-request-Subdirectory"></a>
Menentukan jalur mount untuk sistem file Lustre Anda FSx . Path dapat mencakup subdirektori.  
Saat lokasi digunakan sebagai sumber, DataSync membaca data dari jalur pemasangan. Saat lokasi digunakan sebagai tujuan, DataSync tulis data ke jalur pemasangan. Jika Anda tidak menyertakan parameter ini, DataSync gunakan direktori root sistem file (`/`).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationFsxLustre_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

## Lihat Juga
<a name="API_UpdateLocationFsxLustre_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/UpdateLocationFsxLustre) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxLustre) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxLustre) 

# UpdateLocationFsxOntap
<a name="API_UpdateLocationFsxOntap"></a>

Memodifikasi parameter konfigurasi Amazon berikut FSx untuk lokasi transfer NetApp ONTAP yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan FSx untuk ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html).

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

```
{
   "LocationArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) untuk lokasi transfer ONTAP yang Anda perbarui. FSx   
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Protocol](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Protocol"></a>
Menentukan protokol transfer data yang DataSync digunakan untuk mengakses sistem FSx file Amazon Anda.  
Tipe: Objek [FsxUpdateProtocol](API_FsxUpdateProtocol.md)  
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOntap-request-Subdirectory"></a>
Menentukan jalur ke berbagi file di mesin penyimpanan virtual (SVM) di mana Anda ingin mentransfer data ke atau dari.  
Anda dapat menentukan jalur persimpangan (juga dikenal sebagai titik pemasangan), jalur qtree (untuk berbagi file NFS), atau nama berbagi (untuk berbagi file SMB). Misalnya, jalur pemasangan Anda mungkin`/vol1`,`/vol1/tree1`, atau`/share1`.  
Jangan tentukan jalur persimpangan di volume root SVM. Untuk informasi selengkapnya, lihat [Mengelola FSx mesin virtual penyimpanan ONTAP](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) di *Amazon FSx untuk Panduan Pengguna NetApp ONTAP*.
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationFsxOntap_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

## Lihat Juga
<a name="API_UpdateLocationFsxOntap_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/UpdateLocationFsxOntap) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOntap) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOntap) 

# UpdateLocationFsxOpenZfs
<a name="API_UpdateLocationFsxOpenZfs"></a>

Memodifikasi parameter konfigurasi berikut dari Amazon FSx untuk lokasi transfer OpenZFS yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengkonfigurasi DataSync transfer dengan FSx untuk OpenZFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-openzfs-location.html).

**catatan**  
Parameter permintaan yang terkait dengan `SMB` tidak didukung dengan `UpdateLocationFsxOpenZfs` operasi.

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

```
{
   "LocationArn": "string",
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari FSx lokasi transfer untuk OpenZFS yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Protocol](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Protocol"></a>
Menentukan protokol transfer data yang AWS DataSync digunakan untuk mengakses sistem FSx file Amazon Anda.  
Tipe: Objek [FsxProtocol](API_FsxProtocol.md)  
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationFsxOpenZfs_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxOpenZfs-request-Subdirectory"></a>
Menentukan subdirektori di jalur lokasi yang harus dimulai dengan. `/fsx` DataSync menggunakan subdirektori ini untuk membaca atau menulis data (tergantung pada apakah sistem file adalah lokasi sumber atau tujuan).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationFsxOpenZfs_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

## Lihat Juga
<a name="API_UpdateLocationFsxOpenZfs_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/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxOpenZfs) 

# UpdateLocationFsxWindows
<a name="API_UpdateLocationFsxWindows"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Amazon FSx untuk Windows File Server yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan FSx Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html).

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

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "LocationArn": "string",
   "Password": "string",
   "Subdirectory": "string",
   "User": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [CmkSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti satu `Password` atau set kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [Domain](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Domain"></a>
Menentukan nama domain Windows yang dimiliki oleh sistem file Windows File Server Anda FSx .  
Jika Anda memiliki beberapa domain Active Directory di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke sistem file yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-LocationArn"></a>
Menentukan ARN dari FSx lokasi transfer untuk Windows File Server yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [Password](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Password"></a>
Menentukan kata sandi pengguna dengan izin untuk memasang dan mengakses file, folder, dan metadata file di sistem file Windows File FSx Server Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-Subdirectory"></a>
Menentukan jalur mount untuk sistem file Anda menggunakan garis miring maju. DataSync menggunakan subdirektori ini untuk membaca atau menulis data (tergantung pada apakah sistem file adalah lokasi sumber atau tujuan).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Tidak

 ** [User](#API_UpdateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-UpdateLocationFsxWindows-request-User"></a>
Menentukan pengguna dengan izin untuk me-mount dan mengakses file, folder, dan metadata file dalam sistem file Windows File FSx Server Anda.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [izin yang diperlukan](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx untuk lokasi Windows File Server.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationFsxWindows_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

## Lihat Juga
<a name="API_UpdateLocationFsxWindows_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/UpdateLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationFsxWindows) 

# UpdateLocationHdfs
<a name="API_UpdateLocationHdfs"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Hadoop Distributed File System (HDFS) yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan klaster HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html).

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AgentArns"></a>
Amazon Resource Names (ARNs) dari DataSync agen yang dapat terhubung ke klaster HDFS Anda.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [AuthenticationType](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AuthenticationType"></a>
Jenis otentikasi yang digunakan untuk menentukan identitas pengguna.   
Tipe: String  
Nilai yang Valid: `SIMPLE | KERBEROS`   
Wajib: Tidak

 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-BlockSize"></a>
Ukuran blok data untuk ditulis ke dalam cluster HDFS.   
Jenis: Integer  
Rentang Valid: Nilai minimum 1048576. Nilai maksimum 1073741824.  
Wajib: Tidak

 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `KerberosKeytab` atau kumpulan kredensyal yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti `KerberosKeytab` atau kumpulan kredensyal yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKeytab"></a>
Tabel kunci Kerberos (keytab) yang berisi pemetaan antara prinsipal Kerberos yang ditentukan dan kunci terenkripsi. Anda dapat memuat tab tombol dari file dengan memberikan alamat file.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 65536.  
Wajib: Tidak

 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKrb5Conf"></a>
`krb5.conf`File yang berisi informasi konfigurasi Kerberos. Anda dapat memuat `krb5.conf` file dengan memberikan alamat file. Jika Anda menggunakan AWS CLI, ia melakukan pengkodean base64 untuk Anda. Jika tidak, berikan teks yang dikodekan base64.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 131072.  
Wajib: Tidak

 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosPrincipal"></a>
Kepala sekolah Kerberos dengan akses ke file dan folder pada cluster HDFS.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^.+$`   
Wajib: Tidak

 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KmsKeyProviderUri"></a>
URI dari Server Manajemen Kunci (KMS) klaster HDFS.   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi cluster HDFS sumber.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-NameNodes"></a>
 NameNode Yang mengelola namespace HDFS. NameNode Melakukan operasi seperti membuka, menutup, dan mengganti nama file dan direktori. NameNode Berisi informasi untuk memetakan blok data ke file DataNodes. Anda hanya dapat menggunakan satu NameNode.  
Tipe: Array objek [HdfsNameNode](API_HdfsNameNode.md)  
Anggota Array: Jumlah minimum 1 item.  
Wajib: Tidak

 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-QopConfiguration"></a>
Konfigurasi Quality of Protection (QOP) menentukan pengaturan privasi Remote Procedure Call (RPC) dan transfer data yang dikonfigurasi pada cluster Hadoop Distributed File System (HDFS).   
Tipe: Objek [QopConfiguration](API_QopConfiguration.md)  
Wajib: Tidak

 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-ReplicationFactor"></a>
Jumlah DataNodes untuk mereplikasi data saat menulis ke cluster HDFS.   
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 512.  
Wajib: Tidak

 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-SimpleUser"></a>
Nama pengguna yang digunakan untuk mengidentifikasi klien pada sistem operasi host.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-Subdirectory"></a>
Sebuah subdirektori di cluster HDFS. Subdirektori ini digunakan untuk membaca data dari atau menulis data ke cluster HDFS.  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationHdfs_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

## Lihat Juga
<a name="API_UpdateLocationHdfs_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/UpdateLocationHdfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs) 

# UpdateLocationNfs
<a name="API_UpdateLocationNfs"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Network File System (NFS) yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi transfer dengan server file NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html).

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

```
{
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi transfer NFS yang ingin Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [MountOptions](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-MountOptions"></a>
Menentukan bagaimana DataSync dapat mengakses lokasi menggunakan protokol NFS.  
Tipe: Objek [NfsMountOptions](API_NfsMountOptions.md)  
Wajib: Tidak

 ** [OnPremConfig](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-OnPremConfig"></a>
 AWS DataSync Agen yang dapat terhubung ke server file Network File System (NFS) Anda.  
Tipe: Objek [OnPremConfig](API_OnPremConfig.md)  
Wajib: Tidak

 ** [ServerHostname](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-ServerHostname"></a>
Menentukan nama DNS atau alamat IP (IPv4 atau IPv6) dari server file NFS yang terhubung dengan DataSync agen Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationNfs_RequestSyntax) **   <a name="DataSync-UpdateLocationNfs-request-Subdirectory"></a>
Menentukan jalur ekspor di server file NFS Anda yang DataSync ingin Anda mount.  
Jalur ini (atau subdirektori jalur) adalah tempat DataSync mentransfer data ke atau dari. Untuk informasi tentang mengonfigurasi ekspor DataSync, lihat [Mengakses server file NFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationNfs_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

## Lihat Juga
<a name="API_UpdateLocationNfs_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/UpdateLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationNfs) 

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer penyimpanan objek yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan sistem penyimpanan objek](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

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

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
Menentukan kunci akses (misalnya, nama pengguna) jika kredensional diperlukan untuk mengautentikasi dengan server penyimpanan objek.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.  
Pola: `^.*$`   
Wajib: Tidak

 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(Opsional) Menentukan Nama Sumber Daya Amazon (ARNs) dari DataSync agen yang dapat terhubung dengan sistem penyimpanan objek Anda. Jika Anda menyiapkan transfer lintas cloud tanpa agen, Anda tidak perlu menentukan nilai untuk parameter ini.  
Anda tidak dapat menambah atau menghapus agen dari lokasi penyimpanan setelah Anda pertama kali membuatnya.
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti token otentikasi atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
Menentukan ARN dari lokasi sistem penyimpanan objek yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
Menentukan kunci rahasia (misalnya, kata sandi) jika kredensional diperlukan untuk mengautentikasi dengan server penyimpanan objek.  
Jika Anda memberikan rahasia menggunakan`SecretKey`, tetapi tidak memberikan rincian konfigurasi rahasia menggunakan `CmkSecretConfig` atau`CustomSecretConfig`, kemudian DataSync menyimpan token menggunakan rahasia Secrets Manager AWS akun Anda.
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.  
Pola: `^.*$`   
Wajib: Tidak

 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
Menentukan rantai sertifikat DataSync untuk mengautentikasi dengan sistem penyimpanan objek Anda jika sistem menggunakan otoritas sertifikat pribadi atau yang ditandatangani sendiri (CA). Anda harus menentukan satu `.pem` file dengan rantai sertifikat lengkap (misalnya,`file:///home/user/.ssh/object_storage_certificates.pem`).  
Rantai sertifikat mungkin termasuk:  
+ Sertifikat sistem penyimpanan objek
+ Semua sertifikat menengah (jika ada)
+ Sertifikat root dari CA penandatanganan
Anda dapat menggabungkan sertifikat Anda ke dalam `.pem` file (yang dapat mencapai 32768 byte sebelum pengkodean base64). Contoh `cat` perintah berikut membuat `object_storage_certificates.pem` file yang mencakup tiga sertifikat:  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
Untuk menggunakan parameter ini, konfigurasikan `ServerProtocol` ke`HTTPS`.  
Memperbarui parameter ini tidak mengganggu tugas yang sedang Anda jalani.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 32768.  
Wajib: Tidak

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
Menentukan nama domain atau alamat IP (IPv4 atau IPv6) dari server penyimpanan objek yang terhubung dengan DataSync agen Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Wajib: Tidak

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
Menentukan port tempat server penyimpanan objek Anda menerima lalu lintas jaringan masuk (misalnya, port 443).  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 65536.  
Wajib: Tidak

 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Menentukan protokol yang digunakan server penyimpanan objek Anda untuk berkomunikasi.  
Tipe: String  
Nilai yang Valid: `HTTPS | HTTP`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
Menentukan awalan objek untuk server penyimpanan objek Anda. Jika ini adalah lokasi sumber, DataSync hanya menyalin objek dengan awalan ini. Jika ini adalah lokasi tujuan, DataSync tulis semua objek dengan awalan ini.  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationObjectStorage_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

## Lihat Juga
<a name="API_UpdateLocationObjectStorage_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/UpdateLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage) 

# UpdateLocationS3
<a name="API_UpdateLocationS3"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Amazon S3 yang Anda gunakan. AWS DataSync

**penting**  
Sebelum Anda mulai, pastikan Anda membaca topik-topik berikut:  
 [Pertimbangan kelas penyimpanan dengan lokasi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Mengevaluasi biaya permintaan S3 saat menggunakan DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

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

```
{
   "LocationArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-LocationArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari lokasi transfer Amazon S3 yang Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3Config"></a>
Menentukan Nama Sumber Daya Amazon (ARN) peran (IAM) DataSync yang digunakan untuk mengakses bucket S3 Anda. AWS Identity and Access Management   
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke bucket S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipe: Objek [S3Config](API_S3Config.md)  
Wajib: Tidak

 ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3StorageClass"></a>
Menentukan kelas penyimpanan yang Anda ingin objek Anda gunakan saat Amazon S3 adalah tujuan transfer.  
Untuk bucket masuk Wilayah AWS, kelas penyimpanan default ke. `STANDARD` Untuk bucket aktif AWS Outposts, kelas penyimpanan default ke. `OUTPOSTS`  
Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipe: String  
Nilai yang Valid: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-Subdirectory"></a>
Menentukan awalan di bucket S3 yang DataSync membaca dari atau menulis ke (tergantung pada apakah bucket adalah lokasi sumber atau tujuan).  
DataSync tidak dapat mentransfer objek dengan awalan yang dimulai dengan garis miring (`/`) atau termasuk`//`,`/./`, atau `/../` pola. Contoh:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationS3_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

## Lihat Juga
<a name="API_UpdateLocationS3_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/UpdateLocationS3) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3) 

# UpdateLocationSmb
<a name="API_UpdateLocationSmb"></a>

Memodifikasi parameter konfigurasi berikut dari lokasi transfer Blok Pesan Server (SMB) yang Anda gunakan. AWS DataSync

Untuk informasi selengkapnya, lihat [Mengonfigurasi DataSync transfer dengan server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html).

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "Password": "string",
   "ServerHostname": "string",
   "Subdirectory": "string",
   "User": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AgentArns](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AgentArns"></a>
Menentukan DataSync agen (atau agen) yang dapat terhubung ke server file SMB Anda. Anda menentukan agen dengan menggunakan Nama Sumber Daya Amazon (ARN).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Wajib: Tidak

 ** [AuthenticationType](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-AuthenticationType"></a>
Menentukan protokol otentikasi yang DataSync digunakan untuk terhubung ke server file SMB Anda. DataSync mendukung `NTLM` (default) dan `KERBEROS` otentikasi.  
Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipe: String  
Nilai yang Valid: `NTLM | KERBEROS`   
Wajib: Tidak

 ** [CmkSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` `KerberosKeytab` atau kumpulan kredensyal yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti `Password` `KerberosKeytab` atau kumpulan kredensyal yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [DnsIpAddresses](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-DnsIpAddresses"></a>
Menentukan alamat IP (IPv4 atau IPv6) untuk server DNS yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`KERBEROS`.  
Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke server file SMB yang tepat.   
Tipe: Array string  
Anggota Array: Jumlah maksimum 2 item.  
Batasan Panjang: Panjang minimum 7. Panjang maksimum 39.  
Pola: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z`   
Wajib: Tidak

 ** [Domain](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Domain"></a>
Menentukan nama domain Windows yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke server file yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Wajib: Tidak

 ** [KerberosKeytab](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKeytab"></a>
Menentukan file tabel kunci Kerberos (keytab) Anda, yang mencakup pemetaan antara kunci utama Kerberos dan kunci enkripsi Anda.  
Untuk menghindari kesalahan eksekusi tugas, pastikan bahwa prinsip Kerberos yang Anda gunakan untuk membuat file tab tombol cocok dengan apa yang Anda tentukan. `KerberosPrincipal`  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 65536.  
Wajib: Tidak

 ** [KerberosKrb5Conf](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosKrb5Conf"></a>
Menentukan file konfigurasi Kerberos (`krb5.conf`) yang mendefinisikan konfigurasi ranah Kerberos Anda.  
File harus dikodekan base64. Jika Anda menggunakan AWS CLI, pengkodean dilakukan untuk Anda.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 131072.  
Wajib: Tidak

 ** [KerberosPrincipal](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-KerberosPrincipal"></a>
Menentukan prinicpal Kerberos, yang merupakan identitas di ranah Kerberos Anda yang memiliki izin untuk mengakses file, folder, dan metadata file di server file SMB Anda.  
Kepala sekolah Kerberos mungkin terlihat seperti. `HOST/kerberosuser@MYDOMAIN.ORG`  
Nama-nama utama bersifat case sensitive. Eksekusi DataSync tugas Anda akan gagal jika prinsipal yang Anda tentukan untuk parameter ini tidak sama persis dengan prinsipal yang Anda gunakan untuk membuat file tab tombol.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^.+$`   
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-LocationArn"></a>
Menentukan ARN dari lokasi SMB yang ingin Anda perbarui.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [MountOptions](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-MountOptions"></a>
Menentukan versi protokol Server Message Block (SMB) yang AWS DataSync digunakan untuk mengakses server file SMB.  
Tipe: Objek [SmbMountOptions](API_SmbMountOptions.md)  
Wajib: Tidak

 ** [Password](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Password"></a>
Menentukan kata sandi pengguna yang dapat me-mount server file SMB Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Wajib: Tidak

 ** [ServerHostname](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-ServerHostname"></a>
Menentukan nama domain atau alamat IP (IPv4 atau IPv6) dari server file SMB yang terhubung dengan DataSync agen Anda.  
Jika Anda menggunakan otentikasi Kerberos, Anda harus menentukan nama domain.
Tipe: String  
Batasan Panjang: Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-Subdirectory"></a>
Menentukan nama saham yang diekspor oleh server file SMB Anda di mana DataSync akan membaca atau menulis data. Anda dapat menyertakan subdirektori di jalur berbagi (misalnya,`/path/to/subdirectory`). Pastikan bahwa klien SMB lain di jaringan Anda juga dapat memasang jalur ini.  
Untuk menyalin semua data dalam subdirektori yang ditentukan, DataSync harus dapat me-mount berbagi SMB dan mengakses semua datanya. Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Tidak

 ** [User](#API_UpdateLocationSmb_RequestSyntax) **   <a name="DataSync-UpdateLocationSmb-request-User"></a>
Menentukan nama pengguna yang dapat me-mount server file SMB Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions).  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Diperlukan: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationSmb_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

## Lihat Juga
<a name="API_UpdateLocationSmb_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/UpdateLocationSmb) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationSmb) 

# UpdateTask
<a name="API_UpdateTask"></a>

Memperbarui konfigurasi *tugas*, yang menentukan di mana dan bagaimana AWS DataSync mentransfer data Anda.

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

```
{
   "CloudWatchLogGroupArn": "string",
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "ManifestConfig": { 
      "Action": "string",
      "Format": "string",
      "Source": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "ManifestObjectPath": "string",
            "ManifestObjectVersionId": "string",
            "S3BucketArn": "string"
         }
      }
   },
   "Name": "string",
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "Schedule": { 
      "ScheduleExpression": "string",
      "Status": "string"
   },
   "TaskArn": "string",
   "TaskReportConfig": { 
      "Destination": { 
         "S3": { 
            "BucketAccessRoleArn": "string",
            "S3BucketArn": "string",
            "Subdirectory": "string"
         }
      },
      "ObjectVersionIds": "string",
      "OutputType": "string",
      "Overrides": { 
         "Deleted": { 
            "ReportLevel": "string"
         },
         "Skipped": { 
            "ReportLevel": "string"
         },
         "Transferred": { 
            "ReportLevel": "string"
         },
         "Verified": { 
            "ReportLevel": "string"
         }
      },
      "ReportLevel": "string"
   }
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [CloudWatchLogGroupArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-CloudWatchLogGroupArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari grup log CloudWatch Amazon untuk memantau tugas Anda.  
Untuk tugas mode Enhanced, Anda harus menggunakan `/aws/datasync` sebagai nama grup log Anda. Contoh:  
 `arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*`   
Untuk informasi selengkapnya, lihat [Memantau transfer data dengan CloudWatch Log](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 562.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$`   
Wajib: Tidak

 ** [Excludes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Excludes"></a>
Menentukan mengecualikan filter yang menentukan file, objek, dan folder di lokasi sumber Anda yang tidak DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [Includes](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Includes"></a>
Menentukan termasuk filter menentukan file, objek, dan folder di lokasi sumber Anda yang DataSync ingin Anda transfer. Untuk informasi dan contoh selengkapnya, lihat [Menentukan DataSync transfer apa yang menggunakan filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipe: Array objek [FilterRule](API_FilterRule.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.  
Wajib: Tidak

 ** [ManifestConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-ManifestConfig"></a>
Mengkonfigurasi manifes, yang merupakan daftar file atau objek yang DataSync ingin Anda transfer. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Saat menggunakan parameter ini, identitas penelepon Anda (peran IAM yang Anda gunakan DataSync ) harus memiliki izin. `iam:PassRole` [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini.  
Untuk menghapus konfigurasi manifes, tentukan parameter ini sebagai kosong.  
Tipe: Objek [ManifestConfig](API_ManifestConfig.md)  
Wajib: Tidak

 ** [Name](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Name"></a>
Menentukan nama tugas Anda.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Wajib: Tidak

 ** [Options](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Options"></a>
Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.  
Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin `LogLevel` menyesuaikan eksekusi individual.  
Tipe: Objek [Options](API_Options.md)  
Wajib: Tidak

 ** [Schedule](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-Schedule"></a>
Menentukan jadwal untuk ketika Anda ingin tugas Anda untuk menjalankan. Untuk informasi selengkapnya, lihat [Menjadwalkan tugas Anda](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipe: Objek [TaskSchedule](API_TaskSchedule.md)  
Wajib: Tidak

 ** [TaskArn](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskArn"></a>
Menentukan ARN dari tugas yang ingin Anda perbarui.  
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}:task/task-[0-9a-f]{17}$`   
Wajib: Ya

 ** [TaskReportConfig](#API_UpdateTask_RequestSyntax) **   <a name="DataSync-UpdateTask-request-TaskReportConfig"></a>
Menentukan bagaimana Anda ingin mengkonfigurasi laporan tugas, yang memberikan informasi rinci tentang DataSync transfer Anda. Untuk informasi selengkapnya, lihat [Memantau DataSync transfer Anda dengan laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Saat menggunakan parameter ini, identitas penelepon Anda (peran IAM yang Anda gunakan DataSync ) harus memiliki izin. `iam:PassRole` [AWSDataSyncFullAccess](https://docs.aws.amazon.com/datasync/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-awsdatasyncfullaccess)Kebijakan tersebut mencakup izin ini.  
Untuk menghapus konfigurasi laporan tugas, tentukan parameter ini sebagai kosong.  
Tipe: Objek [TaskReportConfig](API_TaskReportConfig.md)  
Wajib: Tidak

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateTask_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

## Lihat Juga
<a name="API_UpdateTask_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/UpdateTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTask) 

# UpdateTaskExecution
<a name="API_UpdateTaskExecution"></a>

Memperbarui konfigurasi eksekusi AWS DataSync tugas yang sedang berjalan.

**catatan**  
Saat ini, satu-satunya `Option` yang dapat Anda modifikasi `UpdateTaskExecution` adalah` [BytesPerSecond](https://docs.aws.amazon.com/datasync/latest/userguide/API_Options.html#DataSync-Type-Options-BytesPerSecond) `, yang membatasi bandwidth untuk eksekusi tugas yang sedang berjalan atau antrian.

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

```
{
   "Options": { 
      "Atime": "string",
      "BytesPerSecond": number,
      "Gid": "string",
      "LogLevel": "string",
      "Mtime": "string",
      "ObjectTags": "string",
      "OverwriteMode": "string",
      "PosixPermissions": "string",
      "PreserveDeletedFiles": "string",
      "PreserveDevices": "string",
      "SecurityDescriptorCopyFlags": "string",
      "TaskQueueing": "string",
      "TransferMode": "string",
      "Uid": "string",
      "VerifyMode": "string"
   },
   "TaskExecutionArn": "string"
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [Options](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-Options"></a>
Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.  
Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).  
Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin `LogLevel` menyesuaikan eksekusi individual.  
Tipe: Objek [Options](API_Options.md)  
Wajib: Ya

 ** [TaskExecutionArn](#API_UpdateTaskExecution_RequestSyntax) **   <a name="DataSync-UpdateTaskExecution-request-TaskExecutionArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari eksekusi tugas yang Anda perbarui.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Diperlukan: Ya

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateTaskExecution_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

## Lihat Juga
<a name="API_UpdateTaskExecution_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/UpdateTaskExecution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateTaskExecution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateTaskExecution) 

# Tipe Data
<a name="API_Types"></a>

tipe data berikut didukung:
+  [AgentListEntry](API_AgentListEntry.md) 
+  [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) 
+  [CmkSecretConfig](API_CmkSecretConfig.md) 
+  [CustomSecretConfig](API_CustomSecretConfig.md) 
+  [Ec2Config](API_Ec2Config.md) 
+  [FilterRule](API_FilterRule.md) 
+  [FsxProtocol](API_FsxProtocol.md) 
+  [FsxProtocolNfs](API_FsxProtocolNfs.md) 
+  [FsxProtocolSmb](API_FsxProtocolSmb.md) 
+  [FsxUpdateProtocol](API_FsxUpdateProtocol.md) 
+  [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md) 
+  [HdfsNameNode](API_HdfsNameNode.md) 
+  [LocationFilter](API_LocationFilter.md) 
+  [LocationListEntry](API_LocationListEntry.md) 
+  [ManagedSecretConfig](API_ManagedSecretConfig.md) 
+  [ManifestConfig](API_ManifestConfig.md) 
+  [NfsMountOptions](API_NfsMountOptions.md) 
+  [OnPremConfig](API_OnPremConfig.md) 
+  [Options](API_Options.md) 
+  [Platform](API_Platform.md) 
+  [PrivateLinkConfig](API_PrivateLinkConfig.md) 
+  [QopConfiguration](API_QopConfiguration.md) 
+  [ReportDestination](API_ReportDestination.md) 
+  [ReportDestinationS3](API_ReportDestinationS3.md) 
+  [ReportOverride](API_ReportOverride.md) 
+  [ReportOverrides](API_ReportOverrides.md) 
+  [ReportResult](API_ReportResult.md) 
+  [S3Config](API_S3Config.md) 
+  [S3ManifestConfig](API_S3ManifestConfig.md) 
+  [SmbMountOptions](API_SmbMountOptions.md) 
+  [SourceManifestConfig](API_SourceManifestConfig.md) 
+  [TagListEntry](API_TagListEntry.md) 
+  [TaskExecutionFilesFailedDetail](API_TaskExecutionFilesFailedDetail.md) 
+  [TaskExecutionFilesListedDetail](API_TaskExecutionFilesListedDetail.md) 
+  [TaskExecutionFoldersFailedDetail](API_TaskExecutionFoldersFailedDetail.md) 
+  [TaskExecutionFoldersListedDetail](API_TaskExecutionFoldersListedDetail.md) 
+  [TaskExecutionListEntry](API_TaskExecutionListEntry.md) 
+  [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md) 
+  [TaskFilter](API_TaskFilter.md) 
+  [TaskListEntry](API_TaskListEntry.md) 
+  [TaskReportConfig](API_TaskReportConfig.md) 
+  [TaskSchedule](API_TaskSchedule.md) 
+  [TaskScheduleDetails](API_TaskScheduleDetails.md) 

# AgentListEntry
<a name="API_AgentListEntry"></a>

Merupakan entri tunggal dalam daftar (atau array) AWS DataSync agen saat Anda memanggil [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operasi.

## Daftar Isi
<a name="API_AgentListEntry_Contents"></a>

 ** AgentArn **   <a name="DataSync-Type-AgentListEntry-AgentArn"></a>
Nama Sumber Daya Amazon (ARN) dari agen. DataSync   
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}$`   
Wajib: Tidak

 ** Name **   <a name="DataSync-Type-AgentListEntry-Name"></a>
Nama seorang agen.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Wajib: Tidak

 ** Platform **   <a name="DataSync-Type-AgentListEntry-Platform"></a>
Detail terkait platform tentang agen, seperti nomor versi.  
Tipe: Objek [Platform](API_Platform.md)  
Wajib: Tidak

 ** Status **   <a name="DataSync-Type-AgentListEntry-Status"></a>
Status seorang agen.  
+ Jika statusnya`ONLINE`, agen dikonfigurasi dengan benar dan siap digunakan.
+ Jika statusnya`OFFLINE`, agen telah keluar dari kontak DataSync selama lima menit atau lebih. Ini bisa terjadi karena beberapa alasan. Untuk informasi selengkapnya, lihat [Apa yang harus saya lakukan jika agen saya offline?](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-agents.html#troubleshoot-agent-offline) 
Tipe: String  
Nilai yang Valid: `ONLINE | OFFLINE`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AgentListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AgentListEntry) 

# AzureBlobSasConfiguration
<a name="API_AzureBlobSasConfiguration"></a>

Konfigurasi tanda tangan akses bersama (SAS) yang memungkinkan AWS DataSync untuk mengakses Penyimpanan Microsoft Azure Blob Anda.

Untuk informasi selengkapnya, lihat [token SAS](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-sas-tokens) untuk mengakses Penyimpanan Azure Blob Anda.

## Daftar Isi
<a name="API_AzureBlobSasConfiguration_Contents"></a>

 ** Token **   <a name="DataSync-Type-AzureBlobSasConfiguration-Token"></a>
Menentukan token SAS yang memberikan izin untuk mengakses Penyimpanan Azure Blob Anda.  
Token adalah bagian dari string URI SAS yang muncul setelah URI sumber daya penyimpanan dan tanda tanya. Token terlihat seperti ini:  
 `sp=r&st=2023-12-20T14:54:52Z&se=2023-12-20T22:54:52Z&spr=https&sv=2021-06-08&sr=c&sig=aBBKDWQvyuVcTPH9EBp%2FXTI9E%2F%2Fmq171%2BZU178wcwqU%3D`   
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^.+$`   
Diperlukan: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/AzureBlobSasConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/AzureBlobSasConfiguration) 

# CmkSecretConfig
<a name="API_CmkSecretConfig"></a>

Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi, kunci rahasia, kata sandi, atau tab kunci Kerberos yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu, dengan pengelola pelanggan. AWS KMS key

**catatan**  
Anda dapat menggunakan salah satu `CmkSecretConfig` atau `CustomSecretConfig` untuk memberikan kredensyal untuk permintaan. `CreateLocation` Jangan berikan kedua parameter untuk permintaan yang sama.

## Daftar Isi
<a name="API_CmkSecretConfig_Contents"></a>

 ** KmsKeyArn **   <a name="DataSync-Type-CmkSecretConfig-KmsKeyArn"></a>
Menentukan ARN untuk AWS KMS key pelanggan yang dikelola yang menggunakan untuk mengenkripsi DataSync rahasia -managed DataSync yang disimpan untuk. `SecretArn` DataSync menyediakan kunci ini untuk AWS Secrets Manager.  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):kms:[a-z\-0-9]+:[0-9]{12}:key/.*|)$`   
Wajib: Tidak

 ** SecretArn **   <a name="DataSync-Type-CmkSecretConfig-SecretArn"></a>
Menentukan ARN untuk DataSync rahasia AWS Secrets Manager -managed yang digunakan untuk mengakses lokasi penyimpanan tertentu. Properti ini dihasilkan oleh DataSync dan hanya-baca. DataSync mengenkripsi rahasia ini dengan kunci KMS yang Anda tentukan. `KmsKeyArn`  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CmkSecretConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CmkSecretConfig) 

# CustomSecretConfig
<a name="API_CustomSecretConfig"></a>

Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kredensyal lokasi penyimpanan disimpan di Secrets Manager sebagai teks biasa (untuk token otentikasi, kunci rahasia, atau kata sandi) atau sebagai biner (untuk tab kunci Kerberos). Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia.

**catatan**  
Anda dapat menggunakan salah satu `CmkSecretConfig` atau `CustomSecretConfig` untuk memberikan kredensyal untuk permintaan. `CreateLocation` Jangan berikan kedua parameter untuk permintaan yang sama.

## Daftar Isi
<a name="API_CustomSecretConfig_Contents"></a>

 ** SecretAccessRoleArn **   <a name="DataSync-Type-CustomSecretConfig-SecretAccessRoleArn"></a>
Menentukan ARN untuk peran AWS Identity and Access Management yang menggunakan untuk mengakses rahasia DataSync yang ditentukan untuk. `SecretArn`  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/[a-zA-Z0-9+=,.@_-]+|)$`   
Wajib: Tidak

 ** SecretArn **   <a name="DataSync-Type-CustomSecretConfig-SecretArn"></a>
Menentukan ARN untuk AWS Secrets Manager rahasia.  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CustomSecretConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CustomSecretConfig) 

# Ec2Config
<a name="API_Ec2Config"></a>

Subnet dan grup keamanan yang AWS DataSync digunakan untuk terhubung ke salah satu [target pemasangan](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) sistem file Amazon EFS Anda.

## Daftar Isi
<a name="API_Ec2Config_Contents"></a>

 ** SecurityGroupArns **   <a name="DataSync-Type-Ec2Config-SecurityGroupArns"></a>
Menentukan Nama Sumber Daya Amazon (ARNs) dari grup keamanan yang terkait dengan target pemasangan sistem file Amazon EFS.  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 5 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: Ya

 ** SubnetArn **   <a name="DataSync-Type-Ec2Config-SubnetArn"></a>
Menentukan ARN dari subnet DataSync di mana menciptakan antarmuka [jaringan untuk mengelola lalu](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) lintas selama transfer Anda.  
Subnet harus ditemukan:  
+ Di cloud pribadi virtual (VPC) yang sama dengan sistem file Amazon EFS.
+ Di Availability Zone yang sama dengan setidaknya satu target mount untuk sistem file Amazon EFS.
Anda tidak perlu menentukan subnet yang menyertakan target pemasangan sistem file.
Tipe: String  
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]+$`   
Diperlukan: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Ec2Config) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Ec2Config) 

# FilterRule
<a name="API_FilterRule"></a>

Menentukan file, folder, dan objek untuk disertakan atau dikecualikan saat mentransfer file dari sumber ke tujuan.

## Daftar Isi
<a name="API_FilterRule_Contents"></a>

 ** FilterType **   <a name="DataSync-Type-FilterRule-FilterType"></a>
Jenis aturan filter yang akan diterapkan. AWS DataSync hanya mendukung jenis aturan SIMPLE\$1PATTERN.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^[A-Z0-9_]+$`   
Nilai yang Valid: `SIMPLE_PATTERN`   
Wajib: Tidak

 ** Value **   <a name="DataSync-Type-FilterRule-Value"></a>
String filter tunggal yang terdiri dari pola untuk disertakan atau dikecualikan. Pola dibatasi oleh "\$1" (yaitu, pipa), misalnya: `/folder1|/folder2`   
   
Tipe: String  
Kendala Panjang: Panjang maksimum 102400.  
Pola: `^[^\x00]+$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FilterRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FilterRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FilterRule) 

# FsxProtocol
<a name="API_FsxProtocol"></a>

Menentukan protokol transfer data yang AWS DataSync digunakan untuk mengakses sistem FSx file Amazon Anda.

## Daftar Isi
<a name="API_FsxProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxProtocol-NFS"></a>
Menentukan konfigurasi protokol Network File System (NFS) yang DataSync digunakan untuk mengakses sistem file OpenZFS Anda atau FSx FSx untuk mesin virtual penyimpanan sistem file ONTAP (SVM).  
Tipe: Objek [FsxProtocolNfs](API_FsxProtocolNfs.md)  
Wajib: Tidak

 ** SMB **   <a name="DataSync-Type-FsxProtocol-SMB"></a>
Menentukan konfigurasi protokol Server Message Block (SMB) yang DataSync digunakan untuk mengakses SVM sistem file ONTAP Anda FSx .  
Tipe: Objek [FsxProtocolSmb](API_FsxProtocolSmb.md)  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocol) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocol) 

# FsxProtocolNfs
<a name="API_FsxProtocolNfs"></a>

Menentukan konfigurasi protokol Network File System (NFS) yang DataSync digunakan untuk mengakses sistem file OpenZFS Anda atau FSx FSx untuk mesin virtual penyimpanan sistem file ONTAP (SVM).

## Daftar Isi
<a name="API_FsxProtocolNfs_Contents"></a>

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolNfs-MountOptions"></a>
Menentukan bagaimana DataSync dapat mengakses lokasi menggunakan protokol NFS.  
Tipe: Objek [NfsMountOptions](API_NfsMountOptions.md)  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolNfs) 

# FsxProtocolSmb
<a name="API_FsxProtocolSmb"></a>

Menentukan konfigurasi protokol Blok Pesan Server (SMB) yang AWS DataSync digunakan untuk mengakses Amazon FSx Anda untuk mesin virtual penyimpanan (SVM) sistem file NetApp ONTAP. Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke FSx sistem file ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Daftar Isi
<a name="API_FsxProtocolSmb_Contents"></a>

 ** User **   <a name="DataSync-Type-FsxProtocolSmb-User"></a>
Menentukan pengguna yang dapat me-mount dan mengakses file, folder, dan metadata di SVM Anda.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [Menggunakan protokol SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb).  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Wajib: Ya

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, yang mencakup kata sandi yang DataSync digunakan untuk mengakses lokasi penyimpanan ONTAP tertentu FSx (menggunakan SMB), dengan pengelolaan pelanggan. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationFsxOntap` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan yang `Password` Anda tentukan untuk membuat rahasia DataSync -managed untuk menyimpan kredenal akses lokasi.  
Pastikan bahwa DataSync memiliki izin untuk mengakses kunci KMS yang Anda tentukan. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang dikelola layanan yang dienkripsi](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key  
Anda dapat menggunakan `CmkSecretConfig` (with`Password`) atau `CustomSecretConfig` (without`Password`) untuk memberikan kredensi untuk permintaan. `CreateLocationFsxOntap` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kata sandi untuk lokasi penyimpanan ONTAP (menggunakan SMB) disimpan dalam teks biasa, di Secrets Manager. FSx Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Anda dapat menggunakan `CmkSecretConfig` (with`Password`) atau `CustomSecretConfig` (without`Password`) untuk memberikan kredensi untuk permintaan. `CreateLocationFsxOntap` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** Domain **   <a name="DataSync-Type-FsxProtocolSmb-Domain"></a>
Menentukan nama domain Windows yang dimiliki oleh mesin virtual penyimpanan (SVM) Anda.  
Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi pengaturan ini memastikan bahwa DataSync terhubung ke SVM yang tepat.  
Jika Anda memiliki beberapa domain Active Directory di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke SVM yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Wajib: Tidak

 ** ManagedSecretConfig **   <a name="DataSync-Type-FsxProtocolSmb-ManagedSecretConfig"></a>
Menjelaskan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` yang DataSync digunakan untuk mengakses lokasi penyimpanan tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager  
Jangan berikan ini untuk `CreateLocation` permintaan. `ManagedSecretConfig`adalah ReadOnly properti dan hanya dihuni `DescribeLocation` sebagai tanggapan.
Tipe: Objek [ManagedSecretConfig](API_ManagedSecretConfig.md)  
Wajib: Tidak

 ** MountOptions **   <a name="DataSync-Type-FsxProtocolSmb-MountOptions"></a>
Menentukan versi protokol Server Message Block (SMB) yang AWS DataSync digunakan untuk mengakses server file SMB.  
Tipe: Objek [SmbMountOptions](API_SmbMountOptions.md)  
Wajib: Tidak

 ** Password **   <a name="DataSync-Type-FsxProtocolSmb-Password"></a>
Menentukan kata sandi pengguna yang memiliki izin untuk mengakses SVM Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxProtocolSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxProtocolSmb) 

# FsxUpdateProtocol
<a name="API_FsxUpdateProtocol"></a>

Menentukan protokol transfer data yang AWS DataSync digunakan untuk mengakses sistem FSx file Amazon Anda.

**catatan**  
Anda tidak dapat memperbarui konfigurasi protokol Network File System (NFS) FSx untuk lokasi ONTAP. DataSync saat ini hanya mendukung NFS versi 3 dengan jenis lokasi ini.

## Daftar Isi
<a name="API_FsxUpdateProtocol_Contents"></a>

 ** NFS **   <a name="DataSync-Type-FsxUpdateProtocol-NFS"></a>
Menentukan konfigurasi protokol Network File System (NFS) yang DataSync digunakan untuk mengakses sistem file OpenZFS Anda atau FSx FSx untuk mesin virtual penyimpanan sistem file ONTAP (SVM).  
Tipe: Objek [FsxProtocolNfs](API_FsxProtocolNfs.md)  
Wajib: Tidak

 ** SMB **   <a name="DataSync-Type-FsxUpdateProtocol-SMB"></a>
Menentukan konfigurasi protokol Server Message Block (SMB) yang DataSync digunakan untuk mengakses mesin virtual penyimpanan sistem file ONTAP (SVM) Anda FSx .  
Tipe: Objek [FsxUpdateProtocolSmb](API_FsxUpdateProtocolSmb.md)  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocol) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocol) 

# FsxUpdateProtocolSmb
<a name="API_FsxUpdateProtocolSmb"></a>

Menentukan konfigurasi protokol Blok Pesan Server (SMB) yang AWS DataSync digunakan untuk mengakses Amazon FSx Anda untuk mesin virtual penyimpanan sistem file NetApp ONTAP (SVM). Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke FSx sistem file ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access).

## Daftar Isi
<a name="API_FsxUpdateProtocolSmb_Contents"></a>

 ** CmkSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti `Password` atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** CustomSecretConfig **   <a name="DataSync-Type-FsxUpdateProtocolSmb-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti `Password` atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu. Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** Domain **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Domain"></a>
Menentukan nama domain Windows yang dimiliki oleh mesin virtual penyimpanan (SVM) Anda.  
Jika Anda memiliki beberapa domain Active Directory di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke SVM yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^([A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252})?$`   
Wajib: Tidak

 ** MountOptions **   <a name="DataSync-Type-FsxUpdateProtocolSmb-MountOptions"></a>
Menentukan versi protokol Server Message Block (SMB) yang AWS DataSync digunakan untuk mengakses server file SMB.  
Tipe: Objek [SmbMountOptions](API_SmbMountOptions.md)  
Wajib: Tidak

 ** Password **   <a name="DataSync-Type-FsxUpdateProtocolSmb-Password"></a>
Menentukan kata sandi pengguna yang memiliki izin untuk mengakses SVM Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Wajib: Tidak

 ** User **   <a name="DataSync-Type-FsxUpdateProtocolSmb-User"></a>
Menentukan pengguna yang dapat me-mount dan mengakses file, folder, dan metadata di SVM Anda.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [Menggunakan protokol SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb).  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/FsxUpdateProtocolSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/FsxUpdateProtocolSmb) 

# HdfsNameNode
<a name="API_HdfsNameNode"></a>

Hadoop Distributed File System (HDFS) NameNode NameNode Mengelola namespace sistem file. NameNode Melakukan operasi seperti membuka, menutup, dan mengganti nama file dan direktori. NameNode Berisi informasi untuk memetakan blok data ke file DataNodes.

## Daftar Isi
<a name="API_HdfsNameNode_Contents"></a>

 ** Hostname **   <a name="DataSync-Type-HdfsNameNode-Hostname"></a>
Nama host dari cluster NameNode HDFS. Nilai ini adalah alamat IP atau nama Domain Name Service (DNS) dari. NameNode Agen yang diinstal di tempat menggunakan nama host ini untuk berkomunikasi dengan NameNode di jaringan.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$`   
Wajib: Ya

 ** Port **   <a name="DataSync-Type-HdfsNameNode-Port"></a>
Port yang NameNode digunakan untuk mendengarkan permintaan klien.  
Jenis: Integer  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 65536.  
Wajib: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/HdfsNameNode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/HdfsNameNode) 

# LocationFilter
<a name="API_LocationFilter"></a>

Persempit daftar sumber daya yang dikembalikan oleh`ListLocations`. Misalnya, untuk melihat semua lokasi Amazon S3 Anda, buat filter menggunakan`"Name": "LocationType"`,`"Operator": "Equals"`, dan. `"Values": "S3"`

Untuk informasi selengkapnya, lihat [memfilter sumber daya](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html).

## Daftar Isi
<a name="API_LocationFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-LocationFilter-Name"></a>
Nama filter yang digunakan. Setiap panggilan API mendukung daftar filter yang tersedia untuk itu (misalnya, `LocationType` untuk `ListLocations`).  
Tipe: String  
Nilai yang Valid: `LocationUri | LocationType | CreationTime`   
Wajib: Ya

 ** Operator **   <a name="DataSync-Type-LocationFilter-Operator"></a>
Operator yang digunakan untuk membandingkan nilai filter (misalnya, `Equals` atau `Contains`).  
Tipe: String  
Nilai yang Valid: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`   
Wajib: Ya

 ** Values **   <a name="DataSync-Type-LocationFilter-Values"></a>
Nilai yang ingin Anda filter. Misalnya, Anda mungkin ingin menampilkan lokasi Amazon S3.  
Tipe: Array string  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
Diperlukan: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationFilter) 

# LocationListEntry
<a name="API_LocationListEntry"></a>

Merupakan entri tunggal dalam daftar lokasi. `LocationListEntry`mengembalikan array yang berisi daftar lokasi ketika [ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)operasi dipanggil.

## Daftar Isi
<a name="API_LocationListEntry_Contents"></a>

 ** LocationArn **   <a name="DataSync-Type-LocationListEntry-LocationArn"></a>
Amazon Resource Name (ARN) dari lokasi. Untuk sistem file jaringan (NFS) atau Amazon EFS, lokasi adalah jalur ekspor. Untuk Amazon S3, lokasi adalah jalur prefiks yang ingin Anda pasang dan gunakan sebagai dasar dari lokasi tersebut.  
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}:location/loc-[0-9a-z]{17}$`   
Wajib: Tidak

 ** LocationUri **   <a name="DataSync-Type-LocationListEntry-LocationUri"></a>
Merupakan URIs daftar lokasi. `LocationUri`mengembalikan array yang berisi daftar lokasi ketika [ListLocations](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListLocations.html)operasi dipanggil.  
Format: `TYPE://GLOBAL_ID/SUBDIR`.  
TYPE menunjuk jenis lokasi (misalnya, `nfs` atau`s3`).  
GLOBAL\$1ID adalah pengenal global yang unik dari sumber daya yang mendukung lokasi. Contoh untuk EFS adalah `us-east-2.fs-abcd1234`. Contoh untuk Amazon S3 adalah nama bucket, seperti `myBucket`. Contoh untuk NFS adalah valid IPv4 atau IPv6 alamat atau nama host yang sesuai dengan DNS.  
SUBDIR adalah jalur sistem file yang valid, dibatasi oleh garis miring seperti konvensi \$1nix. Untuk NFS dan Amazon EFS, jalur ekspor yang memasang lokasi. Untuk Amazon S3, jalur prefiks yang telah Anda pasang dan anggap sebagai dasar dari lokasi.  
  
Tipe: String  
Kendala Panjang: Panjang maksimum 4360.  
Pola: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/LocationListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/LocationListEntry) 

# ManagedSecretConfig
<a name="API_ManagedSecretConfig"></a>

Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi atau kumpulan kredensi yang DataSync digunakan untuk mengakses lokasi transfer tertentu. DataSync menggunakan kunci KMS AWS-managed default untuk mengenkripsi rahasia ini. AWS Secrets Manager

## Daftar Isi
<a name="API_ManagedSecretConfig_Contents"></a>

 ** SecretArn **   <a name="DataSync-Type-ManagedSecretConfig-SecretArn"></a>
Menentukan ARN untuk AWS Secrets Manager rahasia.  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^(arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*|)$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManagedSecretConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManagedSecretConfig) 

# ManifestConfig
<a name="API_ManifestConfig"></a>

Mengkonfigurasi manifes, yang merupakan daftar file atau objek yang AWS DataSync ingin Anda transfer. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Daftar Isi
<a name="API_ManifestConfig_Contents"></a>

 ** Action **   <a name="DataSync-Type-ManifestConfig-Action"></a>
Menentukan apa yang DataSync menggunakan manifes untuk.  
Tipe: String  
Nilai yang Valid: `TRANSFER`   
Wajib: Tidak

 ** Format **   <a name="DataSync-Type-ManifestConfig-Format"></a>
Menentukan format file manifes Anda. Untuk informasi selengkapnya, lihat [Membuat manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-create).  
Tipe: String  
Nilai yang Valid: `CSV`   
Wajib: Tidak

 ** Source **   <a name="DataSync-Type-ManifestConfig-Source"></a>
Menentukan manifes yang DataSync ingin Anda gunakan dan di mana itu di-host.  
Anda harus menentukan parameter ini jika Anda mengonfigurasi manifes baru pada atau setelah 7 Februari 2024.  
Jika tidak, Anda akan mendapatkan kode status 400 dan `ValidationException` kesalahan yang menyatakan bahwa Anda kehilangan peran IAM untuk mengakses bucket S3 tempat Anda DataSync menghosting manifes Anda. Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke manifes Anda](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access).
Tipe: Objek [SourceManifestConfig](API_SourceManifestConfig.md)  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ManifestConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ManifestConfig) 

# NfsMountOptions
<a name="API_NfsMountOptions"></a>

Menentukan bagaimana DataSync dapat mengakses lokasi menggunakan protokol NFS.

## Daftar Isi
<a name="API_NfsMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-NfsMountOptions-Version"></a>
Menentukan versi NFS yang ingin DataSync Anda gunakan saat memasang share NFS Anda. Jika server menolak untuk menggunakan versi yang ditentukan, tugas gagal.  
Anda dapat menentukan opsi berikut:  
+  `AUTOMATIC`(default): DataSync memilih NFS versi 4.1.
+  `NFS3`: Versi protokol stateless yang memungkinkan penulisan asinkron di server.
+  `NFSv4_0`: Versi protokol stateful dan ramah firewall yang mendukung delegasi dan sistem file semu.
+  `NFSv4_1`: Versi protokol stateful yang mendukung sesi, delegasi direktori, dan pemrosesan data paralel. NFS versi 4.1 juga mencakup semua fitur yang tersedia di versi 4.0.
DataSync saat ini hanya mendukung NFS versi 3 dengan Amazon FSx untuk lokasi NetApp ONTAP.
Tipe: String  
Nilai yang Valid: `AUTOMATIC | NFS3 | NFS4_0 | NFS4_1`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/NfsMountOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/NfsMountOptions) 

# OnPremConfig
<a name="API_OnPremConfig"></a>

 AWS DataSync Agen yang dapat terhubung ke server file Network File System (NFS) Anda.

## Daftar Isi
<a name="API_OnPremConfig_Contents"></a>

 ** AgentArns **   <a name="DataSync-Type-OnPremConfig-AgentArns"></a>
Amazon Resource Names (ARNs) dari DataSync agen yang dapat terhubung ke server file NFS Anda.  
Anda dapat menentukan lebih dari satu agen. Untuk informasi selengkapnya, lihat [Menggunakan beberapa DataSync agen](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents).  
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
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}$`   
Diperlukan: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/OnPremConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/OnPremConfig) 

# Options
<a name="API_Options"></a>

Menunjukkan bagaimana tugas transfer Anda dikonfigurasi. Opsi ini mencakup cara DataSync menangani file, objek, dan metadata terkait selama transfer Anda. Anda juga dapat menentukan cara memverifikasi integritas data, menetapkan batas bandwidth untuk tugas Anda, di antara opsi lainnya.

Setiap opsi memiliki nilai default. Kecuali Anda perlu, Anda tidak perlu mengonfigurasi opsi apa pun sebelum menelepon [StartTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_StartTaskExecution.html).

Anda juga dapat mengganti opsi tugas untuk setiap eksekusi tugas. Misalnya, Anda mungkin ingin `LogLevel` menyesuaikan eksekusi individual.

## Daftar Isi
<a name="API_Options_Contents"></a>

 ** Atime **   <a name="DataSync-Type-Options-Atime"></a>
Menentukan apakah untuk mempertahankan metadata yang menunjukkan terakhir kali file dibaca atau ditulis ke.  
Perilaku `Atime` tidak sepenuhnya standar di seluruh platform, jadi hanya DataSync dapat melakukan ini dengan upaya terbaik.
+  `BEST_EFFORT`(default) - DataSync upaya untuk mempertahankan `Atime` atribut asli pada semua file sumber (yaitu, versi sebelum `PREPARING` langkah-langkah pelaksanaan tugas). Opsi ini direkomendasikan.
+  `NONE`- Mengabaikan. `Atime`
Jika `Atime` diatur ke`BEST_EFFORT`, `Mtime` harus diatur ke`PRESERVE`.   
Jika `Atime` diatur ke`NONE`, `Mtime` harus juga`NONE`. 
Tipe: String  
Nilai yang Valid: `NONE | BEST_EFFORT`   
Wajib: Tidak

 ** BytesPerSecond **   <a name="DataSync-Type-Options-BytesPerSecond"></a>
Membatasi bandwidth yang digunakan oleh DataSync tugas. Misalnya, jika Anda mau DataSync untuk menggunakan maksimal 1 MB, atur nilai ini ke `1048576` (`=1024*1024`).  
Tipe: Long  
Rentang yang Valid: Nilai minimum -1.  
Wajib: Tidak

 ** Gid **   <a name="DataSync-Type-Options-Gid"></a>
Menentukan POSIX grup ID (GID) dari pemilik file.  
+  `INT_VALUE`(default) - Mempertahankan nilai integer ID pengguna (UID) dan GID, yang direkomendasikan.
+  `NONE`- Mengabaikan UID dan GID.
Untuk informasi selengkapnya, lihat [Memahami cara DataSync menangani metadata file dan objek](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
Tipe: String  
Nilai yang Valid: `NONE | INT_VALUE | NAME | BOTH`   
Wajib: Tidak

 ** LogLevel **   <a name="DataSync-Type-Options-LogLevel"></a>
Menentukan jenis log yang DataSync diterbitkan ke grup CloudWatch log Amazon Logs. Untuk menentukan grup log, lihat [CloudWatchLogGroupArn](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html#DataSync-CreateTask-request-CloudWatchLogGroupArn).  
+  `BASIC`- Menerbitkan log dengan hanya informasi dasar (seperti kesalahan transfer).
+  `TRANSFER`- Menerbitkan log untuk semua file atau objek yang ditransfer DataSync tugas Anda dan melakukan pemeriksaan integritas data.
+  `OFF`- Tidak ada log yang diterbitkan.
Tipe: String  
Nilai yang Valid: `OFF | BASIC | TRANSFER`   
Wajib: Tidak

 ** Mtime **   <a name="DataSync-Type-Options-Mtime"></a>
Menentukan apakah akan mempertahankan metadata yang menunjukkan terakhir kali file ditulis sebelum `PREPARING` langkah pelaksanaan tugas Anda. Opsi ini diperlukan ketika Anda perlu menjalankan tugas lebih dari sekali.  
+  `PRESERVE`(default) - Mempertahankan asli`Mtime`, yang direkomendasikan.
+  `NONE`- Mengabaikan. `Mtime`
Jika `Mtime` diatur ke`PRESERVE`, `Atime` harus diatur ke`BEST_EFFORT`.  
Jika `Mtime` diatur ke`NONE`, juga `Atime` harus diatur ke`NONE`. 
Tipe: String  
Nilai yang Valid: `NONE | PRESERVE`   
Wajib: Tidak

 ** ObjectTags **   <a name="DataSync-Type-Options-ObjectTags"></a>
Menentukan apakah Anda DataSync ingin `PRESERVE` objek tag (perilaku default) ketika mentransfer antara sistem penyimpanan objek. Jika Anda ingin DataSync tugas Anda mengabaikan tag objek, tentukan `NONE` nilainya.  
Tipe: String  
Nilai yang Valid: `PRESERVE | NONE`   
Wajib: Tidak

 ** OverwriteMode **   <a name="DataSync-Type-Options-OverwriteMode"></a>
Menentukan apakah DataSync harus memodifikasi atau melestarikan data di lokasi tujuan.  
+  `ALWAYS`(default) - DataSync memodifikasi data di lokasi tujuan ketika data sumber (termasuk metadata) telah berubah.

  Jika DataSync menimpa objek, Anda mungkin dikenakan biaya tambahan untuk kelas penyimpanan Amazon S3 tertentu (misalnya, untuk pengambilan atau penghapusan awal). Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan transfer Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NEVER`- DataSync tidak menimpa data di lokasi tujuan meskipun data sumber telah berubah. Anda dapat menggunakan opsi ini untuk melindungi terhadap perubahan timpa yang dibuat pada file atau objek di tujuan.
Tipe: String  
Nilai yang Valid: `ALWAYS | NEVER`   
Wajib: Tidak

 ** PosixPermissions **   <a name="DataSync-Type-Options-PosixPermissions"></a>
Menentukan pengguna atau grup mana yang dapat mengakses file untuk tujuan tertentu seperti membaca, menulis, atau mengeksekusi file.  
Untuk informasi selengkapnya, lihat [Memahami cara DataSync menangani metadata file dan objek](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `PRESERVE`(default) - Mempertahankan izin gaya POSIX, yang direkomendasikan.
+  `NONE`- Mengabaikan izin gaya POSIX. 
DataSync dapat mempertahankan izin yang masih ada dari lokasi sumber.
Tipe: String  
Nilai yang Valid: `NONE | PRESERVE`   
Wajib: Tidak

 ** PreserveDeletedFiles **   <a name="DataSync-Type-Options-PreserveDeletedFiles"></a>
Menentukan apakah file di lokasi tujuan yang tidak ada di sumber harus dipertahankan. Opsi ini dapat memengaruhi biaya penyimpanan Amazon S3 Anda. Jika tugas Anda menghapus objek, Anda mungkin dikenakan biaya durasi penyimpanan minimum untuk kelas penyimpanan tertentu. Untuk informasi selengkapnya, lihat [Pertimbangan saat bekerja dengan kelas penyimpanan Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) di. DataSync  
+  `PRESERVE`(default) - Mengabaikan file tujuan tersebut, yang direkomendasikan. 
+  `REMOVE`- Menghapus file tujuan yang tidak ada di sumber.
Jika Anda menyetel parameter ini`REMOVE`, Anda tidak dapat mengatur `TransferMode` ke`ALL`. Ketika Anda mentransfer semua data, DataSync tidak memindai lokasi tujuan Anda dan tidak tahu apa yang harus dihapus.
Tipe: String  
Nilai yang Valid: `PRESERVE | REMOVE`   
Wajib: Tidak

 ** PreserveDevices **   <a name="DataSync-Type-Options-PreserveDevices"></a>
Menentukan apakah DataSync harus mempertahankan metadata perangkat blok dan karakter di lokasi sumber dan membuat ulang file dengan nama perangkat dan metadata di tujuan. DataSync hanya menyalin nama dan metadata perangkat tersebut.  
DataSync tidak dapat menyalin konten sebenarnya dari perangkat ini karena mereka nonterminal dan tidak mengembalikan penanda end-of-file (EOF).
+  `NONE`(default) - Mengabaikan perangkat khusus (disarankan).
+  `PRESERVE`- Mempertahankan karakter dan memblokir metadata perangkat. Opsi ini saat ini tidak didukung untuk Amazon EFS.
Tipe: String  
Nilai yang Valid: `NONE | PRESERVE`   
Wajib: Tidak

 ** SecurityDescriptorCopyFlags **   <a name="DataSync-Type-Options-SecurityDescriptorCopyFlags"></a>
Menentukan komponen deskriptor keamanan SMB yang disalin dari sumber ke objek tujuan.   
Nilai ini hanya digunakan untuk transfer antara SMB dan Amazon FSx untuk lokasi Windows File Server atau antara dua FSx untuk lokasi Windows File Server. Untuk informasi selengkapnya, lihat [Memahami cara DataSync menangani metadata file dan objek](https://docs.aws.amazon.com/datasync/latest/userguide/metadata-copied.html).  
+  `OWNER_DACL`(default) - Untuk setiap objek yang disalin, salin DataSync metadata berikut:
  + Pemilik objek.
  + Daftar kontrol akses diskresioner NTFS (DACLs), yang menentukan apakah akan memberikan akses ke objek.

    DataSync tidak akan menyalin daftar kontrol akses sistem NTFS (SACLs) dengan opsi ini.
+  `OWNER_DACL_SACL`- Untuk setiap objek yang disalin, salin DataSync metadata berikut:
  + Pemilik objek.
  + Daftar kontrol akses diskresioner NTFS (DACLs), yang menentukan apakah akan memberikan akses ke objek.
  + SACLs, yang digunakan oleh administrator untuk mencatat upaya untuk mengakses objek aman.

    Menyalin SACLs memerlukan pemberian izin tambahan kepada pengguna Windows yang DataSync menggunakan untuk mengakses lokasi SMB Anda. Untuk informasi tentang memilih pengguna dengan izin yang tepat, lihat izin yang diperlukan untuk [SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions), [FSx untuk Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions), atau [FSx untuk ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-smb) (tergantung pada jenis lokasi dalam transfer Anda).
+  `NONE`- Tidak ada komponen deskriptor keamanan SMB yang disalin. Objek tujuan dimiliki oleh pengguna yang disediakan untuk mengakses lokasi tujuan. DACLs dan SACLs diatur berdasarkan konfigurasi server tujuan. 
Tipe: String  
Nilai yang Valid: `NONE | OWNER_DACL | OWNER_DACL_SACL`   
Wajib: Tidak

 ** TaskQueueing **   <a name="DataSync-Type-Options-TaskQueueing"></a>
Menentukan apakah tugas transfer Anda harus dimasukkan ke dalam antrian selama skenario tertentu saat [menjalankan beberapa](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#running-multiple-tasks) tugas. Ini secara `ENABLED` default.  
Tipe: String  
Nilai yang Valid: `ENABLED | DISABLED`   
Wajib: Tidak

 ** TransferMode **   <a name="DataSync-Type-Options-TransferMode"></a>
Menentukan apakah DataSync transfer hanya data (termasuk metadata) yang berbeda antara lokasi setelah salinan awal atau mentransfer semua data setiap kali Anda menjalankan tugas. Jika Anda berencana melakukan transfer berulang, Anda mungkin hanya ingin mentransfer apa yang telah diubah sejak eksekusi tugas sebelumnya.  
+  `CHANGED`(default) - Setelah transfer penuh awal Anda, DataSync salin hanya data dan metadata yang berbeda antara lokasi sumber dan tujuan.
+  `ALL`- DataSync menyalin semua yang ada di sumber ke tujuan tanpa membandingkan perbedaan antar lokasi.
Tipe: String  
Nilai yang Valid: `CHANGED | ALL`   
Wajib: Tidak

 ** Uid **   <a name="DataSync-Type-Options-Uid"></a>
Menentukan POSIX user ID (UID) dari pemilik file.  
+  `INT_VALUE`(default) - Mempertahankan nilai integer UID dan ID grup (GID), yang direkomendasikan.
+  `NONE`- Mengabaikan UID dan GID. 
Untuk informasi selengkapnya, lihat [Metadata yang disalin](https://docs.aws.amazon.com/datasync/latest/userguide/special-files.html#metadata-copied) oleh. DataSync  
Tipe: String  
Nilai yang Valid: `NONE | INT_VALUE | NAME | BOTH`   
Wajib: Tidak

 ** VerifyMode **   <a name="DataSync-Type-Options-VerifyMode"></a>
Menentukan apakah dan bagaimana DataSync memeriksa integritas data Anda di akhir transfer Anda.  
+  `ONLY_FILES_TRANSFERRED`(disarankan) - DataSync menghitung checksum data yang ditransfer (termasuk metadata) di lokasi sumber. Pada akhir transfer, DataSync kemudian membandingkan checksum ini dengan checksum yang dihitung pada data di tujuan.
**catatan**  
Ini adalah opsi default untuk [tugas mode yang Ditingkatkan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

  Kami merekomendasikan opsi ini saat mentransfer ke kelas penyimpanan S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive. Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan lokasi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `POINT_IN_TIME_CONSISTENT`- Di akhir transfer, DataSync periksa seluruh sumber dan tujuan untuk memverifikasi bahwa kedua lokasi disinkronkan sepenuhnya.
**catatan**  
Ini adalah opsi default untuk [tugas mode Dasar](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html) dan saat ini tidak didukung dengan tugas mode yang Ditingkatkan.

  Jika Anda menggunakan [manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), DataSync hanya memindai dan memverifikasi apa yang tercantum dalam manifes.

  Anda tidak dapat menggunakan opsi ini saat mentransfer ke kelas penyimpanan S3 Glacier Flexible Retrieval atau S3 Glacier Deep Archive. Untuk informasi selengkapnya, lihat [Pertimbangan kelas penyimpanan dengan lokasi Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).
+  `NONE`- DataSync melakukan pemeriksaan integritas data hanya selama transfer Anda. Tidak seperti opsi lain, tidak ada verifikasi tambahan di akhir transfer Anda.
Tipe: String  
Nilai yang Valid: `POINT_IN_TIME_CONSISTENT | ONLY_FILES_TRANSFERRED | NONE`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Options) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Options) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Options) 

# Platform
<a name="API_Platform"></a>

Detail terkait platform tentang AWS DataSync agen, seperti nomor versi.

## Daftar Isi
<a name="API_Platform_Contents"></a>

 ** Version **   <a name="DataSync-Type-Platform-Version"></a>
Versi DataSync agen.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/Platform) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/Platform) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/Platform) 

# PrivateLinkConfig
<a name="API_PrivateLinkConfig"></a>

Menentukan cara AWS DataSync agen Anda terhubung AWS menggunakan titik akhir layanan [virtual private cloud (VPC)](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#choose-service-endpoint-vpc). Agen yang menggunakan titik akhir VPC tidak dapat diakses melalui internet publik.

## Daftar Isi
<a name="API_PrivateLinkConfig_Contents"></a>

 ** PrivateLinkEndpoint **   <a name="DataSync-Type-PrivateLinkConfig-PrivateLinkEndpoint"></a>
Menentukan titik akhir VPC yang disediakan [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-share-your-services.html)oleh agen Anda terhubung.  
Tipe: String  
Batasan Panjang: Panjang minimum 7. Panjang maksimum 15.  
Pola: `\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z`   
Wajib: Tidak

 ** SecurityGroupArns **   <a name="DataSync-Type-PrivateLinkConfig-SecurityGroupArns"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari grup keamanan yang DataSync menyediakan akses ke titik akhir VPC Anda. 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 **   <a name="DataSync-Type-PrivateLinkConfig-SubnetArns"></a>
Menentukan ARN dari subnet tempat titik akhir 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

 ** VpcEndpointId **   <a name="DataSync-Type-PrivateLinkConfig-VpcEndpointId"></a>
Menentukan ID titik akhir VPC yang terhubung dengan agen Anda.  
Tipe: String  
Pola: `^vpce-[0-9a-f]{17}$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/PrivateLinkConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/PrivateLinkConfig) 

# QopConfiguration
<a name="API_QopConfiguration"></a>

Konfigurasi Quality of Protection (QOP) menentukan pengaturan privasi Remote Procedure Call (RPC) dan transfer data yang dikonfigurasi pada cluster Hadoop Distributed File System (HDFS).

## Daftar Isi
<a name="API_QopConfiguration_Contents"></a>

 ** DataTransferProtection **   <a name="DataSync-Type-QopConfiguration-DataTransferProtection"></a>
Pengaturan perlindungan transfer data dikonfigurasi pada cluster HDFS. Pengaturan ini sesuai dengan `dfs.data.transfer.protection` pengaturan Anda dalam `hdfs-site.xml` file di cluster Hadoop Anda.  
Tipe: String  
Nilai yang Valid: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`   
Wajib: Tidak

 ** RpcProtection **   <a name="DataSync-Type-QopConfiguration-RpcProtection"></a>
Pengaturan perlindungan RPC dikonfigurasi pada cluster HDFS. Pengaturan ini sesuai dengan `hadoop.rpc.protection` pengaturan Anda dalam `core-site.xml` file Anda di cluster Hadoop Anda.  
Tipe: String  
Nilai yang Valid: `DISABLED | AUTHENTICATION | INTEGRITY | PRIVACY`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/QopConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/QopConfiguration) 

# ReportDestination
<a name="API_ReportDestination"></a>

Menentukan tempat DataSync mengunggah laporan [tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) Anda.

## Daftar Isi
<a name="API_ReportDestination_Contents"></a>

 ** S3 **   <a name="DataSync-Type-ReportDestination-S3"></a>
Menentukan bucket Amazon S3 DataSync tempat mengunggah laporan tugas Anda.  
Tipe: Objek [ReportDestinationS3](API_ReportDestinationS3.md)  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestination) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestination) 

# ReportDestinationS3
<a name="API_ReportDestinationS3"></a>

[Menentukan bucket Amazon S3 DataSync tempat mengunggah laporan tugas Anda.](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html)

## Daftar Isi
<a name="API_ReportDestinationS3_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-ReportDestinationS3-BucketAccessRoleArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari kebijakan IAM yang DataSync memungkinkan untuk mengunggah laporan tugas ke bucket S3 Anda. Untuk informasi selengkapnya, lihat [ DataSync Mengizinkan mengunggah laporan tugas ke bucket Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Wajib: Ya

 ** S3BucketArn **   <a name="DataSync-Type-ReportDestinationS3-S3BucketArn"></a>
Menentukan ARN bucket S3 DataSync tempat mengunggah laporan Anda.  
Tipe: String  
Kendala Panjang: Panjang maksimum 268.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
Wajib: Ya

 ** Subdirectory **   <a name="DataSync-Type-ReportDestinationS3-Subdirectory"></a>
Menentukan awalan bucket untuk laporan Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportDestinationS3) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportDestinationS3) 

# ReportOverride
<a name="API_ReportOverride"></a>

Menentukan tingkat detail untuk aspek tertentu dari [laporan DataSync tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) Anda.

## Daftar Isi
<a name="API_ReportOverride_Contents"></a>

 ** ReportLevel **   <a name="DataSync-Type-ReportOverride-ReportLevel"></a>
Menentukan apakah laporan tugas Anda hanya mencakup kesalahan atau keberhasilan dan kesalahan.  
Misalnya, laporan Anda mungkin hanya menyertakan apa yang tidak berjalan dengan baik dalam transfer (`ERRORS_ONLY`) Anda. Pada saat yang sama, Anda ingin memverifikasi bahwa [filter tugas](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) Anda berfungsi dengan benar. Dalam situasi ini, Anda bisa mendapatkan daftar file apa yang DataSync berhasil dilewati dan jika sesuatu ditransfer yang tidak Anda transfer (`SUCCESSES_AND_ERRORS`).  
Tipe: String  
Nilai yang Valid: `ERRORS_ONLY | SUCCESSES_AND_ERRORS`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverride) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverride) 

# ReportOverrides
<a name="API_ReportOverrides"></a>

Tingkat detail yang disertakan dalam setiap aspek [laporan DataSync tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) Anda.

## Daftar Isi
<a name="API_ReportOverrides_Contents"></a>

 ** Deleted **   <a name="DataSync-Type-ReportOverrides-Deleted"></a>
Menentukan tingkat pelaporan untuk file, objek, dan direktori yang DataSync mencoba untuk menghapus di lokasi tujuan Anda. Ini hanya berlaku jika [Anda mengonfigurasi tugas Anda](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html) untuk menghapus data di tujuan yang tidak ada di sumber.  
Tipe: Objek [ReportOverride](API_ReportOverride.md)  
Wajib: Tidak

 ** Skipped **   <a name="DataSync-Type-ReportOverrides-Skipped"></a>
Menentukan tingkat pelaporan untuk file, objek, dan direktori yang DataSync mencoba untuk melewati selama transfer Anda.  
Tipe: Objek [ReportOverride](API_ReportOverride.md)  
Wajib: Tidak

 ** Transferred **   <a name="DataSync-Type-ReportOverrides-Transferred"></a>
Menentukan tingkat pelaporan untuk file, objek, dan direktori yang DataSync mencoba untuk mentransfer.  
Tipe: Objek [ReportOverride](API_ReportOverride.md)  
Wajib: Tidak

 ** Verified **   <a name="DataSync-Type-ReportOverrides-Verified"></a>
Menentukan tingkat pelaporan untuk file, objek, dan direktori yang DataSync mencoba memverifikasi pada akhir transfer Anda.  
Tipe: Objek [ReportOverride](API_ReportOverride.md)  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportOverrides) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportOverrides) 

# ReportResult
<a name="API_ReportResult"></a>

Menunjukkan apakah DataSync membuat [laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html) lengkap untuk transfer Anda.

## Daftar Isi
<a name="API_ReportResult_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-ReportResult-ErrorCode"></a>
Menunjukkan kode yang terkait dengan kesalahan jika tidak DataSync dapat membuat laporan lengkap.  
Tipe: String  
Wajib: Tidak

 ** ErrorDetail **   <a name="DataSync-Type-ReportResult-ErrorDetail"></a>
Memberikan rincian tentang masalah membuat laporan.  
Tipe: String  
Wajib: Tidak

 ** Status **   <a name="DataSync-Type-ReportResult-Status"></a>
Menunjukkan DataSync apakah laporan masih berfungsi, membuat laporan, atau tidak dapat membuat laporan lengkap.  
Tipe: String  
Nilai yang Valid: `PENDING | SUCCESS | ERROR`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/ReportResult) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/ReportResult) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/ReportResult) 

# S3Config
<a name="API_S3Config"></a>

Menentukan Nama Sumber Daya Amazon (ARN) peran (IAM) DataSync yang digunakan untuk mengakses bucket S3 Anda. AWS Identity and Access Management 

Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke bucket S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).

## Daftar Isi
<a name="API_S3Config_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3Config-BucketAccessRoleArn"></a>
Menentukan ARN peran IAM DataSync yang digunakan untuk mengakses bucket S3 Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Diperlukan: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3Config) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3Config) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3Config) 

# S3ManifestConfig
<a name="API_S3ManifestConfig"></a>

Menentukan bucket S3 tempat Anda menghosting manifes yang AWS DataSync ingin Anda gunakan. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Daftar Isi
<a name="API_S3ManifestConfig_Contents"></a>

 ** BucketAccessRoleArn **   <a name="DataSync-Type-S3ManifestConfig-BucketAccessRoleArn"></a>
Menentukan peran AWS Identity and Access Management (IAM) yang memungkinkan DataSync untuk mengakses manifes Anda. Untuk informasi selengkapnya, lihat [Menyediakan DataSync akses ke manifes Anda](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html#transferring-with-manifest-access).  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Wajib: Ya

 ** ManifestObjectPath **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectPath"></a>
Menentukan kunci objek Amazon S3 dari manifes Anda. Ini dapat mencakup awalan (misalnya,`prefix/my-manifest.csv`).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Wajib: Ya

 ** S3BucketArn **   <a name="DataSync-Type-S3ManifestConfig-S3BucketArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) bucket S3 tempat Anda menghosting manifes Anda.  
Tipe: String  
Kendala Panjang: Panjang maksimum 268.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$`   
Wajib: Ya

 ** ManifestObjectVersionId **   <a name="DataSync-Type-S3ManifestConfig-ManifestObjectVersionId"></a>
Menentukan ID versi objek dari manifes yang DataSync ingin Anda gunakan. Jika Anda tidak menyetel ini, DataSync gunakan versi terbaru dari objek.  
Tipe: String  
Panjang Batasan: Panjang minimum 1. Panjang maksimum 100.  
Pola: `^.+$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/S3ManifestConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/S3ManifestConfig) 

# SmbMountOptions
<a name="API_SmbMountOptions"></a>

Menentukan versi protokol Server Message Block (SMB) yang AWS DataSync digunakan untuk mengakses server file SMB.

## Daftar Isi
<a name="API_SmbMountOptions_Contents"></a>

 ** Version **   <a name="DataSync-Type-SmbMountOptions-Version"></a>
Secara default, DataSync secara otomatis memilih versi protokol SMB berdasarkan negosiasi dengan server file SMB Anda. Anda juga dapat mengonfigurasi DataSync untuk menggunakan versi SMB tertentu, tetapi kami sarankan melakukan ini hanya jika DataSync mengalami kesulitan bernegosiasi dengan server file SMB secara otomatis.  
Ini adalah opsi berikut untuk mengonfigurasi versi SMB:  
+  `AUTOMATIC`(default): DataSync dan server file SMB menegosiasikan versi SMB tertinggi yang saling mereka dukung antara 2.1 dan 3.1.1.

  Ini adalah opsi yang disarankan. Jika Anda memilih versi tertentu yang tidak didukung oleh server file Anda, Anda mungkin mendapatkan `Operation Not Supported` kesalahan.
+  `SMB3`: Membatasi negosiasi protokol hanya untuk SMB versi 3.0.2.
+  `SMB2`: Membatasi negosiasi protokol hanya untuk SMB versi 2.1.
+  `SMB2_0`: Membatasi negosiasi protokol hanya untuk SMB versi 2.0.
+  `SMB1`: Membatasi negosiasi protokol hanya untuk SMB versi 1.0.
**catatan**  
`SMB1`Opsi ini tidak tersedia saat [membuat Amazon FSx untuk lokasi NetApp ONTAP](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateLocationFsxOntap.html).
Tipe: String  
Nilai yang Valid: `AUTOMATIC | SMB2 | SMB3 | SMB1 | SMB2_0`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SmbMountOptions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SmbMountOptions) 

# SourceManifestConfig
<a name="API_SourceManifestConfig"></a>

Menentukan manifes yang AWS DataSync ingin Anda gunakan dan di mana itu di-host. Untuk informasi selengkapnya dan contoh konfigurasi, lihat [Menentukan DataSync transfer apa yang menggunakan manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).

## Daftar Isi
<a name="API_SourceManifestConfig_Contents"></a>

 ** S3 **   <a name="DataSync-Type-SourceManifestConfig-S3"></a>
Menentukan bucket S3 tempat Anda menghosting manifes Anda.  
Tipe: Objek [S3ManifestConfig](API_S3ManifestConfig.md)  
Wajib: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/SourceManifestConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/SourceManifestConfig) 

# TagListEntry
<a name="API_TagListEntry"></a>

Pasangan kunci-nilai yang mewakili satu tag yang telah diterapkan ke sumber daya. AWS 

## Daftar Isi
<a name="API_TagListEntry_Contents"></a>

 ** Key **   <a name="DataSync-Type-TagListEntry-Key"></a>
Kunci untuk tag AWS sumber daya.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:/-]+$`   
Wajib: Ya

 ** Value **   <a name="DataSync-Type-TagListEntry-Value"></a>
Nilai untuk tag AWS sumber daya.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Diperlukan: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TagListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TagListEntry) 

# TaskExecutionFilesFailedDetail
<a name="API_TaskExecutionFilesFailedDetail"></a>

Jumlah file atau objek yang DataSync gagal untuk mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda.

**catatan**  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Daftar Isi
<a name="API_TaskExecutionFilesFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Delete"></a>
Jumlah file atau objek yang DataSync gagal dihapus selama eksekusi tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Prepare"></a>
Jumlah file atau objek yang DataSync gagal disiapkan selama eksekusi tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Transfer"></a>
Jumlah file atau objek yang DataSync gagal ditransfer selama eksekusi tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** Verify **   <a name="DataSync-Type-TaskExecutionFilesFailedDetail-Verify"></a>
Jumlah file atau objek yang DataSync gagal diverifikasi selama eksekusi tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesFailedDetail) 

# TaskExecutionFilesListedDetail
<a name="API_TaskExecutionFilesListedDetail"></a>

Jumlah file atau objek yang DataSync ditemukan di lokasi Anda.

**catatan**  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Daftar Isi
<a name="API_TaskExecutionFilesListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtDestinationForDelete"></a>
Jumlah file atau objek yang DataSync ditemukan di lokasi tujuan Anda. Penghitung ini hanya berlaku jika Anda [mengonfigurasi tugas Anda](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling) untuk menghapus data di tujuan yang tidak ada di sumbernya.  
Tipe: Panjang  
Wajib: Tidak

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFilesListedDetail-AtSource"></a>
Jumlah file atau objek yang DataSync ditemukan di lokasi sumber Anda.  
+ Dengan [manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), hanya DataSync mencantumkan apa yang ada di manifes Anda (dan bukan semua yang ada di lokasi sumber Anda).
+ Dengan [filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) include, hanya DataSync mencantumkan yang cocok dengan filter di lokasi sumber Anda.
+ Dengan filter pengecualian, DataSync daftar semuanya di lokasi sumber Anda sebelum menerapkan filter.
Tipe: Panjang  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFilesListedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFilesListedDetail) 

# TaskExecutionFoldersFailedDetail
<a name="API_TaskExecutionFoldersFailedDetail"></a>

Jumlah direktori yang DataSync gagal untuk daftar, mempersiapkan, mentransfer, memverifikasi, dan menghapus selama pelaksanaan tugas Anda.

**catatan**  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Daftar Isi
<a name="API_TaskExecutionFoldersFailedDetail_Contents"></a>

 ** Delete **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Delete"></a>
Jumlah direktori yang DataSync gagal dihapus selama eksekusi tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** List **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-List"></a>
Jumlah direktori yang DataSync gagal dicantumkan selama pelaksanaan tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** Prepare **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Prepare"></a>
Jumlah direktori yang DataSync gagal disiapkan selama pelaksanaan tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** Transfer **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Transfer"></a>
Jumlah direktori yang DataSync gagal ditransfer selama eksekusi tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

 ** Verify **   <a name="DataSync-Type-TaskExecutionFoldersFailedDetail-Verify"></a>
Jumlah direktori yang DataSync gagal diverifikasi selama pelaksanaan tugas Anda.  
Tipe: Panjang  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersFailedDetail) 

# TaskExecutionFoldersListedDetail
<a name="API_TaskExecutionFoldersListedDetail"></a>

Jumlah direktori yang DataSync ditemukan di lokasi Anda.

**catatan**  
Hanya berlaku untuk [tugas mode yang disempurnakan](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).

## Daftar Isi
<a name="API_TaskExecutionFoldersListedDetail_Contents"></a>

 ** AtDestinationForDelete **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtDestinationForDelete"></a>
Jumlah direktori yang DataSync ditemukan di lokasi tujuan Anda. Penghitung ini hanya berlaku jika Anda [mengonfigurasi tugas Anda](https://docs.aws.amazon.com/datasync/latest/userguide/configure-metadata.html#task-option-file-object-handling) untuk menghapus data di tujuan yang tidak ada di sumbernya.  
Tipe: Panjang  
Wajib: Tidak

 ** AtSource **   <a name="DataSync-Type-TaskExecutionFoldersListedDetail-AtSource"></a>
Jumlah direktori yang DataSync ditemukan di lokasi sumber Anda.  
+ Dengan [manifes](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html), hanya DataSync mencantumkan apa yang ada di manifes Anda (dan bukan semua yang ada di lokasi sumber Anda).
+ Dengan [filter](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html) include, hanya DataSync mencantumkan yang cocok dengan filter di lokasi sumber Anda.
+ Dengan filter pengecualian, DataSync daftar semuanya di lokasi sumber Anda sebelum menerapkan filter.
Tipe: Panjang  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionFoldersListedDetail) 

# TaskExecutionListEntry
<a name="API_TaskExecutionListEntry"></a>

Merupakan entri tunggal dalam daftar eksekusi AWS DataSync tugas yang dikembalikan dengan [ListTaskExecutions](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTaskExecutions.html)operasi.

## Daftar Isi
<a name="API_TaskExecutionListEntry_Contents"></a>

 ** Status **   <a name="DataSync-Type-TaskExecutionListEntry-Status"></a>
Status eksekusi tugas. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipe: String  
Nilai yang Valid: `QUEUED | CANCELLING | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR`   
Wajib: Tidak

 ** TaskExecutionArn **   <a name="DataSync-Type-TaskExecutionListEntry-TaskExecutionArn"></a>
Nama Sumber Daya Amazon (ARN) dari eksekusi tugas.  
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}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$`   
Wajib: Tidak

 ** TaskMode **   <a name="DataSync-Type-TaskExecutionListEntry-TaskMode"></a>
Mode tugas yang Anda gunakan. Untuk informasi selengkapnya, lihat [Memilih mode tugas untuk transfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipe: String  
Nilai yang Valid: `BASIC | ENHANCED`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionListEntry) 

# TaskExecutionResultDetail
<a name="API_TaskExecutionResultDetail"></a>

Memberikan informasi terperinci tentang hasil pelaksanaan AWS DataSync tugas Anda.

## Daftar Isi
<a name="API_TaskExecutionResultDetail_Contents"></a>

 ** ErrorCode **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorCode"></a>
Kesalahan yang DataSync terjadi selama eksekusi tugas Anda. Anda dapat menggunakan informasi ini untuk membantu [memecahkan masalah](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipe: String  
Wajib: Tidak

 ** ErrorDetail **   <a name="DataSync-Type-TaskExecutionResultDetail-ErrorDetail"></a>
Penjelasan rinci tentang kesalahan yang DataSync ditemui selama pelaksanaan tugas Anda. Anda dapat menggunakan informasi ini untuk membantu [memecahkan masalah](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).   
Tipe: String  
Wajib: Tidak

 ** PrepareDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareDuration"></a>
Waktu dalam milidetik eksekusi tugas Anda ada di `PREPARING` langkah. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Untuk tugas mode yang Ditingkatkan, nilainya selalu`0`. Untuk informasi selengkapnya, lihat [Cara DataSync menyiapkan transfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-prepares).  
Tipe: Long  
Rentang yang Valid: Nilai minimum 0.  
Wajib: Tidak

 ** PrepareStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-PrepareStatus"></a>
Status `PREPARING` langkah untuk pelaksanaan tugas Anda. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipe: String  
Nilai yang Valid: `PENDING | SUCCESS | ERROR`   
Wajib: Tidak

 ** TotalDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TotalDuration"></a>
Waktu dalam milidetik eksekusi tugas Anda berjalan.  
Tipe: Long  
Rentang yang Valid: Nilai minimum 0.  
Wajib: Tidak

 ** TransferDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferDuration"></a>
Waktu dalam milidetik eksekusi tugas Anda ada di `TRANSFERRING` langkah. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Untuk tugas mode yang Ditingkatkan, nilainya selalu`0`. Untuk informasi selengkapnya, lihat [Cara DataSync mentransfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-datasync-transfers).  
Tipe: Long  
Rentang yang Valid: Nilai minimum 0.  
Wajib: Tidak

 ** TransferStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-TransferStatus"></a>
Status `TRANSFERRING` langkah untuk pelaksanaan tugas Anda. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipe: String  
Nilai yang Valid: `PENDING | SUCCESS | ERROR`   
Wajib: Tidak

 ** VerifyDuration **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyDuration"></a>
Waktu dalam milidetik eksekusi tugas Anda ada di `VERIFYING` langkah. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Untuk tugas mode yang Ditingkatkan, nilainya selalu`0`. Untuk informasi selengkapnya, lihat [Cara DataSync memverifikasi integritas data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/how-datasync-transfer-works.html#how-verifying-works).  
Tipe: Long  
Rentang yang Valid: Nilai minimum 0.  
Wajib: Tidak

 ** VerifyStatus **   <a name="DataSync-Type-TaskExecutionResultDetail-VerifyStatus"></a>
Status `VERIFYING` langkah untuk pelaksanaan tugas Anda. Untuk informasi selengkapnya, lihat [Status eksekusi tugas](https://docs.aws.amazon.com/datasync/latest/userguide/run-task.html#understand-task-execution-statuses).  
Tipe: String  
Nilai yang Valid: `PENDING | SUCCESS | ERROR`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskExecutionResultDetail) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskExecutionResultDetail) 

# TaskFilter
<a name="API_TaskFilter"></a>

Anda dapat menggunakan filter API untuk mempersempit daftar sumber daya yang dikembalikan oleh `ListTasks`. Misalnya, untuk mengambil semua tugas di lokasi sumber, Anda dapat menggunakan `ListTasks` dengan nama filter `LocationId` dan `Operator Equals` dengan ARN untuk lokasi.

Untuk informasi selengkapnya, lihat [memfilter DataSync sumber daya](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html).

## Daftar Isi
<a name="API_TaskFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskFilter-Name"></a>
Nama filter yang digunakan. Setiap panggilan API mendukung daftar filter yang tersedia untuk hal tersebut. Misalnya, `LocationId` untuk `ListTasks`.  
Tipe: String  
Nilai yang Valid: `LocationId | CreationTime`   
Wajib: Ya

 ** Operator **   <a name="DataSync-Type-TaskFilter-Operator"></a>
Operator yang digunakan untuk membandingkan nilai filter (misalnya, `Equals` atau `Contains`).  
Tipe: String  
Nilai yang Valid: `Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`   
Wajib: Ya

 ** Values **   <a name="DataSync-Type-TaskFilter-Values"></a>
Nilai yang ingin Anda filter. Misalnya, Anda mungkin hanya ingin menampilkan tugas untuk lokasi tujuan tertentu.  
Tipe: Array string  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 255.  
Pola: `^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`   
Diperlukan: Ya

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter) 

# TaskListEntry
<a name="API_TaskListEntry"></a>

Merupakan entri tunggal dalam daftar tugas. `TaskListEntry`mengembalikan array yang berisi daftar tugas ketika [ListTasks](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListTasks.html)operasi dipanggil. Tugas mencakup sumber dan tujuan sistem file untuk penyinkronan dan opsi yang digunakan untuk tugas.

## Daftar Isi
<a name="API_TaskListEntry_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskListEntry-Name"></a>
Nama tugas.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Wajib: Tidak

 ** Status **   <a name="DataSync-Type-TaskListEntry-Status"></a>
Status tugas.  
Tipe: String  
Nilai yang Valid: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE`   
Wajib: Tidak

 ** TaskArn **   <a name="DataSync-Type-TaskListEntry-TaskArn"></a>
Amazon Resource Name (ARN) tugas.  
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}:task/task-[0-9a-f]{17}$`   
Wajib: Tidak

 ** TaskMode **   <a name="DataSync-Type-TaskListEntry-TaskMode"></a>
Mode tugas yang Anda gunakan. Untuk informasi selengkapnya, lihat [Memilih mode tugas untuk transfer data Anda](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipe: String  
Nilai yang Valid: `BASIC | ENHANCED`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskListEntry) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskListEntry) 

# TaskReportConfig
<a name="API_TaskReportConfig"></a>

Menentukan bagaimana Anda ingin mengkonfigurasi laporan tugas, yang memberikan informasi rinci tentang AWS DataSync transfer Anda.

Untuk informasi selengkapnya, lihat [Laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).

## Daftar Isi
<a name="API_TaskReportConfig_Contents"></a>

 ** Destination **   <a name="DataSync-Type-TaskReportConfig-Destination"></a>
Menentukan bucket Amazon S3 DataSync tempat mengunggah laporan tugas Anda. Untuk informasi selengkapnya, lihat [Laporan tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html#task-report-access).  
Tipe: Objek [ReportDestination](API_ReportDestination.md)  
Wajib: Tidak

 ** ObjectVersionIds **   <a name="DataSync-Type-TaskReportConfig-ObjectVersionIds"></a>
Menentukan apakah laporan tugas Anda menyertakan versi baru dari setiap objek yang ditransfer ke bucket S3. Ini hanya berlaku jika Anda [mengaktifkan pembuatan versi di bucket Anda](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html). Perlu diingat bahwa pengaturan ini `INCLUDE` dapat meningkatkan durasi pelaksanaan tugas Anda.  
Tipe: String  
Nilai yang Valid: `INCLUDE | NONE`   
Wajib: Tidak

 ** OutputType **   <a name="DataSync-Type-TaskReportConfig-OutputType"></a>
Menentukan jenis laporan tugas yang Anda inginkan:  
+  `SUMMARY_ONLY`: Memberikan rincian yang diperlukan tentang tugas Anda, termasuk jumlah file, objek, dan direktori yang ditransfer dan durasi transfer.
+  `STANDARD`: Memberikan detail lengkap tentang tugas Anda, termasuk daftar lengkap file, objek, dan direktori yang ditransfer, dilewati, diverifikasi, dan banyak lagi.
Tipe: String  
Nilai yang Valid: `SUMMARY_ONLY | STANDARD`   
Wajib: Tidak

 ** Overrides **   <a name="DataSync-Type-TaskReportConfig-Overrides"></a>
Menyesuaikan tingkat pelaporan untuk aspek laporan tugas Anda. Misalnya, laporan Anda mungkin umumnya hanya menyertakan kesalahan, tetapi Anda dapat menentukan bahwa Anda menginginkan daftar keberhasilan dan kesalahan hanya untuk file yang DataSync mencoba dihapus di lokasi tujuan Anda.  
Tipe: Objek [ReportOverrides](API_ReportOverrides.md)  
Wajib: Tidak

 ** ReportLevel **   <a name="DataSync-Type-TaskReportConfig-ReportLevel"></a>
Menentukan apakah Anda ingin laporan tugas Anda hanya menyertakan apa yang salah dengan transfer Anda atau daftar apa yang berhasil dan tidak.  
+  `ERRORS_ONLY`: Laporan menunjukkan apa yang tidak dapat ditransfer, DataSync dilewati, diverifikasi, dan dihapus.
+  `SUCCESSES_AND_ERRORS`: Laporan menunjukkan apa yang DataSync mampu dan tidak dapat mentransfer, melewati, memverifikasi, dan menghapus.
Tipe: String  
Nilai yang Valid: `ERRORS_ONLY | SUCCESSES_AND_ERRORS`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskReportConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskReportConfig) 

# TaskSchedule
<a name="API_TaskSchedule"></a>

Mengkonfigurasi AWS DataSync tugas Anda untuk berjalan [sesuai jadwal](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) (pada interval minimal 1 jam).

## Daftar Isi
<a name="API_TaskSchedule_Contents"></a>

 ** ScheduleExpression **   <a name="DataSync-Type-TaskSchedule-ScheduleExpression"></a>
Menentukan jadwal tugas Anda dengan menggunakan ekspresi cron atau tingkat.  
Gunakan ekspresi cron untuk jadwal tugas yang berjalan pada waktu dan hari tertentu. Misalnya, ekspresi cron berikut membuat jadwal tugas yang berjalan pada pukul 8 pagi pada hari Rabu pertama setiap bulan:  
 `cron(0 8 * * 3#1)`   
Gunakan ekspresi tingkat untuk jadwal tugas yang berjalan pada interval reguler. Misalnya, ekspresi laju berikut membuat jadwal tugas yang berjalan setiap 12 jam:  
 `rate(12 hours)`   
Untuk informasi tentang sintaks ekspresi cron dan rate, lihat [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html).  
Jenis: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `^[a-zA-Z0-9\ \_\*\?\,\|\^\-\/\#\s\(\)\+]*$`   
Wajib: Ya

 ** Status **   <a name="DataSync-Type-TaskSchedule-Status"></a>
Menentukan apakah akan mengaktifkan atau menonaktifkan jadwal tugas Anda. Jadwal Anda diaktifkan secara default, tetapi mungkin ada situasi di mana Anda perlu menonaktifkannya. Misalnya, Anda mungkin perlu menjeda transfer berulang untuk memperbaiki masalah dengan tugas Anda atau melakukan pemeliharaan pada sistem penyimpanan Anda.  
DataSync mungkin menonaktifkan jadwal Anda secara otomatis jika tugas Anda gagal berulang kali dengan kesalahan yang sama. Untuk informasi selengkapnya, lihat [TaskScheduleDetails](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskScheduleDetails.html).  
Tipe: String  
Nilai yang Valid: `ENABLED | DISABLED`   
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskSchedule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskSchedule) 

# TaskScheduleDetails
<a name="API_TaskScheduleDetails"></a>

Memberikan informasi tentang [jadwal AWS DataSync tugas](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html) Anda.

## Daftar Isi
<a name="API_TaskScheduleDetails_Contents"></a>

 ** DisabledBy **   <a name="DataSync-Type-TaskScheduleDetails-DisabledBy"></a>
Menunjukkan bagaimana jadwal tugas Anda dinonaktifkan.  
+  `USER`- Jadwal Anda dinonaktifkan secara manual dengan menggunakan [UpdateTask](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html)operasi atau DataSync konsol.
+  `SERVICE`- Jadwal Anda dinonaktifkan secara otomatis DataSync karena tugas gagal berulang kali dengan kesalahan yang sama.
Tipe: String  
Nilai yang Valid: `USER | SERVICE`   
Wajib: Tidak

 ** DisabledReason **   <a name="DataSync-Type-TaskScheduleDetails-DisabledReason"></a>
Memberikan alasan jika jadwal tugas dinonaktifkan.  
Jika jadwal Anda dinonaktifkan`USER`, Anda akan melihat `Manually disabled by user.` pesan.  
Jika jadwal Anda dinonaktifkan`SERVICE`, Anda akan melihat pesan kesalahan untuk membantu Anda memahami mengapa tugas terus gagal. Untuk informasi tentang menyelesaikan DataSync kesalahan, lihat [Memecahkan masalah](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html) dengan transfer. DataSync   
Tipe: String  
Kendala Panjang: Panjang maksimum 8192.  
Pola: `^[\w\s.,'?!:;\/=|<>()-]*$`   
Wajib: Tidak

 ** StatusUpdateTime **   <a name="DataSync-Type-TaskScheduleDetails-StatusUpdateTime"></a>
Menunjukkan terakhir kali status jadwal tugas Anda berubah. Misalnya, jika DataSync secara otomatis menonaktifkan jadwal Anda karena kesalahan berulang, Anda dapat melihat kapan jadwal dinonaktifkan.  
Tipe: Timestamp  
Wajib: Tidak

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskScheduleDetails) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskScheduleDetails) 

# Kesalahan Umum
<a name="CommonErrors"></a>

Bagian ini mencantumkan kesalahan yang umum terjadi pada tindakan API dari semua AWS layanan. Untuk kesalahan khusus pada tindakan API untuk layanan ini, lihat topik untuk tindakan API tersebut.

 **AccessDeniedException**   
Anda tidak memiliki akses yang memadai untuk melakukan tindakan ini.  
Kode Status HTTP: 400

 **IncompleteSignature**   
Tanda tangan permintaan tidak sesuai dengan AWS standar.  
Kode Status HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
Pemrosesan permintaan telah gagal karena kesalahan yang tidak diketahui, pengecualian atau kegagalan.  
Kode Status HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
Tindakan atau operasi yang diminta tidak valid. Verifikasi bahwa tindakan diketik dengan benar.  
Kode Status HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
Sertifikat X.509 atau ID kunci AWS akses yang disediakan tidak ada dalam catatan kami.  
Kode Status HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Anda tidak memiliki izin untuk melakukan tindakan ini.  
Kode Status HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
ID kunci AWS akses memerlukan langganan untuk layanan ini.  
Kode Status HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
Permintaan mencapai layanan lebih dari 15 menit setelah cap tanggal pada permintaan atau lebih dari 15 menit setelah tanggal kedaluwarsa permintaan (seperti untuk pra-ditandatangani URLs), atau cap tanggal pada permintaan lebih dari 15 menit di masa depan.  
Kode Status HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
Permintaan telah gagal karena kegagalan sementara server.  
Kode Status HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
Permintaan ditolak karena throttling permintaan.  
Kode Status HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
Input gagal memenuhi kendala yang ditentukan oleh layanan. AWS   
Kode Status HTTP: 400

# Parameter Umum
<a name="CommonParameters"></a>

Daftar berikut berisi parameter yang digunakan semua tindakan untuk menandatangani permintaan Tanda Tangan Versi 4 dengan string kueri. Setiap parameter khusus tindakan tercantum dalam topik untuk tindakan tersebut. Untuk informasi selengkapnya tentang Tanda Tangan Versi 4, lihat [Menandatangani permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) di *Panduan Pengguna IAM*.

 **Action**   <a name="CommonParameters-Action"></a>
Tindakan yang harus dilakukan.  
Tipe: string  
Diperlukan: Ya

 **Version**   <a name="CommonParameters-Version"></a>
Versi API tempat permintaan ditulis, dinyatakan dalam format YYYY-MM-DD.  
Jenis: string  
Diperlukan: Ya

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
Algoritme hash yang Anda gunakan untuk membuat tanda tangan permintaan.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Nilai yang Valid: `AWS4-HMAC-SHA256`   
Diperlukan: Kondisional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
Nilai lingkup kredensial, yang merupakan string yang menyertakan access key Anda, tanggal, wilayah yang Anda targetkan, layanan yang Anda minta, dan string penghentian ("aws4\$1request"). Nilai dinyatakan dalam format berikut: *access\$1key*/*HHBBTTTT*/*wilayah*/*layanan*/aws4\$1request.  
Untuk informasi selengkapnya, lihat [Membuat permintaan AWS API yang ditandatangani](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) di *Panduan Pengguna IAM*.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Wajib: Bersyarat

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
Tanggal yang digunakan untuk membuat tanda tangan. Format harus berupa format dasar ISO 8601 (YYYYMMDD'T'HMMSS'Z'). Misalnya, waktu tanggal berikut adalah X-Amz-Date nilai yang valid:`20120325T120000Z`.  
Syarat: X-Amz-Date bersifat opsional untuk semua permintaan; ini dapat digunakan untuk menimpa tanggal yang digunakan untuk menandatangani permintaan. Jika header Tanggal ditentukan dalam format dasar ISO 8601, tidak X-Amz-Date diperlukan. Ketika X-Amz-Date digunakan, itu selalu mengesampingkan nilai header Tanggal. Untuk informasi selengkapnya, lihat [Elemen tanda tangan permintaan AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) di *Panduan Pengguna IAM*.  
Jenis: string  
Wajib: Bersyarat

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
Token keamanan sementara yang diperoleh melalui panggilan ke AWS Security Token Service (AWS STS). Untuk daftar layanan yang mendukung kredensi keamanan sementara AWS STS, lihat layanan [Layanan AWS yang berfungsi dengan IAM di Panduan Pengguna *IAM*](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).  
Kondisi: Jika Anda menggunakan kredensi keamanan sementara dari AWS STS, Anda harus menyertakan token keamanan.  
Jenis: string  
Wajib: Bersyarat

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Menentukan tanda tangan yang dikodekan oleh hex yang dihitung dari string to sign dan kunci penandatanganan turunan.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Wajib: Bersyarat

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Menentukan semua header HTTP yang disertakan sebagai bagian dari permintaan kanonik. Untuk informasi selengkapnya tentang menentukan header yang ditandatangani, lihat [Membuat permintaan AWS API yang ditandatangani](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) di Panduan Pengguna *IAM*.  
Syarat: Tentukan parameter ini ketika Anda menyertakan informasi autentikasi dalam string kueri alih-alih di header otorisasi HTTP.  
Tipe: string  
Diperlukan: Kondisional