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 EC2 instance dengan menggunakan target mount.
Anda dapat membuat satu target pemasangan di setiap Availability Zone diVPC. Semua EC2 instance di dalam Availability Zone tertentu berbagi target mount tunggal untuk sistem file tertentu. VPC Jika Anda memiliki beberapa subnet di Availability Zone, Anda membuat target mount di salah satu subnet. EC2instance 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 AmazonEFS: 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:
-
VPCDi mana Amazon EFS membuat target pemasangan
-
Availability Zone di mana Amazon EFS membuat target mount
-
Rentang alamat IP dari mana Amazon EFS memilih alamat IP dari target mount (jika Anda tidak menentukan alamat IP dalam permintaan)
-
Setelah membuat target pemasangan, Amazon EFS mengembalikan respons yang menyertakan, a MountTargetId
danIpAddress
. Anda menggunakan alamat IP ini saat memasang sistem file dalam sebuah EC2 instance. Anda juga dapat menggunakan DNS nama target mount saat memasang sistem file. EC2Instance tempat Anda memasang sistem file dengan menggunakan target mount dapat menyelesaikan DNS nama 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 satuVPC, 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 milik yang VPC 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 EC2CreateNetworkInterface
panggilan Amazon ketika 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 subnet. VPC -
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 EFS pemasangan Amazon memiliki satu antarmuka jaringan yang dikelola pemohon yang EC2 sesuai. Setelah antarmuka jaringan dibuat, Amazon EFS menetapkan
NetworkInterfaceId
bidang dalam deskripsi target mount 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 EC2 tindakan Amazon berikut:
-
ec2:DescribeSubnets
-
ec2:DescribeNetworkInterfaces
-
ec2:CreateNetworkInterface
Sintaks Permintaan
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string
",
"IpAddress": "string
",
"SecurityGroups": [ "string
" ],
"SubnetId": "string
"
}
URIParameter Permintaan
Permintaan tidak menggunakan URI parameter apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam JSON format.
- 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
-
IPv4Alamat 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 kelompok VPC keamananIDs, dari formulir
sg-xxxxxxxx
. Ini harus sama dengan subnet VPC yang ditentukan.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.
Data berikut dikembalikan dalam JSON format oleh layanan.
- 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 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 EFS dibuat Amazon 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 cloud pribadi virtual (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.
HTTPKode Status: 400
- BadRequest
-
Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang.
HTTPKode Status: 400
- FileSystemNotFound
-
Dikembalikan jika
FileSystemId
nilai yang ditentukan tidak ada di pemohon. Akun AWSHTTPKode Status: 404
- IncorrectFileSystemLifeCycleState
-
Dikembalikan jika status siklus hidup sistem file tidak “tersedia”.
HTTPKode Status: 409
- InternalServerError
-
Dikembalikan jika terjadi kesalahan di sisi server.
HTTPKode Status: 500
- IpAddressInUse
-
Dikembalikan jika permintaan ditentukan
IpAddress
yang sudah digunakan di subnet.HTTPKode Status: 409
- MountTargetConflict
-
Dikembalikan jika target pemasangan akan melanggar salah satu batasan yang ditentukan berdasarkan target pemasangan sistem file yang ada.
HTTPKode Status: 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 VPCKuota Amazon di Panduan VPC Pengguna Amazon (lihat entri Antarmuka jaringan per Wilayah di tabel Antarmuka jaringan).
HTTPKode Status: 409
- NoFreeAddressesInSubnet
-
Dikembalikan jika
IpAddress
tidak ditentukan dalam permintaan dan tidak ada alamat IP gratis di subnet.HTTPKode Status: 409
- SecurityGroupLimitExceeded
-
Dikembalikan jika ukuran
SecurityGroups
yang ditentukan dalam permintaan lebih besar dari lima.HTTPKode Status: 400
- SecurityGroupNotFound
-
Dikembalikan jika salah satu grup keamanan yang ditentukan tidak ada di cloud pribadi virtual subnet (VPC).
HTTPKode Status: 400
- SubnetNotFound
-
Dikembalikan jika tidak ada subnet dengan ID
SubnetId
yang disediakan dalam permintaan.HTTPKode Status: 400
- UnsupportedAvailabilityZone
-
Dikembalikan jika EFS fungsionalitas Amazon yang diminta tidak tersedia di Availability Zone yang ditentukan.
HTTPKode Status: 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 for theSecurityGroups
.
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 ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: