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

# CreateLocationFsxWindows
<a name="API_CreateLocationFsxWindows"></a>

Membuat *lokasi* transfer untuk sistem file Amazon FSx untuk Windows File Server. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync [mengakses FSx untuk sistem file Windows File Server](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-location-access).

## Sintaksis Permintaan
<a name="API_CreateLocationFsxWindows_RequestSyntax"></a>

```
{
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "Domain": "string",
   "FsxFilesystemArn": "string",
   "Password": "string",
   "SecurityGroupArns": [ "string" ],
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "User": "string"
}
```

## Parameter Permintaan
<a name="API_CreateLocationFsxWindows_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [CmkSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, yang mencakup kata sandi yang DataSync digunakan untuk mengakses lokasi penyimpanan FSx Windows tertentu, dengan yang dikelola pelanggan. AWS KMS key  
Bila Anda menyertakan parameter ini sebagai bagian dari `CreateLocationFsxWindows` permintaan, Anda hanya memberikan ARN kunci KMS. DataSync menggunakan kunci KMS ini bersama dengan yang `Password` Anda tentukan untuk membuat rahasia DataSync -managed untuk menyimpan kredenal 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 `CmkSecretConfig` (with`Password`) atau `CustomSecretConfig` (without`Password`) untuk memberikan kredensi untuk permintaan. `CreateLocationFsxWindows` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia Secrets Manager yang dikelola pelanggan di mana kata sandi untuk lokasi penyimpanan Windows File Server disimpan dalam teks biasa, di Secrets Manager. FSx 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` (with`Password`) atau `CustomSecretConfig` (without`Password`) untuk memberikan kredensi untuk permintaan. `CreateLocationFsxWindows` Jangan berikan kedua parameter untuk permintaan yang sama.
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [Domain](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Domain"></a>
Menentukan nama domain Windows yang dimiliki oleh FSx sistem file Windows File Server.  
Jika Anda memiliki beberapa domain Active Directory di lingkungan Anda, mengonfigurasi parameter ini memastikan bahwa DataSync terhubung ke sistem file yang tepat.  
Tipe: String  
Batasan Panjang: Panjang maksimum 253.  
Pola: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$`   
Wajib: Tidak

 ** [FsxFilesystemArn](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-FsxFilesystemArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) untuk FSx sistem file Windows File Server.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]+$`   
Wajib: Ya

 ** [Password](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Password"></a>
Menentukan kata sandi pengguna dengan izin untuk memasang dan mengakses file, folder, dan metadata file di sistem file Windows File FSx Server Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^.{0,104}$`   
Wajib: Tidak

 ** [SecurityGroupArns](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-SecurityGroupArns"></a>
Menentukan ARN dari grup keamanan Amazon EC2 yang menyediakan akses ke subnet pilihan sistem file Anda.  
Grup keamanan yang Anda tentukan harus dapat berkomunikasi dengan grup keamanan sistem file Anda. Untuk informasi tentang mengonfigurasi grup keamanan untuk akses sistem file, lihat [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/limit-access-security-groups.html).  
Jika Anda memilih grup keamanan yang tidak mengizinkan koneksi dari dalam dirinya sendiri, lakukan salah satu hal berikut:  
+ Konfigurasikan grup keamanan untuk memungkinkannya berkomunikasi di dalam dirinya sendiri.
+ Pilih grup keamanan lain yang dapat berkomunikasi dengan grup keamanan target mount.
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]+$`   
Wajib: Ya

 ** [Subdirectory](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Subdirectory"></a>
Menentukan jalur mount untuk sistem file Anda menggunakan garis miring maju. Di sinilah DataSync membaca atau menulis data (tergantung pada apakah ini adalah lokasi sumber atau tujuan).  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
Wajib: Tidak

 ** [Tags](#API_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-Tags"></a>
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_CreateLocationFsxWindows_RequestSyntax) **   <a name="DataSync-CreateLocationFsxWindows-request-User"></a>
Menentukan pengguna dengan izin untuk me-mount dan mengakses file, folder, dan metadata file dalam sistem file Windows File FSx Server Anda.  
Untuk informasi tentang memilih pengguna dengan tingkat akses yang tepat untuk transfer Anda, lihat [izin yang diperlukan](https://docs.aws.amazon.com/datasync/latest/userguide/create-fsx-location.html#create-fsx-windows-location-permissions) FSx untuk lokasi Windows File Server.  
Tipe: String  
Batasan Panjang: Panjang maksimum 104.  
Pola: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$`   
Diperlukan: Ya

## Sintaksis Respons
<a name="API_CreateLocationFsxWindows_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Elemen Respons
<a name="API_CreateLocationFsxWindows_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationFsxWindows_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxWindows-response-LocationArn"></a>
ARN dari lokasi sistem file FSx untuk Windows File Server 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
<a name="API_CreateLocationFsxWindows_Errors"></a>

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

## Lihat Juga
<a name="API_CreateLocationFsxWindows_SeeAlso"></a>

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/CreateLocationFsxWindows) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationFsxWindows) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationFsxWindows)