Minta Sintaks Parameter Permintaan URI Isi Permintaan Sintaksis Respons Elemen Respons Kesalahan Contoh Lihat Juga

CreateMountTarget

Membuat target mount untuk sistem file. Anda kemudian dapat me-mount sistem file pada EC2 instance dengan menggunakan target mount. Untuk informasi selengkapnya tentang target pemasangan, lihat Mengelola target pemasangan.

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

Setelah membuat target pemasangan, Amazon EFS mengembalikan respons yang menyertakan alamat IP MountTargetId dan (IpAddressatauIpv6Address). Anda menggunakan alamat IP ini saat memasang sistem file dalam sebuah EC2 instance. Anda juga dapat menggunakan nama DNS target mount saat memasang sistem file. EC2 Instance tempat Anda memasang sistem file dengan menggunakan target mount dapat menyelesaikan nama DNS target mount ke alamat IP-nya. Untuk informasi selengkapnya, lihat Cara kerja Amazon EFS.

Perhatikan bahwa Anda dapat membuat target mount untuk sistem file hanya dalam satu VPC, dan hanya ada satu target mount per Availability Zone. Untuk informasi selengkapnya, lihat Membuat target pemasangan.

Jika permintaan memenuhi persyaratan, Amazon EFS melakukan hal berikut:

Membuat target mount baru di subnet yang ditentukan.
Membuat antarmuka jaringan baru di subnet dengan folowing:
- Deskripsi di Mount target fsmt-id for file system fs-id fsmt-id mana ID target mount, dan fs-id merupakanFileSystemId.
- requesterManagedProperti antarmuka jaringan diatur ketrue, dan requesterId nilai diatur keEFS.
Setiap target mount memiliki satu antarmuka jaringan yang dikelola pemohon yang EC2 sesuai. Setelah antarmuka jaringan dibuat, Amazon EFS menetapkan NetworkInterfaceId bidang dalam deskripsi target pemasangan ke ID antarmuka jaringan, dan alamat IP 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.

Operasi ini memerlukan izin untuk tindakan berikut pada sistem file:

elasticfilesystem:CreateMountTarget

Operasi ini juga memerlukan izin untuk EC2 tindakan Amazon 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",
   "IpAddressType": "string",
   "Ipv6Address": "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})$

Wajib: Ya

IpAddress

Jika target IpAddressType untuk mount adalah IPv4 (IPV4_ONLYatauDUAL_STACK), maka tentukan IPv4 alamat yang akan digunakan. Jika Anda tidak menentukanIpAddress, Amazon EFS memilih alamat IP yang tidak digunakan dari subnet yang ditentukan untuk. SubnetId

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}$

Wajib: Tidak

IpAddressType

Jenis alamat IP untuk target pemasangan. Nilai yang mungkin adalah IPV4_ONLY (hanya IPv4 alamat), IPV6_ONLY (hanya IPv6 alamat), dan DUAL_STACK (dual-stack, keduanya IPv4 dan IPv6 alamat). Jika Anda tidak menentukanIpAddressType, maka IPV4_ONLY digunakan.

catatan

IPAddressTypeHarus cocok dengan jenis IP subnet. Selain itu, IPAddressType parameter mengesampingkan nilai yang ditetapkan sebagai alamat IP default untuk subnet di VPC. Misalnya, jika IPAddressType is IPV4_ONLY dan AssignIpv6AddressOnCreation istrue, maka IPv4 digunakan untuk target mount. Untuk informasi selengkapnya, lihat Memodifikasi atribut pengalamatan IP subnet Anda.

Tipe: String

Nilai yang Valid: IPV4_ONLY | IPV6_ONLY | DUAL_STACK

Wajib: Tidak

Ipv6Address

Jika target IPAddressType untuk mount adalah IPv6 (IPV6_ONLYatauDUAL_STACK), maka tentukan IPv6 alamat yang akan digunakan. Jika Anda tidak menentukanIpv6Address, Amazon EFS memilih alamat IP yang tidak digunakan dari subnet yang ditentukan untuk. SubnetId

Tipe: String

Batasan Panjang: Panjang minimum 3. Panjang maksimum 39.

Wajib: Tidak

SecurityGroups

Grup keamanan VPC IDs, dari formulir. sg-xxxxxxxx Ini harus untuk VPC yang sama dengan subnet yang ditentukan. Jumlah maksimum grup keamanan tergantung pada kuota akun. Untuk informasi selengkapnya, lihat Kuota VPC Amazon di Panduan Pengguna Amazon VPC (lihat tabel Grup Keamanan). Jika Anda tidak menentukan grup keamanan, Amazon EFS menggunakan grup keamanan default untuk VPC 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}

Wajib: Tidak

SubnetId

ID subnet yang diambahkan target pemasangan. Untuk sistem file One Zone, gunakan subnet yang terkait dengan Availability Zone sistem file. Jenis subnet harus tipe yang sama denganIpAddressType.

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",
   "Ipv6Address": "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-east-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-masing Akun AWS. Misalnya, Availability Zone us-east-1a untuk Anda Akun AWS mungkin bukan lokasi yang sama dengan us-east-1a yang lain Akun 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

IPv4 Alamat untuk target pemasangan.

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}$

Ipv6Address

IPv6 Alamat untuk target pemasangan.

Tipe: String

Batasan Panjang: Panjang minimum 3. Panjang maksimum 39.

LifeCycleState

Status siklus hidup target pemasangan.

Tipe: String

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 AWS ID 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 ditentukan untuk target mount berbeda dari Availability Zone sistem file. 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 alamat IP (IpAddressatauIpv6Address) 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 spesifik Wilayah 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

Tidak Ipv6Address dikembalikan IpAddress atau disediakan dalam permintaan dan tidak ada alamat IP gratis di subnet yang ditentukan.

Kode Status HTTP: 409

SecurityGroupLimitExceeded

Dikembalikan jika jumlah SecurityGroups yang ditentukan dalam permintaan lebih besar dari batas, yang didasarkan pada kuota akun. Hapus beberapa grup keamanan atau minta kuota akun dinaikkan. Untuk informasi selengkapnya, lihat Kuota VPC Amazon di Panduan Pengguna Amazon VPC (lihat tabel Grup Keamanan).

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

Buat target pemasangan di IPv4 alamat yang tersedia di subnet

Permintaan berikut hanya menentukan sistem file dan subnet untuk target mount. Target dibuat pada IPv4 alamat yang tersedia di subnet yang ditentukan, dengan grup keamanan default yang terkait dengan VPC.

Permintaan Sampel


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

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "NetworkInterfaceId":"eni-1bcb7772"
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Buat target pemasangan di IPv4 alamat tertentu

Permintaan berikut menentukan sistem file, subnet, grup keamanan, dan IPv4 alamat yang akan digunakan untuk target mount.

Permintaan Sampel


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"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Buat target pemasangan di IPv6 alamat tertentu

Permintaan berikut menentukan sistem file, subnet, grup keamanan, dan IPv6 alamat yang akan digunakan untuk target mount.

Permintaan Sampel


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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

Buat target pemasangan di IPv4 alamat yang tersedia di subnet dual-stack

Permintaan berikut menentukan sistem file, subnet, dan jenis alamat untuk target mount. Target dibuat pada IPv4 alamat yang tersedia pada subnet dual-stack yang ditentukan, dengan grup keamanan default yang terkait dengan VPC.

Permintaan Sampel


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

{
    "OwnerId": "251839141158",
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId":"subnet-fd04ff94",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Buat target mount pada Ipv4 tertentu dan IPv6 alamat pada subnet dual-stack

Permintaan berikut menentukan sistem file, subnet, grup keamanan, IPv4 alamat, IPv6 alamat untuk target mount. Target dibuat pada yang ditentukan IPv4 dan IPv6 alamat pada subnet dual-stack.

Permintaan Sampel


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",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "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": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "10.0.1.25",
    "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

Lihat Juga

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

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CreateFileSystem

CreateReplicationConfiguration