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

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