Contoh integrasi OpenAPI - ENS

Topik ini menjelaskan cara memanggil operasi DescribeEnsRegions menggunakan OpenAPI untuk mengkueri daftar Node Tepi ENS yang tersedia.

Langkah 1: Lihat dokumentasi OpenAPI

Sebelum memanggil OpenAPI, baca dokumen API terkait, DescribeEnsRegions, untuk memahami parameter yang diperlukan dan izin yang dibutuhkan. Untuk informasi selengkapnya, lihat Ikhtisar API.

Pada halaman Stacks, klik Create Stack. Di bagian Specify Template, klik Select an Existing Template.
Catatan
- Jika Anda memilih Create Template atau Infrastructure Composer, Anda akan diarahkan ke halaman yang sesuai.
Atur Template Import Method menjadi Enter Template Content, dan Template Content menjadi ROS. Kemudian, masukkan kode tersebut.

Langkah 2: Buat pengguna RAM dan berikan izin

Penting

Akun Alibaba Cloud memiliki izin akses untuk semua operasi API. Untuk akses API atau O&M rutin, buat dan gunakan pengguna RAM.

Anda dapat memanggil operasi ini menggunakan Akun Alibaba Cloud, pengguna Resource Access Management (RAM), atau peran RAM. Untuk informasi selengkapnya tentang perbedaan antara identitas-identitas ini, lihat Identitas.

Dalam topik ini, pengguna RAM digunakan untuk memanggil operasi API.

Buat Pengguna RAM.
1. Masuk ke Konsol RAM.
2. Di panel navigasi sebelah kiri, pilih Identity Management > Users.
3. Di halaman Users, klik Create User.
4. Pada halaman Create User, atur Logon Name dan Display Name. Atur Access Mode menjadi Console Access.
5. Klik OK.
  Setelah membuat pengguna RAM, catat nama logon dan kata sandinya. Anda akan memerlukannya untuk masuk ke Portal Pengembang OpenAPI Alibaba Cloud guna memanggil operasi OpenAPI.
Berikan izin kepada pengguna RAM.
Catatan
AliyunENSFullAccess: Memberikan izin untuk mengelola sumber daya Edge Node Service (ENS).
AliyunENSReadOnlyAccess: Memberikan izin read-only pada sumber daya ENS.
Untuk membuat kebijakan kustom, lihat Informasi otorisasi.
1. Buka daftar pengguna RAM.
2. Temukan pengguna RAM yang dituju dan klik Add Permissions di kolom Actions.
3. Di kotak teks, masukkan kata kunci ENS untuk mencari kebijakan yang ingin disambungkan. Pilih kebijakan AliyunENSFullAccess.
4. Klik Confirm untuk menyelesaikan otorisasi.
Pergi ke halaman detail pengguna RAM. Di tab Authentication, klik Create AccessKey.
Untuk informasi lebih lanjut, lihat Buat Pasangan AccessKey.

Langkah 3: Panggil OpenAPI

Topik ini menggunakan Java SDK untuk memanggil OpenAPI. SDK untuk bahasa lain digunakan dengan cara yang serupa. Untuk informasi selengkapnya, lihat Edge Node Service SDK. Anda juga dapat memilih metode lain untuk memanggil operasi tersebut. Untuk informasi selengkapnya tentang metode pemanggilan, lihat Metode pemanggilan.

Konfigurasikan variabel lingkungan

Variabel lingkungan adalah parameter tingkat sistem yang spesifik untuk sistem operasi. Variabel ini berisi nama dan nilai yang menyediakan pengaturan waktu proses untuk aplikasi. Untuk informasi tentang cara mengonfigurasi Pasangan Kunci Akses Alibaba Cloud sebagai variabel lingkungan pada berbagai sistem operasi, lihat Konfigurasi variabel lingkungan di Linux, macOS, dan Windows.

Unduh kode contoh

Buka DescribeEnsRegions.
Pada tab Parameter Settings di sebelah kiri, masukkan parameter yang diperlukan.
Pada tab SDK Sample di sebelah kanan, atur SDK Version menjadi v2.0 dan Language menjadi Java. Klik Download Full Project untuk mengunduh paket kode contoh.
Ekstrak paket tersebut di komputer Anda dan buka folder alibabacloud_sample.

Buka proyek

Gunakan IntelliJ IDEA untuk memuat proyek tersebut. Setelah dependensi dimuat, buka file src/main/java/com/aliyun/sample/Sample.java. Tambahkan kode untuk mencetak nilai kembali berdasarkan komentar dalam file tersebut.

Jalankan proyek

Klik Run di pojok kanan atas IDE untuk melihat log keluaran. Konten berikut dikembalikan dalam contoh ini:

{
  "headers": {
    "access-control-allow-origin": "*",
    "date": "Tue, 18 Jul 2023 15:26:50 GMT",
    "content-length": "92",
    "keep-alive": "timeout=25",
    "x-acs-request-id": "1589E192-A47E-5224-95E2-A18F2D1ED186",
    "connection": "keep-alive",
    "content-type": "application/json;charset=utf-8",
    "etag": "9fcxMGIK+zckvQOS1NfD6GA2",
    "access-control-expose-headers": "*",
    "x-acs-trace-id": "bdfecedff57c1e8fc1b7970e909bca31"
  },
  "statusCode": 200,
  "body": {
    "code": 0,
    "ensRegions": {
      "ensRegions": [
        {
          "Area": "SouthWestChina",
          "EnName": "",
          "EnsRegionId": "cn-chongqing-unicom",
          "Province": "Chongqing",
          "Name": "China Unicom (Chongqing)"
        }
      ]
    },
    "requestId": "1589E192-A47E-5224-95E2-A18F2D1ED186"
  }
}