All Products
Search
Document Center

ApsaraDB for MongoDB:Integrasikan ApsaraDB for MongoDB menggunakan SDK

Last Updated:Jun 24, 2026

Panggil operasi API menggunakan SDK untuk mengkueri instans ApsaraDB for MongoDB di wilayah tertentu.

Lihat dokumentasi API

Lihat Daftar operasi berdasarkan fungsi untuk menemukan operasi API yang mengkueri instans di wilayah tertentu. Sebagai contoh, Anda dapat memanggil operasi DescribeDBInstances. Lihat topik DescribeDBInstances untuk mengetahui parameter permintaan dan izin yang diperlukan.

Buat RAM user dan berikan izin kepada RAM user tersebut

Identitas

Anda dapat memanggil operasi ini menggunakan Akun Alibaba Cloud, Peran RAM, atau RAM user. Untuk informasi selengkapnya, lihat Identitas, kredensial, dan otorisasi. Dalam contoh ini, RAM user digunakan untuk memanggil operasi DescribeDBInstances. Masuk ke konsol RAM, buat RAM user, dan catat Pasangan Kunci Akses (AccessKey pair) milik RAM user tersebut. Untuk informasi selengkapnya, lihat Buat RAM user.

Otorisasi

  1. Buka halaman Users, temukan RAM user yang dituju, lalu klik Add Permissions pada kolom Actions.

  2. Pada bagian Policies, cari kata kunci MongoDB dan pilih kebijakan yang ingin Anda sambungkan.

    Catatan

    AliyunMongoDBFullAccess: memberikan akses penuh ke ApsaraDB for MongoDB.

    AliyunMongoDBReadOnlyAccess: memberikan akses read-only ke ApsaraDB for MongoDB.

    Untuk informasi tentang cara membuat kebijakan kustom, lihat Otorisasi RAM.

  3. Klik OK.

Kredensial

AccessKey default dibuat secara otomatis saat Anda membuat RAM user. Anda juga dapat membuka halaman detail RAM user, masuk ke tab Certification management, lalu klik Create AccessKey. Untuk informasi selengkapnya, lihat Buat AccessKey.

Panggil operasi DescribeDBInstances

Contoh berikut menggunakan SDK untuk Java guna memanggil operasi DescribeDBInstances.

Konfigurasikan variabel lingkungan

Konfigurasikan Pasangan Kunci Akses (AccessKey pair) dalam variabel lingkungan untuk menghindari penyisipan kredensial secara langsung di dalam kode Anda.

Untuk informasi selengkapnya, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

Unduh kode contoh

  1. Buka halaman DescribeDBInstances.

  2. Pada tab Parameter Configuration, atur parameter yang diperlukan.

    • RegionId: ID wilayah tempat Anda ingin mengkueri instans.

  3. Di sisi kanan, pada tab SDK Sample, pilih v2.0 sebagai versi SDK dan Java sebagai bahasa pemrograman. Lalu, klik Download Project.

  4. Ekstrak paket kode contoh di komputer Anda dan buka direktori alibabacloud_sample.

Buka dan jalankan proyek

Gunakan IntelliJ IDEA untuk memuat proyek tersebut. Setelah dependensi selesai dimuat, buka file src/main/java/com/aliyun/sample/Sample.java dan tambahkan kode untuk mencetak nilai yang dikembalikan sesuai dengan komentar dalam kode.

Klik tombol Run di pojok kanan atas IDE untuk melihat log output. Contoh berikut menunjukkan tanggapan respons:

{
  "headers": {
    "access-control-allow-origin": "*",
    "date": "Wed, 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
  }
}