CreateLocationHdfs

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

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync mengakses klaster HDFS.

Sintaksis Permintaan

{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "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

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

AgentArns

Amazon Resource Names (ARN) dari agen yang digunakan untuk terhubung ke cluster HDFS.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 4 item.

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

Diperlukan: Ya

AuthenticationType

Jenis otentikasi yang digunakan untuk menentukan identitas pengguna.

Jenis: String

Nilai yang Valid: SIMPLE | KERBEROS

Diperlukan: Ya

BlockSize

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.

Diperlukan: Tidak

KerberosKeytab

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 Anda menggunakanAWS CLI, ia melakukan pengkodean base64 untuk Anda. Jika tidak, berikan teks yang dikodekan base64.

catatan

Jika KERBEROS ditentukan untukAuthenticationType, parameter ini diperlukan.

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 65536.

Diperlukan: Tidak

KerberosKrb5Conf

krb5.confFile yang berisi informasi konfigurasi Kerberos. Anda dapat memuat krb5.conf file dengan memberikan alamat file. Jika Anda menggunakanAWS CLI, ia melakukan pengkodean base64 untuk Anda. Jika tidak, berikan teks yang dikodekan base64.

catatan

Jika KERBEROS ditentukan untukAuthenticationType, parameter ini diperlukan.

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 131072.

Diperlukan: Tidak

KerberosPrincipal

Kepala sekolah Kerberos dengan akses ke file dan folder pada cluster HDFS.

catatan

Jika KERBEROS ditentukan untukAuthenticationType, parameter ini diperlukan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: ^.+$

Diperlukan: Tidak

KmsKeyProviderUri

URI dari Server Manajemen Kunci (KMS) klaster HDFS.

Jenis: 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$

Diperlukan: Tidak

NameNodes

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

Anggota Array: Jumlah minimum 1 item.

Diperlukan: Ya

QopConfiguration

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 kePRIVACY. Jika Anda menetapkan RpcProtection atauDataTransferProtection, parameter lain mengasumsikan nilai yang sama.

Tipe: Objek QopConfiguration

Diperlukan: Tidak

ReplicationFactor

Jumlah DataNodes untuk mereplikasi data saat menulis ke cluster HDFS. Secara default, data direplikasi menjadi tiga DataNodes.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 512.

Diperlukan: Tidak

SimpleUser

Nama pengguna yang digunakan untuk mengidentifikasi klien pada sistem operasi host.

catatan

Jika SIMPLE ditentukan untukAuthenticationType, parameter ini diperlukan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: ^[_.A-Za-z0-9][-_.A-Za-z0-9]*$

Diperlukan: Tidak

Subdirectory

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/.

Jenis: String

Batasan Panjang: Panjang maksimum 4096.

Pola: ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Diperlukan: Tidak

Tags

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

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.

Diperlukan: Tidak

Sintaksis Respons

{
   "LocationArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

LocationArn

ARN dari lokasi cluster HDFS sumber yang dibuat.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go.

• AWSSDK for Java V2

• AWSSDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3