Gunakan SDK untuk Java untuk menanyakan instans yang dibuat di wilayah tertentu - ApsaraDB for MongoDB

Topik ini menjelaskan cara memanggil API menggunakan SDK untuk menanyakan instans yang dibuat di wilayah tertentu.

Lihat dokumentasi API

Anda dapat merujuk ke Daftar operasi berdasarkan fungsi untuk memilih API yang dapat Anda panggil guna menanyakan instans di wilayah tertentu. Sebagai contoh, Anda dapat memanggil operasi DescribeDBInstances untuk menanyakan instans di wilayah tersebut. Untuk informasi lebih lanjut tentang operasi DescribeDBInstances, lihat DescribeDBInstances. Anda dapat merujuk pada topik DescribeDBInstances untuk mempelajari parameter permintaan yang harus dikonfigurasi dan izin yang harus diberikan kepada Pengguna Resource Access Management (RAM).

Buat pengguna RAM dan berikan izin kepada pengguna RAM

Identitas

Anda dapat memanggil operasi menggunakan salah satu dari identitas berikut: Akun Alibaba Cloud, Peran Resource Access Management (RAM), atau Pengguna RAM. Untuk informasi lebih lanjut tentang perbedaan antara identitas, lihat Identitas, kredensial, dan otorisasi. Dalam contoh ini, Pengguna RAM digunakan untuk memanggil operasi DescribeDBInstances. Masuk ke Konsol RAM, buat pengguna RAM yang ingin Anda gunakan untuk memanggil operasi DescribeDBInstances, dan catat informasi pasangan AccessKey dari pengguna RAM tersebut. Untuk informasi lebih lanjut, lihat Buat pengguna RAM.

Otorisasi

Pergi ke halaman Pengguna di Konsol RAM. Temukan pengguna RAM yang ingin Anda kelola dan klik Add Permissions di kolom Actions.
Di bagian Policy panel Pemberian Izin, masukkan MongoDB di bidang pencarian lalu pilih kebijakan yang ingin Anda lampirkan ke pengguna RAM.
Catatan
AliyunMongoDBFullAccess: memberikan akses penuh ke ApsaraDB for MongoDB.
AliyunMongoDBReadOnlyAccess: memberikan akses hanya-baca ke ApsaraDB for MongoDB.
Untuk informasi tentang cara membuat kebijakan kustom, lihat Otorisasi RAM.
Klik Grant permissions.

Kredensial

Secara default, sepasang AccessKey dihasilkan saat Anda membuat pengguna RAM. Anda juga bisa pergi ke halaman rincian pengguna untuk membuat sepasang AccessKey. Di tab Authentication halaman tersebut, klik Create AccessKey. Untuk informasi lebih lanjut, lihat Buat sepasang AccessKey.

Panggil operasi DescribeDBInstances

Dalam bagian ini, SDK untuk Java digunakan untuk memanggil operasi DescribeDBInstances.

Konfigurasikan variabel lingkungan

Anda dapat mengonfigurasi sepasang AccessKey dalam variabel lingkungan. Dengan cara ini, sepasang AccessKey tidak di-hard-code dalam kode, sehingga layanan Anda tidak terpapar risiko.

Untuk informasi lebih lanjut tentang cara mengonfigurasi variabel lingkungan, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

Unduh kode contoh

Pergi ke halaman DescribeDBInstances.
Di tab Parameters halaman tersebut, konfigurasikan parameter yang diperlukan.
- RegionId: ID wilayah. Parameter ini menentukan wilayah instans yang ingin Anda tanyakan.
Di tab SDK Sample Code halaman tersebut, pilih V2.0 untuk Versi SDK dan Java untuk Bahasa. Lalu, klik Download Project untuk mengunduh paket kode contoh.
Ekstrak paket kode contoh di komputer Anda dan akses direktori alibabacloud_sample.

Buka dan jalankan proyek

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

Di pojok kanan atas IDE, klik Run untuk melihat log output. Dalam contoh ini, konten berikut dikembalikan:

{
  "headers": {
    "access-control-allow-origin": "*",
    "date": "Rab, 26 Jul 2023 05:45:58 GMT",
    "keep-alive": "timeout=25",
    "transfer-encoding": "chunked",
    "vary": "Accept-Encoding",
    "x-acs-request-id": "CF00C412-4BB5-5D02-803C-46D0AF71DC23",
    "connection": "keep-alive",
    "content-type": "application/json;charset=utf-8",
    "access-control-expose-headers": "*",
    "x-acs-trace-id": "48df4a01d258338ee5327a6a48628426"
  },
  "statusCode": 200,
  "body": {
    "DBInstances": {
      "DBInstance": [
        {
          "capacityUnit": "",
          "chargeType": "PostPaid",
          "creationTime": "2023-07-25T06:32:25Z",
          "DBInstanceClass": "mdb.shard.2x.xlarge.d",
          "DBInstanceId": "dds-***",
          "DBInstanceStatus": "Running",
          "DBInstanceStorage": 500,
          "DBInstanceType": "replicate",
          "engine": "MongoDB",
          "engineVersion": "5.0",
          "expireTime": "2999-09-08T16:00Z",
          "kindCode": "18",
          "lockMode": "Unlock",
          "mongosList": { "mongosAttribute": [] },
          "networkType": "VPC",
          "regionId": "cn-shanghai",
          "replicationFactor": "3",
          "resourceGroupId": "rg-***",
          "shardList": { "shardAttribute": [] },
          "storageType": "cloud_essd1",
          "tags": { "tag": [] },
          "zoneId": "cn-shanghai-m"
        }
      ]
    },
    "pageNumber": 1,
    "pageSize": 30,
    "requestId": "CF00C412-4BB5-5D02-803C-***",
    "totalCount": 3
  }
}