All Products
Search

This Product

    :Kueri titik akhir

    Document Center

    :Kueri titik akhir

    Last Updated:May 26, 2026

    Anda dapat memanggil operasi DescribeDBInstanceNetInfo untuk mengkueri titik akhir instans ApsaraDB RDS.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    Parameter Tipe Wajib Contoh Deskripsi
    Action String Ya DescribeDBInstanceNetInfo

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDBInstanceNetInfo.

    ClientToken String Tidak ETnLKlblzczshOTUbOC*****

    Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token tersebut, tetapi Anda harus memastikan bahwa token yang dihasilkan unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

    DBInstanceId String Ya rm-uf6wjk5*****

    ID instans.

    Flag Integer Tidak N/A

    Parameter cadangan.

    DBInstanceNetRWSplitType String Tidak Normal

    Tipe titik akhir. Nilai yang valid:

    • Normal: titik akhir reguler
    • ReadWriteSplitting: titik akhir pemisahan baca/tulis
    Catatan Secara default, sistem mengembalikan kedua jenis titik akhir tersebut.
    GeneralGroupName String Tidak rgc-2ze*****

    Nama klaster khusus tempat instans berada. Parameter ini hanya berlaku ketika instans menjalankan MySQL pada RDS Standard Edition dan dibuat dalam klaster khusus.

    Parameter respons

    Parameter Tipe Contoh Deskripsi
    SecurityIPMode String safety

    Mode daftar putih instans. Nilai yang valid:

    • normal: mode daftar putih standar
    • safety: mode daftar putih yang ditingkatkan
    RequestId String 777C4593-8053-427B-99E2-105593277CAB

    ID permintaan.

    InstanceNetworkType String VPC

    Jenis jaringan instans. Nilai yang valid:

    • Classic
    • VPC
    DBInstanceNetInfos Array of DBInstanceNetInfo

    Detail titik akhir instans.

    DBInstanceNetInfo
    VSwitchId String vsw-uf6adz52c2p*****

    ID vSwitch.

    ConnectionStringType String Normal

    Tipe titik akhir. Nilai yang valid:

    • Normal: titik akhir reguler
    • ReadWriteSplitting: titik akhir pemisahan baca/tulis
    ConnectionString String rm-uf6w*****.mysql.rds.aliyuncs.com

    Titik akhir instans.

    ExpiredTime String 1209534

    Periode validitas tersisa instans jaringan klasik dalam mode akses hybrid. Satuan: detik.

    Upgradeable String Disabled

    Menunjukkan apakah versi IP dapat diperbarui. Nilai yang valid:

    • Enable: Versi IP dapat diperbarui.
    • Disabled: Versi IP tidak dapat diperbarui.
      Catatan Versi IP dapat diperbarui dari IPv4 ke IPv6.
    MaxDelayTime String 12

    Ambang batas latensi. Parameter ini hanya dikembalikan untuk titik akhir pemisahan baca/tulis. Satuan: detik.

    Catatan Jika latensi pada instans hanya baca melebihi ambang batas yang ditentukan, ApsaraDB RDS tidak lagi meneruskan permintaan baca ke instans hanya baca tersebut.
    IPType String Public

    Jenis jaringan.

    • Nilai yang valid ketika instans berada di jaringan klasik:
      • Inner:: jaringan internal
      • Public: Internet
    • Nilai yang valid ketika instans berada di virtual private cloud (VPC):
      • Private: jaringan internal
      • Public: Internet
    Port String 3306

    Port yang digunakan untuk menghubungkan ke instans.

    BabelfishPort String 1433

    Port Tabular Data Stream (TDS) instans tempat Babelfish diaktifkan.

    Catatan Parameter ini hanya berlaku untuk instans ApsaraDB RDS for PostgreSQL. Untuk informasi selengkapnya tentang Babelfish untuk ApsaraDB RDS for PostgreSQL, lihat Pengenalan Babelfish.
    VPCId String vpc-uf6f7l4fg90*****

    ID VPC tempat instans berada.

    DistributionType String Standard

    Kebijakan yang digunakan untuk menetapkan bobot baca. Parameter ini hanya dikembalikan untuk titik akhir pemisahan baca/tulis. Nilai yang valid:

    • Standard: ApsaraDB RDS secara otomatis menetapkan bobot baca ke instans dan instans hanya bacanya berdasarkan spesifikasi instans-instans tersebut.
    • Custom: Anda harus menetapkan secara manual bobot baca ke instans dan instans hanya bacanya.
    IPAddress String 192.168.XX.XX

    Alamat IP instans.

    SecurityIPGroups Array of securityIPGroup

    Detail tentang daftar putih IP instans.

    securityIPGroup
    SecurityIPs String 127.0.XX.XX

    Alamat IP yang terdapat dalam daftar putih alamat IP.

    SecurityIPGroupName String Default

    Nama daftar putih alamat IP.

    DBInstanceWeights Array of DBInstanceWeight

    Detail bobot. Parameter ini hanya dikembalikan ketika fitur pemisahan baca/tulis diaktifkan untuk instans.

    DBInstanceWeight
    Availability String Unavailable

    Ketersediaan instans. Nilai yang valid:

    • Unavailable
    • Available
    Weight String 100

    Bobot instans.

    DBInstanceId String rm-uf6wjk5*****

    ID instans.

    Role String N/A

    Parameter yang sudah tidak digunakan.

    DBInstanceType String Master

    Peran instans. Nilai yang valid:

    • Master: instans utama
    • Readonly: instans hanya baca

    Contoh

    Permintaan contoh

    http(s)://rds.aliyuncs.com/?Action=DescribeDBInstanceNetInfo
&DBInstanceId=rm-uf6wjk5*****
&<Common request parameters>

    Respons sukses contoh

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDBInstanceNetInfoResponse>
    <dBInstanceNetInfos>
        <connectionString>rm-uf6wjk5*****.mysql.rds.aliyuncs.com</connectionString>
        <connectionStringType>Normal</connectionStringType>
        <iPAddress>192.168.XX.XX</iPAddress>
        <iPType>Public</iPType>
        <port>3306</port>
        <upgradeable>Disabled</upgradeable>
        <vPCId/>
    </dBInstanceNetInfos>
    <instanceNetworkType>Classic</instanceNetworkType>
    <requestId>777C4593-8053-427B-99E2-105593277CAB</requestId>
</DescribeDBInstanceNetInfoResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "dBInstanceNetInfos" : {
    "connectionString" : "rm-uf6wjk5*****.mysql.rds.aliyuncs.com",
    "connectionStringType" : "Normal",
    "iPAddress" : "192.168.XX.XX",
    "iPType" : "Public",
    "port" : 3306,
    "upgradeable" : "Disabled",
    "vPCId" : ""
  },
  "instanceNetworkType" : "Classic",
  "requestId" : "777C4593-8053-427B-99E2-105593277CAB"
}

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 IllegalParameter Illegal parameter Pesan kesalahan yang dikembalikan karena parameter yang ditentukan tidak valid.

    Untuk daftar kode kesalahan, kunjungi API Error Center.