Contoh integrasi OpenAPI - ENS - Alibaba Cloud Documentation Center

Topik ini menjelaskan cara memanggil operasi DescribeEnsRegions menggunakan OpenAPI untuk mengkueri Node Tepi Edge Node Service (ENS) yang tersedia.

Langkah 1: Tinjau dokumentasi API

Baca dokumentasi API sebelum memanggil suatu operasi. Untuk mengetahui parameter permintaan dan izin yang diperlukan guna memanggil operasi DescribeEnsRegions, lihat DescribeEnsRegions. 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 ROS Infrastructure Composer, Anda akan diarahkan ke halaman yang sesuai.
Untuk Template Import Method, pilih Enter Template Content. Untuk Template Content, pilih ROS dan masukkan kode.

Langkah 2: Buat Pengguna RAM dan berikan izin

Penting

Akun Alibaba Cloud memiliki izin penuh untuk semua operasi API. Untuk alasan keamanan, kami menyarankan agar Anda menggunakan Pengguna RAM untuk pemanggilan API dan operasi O&M rutin.

Operasi ini dapat dipanggil menggunakan Akun Alibaba Cloud (akun root), Pengguna RAM, atau Peran RAM. Untuk informasi selengkapnya mengenai perbedaan antara identitas tersebut, lihat identitas.

Topik ini menggunakan Pengguna RAM untuk memanggil operasi API.

Buat Pengguna RAM.
1. Masuk ke konsol Resource Access Management (RAM).
2. Di panel navigasi kiri, pilih .
3. Pada halaman Users, klik Create User.
4. Pada halaman Create User, atur logon name dan display name. Untuk access mode, pilih console access.
5. Klik OK.
  
  Setelah membuat Pengguna RAM, catat logon name dan password. Anda akan menggunakan kredensial ini untuk akses konsol.
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 Users.
2. Temukan Pengguna RAM yang dituju dan klik Add Permissions di kolom Actions.
3. Di kotak pencarian, masukkan ENS dan pilih kebijakan AliyunENSFullAccess.
4. Klik OK.
Buka halaman detail Pengguna RAM. Pada tab Authentication, klik Create AccessKey.

Untuk informasi selengkapnya, lihat Buat Pasangan Kunci Akses.

Langkah 3: Panggil API

Topik ini memberikan contoh cara memanggil OpenAPI menggunakan Java SDK. Penggunaannya serupa untuk SDK dalam bahasa lain. Untuk informasi selengkapnya, lihat Edge Node Service SDK. Anda juga dapat memilih metode pemanggilan lain berdasarkan kebutuhan bisnis Anda. Untuk informasi selengkapnya, lihat Metode pemanggilan.

Konfigurasikan variabel lingkungan

Variabel lingkungan adalah parameter tingkat sistem yang berisi nama dan nilai untuk menentukan lingkungan runtime bagi aplikasi. Untuk informasi tentang cara mengonfigurasi Pasangan Kunci Akses sebagai variabel lingkungan pada berbagai sistem operasi, lihat Konfigurasikan variabel lingkungan pada Linux, macOS, dan Windows.

Unduh kode contoh

Buka DescribeEnsRegions.
Pada tab Parameters di sebelah kiri, tentukan parameter yang diperlukan.
Pada tab SDK sample di sebelah kanan, atur SDK Version ke v2.0 dan Language ke Java. Klik Download sample project untuk mengunduh proyek contoh.
Ekstrak paket tersebut dan buka direktori alibabacloud_sample.

Buka proyek

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

Jalankan proyek

Klik Run di pojok kanan atas IDE untuk melihat log output. Contoh tanggapan ditampilkan di bawah 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"
  }
}