API Amazon EFS - Amazon Elastic File System

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

API Amazon EFS

Amazon EFS API adalah protokol jaringan berdasarkanHTTP (RFC 2616). Untuk setiap panggilan API, Anda membuat permintaan HTTP ke titik akhir API Amazon EFS khusus wilayah untukWilayah AWSdi mana Anda ingin mengelola sistem file. API menggunakan dokumen JSON (RFC 4627) untuk badan permintaan/respons HTTP.

Amazon EFS API adalah model RPC. Dalam model ini, ada satu set tetap operasi dan sintaks untuk setiap operasi diketahui klien tanpa interaksi sebelumnya. Pada bagian berikutnya, Anda dapat menemukan deskripsi dari setiap operasi API menggunakan notasi RPC abstrak. Masing-masing memiliki nama operasi yang tidak muncul di kawat. Untuk setiap operasi, topik menentukan pemetaan untuk elemen permintaan HTTP.

Operasi Amazon EFS yang ditentukan oleh kombinasi metode permintaan tertentu (GET, PUT, POST, atau DELETE) dan di mana berbagai pola yang sesuai dengan Request-URI-nya. Jika operasi PUT atau POST, Amazon EFS mengekstrak argumen panggilan dari segmen jalur Request-URI, parameter kueri, dan objek JSON di isi permintaan.

catatan

Meskipun nama operasi, sepertiCreateFileSystem, tidak muncul di kawat, nama-nama ini bermakna dalamAWS Identity and Access Management(IAM) kebijakan. Untuk informasi selengkapnya, lihat Identity and Access Management untuk Amazon EFS.

Nama operasi juga digunakan untuk nama perintah dalam alat baris perintah dan elemen dari API AWS SDK. Misalnya, adaAWS CLIperintah bernamacreate-file-systembahwa peta keCreateFileSystemoperasi.

Nama operasi juga muncul diAWS CloudTraillog untuk panggilan API Amazon EFS.

Titik Akhir API

Titik akhir API adalah nama DNS yang digunakan sebagai host di HTTP URI untuk panggilan API. Endpoint API ini khusus untukWilayah AWSdan ambil formulir berikut.

elasticfilesystem.aws-region.amazonaws.com

Misalnya, titik akhir API Amazon EFS untuk Wilayah US West (Oregon) adalah sebagai berikut.

elasticfilesystem.us-west-2.amazonaws.com

Untuk daftarWilayah AWSs yang Amazon EFS mendukung (di mana Anda dapat membuat dan mengelola sistem file), lihatAmazon Elastic File Systemdi dalamAWSReferensi Umum.

Titik akhir API khusus Wilayah menentukan cakupan sumber daya Amazon EFS yang dapat diakses saat Anda membuat panggilan API. Misalnya, saat Anda memanggilDescribeFileSystemsoperasi menggunakan titik akhir sebelumnya, Anda mendapatkan daftar sistem file di Wilayah US West (Oregon) yang telah dibuat di akun Anda.

Versi API

Versi API yang digunakan untuk panggilan diidentifikasi oleh segmen jalur pertama dari permintaan URI, dan bentuknya adalah tanggal ISO 8601. Sebagai contoh, lihat CreateFileSystem.

Dokumentasi menjelaskan versi API 2015-02-01.

Bagian berikut menyediakan deskripsi operasi API, cara membuat tanda tangan untuk otentikasi permintaan, dan cara memberikan izin untuk operasi API ini menggunakan kebijakan IAM.

Bekerja dengan tingkat permintaan API kueri untuk Amazon EFS

Permintaan API Amazon EFS dicekik untuk masing-masingAkun AWSberdasarkan wilayah untuk membantu kinerja layanan. Semua Amazon EFS API panggilan bersama-sama, apakah mereka berasal dari aplikasi,AWS CLI, atau konsol Amazon EFS, tidak boleh melebihi tingkat permintaan maksimum API yang diizinkan. Tingkat permintaan API maksimum dapat bervariasi di seluruhWilayah AWSS. Permintaan API yang dibuat olehAWS Identity and Access Management(IAM) pengguna dikaitkan dengan yang mendasariAkun AWS.

Jika permintaan API melebihi tingkat permintaan API untuk kategorinya, permintaan akan mengembalikanThrottlingExceptionkode kesalahan. Untuk mencegah kesalahan ini, pastikan bahwa aplikasi Anda tidak mencoba kembali permintaan API pada tingkat tinggi. Anda dapat melakukan ini dengan menggunakan perawatan saat polling dan dengan menggunakan retries backoff eksponensial.

Pemungutan Suara

Aplikasi Anda mungkin perlu memanggil operasi API berulang kali untuk memeriksa pembaruan status. Sebelum memulai pemungutan suara, berikan waktu permintaan untuk berpotensi selesai. Saat Anda memulai pemungutan suara, gunakan interval tidur yang sesuai antara permintaan berturut-turut. Untuk hasil terbaik, gunakan interval tidur yang meningkat.

Pemrosesan coba ulang atau batch

Aplikasi Anda mungkin perlu mencoba kembali permintaan API setelah gagal, atau memproses beberapa sumber daya (misalnya, semua sistem file Amazon EFS Anda). Untuk menurunkan laju permintaan API, gunakan interval tidur yang sesuai antara permintaan berturut-turut. Untuk hasil terbaik, gunakan interval tidur yang meningkat atau variabel.

Menghitung interval tidur

Ketika Anda harus melakukan polling atau mencoba lagi permintaan API, sebaiknya gunakan algoritme backoff eksponensial untuk menghitung interval tidur antara panggilan API. Ide di balik backoff eksponensial adalah menggunakan waktu tunggu yang semakin lama antara percobaan ulang untuk respons kesalahan yang berurutan. Untuk informasi lebih lanjut, dan contoh implementasi dari algoritme ini, lihatPengulang Kesalahan dan Backoff Eksponensial diAWSdi dalamReferensi Umum Amazon Web Services.