View a markdown version of this page

Memanggil API IAM menggunakan permintaan kueri HTTP - AWS Identity and Access Management
Titik akhirHTTPS diperlukanMenandatangani permintaan API IAM

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

Memanggil API IAM menggunakan permintaan kueri HTTP

Anda dapat mengakses IAM dan AWS STS layanan secara terprogram menggunakan Query API. Permintaan API Kueri adalah permintaan HTTPS yang harus berisi parameter Action untuk menunjukkan tindakan yang akan dilakukan. IAM dan AWS STS mendukung permintaan GET dan POST untuk semua tindakan. Artinya, API tidak mewajibkan Anda menggunakan GET untuk beberapa tindakan dan POST untuk yang lainnya. Namun, permintaan GET harus memenuhi ukuran batas dari URL; meskipun batas ini bergantung pada browser, batas umumnya adalah 2048 byte. Oleh karena itu, untuk permintaan API Kueri yang memerlukan ukuran lebih besar, Anda harus menggunakan permintaan POST.

Responsnya adalah dokumen XML. Untuk detail tentang respons, lihat halaman tindakan individual di Referensi API IAM atau Referensi AWS Security Token Service API.

Tip

Alih-alih melakukan panggilan langsung ke operasi IAM atau AWS STS API, Anda dapat menggunakan salah satu SDK AWS . AWS SDK terdiri dari pustaka dan kode sampel untuk berbagai bahasa pemrograman dan platform (Java, Ruby, .NET, iOS, Android, dll.). SDK menyediakan cara mudah untuk membuat akses terprogram ke IAM dan. AWS Misalnya, SDK menangani tugas seperti menandatangani permintaan secara kriptografis (lihat di bawah ini), mengelola kesalahan, dan mencoba kembali permintaan secara otomatis. Untuk informasi tentang AWS SDK, termasuk cara mengunduh dan menginstalnya, lihat halaman Alat untuk Amazon Web Services.

Untuk detail tentang tindakan dan kesalahan API, lihat Referensi API IAM atau Referensi AWS Security Token Service API.

Titik akhir

IAM dan AWS STS masing-masing memiliki titik akhir global tunggal:

penting

AWS STS juga mendukung pengiriman permintaan ke titik akhir regional selain titik akhir global. AWS merekomendasikan penggunaan titik akhir regional alih-alih titik akhir global untuk mengurangi latensi, membangun redundansi, dan meningkatkan validitas token sesi. Sebelum Anda dapat menggunakan AWS STS di Wilayah, Anda harus terlebih dahulu mengaktifkan STS di Wilayah itu untuk Anda Akun AWS. Untuk informasi selengkapnya tentang mengaktifkan Wilayah tambahan untuk AWS STS, lihatKelola AWS STS dalam sebuah Wilayah AWS.

Untuk informasi selengkapnya tentang AWS titik akhir dan Wilayah untuk semua layanan, lihat T itik akhir layanan dan kuota di. Referensi Umum AWS

HTTPS diperlukan

Karena API Kueri mengembalikan informasi sensitif seperti kredensial keamanan, Anda harus menggunakan HTTPS dengan semua permintaan API.

Menandatangani permintaan API IAM

Permintaan harus ditandatangani menggunakan access key ID dan secret access key. Kami sangat menyarankan agar Anda tidak menggunakan Pengguna root akun AWS kredenSIAL Anda untuk pekerjaan sehari-hari dengan IAM. Anda dapat menggunakan kredenSIAL untuk pengguna IAM atau Anda dapat menggunakan AWS STS untuk menghasilkan kredenSIAL keamanan sementara.

Untuk menandatangani permintaan API Anda, sebaiknya gunakan AWS Signature Version 4. Untuk informasi tentang menggunakan Tanda Tangan Versi 4, kunjungi Proses Penandatanganan Tanda Tangan Versi 4 di Referensi Umum AWS .

Jika Anda perlu menggunakan Signature Versi 2, informasi tentang menggunakan Signature Versi 2 tersedia di Referensi Umum AWS.

Untuk informasi selengkapnya, lihat berikut ini: