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

DescribeLocationHdfs

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

Sintaksis Permintaan

{
   "LocationArn": "string"
}

Parameter Permintaan

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

Permintaan menerima data berikut dalam format JSON.

LocationArn

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

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AgentArns

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

Jenis otentikasi yang digunakan untuk menentukan identitas pengguna.

Tipe: String

Nilai yang Valid: SIMPLE | KERBEROS

BlockSize

Ukuran blok data untuk ditulis ke dalam cluster HDFS.

Jenis: Integer

Rentang Valid: Nilai minimum 1048576. Nilai maksimum 1073741824.

CmkSecretConfig

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

CreationTime

Waktu lokasi HDFS dibuat.

Tipe: Timestamp

CustomSecretConfig

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

KerberosPrincipal

Kepala sekolah Kerberos dengan akses ke file dan folder pada cluster HDFS. Parameter ini digunakan jika AuthenticationType didefinisikan sebagaiKERBEROS.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: ^.+$

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$

LocationArn

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

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

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

NameNodes

NameNode Yang mengelola namespace HDFS.

Tipe: Array objek HdfsNameNode

Anggota Array: Jumlah minimum 1 item.

QopConfiguration

Konfigurasi Quality of Protection (QOP), yang menentukan pengaturan Remote Procedure Call (RPC) dan perlindungan transfer data yang dikonfigurasi pada cluster HDFS.

Tipe: Objek QopConfiguration

ReplicationFactor

Jumlah DataNodes untuk mereplikasi data saat menulis ke cluster HDFS.

Tipe: Bilangan Bulat

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

SimpleUser

Nama pengguna untuk mengidentifikasi klien pada sistem operasi host. Parameter ini digunakan jika AuthenticationType didefinisikan sebagaiSIMPLE.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

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

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: