Amazon EFS API - Sistem File Elastis Amazon
Titik akhir APIVersi APITopik terkaitBekerja dengan tingkat permintaan API kueri untuk Amazon EFS

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

Amazon EFS API

Amazon EFS API adalah protokol jaringan berbasis HTTP (RFC 2616). Untuk setiap panggilan API, Anda membuat permintaan HTTP ke titik akhir Amazon EFS API khusus wilayah untuk Wilayah AWS tempat 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 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

Endpoint adalah URL yang berfungsi sebagai titik masuk untuk layanan AWS web. Amazon EFS mendukung jenis titik akhir berikut:

  • IPv4 titik akhir

  • Dual-stack (keduanya IPv4 dan IPv6) titik akhir

  • Titik akhir FIPS

Saat Anda membuat permintaan, Anda dapat menentukan titik akhir yang akan digunakan. Jika Anda tidak menentukan titik akhir, IPv4 titik akhir digunakan secara default. Untuk menggunakan tipe titik akhir yang berbeda, Anda harus menentukannya dalam permintaan Anda. Untuk contoh cara melakukannya, lihat Menentukan titik akhir. Untuk tabel titik akhir yang tersedia, lihat titik akhir dan kuota Amazon EFS.

IPv4 titik akhir

IPv4 endpoint hanya mendukung IPv4 lalu lintas. IPv4 titik akhir tersedia untuk semua Wilayah. Format IPv4 titik akhir tergantung pada Wilayah.

  • Untuk IPv4 titik akhir di Wilayah AWS komersial, formatnya adalahelasticfilesystem.region.amazonaws.com.

    Misalnya, jika Anda menentukan elasticfilesystem.us-west-2.amazonaws.com sebagai titik akhir, kami mengarahkan permintaan Anda ke titik akhir Wilayah Barat (Oregon) AS (us-west-2).

  • Untuk IPv4 titik akhir di Wilayah Tiongkok, formatnya adalah. elasticfilesystem.region.amazonaws.com.rproxy.govskope.ca.cn

    Misalnya, titik akhir Amazon EFS API untuk Wilayah Tiongkok (Beijing) adalah. elasticfilesystem---cn-north-1.amazonaws.com.rproxy.govskope.ca.cn

Titik akhir tumpukan ganda (IPv4 dan IPv6)

Titik akhir dual-stack mendukung keduanya IPv4 dan lalu lintas. IPv6 Saat Anda membuat permintaan ke titik akhir dual-stack, URL endpoint akan diselesaikan ke alamat IPv6 atau IPv4 alamat, tergantung pada protokol yang digunakan oleh jaringan dan klien Anda. Format titik akhir dual-stack tergantung pada Region.

  • Untuk titik akhir tumpukan ganda di Wilayah AWS komersial, formatnya adalah. efs.aws-region.api.aws

    Misalnya, titik akhir tumpukan ganda untuk Wilayah Barat AS (Oregon) (us-west-2) adalah. efs.eu-west-2.api.aws

  • Untuk titik akhir tumpukan ganda di Wilayah Tiongkok, formatnya adalah. efs.region.api.amazonwebservices.com.rproxy.govskope.ca.cn

    Misalnya, titik akhir tumpukan ganda untuk Wilayah Tiongkok (Beijing) adalah. efs---cn-north-1---api.amazonwebservices.com.rproxy.govskope.ca.cn

Menentukan titik akhir

Contoh berikut menunjukkan cara menentukan titik akhir untuk Wilayah AS Barat (California Utara) (us-west-1) menggunakan untuk Amazon EFS. AWS CLI

IPv4

aws efs get-rest-apis --region us-west-1 --endpoint-url https://elasticfilesystem.us-west-1.amazonaws.com

Tumpukan ganda

aws efs get-rest-apis --region us-west-1 --endpoint-url https://efs.us-west-1.api.aws

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.

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 Coba lagi perilaku di.Referensi Umum Amazon Web Services