Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
API Amazon EFS
API Amazon EFS adalah protokol jaringan berdasarkan HTTP (RFC 2616)
Amazon EFS API adalah model RPC. Dalam model ini, ada satu set tetap operasi dan sintaks untuk setiap operasi diketahui klien tanpa interaksi sebelumnya. Di 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 di mana peta permintaan yang diberikan ditentukan oleh kombinasi metode permintaan ini (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-nama operasiCreateFileSystem, seperti, tidak muncul pada kabel, nama-nama ini berarti dalam kebijakanAWS Identity and Access Management (IAM). Untuk informasi selengkapnya, lihat Manajemen identitas dan akses untuk Amazon EFS.
Nama operasi juga digunakan untuk nama perintah dalam alat baris perintah dan elemen dari API AWS SDK. Misalnya, adaAWS CLI perintah bernamacreate-file-system yang memetakan keCreateFileSystem operasi.
Nama operasi juga muncul diAWS CloudTrail log untuk panggilan API Amazon EFS.
Titik akhir API REST
Titik akhir API adalah nama DNS yang digunakan sebagai host di HTTP URI untuk panggilan API. Titik akhir API ini khusus untukWilayah AWS dan berbentuk sebagai 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 daftar yangWilayah AWS didukung Amazon EFS (tempat Anda dapat membuat dan mengelola sistem file), lihat Amazon Elastic File System di Referensi Umum AWS.
Titik akhir API khusus Wilayah menentukan cakupan sumber daya Amazon EFS yang dapat diakses saat Anda membuat panggilan API. Misalnya, saat Anda memanggilDescribeFileSystems operasi 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.
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 API Amazon EFS dibatasi untuk masing-masingAkun AWS berdasarkan per-wilayah untuk membantu kinerja layanan. Semua panggilan API Amazon EFS bersama-sama, baik yang berasal dari aplikasi, konsol Amazon EFS, tidak boleh melebihi tingkat permintaan API maksimum yang diizinkan.AWS CLI Tingkat permintaan API maksimum dapat bervariasiWilayah AWS. Permintaan API yang dibuat dikaitkan dengan yang mendasarinyaAkun AWS.
Jika permintaan API melebihi tingkat permintaan API untuk kategorinya, permintaan akan mengembalikan kodeThrottlingException kesalahan. Untuk mencegah kesalahan ini, pastikan aplikasi Anda tidak mencoba lagi permintaan API dengan kecepatan tinggi. Anda dapat melakukan ini dengan menggunakan hati-hati ketika polling dan dengan menggunakan retries backoff eksponensial.
Polling
Aplikasi Anda mungkin perlu memanggil operasi API berulang kali untuk memeriksa pembaruan status. Sebelum Anda memulai polling, berikan waktu permintaan untuk berpotensi menyelesaikan. Saat Anda memulai polling, 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 untuk memproses beberapa sumber daya (misalnya, semua sistem file Amazon EFS Anda). Untuk merendahkan tingkat 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 selengkapnya, dan contoh implementasi dari algoritme ini, lihat Pengulang Kesalahan dan Backoff EksponensialAWS di dalamReferensi Umum Amazon Web Services.
