全部产品
Search

搜索本产品

    ApsaraMQ for RocketMQ：OnsInstanceBaseInfo

    文档中心

    ApsaraMQ for RocketMQ：OnsInstanceBaseInfo

    更新时间：Jan 06, 2026

    Anda dapat memanggil operasi OnsInstanceBaseInfo untuk mengkueri informasi dasar suatu instans beserta titik akhirnya guna mengirim dan menerima pesan.

    Deskripsi operasi

    Penting OpenAPI yang disediakan oleh Alibaba Cloud merupakan API manajemen yang digunakan untuk mengelola dan mengkueri resource Layanan Alibaba Cloud. Integrasi OpenAPI hanya ditujukan untuk keperluan manajemen. Jangan gunakan OpenAPI untuk data link inti yang mengirim dan menerima pesan karena dapat menimbulkan ancaman keamanan terhadap data link Anda.
    Klien terhubung ke ApsaraMQ for RocketMQ melalui titik akhir untuk mengirim dan menerima pesan. Anda dapat memanggil operasi ini untuk mengkueri titik akhir suatu instans.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    mq:QueryInstanceBaseInfo

    get

    *Instance

    acs:mq:{#regionId}:{#accountId}:{#InstanceId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID instans yang akan dikueri.

    MQ_INST_138015630679****_BAAy1Hac

    Elemen respons

    Element

    Type

    Description

    Example

    object

    InstanceBaseInfo

    object

    Objek informasi instans.

    Endpoints

    object

    Titik akhir untuk protokol yang berbeda.

    TcpEndpoint

    string

    Titik akhir internal untuk protokol TCP.

    http://MQ_INST_138015630679****_BAAy1Hac.cn-chengdu.mq-internal.aliyuncs.com:8080
    TcpInternetEndpoint

    string

    Titik akhir publik untuk protokol TCP.

    • Hanya instans di wilayah China (Chengdu), China (Qingdao), dan China (Shenzhen) yang mendukung titik akhir publik untuk protokol TCP.

    • Untuk menggunakan titik akhir publik untuk protokol TCP, upgrade kit pengembangan perangkat lunak (SDK) client ke salah satu versi berikut:

      • Java SDK untuk TCP: 2.0.0.Final atau yang lebih baru. Untuk informasi selengkapnya, lihat Panduan Versi Java SDK.

      • C++ SDK untuk TCP: 3.0.0 atau yang lebih baru. Untuk informasi selengkapnya, lihat Panduan Versi C++ SDK.

    • Biaya transfer data dikenakan saat Anda menggunakan titik akhir publik untuk protokol TCP. Untuk informasi selengkapnya, lihat Biaya transfer data.

    http://MQ_INST_138015630679****_BAAy1Hac.mq.cn-chengdu.aliyuncs.com:80
    HttpInternetEndpoint

    string

    Titik akhir publik untuk protokol HTTP.

    http://138015630679****.mqrest.cn-chengdu.aliyuncs.com
    HttpInternalEndpoint

    string

    Titik akhir internal untuk protokol HTTP.

    http://138015630679****.mqrest.cn-chengdu-internal.aliyuncs.com
    HttpInternetSecureEndpoint

    string

    Titik akhir publik untuk protokol HTTPS.

    https://138015630679****.mqrest.cn-chengdu.aliyuncs.com
    IndependentNaming

    boolean

    Menunjukkan apakah instans memiliki namespace. Nilai yang valid:

    • true: Instans memiliki namespace independen. Nama resource harus unik dalam instans tersebut. Nama resource dapat sama antar instans.

    • false: Instans tidak memiliki namespace independen. Nama resource harus unik secara global.

    true
    MaxTps

    integer

    TPS (Transactions Per Second) maksimum untuk mengirim dan menerima pesan. Nilai yang valid: 5000, 10000, 20000, 50000, 100000, 200000, 300000, 500000, 800000, dan 1000000.

    Untuk informasi selengkapnya, lihat halaman pembelian instans.

    Catatan

    Parameter ini hanya berlaku untuk instans ApsaraMQ for RocketMQ Edisi Platinum.

    10000
    Remark

    string

    Keterangan mengenai instans.

    ons-cn-m7r1r5f****
    InstanceName

    string

    Nama instans.

    Nama harus terdiri dari 3 hingga 64 karakter dan dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_).

    test
    ReleaseTime

    integer

    Waktu kedaluwarsa instans Edisi Platinum.

    1603555200000
    TopicCapacity

    integer

    Jumlah maksimum topik yang dapat dibuat pada instans. Nilai yang valid: 25, 50, 100, 300, dan 500.

    Catatan

    Parameter ini hanya berlaku untuk instans ApsaraMQ for RocketMQ Edisi Platinum.

    50
    InstanceStatus

    integer

    Status instans. Nilai yang valid:

    • 0: Instans Edisi Platinum sedang dideploy.

    • 2: Pembayaran untuk instans Edisi Standar telah jatuh tempo.

    • 5: Instans Edisi Standar atau Edisi Platinum dalam layanan.

    • 7: Instans Edisi Platinum sedang ditingkatkan dan tersedia.

    5
    InstanceId

    string

    ID instans.

    MQ_INST_138015630679****_BAAy1Hac
    InstanceType

    integer

    Tipe instans. Nilai yang valid:

    • 1: Instans Edisi Standar (pay-as-you-go)

    • 2: Instans Edisi Platinum (subscription)

    Untuk informasi selengkapnya mengenai tipe dan spesifikasi instans ApsaraMQ for RocketMQ, lihat Tipe Instans.

    2
    CreateTime

    string

    Waktu pembuatan instans. Nilai parameter ini merupakan stempel waktu UNIX dalam milidetik.

    1570701259403
    spInstanceId

    string

    ID komoditas instans.

    ons-cn-m7r1r5f****
    spInstanceType

    integer

    Tipe penjualan instans.

    Valid values:

    • 1 :

      Instans Edisi Standar (pay-as-you-go)

    • 2 :

      Instans Edisi Platinum (subscription)

    1
    SupportClassic

    integer

    2
    RequestId

    string

    Parameter umum. Setiap permintaan memiliki ID unik yang dapat Anda gunakan untuk memecahkan masalah.

    6CC46974-65E8-4C20-AB07-D20D102E****

    Contoh

    Respons sukses

    JSONformat

    {
  "InstanceBaseInfo": {
    "Endpoints": {
      "TcpEndpoint": "http://MQ_INST_138015630679****_BAAy1Hac.cn-chengdu.mq-internal.aliyuncs.com:8080",
      "TcpInternetEndpoint": "http://MQ_INST_138015630679****_BAAy1Hac.mq.cn-chengdu.aliyuncs.com:80",
      "HttpInternetEndpoint": "http://138015630679****.mqrest.cn-chengdu.aliyuncs.com",
      "HttpInternalEndpoint": "http://138015630679****.mqrest.cn-chengdu-internal.aliyuncs.com",
      "HttpInternetSecureEndpoint": "https://138015630679****.mqrest.cn-chengdu.aliyuncs.com"
    },
    "IndependentNaming": true,
    "MaxTps": 10000,
    "Remark": "ons-cn-m7r1r5f****",
    "InstanceName": "test",
    "ReleaseTime": 1603555200000,
    "TopicCapacity": 50,
    "InstanceStatus": 5,
    "InstanceId": "MQ_INST_138015630679****_BAAy1Hac",
    "InstanceType": 2,
    "CreateTime": "1570701259403",
    "spInstanceId": "ons-cn-m7r1r5f****",
    "spInstanceType": 1,
    "SupportClassic": 2
  },
  "RequestId": "6CC46974-65E8-4C20-AB07-D20D102E****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.