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](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). ## Sintaksis Permintaan ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "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](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [AgentArns](#API_CreateLocationSmb_RequestSyntax) ** 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 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](#API_CreateLocationSmb_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipe: String Nilai yang Valid: `NTLM | KERBEROS` Wajib: Tidak ** [CmkSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Menentukan informasi konfigurasi untuk rahasia DataSync -managed, baik `Password` atau `KerberosKeytab` (untuk `NTLM` (default) dan jenis `KERBEROS` otentikasi, masing-masing) yang DataSync digunakan untuk mengakses lokasi penyimpanan SMB tertentu, dengan pelanggan yang dikelola. AWS KMS key Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationSmbRequest` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan salah satu `Password` atau 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](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key) dengan kustom. AWS KMS key Anda dapat menggunakan salah satu `CmkSecretConfig` (dengan salah satu `Password` atau`KerberosKeytab`) atau `CustomSecretConfig` (tanpa `Password` dan`KerberosKeytab`) untuk memberikan kredensyal untuk permintaan. `CreateLocationSmbRequest` Jangan berikan keduanya `CmkSecretConfig` dan `CustomSecretConfig` parameter untuk permintaan yang sama. Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md) Wajib: Tidak ** [CustomSecretConfig](#API_CreateLocationSmb_RequestSyntax) ** Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kredensyal lokasi penyimpanan SMB disimpan di Secrets Manager sebagai teks biasa (untuk) atau biner (untuk`Password`). `KerberosKeytab` Konfigurasi ini mencakup ARN rahasia, dan ARN untuk peran IAM yang menyediakan akses ke rahasia. Untuk informasi selengkapnya, lihat [Menggunakan rahasia yang Anda kelola](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Anda dapat menggunakan `CmkSecretConfig` (dengan`SasConfiguration`) atau `CustomSecretConfig` (tanpa`SasConfiguration`) untuk memberikan kredensyal untuk permintaan. `CreateLocationSmbRequest` Jangan berikan kedua parameter untuk permintaan yang sama. Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md) Wajib: Tidak ** [DnsIpAddresses](#API_CreateLocationSmb_RequestSyntax) ** Menentukan IPv4 atau IPv6 alamat untuk server DNS yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`KERBEROS`. 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 39. 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}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` Wajib: Tidak ** [Domain](#API_CreateLocationSmb_RequestSyntax) ** Menentukan nama domain Windows yang dimiliki server file SMB Anda. Parameter ini hanya berlaku jika `AuthenticationType` diatur ke`NTLM`. 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](#API_CreateLocationSmb_RequestSyntax) ** Menentukan file tabel kunci Kerberos (keytab) Anda, yang mencakup pemetaan antara kunci utama Kerberos dan kunci enkripsi Anda. Untuk menghindari kesalahan eksekusi tugas, pastikan bahwa prinsip Kerberos yang Anda gunakan untuk membuat file tab tombol cocok persis dengan apa yang Anda tentukan. `KerberosPrincipal` Tipe: Objek data biner dienkode Base64 Kendala Panjang: Panjang maksimum 65536. Wajib: Tidak ** [KerberosKrb5Conf](#API_CreateLocationSmb_RequestSyntax) ** 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](#API_CreateLocationSmb_RequestSyntax) ** Menentukan prinsipal 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](#API_CreateLocationSmb_RequestSyntax) ** Menentukan versi protokol SMB yang DataSync digunakan untuk mengakses server file SMB Anda. Tipe: Objek [SmbMountOptions](API_SmbMountOptions.md) Wajib: Tidak ** [Password](#API_CreateLocationSmb_RequestSyntax) ** 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 ke`NTLM`. Tipe: String Batasan Panjang: Panjang maksimum 104. Pola: `^.{0,104}$` Wajib: Tidak ** [ServerHostname](#API_CreateLocationSmb_RequestSyntax) ** Menentukan nama domain atau alamat IP (IPv4 atau IPv6) dari server file SMB yang terhubung dengan DataSync agen Anda. 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](#API_CreateLocationSmb_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). Tipe: String Batasan Panjang: Panjang maksimum 4096. Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$` Wajib: Ya ** [Tags](#API_CreateLocationSmb_RequestSyntax) ** 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](API_TagListEntry.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item. Wajib: Tidak ** [User](#API_CreateLocationSmb_RequestSyntax) ** 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 ke`NTLM`. Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [Menyediakan DataSync akses ke server file SMB](https://docs.aws.amazon.com/datasync/latest/userguide/create-smb-location.html#configuring-smb-permissions). 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](#API_CreateLocationSmb_ResponseSyntax) ** ARN dari lokasi SMB 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 [Jenis Kesalahan Umum](CommonErrors.md). ** 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: + [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationSmb) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationSmb)