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

# CreateLocationEfs
<a name="API_CreateLocationEfs"></a>

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

Sebelum memulai, pastikan Anda memahami cara DataSync [mengakses sistem file Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access).

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

```
{
   "AccessPointArn": "string",
   "Ec2Config": { 
      "SecurityGroupArns": [ "string" ],
      "SubnetArn": "string"
   },
   "EfsFilesystemArn": "string",
   "FileSystemAccessRoleArn": "string",
   "InTransitEncryption": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

Permintaan menerima data berikut dalam format JSON.

 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-AccessPointArn"></a>
Menentukan Nama Sumber Daya Amazon (ARN) dari titik akses DataSync yang digunakan untuk memasang sistem file Amazon EFS Anda.  
Untuk informasi selengkapnya, lihat [Mengakses sistem file terbatas](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam).  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$`   
Wajib: Tidak

 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Ec2Config"></a>
Menentukan subnet dan grup keamanan yang DataSync digunakan untuk terhubung ke salah satu target [pemasangan](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) sistem file Amazon EFS Anda.  
Tipe: Objek [Ec2Config](API_Ec2Config.md)  
Wajib: Ya

 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-EfsFilesystemArn"></a>
Menentukan ARN untuk sistem file Amazon EFS Anda.  
Tipe: String  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$`   
Wajib: Ya

 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-FileSystemAccessRoleArn"></a>
Menentukan peran AWS Identity and Access Management (IAM) yang memungkinkan DataSync untuk mengakses sistem file Amazon EFS Anda.  
Untuk informasi tentang membuat peran ini, lihat [Membuat peran DataSync IAM untuk akses sistem file](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role).  
Tipe: String  
Batasan Panjang: Panjang maksimum 2048.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$`   
Wajib: Tidak

 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-InTransitEncryption"></a>
Menentukan apakah Anda DataSync ingin menggunakan enkripsi Transport Layer Security (TLS) 1.2 saat mentransfer data ke atau dari sistem file Amazon EFS Anda.  
Jika Anda menentukan titik akses menggunakan `AccessPointArn` atau peran IAM menggunakan`FileSystemAccessRoleArn`, Anda harus mengatur parameter ini ke`TLS1_2`.  
Tipe: String  
Nilai yang Valid: `NONE | TLS1_2`   
Wajib: Tidak

 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Subdirectory"></a>
Menentukan jalur pemasangan untuk sistem file Amazon EFS Anda. Di sinilah DataSync membaca atau menulis data pada sistem file Anda (tergantung pada apakah ini adalah lokasi sumber atau tujuan).  
Secara default, DataSync gunakan direktori root (atau [titik akses](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) jika Anda menyediakannya dengan menggunakan`AccessPointArn`). Anda juga dapat menyertakan subdirektori menggunakan garis miring maju (misalnya,). `/path/to/folder`  
Tipe: String  
Batasan Panjang: Panjang maksimum 4096.  
Pola: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Wajib: Tidak

 ** [Tags](#API_CreateLocationEfs_RequestSyntax) **   <a name="DataSync-CreateLocationEfs-request-Tags"></a>
Menentukan pasangan kunci-nilai yang mewakili tag yang ingin Anda tambahkan ke sumber daya. Nilai dapat berupa string kosong. Nilai ini membantu Anda mengelola, mem-filter, dan mencari sumber daya Anda. Kami merekomendasikan agar Anda membuat tanda nama untuk lokasi Anda.  
Tipe: Array objek [TagListEntry](API_TagListEntry.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.  
Diperlukan: Tidak

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

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

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) **   <a name="DataSync-CreateLocationEfs-response-LocationArn"></a>
Nama Sumber Daya Amazon (ARN) dari lokasi sistem file Amazon EFS 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_CreateLocationEfs_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

## Contoh
<a name="API_CreateLocationEfs_Examples"></a>

### Permintaan Sampel
<a name="API_CreateLocationEfs_Example_1"></a>

Contoh berikut membuat lokasi untuk sistem file Amazon EFS.

```
{
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2"
        ]
    },
    "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### Permintaan Sampel: Membuat lokasi untuk sistem file Amazon EFS terbatas
<a name="API_CreateLocationEfs_Example_2"></a>

Contoh berikut membuat lokasi untuk sistem file Amazon EFS dengan akses terbatas. Dalam skenario semacam ini, Anda mungkin harus menentukan nilai untuk`AccessPointArn`,`FileSystemAccessRoleArn`, dan `InTransitEncryption` dalam permintaan Anda.

```
{
    "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0",
    "Ec2Config": {
        "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1",
        "SecurityGroupArns": [
            "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2"
        ]
    },
    "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew",
    "InTransitEncryption": "TLS1_2",
    "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890",
    "LocationUri": "efs://us-east-2.fs-021345abcdef6789/",
    "Subdirectory": "/mount/path",
    "Tags": [{
        "Key": "Name",
        "Value": "ElasticFileSystem-1"
    }]
}
```

### Contoh Respons
<a name="API_CreateLocationEfs_Example_3"></a>

Respons mengembalikan lokasi ARN dari sistem file Amazon EFS.

```
{
  "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678"
}
```

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