Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 menyediakan
IpAddress
, Amazon EFS menetapkan alamat IP tersebut ke antarmuka jaringan. Jika tidak, Amazon EFS memberikan alamat gratis di subnet (dengan cara yang sama seperti panggilan AmazonCreateNetworkInterface
EC2 saat permintaan tidak menentukan alamat IP pribadi utama). -
Jika permintaan menyediakan
SecurityGroups
, 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, danfs-id
merupakan.FileSystemId
-
Menetapkan
requesterManaged
properti antarmuka jaringan ketrue
, danrequesterId
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, danIpAddress
bidang ke alamatnya. Jika pembuatan antarmuka jaringan gagal, seluruhCreateMountTarget
operasi gagal. -
catatan
CreateMountTarget
Panggilan 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
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.
Jenis: 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
-
Alamat IPv4 yang valid dalam rentang alamat subnet yang ditentukan.
Jenis: 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
- 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}
Wajib: Tidak
- SubnetId
-
ID subnet yang diambahkan target pemasangan. Untuk sistem file One Zone, gunakan subnet yang terkait dengan Availability Zone sistem file.
Jenis: 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
-
Pengenal 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 AWSJenis: 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 lokasi Anda Akun AWS mungkin bukan lokasi yang sama denganus-east-1a
yang lain Akun AWS.Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.
Pola:
.+
- FileSystemId
-
ID sistem file tempat target mount dimaksudkan.
Jenis: 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.
Jenis: 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.
Jenis: String
Nilai yang Valid:
creating | available | updating | deleting | deleted | error
- MountTargetId
-
ID target pemasangan yang ditetapkan sistem.
Jenis: 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.
Jenis: String
- OwnerId
-
Akun AWS ID yang memiliki sumber daya.
Jenis: String
Kendala Panjang: Panjang maksimum 14.
Pola:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- SubnetId
-
ID subnet target mount.
Jenis: 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.
Jenis: 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 AWSKode 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 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
-
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
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
{
"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.
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"
}
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: