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

DescribeLocationFsxWindows

Memberikan rincian tentang bagaimana lokasi AWS DataSync transfer untuk sistem file Amazon FSx untuk Windows File Server 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) 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

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

CmkSecretConfig

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

CreationTime

Waktu lokasi FSx untuk Windows File Server dibuat.

Tipe: Timestamp

CustomSecretConfig

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

Domain

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

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

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

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

SecurityGroupArns

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 Panduan Pengguna Amazon FSx untuk Windows File Server.

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

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

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: