CreateLocationSmb - AWS DataSync

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

CreateLocationSmb

Membuat lokasi transfer untuk server file Server Message Block (SMB). AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync mengakses server file SMB. Untuk informasi selengkapnya, lihat Menyediakan DataSync akses ke server file SMB.

Sintaksis Permintaan

{ "AgentArns": [ "string" ], "AuthenticationType": "string", "DnsIpAddresses": [ "string" ], "Domain": "string", "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "MountOptions": { "Version": "string" }, "Password": "string", "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" }

Parameter Permintaan

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

Permintaan menerima data berikut dalam format JSON.

AgentArns

Menentukan DataSync agen (atau agen) yang dapat terhubung ke server file SMB Anda. Anda menentukan agen dengan menggunakan Nama Sumber Daya Amazon (ARN).

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

Wajib: Ya

AuthenticationType

Menentukan protokol otentikasi yang DataSync digunakan untuk terhubung ke server file SMB Anda. DataSync mendukung NTLM (default) dan KERBEROS otentikasi.

Untuk informasi selengkapnya, lihat Menyediakan DataSync akses ke server file SMB.

Tipe: String

Nilai yang Valid: NTLM | KERBEROS

Wajib: Tidak

DnsIpAddresses

Menentukan IPv4 alamat untuk server DNS yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika AuthenticationType diatur keKERBEROS.

Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke server file SMB yang tepat.

Tipe: Array string

Anggota Array: Jumlah maksimum 2 item.

Batasan Panjang: Panjang minimum 7. Panjang maksimum 15.

Pola: \A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z

Wajib: Tidak

Domain

Menentukan nama domain Windows yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika AuthenticationType diatur keNTLM.

Jika Anda memiliki beberapa domain di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke server file yang tepat.

Tipe: String

Batasan Panjang: Panjang maksimum 253.

Pola: ^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

Wajib: Tidak

KerberosKeytab

Menentukan file tabel kunci Kerberos (keytab) Anda, yang mencakup pemetaan antara kunci utama Kerberos dan kunci enkripsi Anda.

File harus dikodekan base64. Jika Anda menggunakan AWS CLI, pengkodean dilakukan untuk Anda.

Untuk menghindari kesalahan eksekusi tugas, pastikan bahwa prinsip Kerberos yang Anda gunakan untuk membuat file tab tombol cocok dengan apa yang Anda tentukan. KerberosPrincipal

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 65536.

Wajib: Tidak

KerberosKrb5Conf

Menentukan file konfigurasi Kerberos (krb5.conf) yang mendefinisikan konfigurasi ranah Kerberos Anda.

File harus dikodekan base64. Jika Anda menggunakan AWS CLI, pengkodean dilakukan untuk Anda.

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 131072.

Wajib: Tidak

KerberosPrincipal

Menentukan prinicpal Kerberos, yang merupakan identitas di ranah Kerberos Anda yang memiliki izin untuk mengakses file, folder, dan metadata file di server file SMB Anda.

Kepala sekolah Kerberos mungkin terlihat seperti. HOST/kerberosuser@MYDOMAIN.ORG

Nama-nama utama bersifat case sensitive. Eksekusi DataSync tugas Anda akan gagal jika prinsipal yang Anda tentukan untuk parameter ini tidak sama persis dengan prinsipal yang Anda gunakan untuk membuat file tab tombol.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: ^.+$

Wajib: Tidak

MountOptions

Menentukan versi protokol SMB yang DataSync digunakan untuk mengakses server file SMB Anda.

Tipe: Objek SmbMountOptions

Wajib: Tidak

Password

Menentukan kata sandi pengguna yang dapat me-mount server file SMB Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda. Parameter ini hanya berlaku jika AuthenticationType diatur keNTLM.

Tipe: String

Batasan Panjang: Panjang maksimum 104.

Pola: ^.{0,104}$

Wajib: Tidak

ServerHostname

Menentukan nama domain atau alamat IP server file SMB yang akan dipasang DataSync agen Anda.

Ingat hal berikut saat mengkonfigurasi parameter ini:

  • Anda tidak dapat menentukan alamat IP versi 6 (IPv6).

  • Jika Anda menggunakan otentikasi Kerberos, Anda harus menentukan nama domain.

Tipe: String

Batasan Panjang: Panjang maksimum 255.

Pola: ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

Wajib: Ya

Subdirectory

Menentukan nama saham yang diekspor oleh server file SMB Anda di mana DataSync akan membaca atau menulis data. Anda dapat menyertakan subdirektori di jalur berbagi (misalnya,/path/to/subdirectory). Pastikan bahwa klien SMB lain di jaringan Anda juga dapat memasang jalur ini.

Untuk menyalin semua data dalam subdirektori, DataSync harus dapat me-mount berbagi SMB dan mengakses semua datanya. Untuk informasi selengkapnya, lihat Menyediakan DataSync akses ke server file SMB.

Tipe: String

Batasan Panjang: Panjang maksimum 4096.

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

Wajib: Ya

Tags

Menentukan label yang membantu Anda mengkategorikan, memfilter, dan mencari sumber daya Anda. AWS Sebaiknya buat setidaknya tag nama untuk lokasi Anda.

Tipe: Array objek TagListEntry

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

Wajib: Tidak

User

Menentukan pengguna yang dapat me-mount dan mengakses file, folder, dan metadata file di server file SMB Anda. Parameter ini hanya berlaku jika AuthenticationType diatur keNTLM.

Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat Menyediakan DataSync akses ke server file SMB.

Tipe: String

Batasan Panjang: Panjang maksimum 104.

Pola: ^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$

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 SMB yang Anda buat.

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

Contoh

Permintaan Sampel

Contoh berikut membuat lokasi untuk server file SMB.

{ "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs", "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3" ], "Domain":"AMAZON", "MountOptions":{ "Version":"SMB3" }, "Password":"string", "ServerHostname":"MyServer.amazon.com", "Subdirectory":"share", "Tags":[ { "Key":"department", "Value":"finance" } ], "User":"user-1" }

Contoh Respons

Respons mengembalikan ARN lokasi server file SMB Anda.

{ "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" }

Lihat Juga

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