CreateLocationEfs - AWS DataSync
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanContohLihat Juga

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

CreateLocationEfs

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

Sebelum Anda mulai, pastikan bahwa Anda memahami bagaimana DataSync mengakses sistem EFS file Amazon.

Sintaksis Permintaan

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

Parameter Permintaan

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

Permintaan menerima data berikut dalam JSON format.

AccessPointArn

Menentukan Nama Sumber Daya Amazon (ARN) dari titik akses yang DataSync digunakan untuk mengakses sistem EFS file Amazon.

Tipe: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$

Wajib: Tidak

Ec2Config

Menentukan subnet dan kelompok keamanan yang DataSync digunakan untuk mengakses sistem EFS file Amazon Anda.

Tipe: Objek Ec2Config

Wajib: Ya

EfsFilesystemArn

Menentukan ARN untuk sistem EFS file Amazon.

Tipe: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$

Wajib: Ya

FileSystemAccessRoleArn

Menentukan peran AWS Identity and Access Management (IAM) yang DataSync diasumsikan saat memasang sistem EFS file Amazon.

Tipe: String

Batasan Panjang: Panjang maksimum 2048.

Pola: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$

Wajib: Tidak

InTransitEncryption

Menentukan apakah Anda DataSync ingin menggunakan enkripsi Transport Layer Security (TLS) 1.2 saat menyalin data ke atau dari sistem EFS file Amazon.

Jika Anda menentukan titik akses menggunakan AccessPointArn atau IAM peran menggunakanFileSystemAccessRoleArn, Anda harus mengatur parameter ini keTLS1_2.

Tipe: String

Nilai yang Valid: NONE | TLS1_2

Wajib: Tidak

Subdirectory

Menentukan jalur pemasangan untuk sistem EFS file Amazon Anda. Di sinilah DataSync membaca atau menulis data (tergantung pada apakah ini adalah lokasi sumber atau tujuan). Secara default, DataSync menggunakan direktori root, tetapi Anda juga dapat menyertakan subdirektori.

catatan

Anda harus menentukan nilai dengan garis miring ke depan (misalnya,/path/to/folder).

Tipe: String

Batasan Panjang: Panjang maksimum 4096.

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

Wajib: Tidak

Tags

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

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

Diperlukan: Tidak

Sintaksis Respons

{
   "LocationArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

LocationArn

Nama Sumber Daya Amazon (ARN) dari lokasi sistem EFS file Amazon 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 sistem EFS file Amazon.

{
    "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 EFS file Amazon terbatas

Contoh berikut membuat lokasi untuk sistem EFS file Amazon dengan akses terbatas. Dalam skenario semacam ini, Anda mungkin harus menentukan nilai untukAccessPointArn,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

Respons mengembalikan ARN lokasi sistem EFS file Amazon.

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

Lihat Juga

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