CreateLocationHdfs - AWS DataSync
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateLocationHdfs

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.

Sintaksis Permintaan

{
   "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

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

Permintaan menerima data berikut dalam format JSON.

AgentArns

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

Jenis otentikasi yang digunakan untuk menentukan identitas pengguna.

Tipe: String

Nilai yang Valid: SIMPLE | KERBEROS

Wajib: 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.

Wajib: Tidak

CmkSecretConfig

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 dengan kustom. AWS KMS key

catatan

Anda dapat menggunakan CmkSecretConfig (denganKerberosKeytab) atau CustomSecretConfig (tanpaKerberosKeytab) untuk memberikan kredensyal untuk permintaan. CreateLocationHdfs Jangan berikan kedua parameter untuk permintaan yang sama.

Tipe: Objek CmkSecretConfig

Wajib: Tidak

CustomSecretConfig

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.

catatan

Anda dapat menggunakan CmkSecretConfig (denganKerberosKeytab) atau CustomSecretConfig (tanpaKerberosKeytab) untuk memberikan kredensyal untuk permintaan. CreateLocationHdfs Jangan berikan kedua parameter untuk permintaan yang sama.

Tipe: Objek CustomSecretConfig

Wajib: 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.

catatan

Jika KERBEROS ditentukan untukAuthenticationType, parameter ini diperlukan.

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 65536.

Wajib: Tidak

KerberosKrb5Conf

krb5.confFile 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.

catatan

Jika KERBEROS ditentukan untukAuthenticationType, parameter ini diperlukan.

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 131072.

Wajib: Tidak

KerberosPrincipal

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

catatan

Jika KERBEROS ditentukan untukAuthenticationType, parameter ini diperlukan.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: ^.+$

Wajib: Tidak

KmsKeyProviderUri

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

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.

Wajib: 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

Wajib: Tidak

ReplicationFactor

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

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

catatan

Jika SIMPLE ditentukan untukAuthenticationType, 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

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

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

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 bahasa khusus AWS SDKs, lihat berikut ini: