CreateMountTarget

Membuat target mount untuk sistem file. Anda kemudian dapat me-mount sistem file pada instans EC2 dengan menggunakan target mount.

Anda dapat membuat satu target mount di setiap Availability Zone di VPC Anda. Semua instans EC2 dalam VPC dalam Availability Zone tertentu berbagi target mount tunggal untuk sistem file tertentu. Jika Anda memiliki beberapa subnet di Availability Zone, Anda membuat target mount di salah satu subnet. Instans EC2 tidak perlu berada di subnet yang sama dengan target mount untuk mengakses sistem file mereka.

Anda hanya dapat membuat satu target mount untuk sistem file One Zone. Anda harus membuat target mount itu di Availability Zone yang sama di mana sistem file berada. Gunakan AvailabilityZoneName dan AvailabiltyZoneId properti di objek DescribeFileSystems respons untuk mendapatkan informasi ini. Gunakan yang subnetId terkait dengan Availability Zone sistem file saat membuat target mount.

Untuk informasi selengkapnya, lihat Amazon EFS: Cara Kerjanya.

Untuk membuat target mount untuk sistem file, status siklus hidup sistem file harus. available Untuk informasi selengkapnya, lihat DescribeFileSystems.

Dalam permintaan, berikan yang berikut:

• ID sistem file tempat Anda membuat target mount.

• ID subnet, yang menentukan hal berikut:

  • VPC tempat Amazon EFS membuat target pemasangan

  • Availability Zone di mana Amazon EFS membuat target mount

  • Rentang alamat IP dari mana Amazon EFS memilih alamat IP target mount (jika Anda tidak menentukan alamat IP dalam permintaan)

Setelah membuat target pemasangan, Amazon EFS mengembalikan respons yang menyertakan, a MountTargetId dan anIpAddress. Anda menggunakan alamat IP ini saat memasang sistem file dalam instans EC2. Anda juga dapat menggunakan nama DNS target mount saat memasang sistem file. Instans EC2 tempat Anda memasang sistem file dengan menggunakan target mount dapat menyelesaikan nama DNS target mount ke alamat IP-nya. Untuk informasi selengkapnya, lihat Cara Kerjanya: Ikhtisar Implementasi.

Perhatikan bahwa Anda dapat membuat target mount untuk sistem file hanya dalam satu VPC, dan hanya ada satu target mount per Availability Zone. Artinya, jika sistem file sudah memiliki satu atau lebih target mount yang dibuat untuknya, subnet yang ditentukan dalam permintaan untuk menambahkan target mount lain harus memenuhi persyaratan berikut:

• Harus memiliki VPC yang sama dengan subnet dari target mount yang ada

• Tidak boleh berada di Availability Zone yang sama dengan subnet dari target mount yang ada

Jika permintaan memenuhi persyaratan, Amazon EFS melakukan hal berikut:

• Membuat target mount baru di subnet yang ditentukan.

• Juga membuat antarmuka jaringan baru di subnet sebagai berikut:

  • Jika permintaan menyediakanIpAddress, Amazon EFS menetapkan alamat IP tersebut ke antarmuka jaringan. Jika tidak, Amazon EFS memberikan alamat gratis di subnet (dengan cara yang sama seperti panggilan Amazon CreateNetworkInterface EC2 saat permintaan tidak menentukan alamat IP pribadi utama).

  • Jika permintaan menyediakanSecurityGroups, antarmuka jaringan ini dikaitkan dengan grup keamanan tersebut. Jika tidak, itu milik grup keamanan default untuk VPC subnet.

  • Menetapkan deskripsi di Mount target fsmt-id for file system fs-id fsmt-id mana ID target mount, dan fs-id merupakan. FileSystemId

  • Menetapkan requesterManaged properti antarmuka jaringan ketrue, dan requesterId nilai keEFS.

  Setiap target pemasangan Amazon EFS memiliki satu antarmuka jaringan EC2 yang dikelola pemohon yang sesuai. Setelah antarmuka jaringan dibuat, Amazon EFS menetapkan NetworkInterfaceId bidang dalam deskripsi target pemasangan ke ID antarmuka jaringan, dan IpAddress bidang ke alamatnya. Jika pembuatan antarmuka jaringan gagal, seluruh CreateMountTarget operasi gagal.

catatan

CreateMountTargetPanggilan kembali hanya setelah membuat antarmuka jaringan, tetapi saat status target mount masihcreating, Anda dapat memeriksa status pembuatan target mount dengan memanggil DescribeMountTargets operasi, yang antara lain mengembalikan status target mount.

Kami menyarankan Anda membuat target pemasangan di setiap Availability Zone. Ada pertimbangan biaya untuk menggunakan sistem file di Availability Zone melalui target mount yang dibuat di Availability Zone lain. Untuk informasi selengkapnya, lihat Amazon EFS. Selain itu, dengan selalu menggunakan target mount lokal ke Availability Zone instance, Anda menghilangkan skenario kegagalan sebagian. Jika Availability Zone di mana target mount Anda dibuat turun, maka Anda tidak dapat mengakses sistem file Anda melalui target mount tersebut.

Operasi ini memerlukan izin untuk tindakan berikut pada sistem file:

• elasticfilesystem:CreateMountTarget

Operasi ini juga memerlukan izin untuk tindakan Amazon EC2 berikut:

• ec2:DescribeSubnets

• ec2:DescribeNetworkInterfaces

• ec2:CreateNetworkInterface

Minta Sintaks

POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json

{
   "FileSystemId": "string",
   "IpAddress": "string",
   "SecurityGroups": [ "string" ],
   "SubnetId": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

FileSystemId

ID sistem file yang akan digunakan untuk membuat target pemasangan.

Tipe: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Diperlukan: Ya

IpAddress

Alamat IPv4 yang valid dalam rentang alamat subnet yang ditentukan.

Tipe: String

Batasan Panjang: Panjang minimum 7. Panjang maksimum 15.

Pola: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Diperlukan: Tidak

SecurityGroups

Hingga lima ID grup keamanan VPC, dari bentuk sg-xxxxxxxx. Ini harus untuk VPC yang sama dengan yang ditentukan subnet.

Tipe: Array string

Anggota Array: Jumlah maksimum 100 item.

Kendala Panjang: Panjang minimum 11. Panjang maksimum 43.

Pola: ^sg-[0-9a-f]{8,40}

Diperlukan: Tidak

SubnetId

ID subnet yang diambahkan target pemasangan. Untuk sistem file One Zone, gunakan subnet yang terkait dengan Availability Zone sistem file.

Tipe: String

Kendala Panjang: Panjang minimum 15. Panjang maksimum 47.

Pola: ^subnet-[0-9a-f]{8,40}$

Diperlukan: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "FileSystemId": "string",
   "IpAddress": "string",
   "LifeCycleState": "string",
   "MountTargetId": "string",
   "NetworkInterfaceId": "string",
   "OwnerId": "string",
   "SubnetId": "string",
   "VpcId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AvailabilityZoneId

Pengidentifikasi unik dan konsisten dari Availability Zone tempat target mount berada. Misalnya, use1-az1 adalah ID AZ untuk Wilayah us-timur-1 dan memiliki lokasi yang sama di setiap wilayah. Akun AWS

Tipe: String

AvailabilityZoneName

Nama Availability Zone di mana target mount berada. Availability Zones dipetakan secara independen ke nama masing-masingAkun AWS. Misalnya, Availability Zone us-east-1a untuk Anda Akun AWS mungkin bukan lokasi yang sama dengan us-east-1a yang lainAkun AWS.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: .+

FileSystemId

ID sistem file tempat target mount dimaksudkan.

Tipe: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

IpAddress

Alamat di mana sistem file dapat dipasang dengan menggunakan target mount.

Tipe: String

Batasan Panjang: Panjang minimum 7. Panjang maksimum 15.

Pola: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

LifeCycleState

Status siklus hidup target pemasangan.

Tipe: String

Nilai yang Valid: creating | available | updating | deleting | deleted | error

MountTargetId

ID target pemasangan yang ditetapkan sistem.

Tipe: String

Kendala Panjang: Panjang minimum 13. Panjang maksimum 45.

Pola: ^fsmt-[0-9a-f]{8,40}$

NetworkInterfaceId

ID antarmuka jaringan yang dibuat Amazon EFS saat membuat target pemasangan.

Tipe: String

OwnerId

Akun AWSID yang memiliki sumber daya.

Tipe: String

Kendala Panjang: Panjang maksimum 14.

Pola: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

SubnetId

ID subnet target mount.

Tipe: String

Kendala Panjang: Panjang minimum 15. Panjang maksimum 47.

Pola: ^subnet-[0-9a-f]{8,40}$

VpcId

ID virtual private cloud (VPC) tempat target mount dikonfigurasi.

Tipe: String

Kesalahan

AvailabilityZonesMismatch

Dikembalikan jika Availability Zone yang ditetapkan untuk target mount berbeda dari Availability Zone yang ditentukan untuk penyimpanan One Zone. Untuk informasi selengkapnya, lihat Redundansi penyimpanan Regional dan Satu Zona.

Kode Status HTTP: 400

BadRequest

Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang.

Kode Status HTTP: 400

FileSystemNotFound

Dikembalikan jika FileSystemId nilai yang ditentukan tidak ada di pemohon. Akun AWS

Kode Status HTTP: 404

IncorrectFileSystemLifeCycleState

Dikembalikan jika status siklus hidup sistem file tidak “tersedia”.

Kode Status HTTP: 409

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

IpAddressInUse

Dikembalikan jika permintaan ditentukan IpAddress yang sudah digunakan di subnet.

Kode Status HTTP: 409

MountTargetConflict

Dikembalikan jika target pemasangan akan melanggar salah satu batasan yang ditentukan berdasarkan target pemasangan sistem file yang ada.

Kode Status HTTP: 409

NetworkInterfaceLimitExceeded

Akun panggilan telah mencapai batas untuk antarmuka jaringan elastis untuk spesifikWilayah AWS. Hapus beberapa antarmuka jaringan atau minta kuota akun dinaikkan. Untuk informasi selengkapnya, lihat Kuota VPC Amazon di Panduan Pengguna Amazon VPC (lihat entri Antarmuka jaringan per Wilayah di tabel Antarmuka jaringan).

Kode Status HTTP: 409

NoFreeAddressesInSubnet

Dikembalikan jika IpAddress tidak ditentukan dalam permintaan dan tidak ada alamat IP gratis di subnet.

Kode Status HTTP: 409

SecurityGroupLimitExceeded

Dikembalikan jika ukuran SecurityGroups yang ditentukan dalam permintaan lebih besar dari lima.

Kode Status HTTP: 400

SecurityGroupNotFound

Dikembalikan jika salah satu grup keamanan yang ditentukan tidak ada di virtual private cloud (VPC) subnet.

Kode Status HTTP: 400

SubnetNotFound

Dikembalikan jika tidak ada subnet dengan ID SubnetId yang disediakan dalam permintaan.

Kode Status HTTP: 400

UnsupportedAvailabilityZone

Dikembalikan jika fungsionalitas Amazon EFS yang diminta tidak tersedia di Availability Zone yang ditentukan.

Kode Status HTTP: 400

Contoh

Tambahkan target mount ke sistem file

Permintaan berikut membuat target mount untuk sistem file. Permintaan menentukan nilai hanya untuk yang diperlukan FileSystemId dan SubnetId parameter. Permintaan tidak memberikan opsional IpAddress dan SecurityGroups parameter. UntukIpAddress, operasi menggunakan salah satu alamat IP yang tersedia di subnet yang ditentukan. Dan, operasi menggunakan grup keamanan default yang terkait dengan VPC untuk. SecurityGroups

Sampel Permintaan

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}

Contoh Respons

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "MountTargetId": "fsmt-55a4413c",
    "NetworkInterfaceId": "eni-01234567",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "available",
    "SubnetId": "subnet-01234567",
    "OwnerId": "231243201240",
    "IpAddress": "172.31.22.183"
}

Tambahkan target mount ke sistem file

Permintaan berikut menentukan semua parameter permintaan untuk membuat target mount.

Sampel Permintaan

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "IpAddress":"10.0.2.42",
   "SecurityGroups":[
      "sg-01234567"
   ]
}

Contoh Respons

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
   "OwnerId":"251839141158",
   "MountTargetId":"fsmt-9a13661e",
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-fd04ff94",
   "LifeCycleState":"available",
   "IpAddress":"10.0.2.42",
   "NetworkInterfaceId":"eni-1bcb7772"
}

Lihat Juga

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

• AWSAntarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go.

• AWSSDK for Java V2

• AWSSDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3