CreateMountTarget - Sistem File Elastis Amazon

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 menyediakanIpAddress, Amazon EFS menetapkan alamat IP tersebut ke antarmuka jaringan. Jika tidak, Amazon EFS memberikan alamat gratis di subnet (dengan cara yang sama seperti EC2 CreateNetworkInterface panggilan Amazon ketika 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 subnet. VPC

    • 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 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, 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 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 formulirsg-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 AWS

Jenis: 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.

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 AWS

HTTPKode 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: