Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Gunakan kunci API untuk mengotentikasi dengan Grafana HTTP API
Salah satu cara untuk mengakses API Grafana adalah dengan menggunakan kunci API, yang juga disebut token API. Untuk membuat kunci API, gunakan salah satu prosedur berikut. Kunci API berlaku untuk waktu terbatas yang Anda tentukan saat Anda membuatnya, hingga 30 hari.
Topik
penting
Kunci API tidak digunakan lagi dan telah dihapus di Amazon Managed Grafana versi 12. Gunakan akun layanan sebagai gantinya. Untuk informasi selengkapnya, lihat Gunakan akun layanan untuk mengautentikasi dengan Grafana HTTP API.
Saat Anda membuat kunci API, Anda menentukan peran untuk kunci tersebut. Peran menentukan tingkat kekuatan administratif yang dimiliki pengguna kunci.
Tabel berikut menunjukkan izin yang diberikan kepada peran Admin, Editor, dan Penampil. Tabel pertama menunjukkan izin organisasi umum. Dalam tabel ini, Penuh berarti kemampuan untuk melihat, mengedit, menambahkan izin, dan menghapus izin. Kolom Jelajahi menunjukkan apakah peran dapat menggunakan tampilan Jelajahi. Kolom izin lain menunjukkan apakah peran tersebut memiliki izin untuk mengelola pengguna, tim, plug-in, dan pengaturan organisasi.
| Peran | Dasbor | Daftar Putar | Folder | Jelajahi | Sumber data | Izin lainnya |
|---|---|---|---|---|---|---|
|
Penampil |
Tampilan | Tampilan | Tidak | Tidak | Tidak | Tidak |
|
Penyunting |
Penuh | Penuh | Penuh | Ya | Tidak | Tidak |
|
Admin |
Penuh | Penuh | Penuh | Ya | Penuh | Penuh |
Tabel berikut menunjukkan izin tingkat dasbor dan folder tambahan yang dapat Anda tetapkan. Ini berbeda dari peran Admin, Editor, dan Penampil.
| Peran | Dasbor | Folder | Ubah izin |
|---|---|---|---|
|
Melihat |
Tampilan | Tampilan | Tidak |
|
Sunting |
Buat, edit | Tampilan | Tidak |
|
Admin |
Buat, edit, hapus | Buat, edit, hapus | Ya |
catatan
Izin yang lebih cakupan dengan tingkat izin yang lebih rendah tidak berpengaruh jika aturan yang lebih umum dengan izin lebih banyak ada. Misalnya, jika Anda memberi pengguna peran Editor organisasi dan kemudian menetapkan pengguna itu hanya izin Lihat untuk dasbor, izin T ampilan yang lebih ketat tidak berpengaruh karena pengguna memiliki akses Edit penuh karena peran Editornya.
Membuat kunci API Grafana untuk digunakan dengan API Grafana di ruang kerja (Konsol)
catatan
Di ruang kerja Grafana yang Dikelola Amazon yang kompatibel dengan Grafana versi 10 ke atas, kemampuan untuk membuat kunci API di ruang kerja telah dihapus. Jika ruang kerja Anda adalah ruang kerja Grafana versi 10, Anda hanya dapat membuat kunci API melalui AWS CLI atau API.
Kunci API tidak digunakan lagi dan telah dihapus di Amazon Managed Grafana versi 12. Gunakan akun layanan sebagai gantinya. Untuk informasi selengkapnya, lihat Gunakan akun layanan untuk mengautentikasi dengan Grafana HTTP API.
Untuk membuat kunci API Grafana untuk digunakan dengan API Grafana di konsol ruang kerja
-
Buka konsol Amazon Managed Grafana di https://console.aws.amazon.com/grafana/
. -
Di sudut kiri atas halaman, pilih ikon menu dan kemudian pilih Semua ruang kerja.
-
Pilih nama ruang kerja Grafana yang Dikelola Amazon.
-
Di halaman detail ruang kerja, pilih URL yang ditampilkan di bawah URL ruang kerja Grafana.
-
Di menu sisi konsol Grafana, jeda pada ikon Konfigurasi (roda gigi), lalu pilih API Keys.
-
Pilih Kunci API Baru.
-
Masukkan nama unik untuk kunci.
-
Untuk Per an, pilih tingkat akses yang akan diberikan kunci tersebut. Pilih Admin untuk mengizinkan pengguna dengan kunci ini menggunakan API di tingkat administrasi terluas dan paling kuat. Pilih Editor atau Pen ampil untuk membatasi pengguna kunci pada tingkat kekuatan tersebut. Untuk informasi lebih lanjut, lihat tabel sebelumnya.
-
Untuk Waktu untuk hidup, tentukan berapa lama Anda ingin kunci valid. Maksimal adalah 30 hari (satu bulan). Anda memasukkan angka dan huruf. Huruf yang valid adalah s untuk detik, m untuk menit, h untuk jam, d untuk hari, w untuk minggu, dan M untuk bulan. Misalnya, 12 jam adalah 12 jam dan 1M adalah 1 bulan (30 hari).
Kami sangat menyarankan Anda mengatur waktu kunci untuk hidup untuk waktu yang lebih singkat, seperti beberapa jam atau kurang. Ini menciptakan risiko yang jauh lebih kecil daripada memiliki kunci API yang valid untuk waktu yang lama.
-
Pilih Tambahkan.
-
(Opsional) Anda dapat mengotomatiskan pembuatan kunci API dengan Create API Key API API menggunakan Terraform. Untuk informasi selengkapnya tentang mengotomatiskan pembuatan kunci API menggunakan Terraform, lihat Membuat Kunci API Grafana menggunakan Terraform.
Membuat kunci API ruang kerja Grafana yang Dikelola Amazon menggunakan AWS CLI
Cara membuat kunci API ruang kerja Grafana yang Dikelola Amazon menggunakan AWS CLI
Dalam contoh berikut, gantikey_name,key_role, seconds_to_live dan workspace_id dengan informasi Anda sendiri. Untuk mengetahui tentang format nama kunci, peran kunci, dan seconds-to-live, lihat di panduan API. https://docs.aws.amazon.com/grafana/latest/APIReference/API_CreateWorkspaceApiKey.html
aws grafana create-workspace-api-key --key-name "key_name" --key-role "key_role" --seconds-to-liveseconds_to_live--workspace-id "workspace_id"
Berikut ini adalah contoh respons CLI:
Anda dapat menemukan ruang workspace_id kerja Anda dengan menjalankan perintah berikut:
aws grafana list-workspaces