Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Amazon EFS API adalah protokol jaringan berbasis HTTP (RFC 2616
Amazon EFS API adalah model RPC. Dalam model ini, ada satu set operasi tetap dan sintaks untuk setiap operasi diketahui klien tanpa interaksi sebelumnya. Di bagian berikut, Anda dapat menemukan deskripsi dari setiap operasi API menggunakan notasi RPC abstrak. Masing-masing memiliki nama operasi yang tidak muncul di kabel. Untuk setiap operasi, topik menentukan pemetaan untuk elemen permintaan HTTP.
Operasi Amazon EFS spesifik yang menjadi peta permintaan tertentu ditentukan oleh kombinasi metode permintaan (GET, PUT, POST, atau DELETE) dan pola mana yang cocok dengan Request-URI. Jika operasinya PUT atau POST, Amazon EFS mengekstrak argumen panggilan dari segmen jalur request-URI, parameter kueri, dan objek JSON di badan permintaan.
catatan
Meskipun nama operasi, sepertiCreateFileSystem, tidak muncul di kawat, nama-nama ini berarti dalam kebijakan AWS Identity and Access Management (IAM). Untuk informasi selengkapnya, lihat Manajemen identitas dan akses untuk Amazon EFS.
Nama operasi juga digunakan untuk memberi nama perintah dalam alat baris perintah dan elemen SDK AWS . APIs Misalnya, ada AWS CLI perintah bernama create-file-system yang memetakan ke CreateFileSystem operasi.
Nama operasi juga muncul di AWS CloudTrail log untuk panggilan Amazon EFS API.
Titik akhir API
Titik akhir API adalah nama DNS yang digunakan sebagai host di URI HTTP untuk panggilan API. Titik akhir API ini khusus untuk Wilayah AWS dan mengambil formulir berikut.
elasticfilesystem.aws-region.amazonaws.com
Misalnya, titik akhir Amazon EFS API untuk Wilayah AS Barat (Oregon) adalah sebagai berikut.
elasticfilesystem---us-west-2.amazonaws.com.rproxy.goskope.comUntuk daftar Wilayah AWS s yang didukung Amazon EFS (tempat Anda dapat membuat dan mengelola sistem file), lihat Amazon Elastic File System di file Referensi Umum AWS.
Titik akhir API khusus wilayah menentukan cakupan sumber daya Amazon EFS yang dapat diakses saat Anda melakukan panggilan API. Misalnya, ketika Anda memanggil DescribeFileSystems operasi menggunakan endpoint sebelumnya, Anda mendapatkan daftar sistem file di Wilayah AS Barat (Oregon) yang telah dibuat di akun Anda.
Versi API
Versi API yang digunakan untuk panggilan diidentifikasi oleh segmen jalur pertama dari URI permintaan, dan bentuknya adalah tanggal ISO 8601. Sebagai contoh, lihat CreateFileSystem.
Dokumentasi menjelaskan versi API 2015-02-01.
Topik terkait
Bagian berikut memberikan 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 Amazon EFS API dibatasi untuk masing-masing Akun AWS berdasarkan per wilayah untuk membantu kinerja layanan. Semua panggilan Amazon EFS API bersama-sama, baik yang berasal dari aplikasi, konsol Amazon EFS AWS CLI, atau Amazon EFS, tidak boleh melebihi tingkat permintaan API maksimum yang diizinkan. Tingkat permintaan API maksimum dapat bervariasi Wilayah AWS. Permintaan API yang dibuat dikaitkan dengan yang mendasarinya Akun AWS.
Jika permintaan API melebihi tingkat permintaan API untuk kategorinya, permintaan akan mengembalikan kode ThrottlingException kesalahan. Untuk mencegah kesalahan ini, pastikan aplikasi Anda tidak mencoba lagi permintaan API dengan kecepatan tinggi. Anda dapat melakukan ini dengan berhati-hati saat melakukan polling dan dengan menggunakan percobaan ulang backoff eksponensial.
Pemungutan Suara
Aplikasi Anda mungkin perlu memanggil operasi API berulang kali untuk memeriksa pembaruan dalam status. Sebelum Anda memulai polling, berikan waktu permintaan untuk berpotensi selesai. Saat Anda memulai polling, gunakan interval tidur yang sesuai di antara permintaan yang berurutan. Untuk hasil terbaik, gunakan interval tidur yang meningkat.
Pemrosesan coba ulang atau batch
Aplikasi Anda mungkin perlu mencoba ulang permintaan API setelah gagal, atau untuk memproses beberapa sumber daya (misalnya, semua sistem file Amazon EFS Anda). Untuk menurunkan tingkat permintaan API, gunakan interval tidur yang sesuai di antara permintaan yang berurutan. 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 selengkapnya, dan contoh implementasi algoritme ini, lihat Error Retries and Exponential Backoff di. AWSReferensi Umum Amazon Web Services
