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 memulai, pastikan Anda memahami cara DataSync mengakses server SMB file.
Sintaksis Permintaan
{
"AgentArns": [ "string" ],
"Domain": "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 JSON format.
- AgentArns
-
Menentukan DataSync agen (atau agen) yang dapat terhubung ke server SMB file Anda. Anda menentukan agen dengan menggunakan Amazon Resource Name (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
- Domain
-
Menentukan nama domain Active Directory yang dimiliki server SMB file Anda.
Jika Anda memiliki beberapa domain Active Directory 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
- MountOptions
-
Menentukan versi SMB protokol yang DataSync digunakan untuk mengakses server SMB file Anda.
Tipe: Objek SmbMountOptions
Wajib: Tidak
- Password
-
Menentukan kata sandi pengguna yang dapat me-mount server SMB file Anda dan memiliki izin untuk mengakses file dan folder yang terlibat dalam transfer Anda.
Untuk informasi selengkapnya, lihat izin yang diperlukan untuk SMB lokasi.
Tipe: String
Batasan Panjang: Panjang maksimum 104.
Pola:
^.{0,104}$Wajib: Ya
- ServerHostname
-
Menentukan nama Layanan Nama Domain (DNS) atau alamat IP dari server SMB file yang akan dipasang DataSync agen Anda.
catatan
Anda tidak dapat menentukan alamat IP versi 6 (IPv6).
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 SMB file Anda di mana DataSync akan membaca atau menulis data. Anda dapat menyertakan subdirektori di jalur berbagi (misalnya,
/path/to/subdirectory). Pastikan bahwa SMB klien lain di jaringan Anda juga dapat memasang jalur ini.Untuk menyalin semua data dalam subdirektori, DataSync harus dapat me-mount SMB share dan mengakses semua datanya. Untuk informasi selengkapnya, lihat izin yang diperlukan untuk SMB lokasi.
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 AndaSMB.
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat izin yang diperlukan untuk SMB lokasi.
Tipe: String
Batasan Panjang: Panjang maksimum 104.
Pola:
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$Diperlukan: Ya
Sintaksis Respons
{
"LocationArn": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Data berikut dikembalikan dalam JSON format oleh layanan.
- LocationArn
-
SMBLokasi ARN 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 .
HTTPKode Status: 500
- InvalidRequestException
-
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
HTTPKode Status: 400
Contoh
Permintaan Sampel
Contoh berikut membuat lokasi untuk server SMB file.
{ "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 SMB file Anda.
{ "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" }
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
