Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menggunakan API untuk Amazon EC2
penting
Pada 14 Oktober 2022, tanggapan HTTP dari Amazon EC2 API tidak lagi menyertakan elemen alasan-frasa. Seperti yang direkomendasikan oleh RFC7230
Kami menyediakan Query API untuk Amazon EC2, serta perangkat pengembangan perangkat lunak (SDK) AWS yang memungkinkan Anda mengakses Amazon EC2 dari bahasa pemrograman pilihan Anda. Untuk informasi selengkapnya, lihat Panduan Pengembang Amazon EC2.
Daftar Isi
Pengetahuan yang dibutuhkan
Jika Anda berencana untuk mengakses Amazon EC2 melalui API, Anda harus terbiasa dengan hal berikut:
-
XML
-
Layanan web
-
Permintaan HTTP
-
Satu atau lebih bahasa pemrograman, seperti Java, PHP, Perl, Python, Ruby, C #, atau C ++.
API yang tersedia untuk Amazon EC2
Amazon EC2 Query API menyediakan permintaan HTTP atau HTTPS yang menggunakan kata kerja HTTP GET atau POST dan parameter Query bernamaAction.
AWS menyediakan pustaka, kode sampel, tutorial, dan sumber daya lainnya untuk pengembang perangkat lunak yang lebih suka membangun aplikasi menggunakan API khusus bahasa daripada mengirimkan permintaan melalui HTTP atau HTTPS. Pustaka ini menyediakan fungsi dasar yang secara otomatis menangani tugas-tugas seperti menandatangani permintaan Anda secara kriptografis, mencoba kembali permintaan, dan menangani respons kesalahan, sehingga lebih mudah bagi Anda untuk memulai.
Untuk informasi selengkapnya, lihat Membuat sumber daya Amazon EC2 menggunakan AWS SDK di Panduan Pengembang Amazon EC2.
Parameter kueri umum
Sebagian besar tindakan Amazon EC2 API mendukung parameter yang dijelaskan dalam tabel berikut. Parameter umum bervariasi tergantung pada apakah Anda menggunakan Tanda Tangan Versi 2 atau Tanda Tangan Versi 4 untuk menandatangani permintaan Anda. Untuk informasi selengkapnya, lihat AWS Men andatangani permintaan API di Panduan Pengguna IAM.
Parameter untuk Tanda Tangan Versi 4
| Nama | Deskripsi | Diperlukan |
|---|---|---|
|
|
Tindakan yang harus dilakukan. Contoh: |
Ya |
|
|
Versi API yang akan digunakan. |
Ya |
|
|
Algoritma hash yang Anda gunakan untuk membuat tanda tangan permintaan. Contoh: |
Ya |
|
|
Ruang lingkup kredenSIAL untuk permintaan, dalam format Contoh: |
Ya |
|
|
Tanggal dan waktu di mana permintaan ditandatangani, dalam format YYYYMMDDTHHMMSSZ. Tanggal harus sesuai dengan tanggal yang disertakan dalam cakupan kredensi untuk Contoh: |
Ya |
X-Amz-SignedHeaders |
Header yang Anda sertakan sebagai bagian dari permintaan. Minimal, Anda harus menyertakan Contoh: |
Ya |
|
|
Tanda tangan yang berasal dari kunci akses rahasia Anda. Contoh: |
Ya |
|
|
Token keamanan sementara diperoleh melalui panggilan ke AWS Security Token Service. Contoh: |
Tidak |
|
|
Memeriksa apakah Anda memiliki izin yang diperlukan untuk tindakan tersebut, tanpa benar-benar membuat permintaan. Jika Anda memiliki izin yang diperlukan, permintaan akan kembali |
Tidak |
X-Amz-SignatureParam X-Amz-Algorithm eter X-Amz-CredentialX-Amz-SignedHeaders,,, dan dapat ditentukan sebagai parameter terpisah dalam string kueri, atau nilainya dapat dimasukkan dalam satu Authorization header. Untuk informasi selengkapnya, lihat AWS Men andatangani permintaan API di Panduan Pengguna IAM.
Parameter untuk Tanda Tangan Versi 2
| Nama | Deskripsi | Diperlukan |
|---|---|---|
|
|
Tindakan yang harus dilakukan. Contoh: |
Ya |
|
|
Versi API yang akan digunakan. |
Ya |
|
|
ID kunci akses untuk pengirim permintaan. Ini mengidentifikasi akun yang akan dikenakan biaya untuk penggunaan layanan. Akun yang terkait dengan ID kunci akses harus terdaftar untuk Amazon EC2, atau permintaan tidak diterima. Contoh: |
Ya |
|
|
Tanggal dan waktu di mana tanda tangan yang termasuk dalam permintaan berakhir, dalam format YYYY-MM-DDThh:mm:ssZ. Untuk informasi selengkapnya, lihat ISO 8601 Contoh: |
Bersyarat. Permintaan harus menyertakan salah Timestamp satu atauExpires, tetapi tidak dapat berisi keduanya. |
|
|
Tanggal dan waktu di mana permintaan ditandatangani, dalam format YYYY-MM-DDThh:mm:ssZ. Untuk informasi selengkapnya, lihat ISO 8601 Contoh: |
Bersyarat. Permintaan harus menyertakan salah Timestamp satu atauExpires, tetapi tidak dapat berisi keduanya. |
|
|
Tanda tangan permintaan. Contoh: |
Ya |
|
|
Algoritma hash yang Anda gunakan untuk membuat tanda tangan permintaan. Nilai yang valid: Contoh: |
Ya |
|
|
Versi tanda tangan yang Anda gunakan untuk menandatangani permintaan. Tetapkan nilai ini ke Contoh: |
Ya |
|
|
Memeriksa apakah Anda memiliki izin yang diperlukan untuk tindakan tersebut, tanpa benar-benar membuat permintaan. Jika Anda memiliki izin yang diperlukan, permintaan akan kembali |
Tidak |
|
|
Token keamanan sementara diperoleh melalui panggilan ke AWS Security Token Service. Contoh: |
Tidak |
Nilai parameter harus URL-encoded. Hal ini berlaku untuk setiap parameter Kueri yang diteruskan ke Amazon EC2 dan biasanya diperlukan dalam Signature parameter. Beberapa klien melakukan ini secara otomatis, tetapi ini bukan norma.
