All Products
Search
Document Center

:Kueri detail tentang instans

Last Updated:May 26, 2026

Anda dapat memanggil operasi DescribeDBInstanceAttribute untuk mengkueri detail instans.

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 DescribeDBInstanceAttribute

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDBInstanceAttribute.

DBInstanceId String Ya rm-uf6wjk5*****

ID instans. Anda dapat menentukan hingga 30 ID instans dalam satu permintaan. Jika Anda menentukan beberapa ID instans, pisahkan ID tersebut dengan koma (,).

Expired String Tidak False

Menentukan apakah instans kedaluwarsa. Nilai yang valid:

  • True: Instans kedaluwarsa.
  • False: Instans tidak kedaluwarsa.

Parameter respons

Parameter Tipe Contoh Deskripsi
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

ID permintaan.

Items Array of DBInstanceAttribute

Array yang berisi detail instans.

DBInstanceAttribute
VpcId String vpc-*****

ID virtual private cloud (VPC).

CreationTime String 2011-05-30T12:11:04Z

Waktu pembuatan instans. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

IncrementSourceDBInstanceId String rm-uf6wjk5*****

ID instans sumber data inkremental. Data inkremental dari instans disaster recovery atau instans read-only berasal dari instans primernya. Jika parameter ini tidak dikembalikan, instans tersebut adalah instans primer.

MaintainTime String 00:00Z-02:00Z

Jendela pemeliharaan instans. Waktu ditampilkan dalam UTC. Perhatikan bahwa jendela pemeliharaan yang ditampilkan di Konsol ApsaraDB RDS sama dengan nilai parameter ini ditambah 8 jam.

PayType String Postpaid

Metode penagihan instans. Nilai yang valid:

  • Postpaid: pay-as-you-go
  • Prepaid: subscription
AvailabilityValue String 100.0%

Status ketersediaan instans dalam persentase.

EngineVersion String 5.5

Versi mesin database instans.

DedicatedHostGroupId String dhg-7a9*****

ID klaster khusus tempat instans berada.

ConnectionString String rm-uf6wjk5*****.mysql.rds.aliyuncs.com

Titik akhir internal instans.

SuperPermissionMode String Disabled

Menunjukkan apakah instans mendukung akun superuser, seperti akun administrator sistem (SA), akun Active Directory (AD), dan akun host.

  • Enable: Akun superuser didukung.
  • Disabled: Akun superuser tidak didukung.
InstanceNetworkType String Classic

Jenis jaringan instans. Nilai yang valid:

  • Classic: classic network
  • VPC: VPC
MasterInstanceId String rm-uf6wjk5*****

ID instans primer.

Catatan Jika parameter ini tidak dikembalikan, instans tersebut adalah instans primer.
AutoUpgradeMinorVersion String Auto

Metode yang digunakan untuk memperbarui versi mesin minor instans. Nilai yang valid:

  • Auto: pembaruan otomatis.
  • Manual: pembaruan manual. ApsaraDB RDS hanya akan memperbarui versi mesin minor saat ini secara otomatis ketika versi tersebut sudah tidak didukung lagi.
ExpireTime String 2019-03-27T16:00:00Z

Waktu kedaluwarsa instans. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

Catatan Instans pay-as-you-go tidak pernah kedaluwarsa.
AccountMaxQuantity Integer 50

Jumlah maksimum akun yang dapat dibuat pada instans.

MasterZone String 5454284

ID zona instans primer.

GuardDBInstanceId String rm-uf64zsu*****

ID instans disaster recovery yang terhubung ke instans ini.

DBInstanceStorage Integer 10

Kapasitas penyimpanan instans. Satuan: GB.

TimeZone String Central Standard Time

Zona waktu instans.

LatestKernelVersion String rds_20201031

Versi mesin minor terbaru yang didukung oleh instans.

TipsLevel Integer 1

Tingkat keparahan pengecualian yang terdeteksi pada instans. Parameter ini hanya dikembalikan jika instans dibuat dalam klaster ApsaraDB MyBase yang menjalankan MySQL pada Edisi Standar. Nilai yang valid:

  • 1: Instans normal.
  • 2: Spesifikasi instans read-only tidak sesuai dengan spesifikasi instans primer. Anda harus menyesuaikan spesifikasi instans tersebut berdasarkan kebutuhan bisnis Anda.
ZoneId String cn-hangzhou-a

ID zona instans.

MaxConnections Integer 60

Jumlah maksimum koneksi bersamaan yang diizinkan oleh instans.

DBInstanceId String rm-uf6wjk5*****

ID instans.

TempDBInstanceId String rm-uf64zsu*****

ID instans temporary yang terhubung ke instans ini.

AdvancedFeatures String LinkedServer

Fitur advanced yang diaktifkan untuk instans. Jika beberapa fitur advanced diaktifkan, fitur-fitur tersebut dipisahkan dengan koma (,). Parameter ini hanya tersedia untuk instans yang menjalankan SQL Server. Nilai yang valid:

  • LinkedServer
  • DistributeTransaction
DBInstanceStorageType String local_ssd

Jenis penyimpanan instans. Nilai yang valid:

  • local_ssd dan ephemeral_ssd: local SSD
  • cloud_ssd: standard SSD
  • cloud_essd: enhanced SSD
DBInstanceMemory Long 4096

Kapasitas memori instans. Satuan: MB.

IPType String IPv4

Jenis alamat IP. Hanya alamat IPv4 yang didukung.

ConsoleVersion String 2

Jenis proxy yang digunakan oleh instans. Nilai yang valid:

  • 1: shared proxy
  • 2: dedicated proxy
Catatan Kami menyarankan agar Anda menggunakan parameter ProxyType sebagai ganti parameter ini.
ConnectionMode String Standard

Mode koneksi instans. Nilai yang valid:

  • Standard: standard mode
  • Safe: proxy mode
Port String 3306

Nomor port internal yang digunakan untuk menghubungkan ke instans.

LockMode String Unlock

Mode penguncian instans. Nilai yang valid:

  • Unlock: Instans tidak terkunci.
  • ManualLock: Instans dikunci secara manual.
  • LockByExpiration: Instans dikunci otomatis karena kedaluwarsa.
  • LockByRestoration: Instans dikunci otomatis karena proses restorasi.
  • LockByDiskQuota: Instans dikunci otomatis karena ruang penyimpanan habis.
  • LockReadInstanceByDiskQuota: Instans adalah instans read-only yang dikunci otomatis ketika disk space penuh.
GeneralGroupName String TestGroup

Nama klaster khusus tempat instans berada. Parameter ini hanya dikembalikan jika instans dibuat dalam klaster ApsaraDB MyBase yang menjalankan MySQL pada Edisi Standar.

VpcCloudInstanceId String vpc-23rsxdf*****

ID VPC instans. Parameter ini hanya dikembalikan jika instans berada dalam VPC.

Collation String Chinese_PRC_CI_AS

Aturan pengurutan set karakter instans.

MaxIOPS Integer 150

Jumlah maksimum permintaan I/O yang dapat diproses oleh instans per detik.

MaxIOMBPS Integer 0MB/s

Throughput I/O maksimum. Satuan: MB/s.

Tips String Everything is fine.

Informasi tentang pengecualian yang terdeteksi pada instans. Parameter ini hanya dikembalikan jika instans dibuat dalam klaster ApsaraDB MyBase yang menjalankan MySQL pada Edisi Standar.

SecurityIPList String 192.168.XX.XX/24

Alamat IP dalam daftar putih alamat IP.

SecurityIPMode String normal

Mode daftar putih instans. Nilai yang valid:

  • normal: mode daftar putih standar
  • safety: mode daftar putih yang ditingkatkan
DBInstanceClassType String s

keluarga instans tempat instans berada. Nilai yang valid:

  • s: keluarga instans shared
  • x: keluarga instans tujuan umum
  • d: keluarga instans dedicated
  • h: keluarga instans dedicated host
ProxyType Integer 1

Jenis proxy yang didukung oleh instans. Nilai yang valid:

  • 0: Instans tidak mendukung database proxy.
  • 1: Instans mendukung shared proxy, sehingga instans berjalan dalam mode multi-tenant.
  • 2: Instans mendukung dedicated proxy, sehingga instans berjalan dalam mode single-tenant.
CurrentKernelVersion String rds_20181010

Versi mesin minor instans.

DBInstanceDescription String Test database

Deskripsi instans.

DBInstanceCPU String 2

Jumlah core yang dikonfigurasi untuk instans.

DBInstanceNetType String Internet

Jenis jaringan tempat instans terhubung. Nilai yang valid:

  • Internet: Internet
  • Intranet: jaringan internal
DBInstanceType String Primary

Tipe instans. Nilai yang valid:

  • Primary: instans primer
  • Readonly: instans read-only
  • Guard: instans disaster recovery
  • Temp: instans temporary
LockReason String instance_expired

Alasan instans dikunci.

DBInstanceStatus String Running

Status instans. Untuk informasi lebih lanjut, lihat tabel status instans.

DBMaxQuantity Integer 200

Jumlah maksimum database yang dapat dibuat pada instans.

RegionId String cn-hangzhou

ID wilayah instans.

ReadonlyInstanceSQLDelayedTime String 30

Latensi replikasi data ke instans read-only. Sistem mereplikasi data dari instans primer ke instans read-only dengan latensi yang ditentukan oleh parameter ReadonlyInstanceSQLDelayedTime. Satuan: detik.

VSwitchId String vsw-*****

ID vSwitch.

ResourceGroupId String rg-acfmy*****

ID kelompok sumber daya.

Category String Basic

Edisi RDS dari instance tersebut. Nilai yang valid:

  • Basic: RDS Basic Edition
  • HighAvailability: RDS High-availability Edition

  • AlwaysOn: RDS Cluster Edition for SQL Server
  • Finance: RDS Enterprise Edition
  • Serverless_basic: RDS Serverless Basic Edition
DBInstanceClass String rds.mys2.small

Tipe instans instans. Untuk informasi lebih lanjut, lihat Tipe instans utama ApsaraDB RDS.

Engine String MySQL

Mesin database instans. Nilai yang valid:

  • MySQL
  • PostgreSQL
  • SQLServer
  • MariaDB
SlaveZones Array of SlaveZone

Array yang berisi detail zona sekunder.

SlaveZone
ZoneId String cn-hangzhou-a

ID zona.

ReadOnlyDBInstanceIds Array of ReadOnlyDBInstanceId

Array yang berisi ID instans read-only yang terhubung ke instans primer.

ReadOnlyDBInstanceId
DBInstanceId String rm-bp*****

ID instans RDS read-only.

Extra Object

Informasi tambahan instans.

DBInstanceIds Array of String rm-uf6wjk5*****

ID instans.

DeletionProtection Boolean true

Menunjukkan apakah fitur perlindungan rilis diaktifkan. Nilai yang valid:

  • true: Fitur diaktifkan.
  • false: Fitur dinonaktifkan.
ServerlessConfig Object

Pengaturan instans serverless.

ScaleMin double 0.5

Jumlah minimum Unit Kapasitas RDS (RCU).

ScaleMax double 8

Jumlah maksimum RCU.

AutoPause Boolean true

Menunjukkan apakah fitur mulai dan henti otomatis diaktifkan untuk instans serverless. Nilai yang valid:

  • true: Fitur diaktifkan.
  • false: Fitur dinonaktifkan. Ini adalah nilai default.
Catatan Setelah fitur mulai dan henti diaktifkan, jika tidak ada koneksi ke instans selama 10 menit, instans akan ditangguhkan. Setelah koneksi dibuat ke instans, instans akan dilanjutkan secara otomatis.
SwitchForce Boolean false

Menunjukkan apakah fitur scaling paksa diaktifkan untuk instans serverless.

  • true: Fitur diaktifkan.
  • false: Fitur dinonaktifkan. Ini adalah nilai default.
Catatan Dalam kebanyakan kasus, ApsaraDB RDS secara otomatis melakukan scaling in atau out RCU instans serverless berdasarkan kebutuhan bisnis secara real time. Dalam beberapa kasus, scaling tidak langsung berlaku secara real time. Anda dapat mengaktifkan fitur scaling paksa untuk memaksa scaling in atau out RCU instans.
BabelfishConfig Object

Konfigurasi Babelfish untuk instans.

Catatan Parameter ini hanya berlaku untuk instans ApsaraDB RDS for PostgreSQL yang telah mengaktifkan Babelfish. Untuk informasi lebih lanjut, lihat Pengenalan Babelfish.
BabelfishEnabled String true

Sakelar untuk mengaktifkan atau menonaktifkan Babelfish.

Catatan Jika Babelfish diaktifkan saat Anda membeli instans ApsaraDB RDS for PostgreSQL, parameter ini tetap bernilai true.
MigrationMode String single-db

Mode migrasi untuk Babelfish. Nilai yang valid:

  • single-db
  • multi-db
Catatan Untuk informasi lebih lanjut tentang mode migrasi Babelfish, lihat Mode migrasi.
kindCode String None

Parameter internal. Operasi ini tidak mengembalikan nilai untuk parameter ini.

InstructionSetArch String x86

Jenis arsitektur instans. Nilai yang valid:

  • x86
  • arm
DBClusterNodes Array of DBClusterNode

Informasi tentang node dalam kluster.

DBClusterNode
NodeRegionId String cn-beijing

ID wilayah.

NodeZoneId String cn-beijing-h

ID zona instans.

NodeId String rn-****

ID node.

NodeRole String primary

Peran node. Nilai yang valid:

  • primary: node primer
  • secondary: node sekunder
ClassCode String mysql.n2.medium.xc

Tipe node.

Contoh

Permintaan contoh

http(s)://rds.aliyuncs.com/?Action=DescribeDBInstanceAttribute
&DBInstanceId=rm-uf6wjk5*****
&Expired=False
&Common request parameters

Respons sukses contoh

XML format

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

<DescribeDBInstanceAttributeResponse>
    <RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
    <Items>
        <VpcId>vpc-*****</VpcId>
        <CreationTime>2011-05-30T12:11:04Z</CreationTime>
        <IncrementSourceDBInstanceId>rm-uf6wjk5*****</IncrementSourceDBInstanceId>
        <MaintainTime>00:00Z-02:00Z</MaintainTime>
        <PayType>Postpaid</PayType>
        <AvailabilityValue>100.0%</AvailabilityValue>
        <EngineVersion>5.5</EngineVersion>
        <DedicatedHostGroupId>dhg-7a9*****</DedicatedHostGroupId>
        <ConnectionString>rm-uf6wjk5*****.mysql.rds.aliyuncs.com</ConnectionString>
        <SuperPermissionMode>Disabled</SuperPermissionMode>
        <InstanceNetworkType>Classic</InstanceNetworkType>
        <MasterInstanceId>rm-uf6wjk5*****</MasterInstanceId>
        <AutoUpgradeMinorVersion>Auto</AutoUpgradeMinorVersion>
        <ExpireTime>2019-03-27T16:00:00Z</ExpireTime>
        <AccountMaxQuantity>50</AccountMaxQuantity>
        <MasterZone>5454284</MasterZone>
        <GuardDBInstanceId>rm-uf64zsu*****</GuardDBInstanceId>
        <DBInstanceStorage>10</DBInstanceStorage>
        <TimeZone>Central Standard Time</TimeZone>
        <LatestKernelVersion>rds_20201031</LatestKernelVersion>
        <TipsLevel>1</TipsLevel>
        <ZoneId>cn-hangzhou-a</ZoneId>
        <MaxConnections>60</MaxConnections>
        <DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
        <TempDBInstanceId>rm-uf64zsu*****</TempDBInstanceId>
        <AdvancedFeatures>LinkedServer</AdvancedFeatures>
        <DBInstanceStorageType>local_ssd</DBInstanceStorageType>
        <DBInstanceMemory>4096</DBInstanceMemory>
        <IPType>IPv4</IPType>
        <ConsoleVersion>2</ConsoleVersion>
        <ConnectionMode>Standard</ConnectionMode>
        <Port>3306</Port>
        <LockMode>Unlock</LockMode>
        <GeneralGroupName>TestGroup</GeneralGroupName>
        <VpcCloudInstanceId>vpc-23rsxdf*****</VpcCloudInstanceId>
        <Collation>Chinese_PRC_CI_AS</Collation>
        <MaxIOPS>150</MaxIOPS>
        <Tips>Run as normal</Tips>
        <SecurityIPList>192.168.XX.XX/24</SecurityIPList>
        <SecurityIPMode>normal</SecurityIPMode>
        <DBInstanceClassType>s</DBInstanceClassType>
        <ProxyType>1</ProxyType>
        <CurrentKernelVersion>rds_20181010</CurrentKernelVersion>
        <DBInstanceDescription>Test database</DBInstanceDescription>
        <DBInstanceCPU>2</DBInstanceCPU>
        <DBInstanceNetType>Internet</DBInstanceNetType>
        <DBInstanceType>Primary</DBInstanceType>
        <LockReason>instance_expired</LockReason>
        <DBInstanceStatus>Running</DBInstanceStatus>
        <DBMaxQuantity>200</DBMaxQuantity>
        <RegionId>cn-hangzhou </RegionId>
        <ReadonlyInstanceSQLDelayedTime>30</ReadonlyInstanceSQLDelayedTime>
        <VSwitchId>vsw-*****</VSwitchId>
        <ResourceGroupId>rg-acfmy*****</ResourceGroupId>
        <Category>Basic</Category>
        <DBInstanceClass>rds.mys2.small</DBInstanceClass>
        <Engine>MySQL</Engine>
        <SlaveZones>
            <ZoneId>cn-hangzhou-a</ZoneId>
        </SlaveZones>
        <ReadOnlyDBInstanceIds>
            <DBInstanceId>rm-bp*****</DBInstanceId>
        </ReadOnlyDBInstanceIds>
        <Extra>
            <DBInstanceIds>rm-uf6wjk5*****</DBInstanceIds>
        </Extra>
        <DeletionProtection>true</DeletionProtection>
        <ServerlessConfig>
            <ScaleMin>0.5</ScaleMin>
            <ScaleMax>8</ScaleMax>
            <AutoPause>true</AutoPause>
            <SwitchForce>false</SwitchForce>
        </ServerlessConfig>
        <BabelfishConfig>
            <BabelfishEnabled>true</BabelfishEnabled>
            <MigrationMode>single-db</MigrationMode>
        </BabelfishConfig>
        <kindCode>None</kindCode>
        <InstructionSetArch>x86</InstructionSetArch>
        <DBClusterNodes>
            <NodeRegionId>cn-beijing</NodeRegionId>
            <NodeZoneId>cn-beijing-h</NodeZoneId>
            <NodeId>rn-****</NodeId>
            <NodeRole>primary</NodeRole>
            <ClassCode>mysql.n2.medium.xc</ClassCode>
        </DBClusterNodes>
    </Items>
</DescribeDBInstanceAttributeResponse>

JSON format

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

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "Items" : [ {
    "VpcId" : "vpc-*****",
    "CreationTime" : "2011-05-30T12:11:04Z",
    "IncrementSourceDBInstanceId" : "rm-uf6wjk5*****",
    "MaintainTime" : "00:00Z-02:00Z",
    "PayType" : "Postpaid",
    "AvailabilityValue" : "100.0%",
    "EngineVersion" : "5.5",
    "DedicatedHostGroupId" : "dhg-7a9*****",
    "ConnectionString" : "rm-uf6wjk5*****.mysql.rds.aliyuncs.com",
    "SuperPermissionMode" : "Disabled",
    "InstanceNetworkType" : "Classic",
    "MasterInstanceId" : "rm-uf6wjk5*****",
    "AutoUpgradeMinorVersion" : "Auto",
    "ExpireTime" : "2019-03-27T16:00:00Z",
    "AccountMaxQuantity" : 50,
    "MasterZone" : "5454284",
    "GuardDBInstanceId" : "rm-uf64zsu*****",
    "DBInstanceStorage" : 10,
    "TimeZone" : "Central Standard Time",
    "LatestKernelVersion" : "rds_20201031",
    "TipsLevel" : 1,
    "ZoneId" : "cn-hangzhou-a",
    "MaxConnections" : 60,
    "DBInstanceId" : "rm-uf6wjk5*****",
    "TempDBInstanceId" : "rm-uf64zsu*****",
    "AdvancedFeatures" : "LinkedServer",
    "DBInstanceStorageType" : "local_ssd",
    "DBInstanceMemory" : 4096,
    "IPType" : "IPv4",
    "ConsoleVersion" : "2",
    "ConnectionMode" : "Standard",
    "Port" : "3306",
    "LockMode" : "Unlock",
    "GeneralGroupName" : "TestGroup",
    "VpcCloudInstanceId" : "vpc-23rsxdf*****",
    "Collation" : "Chinese_PRC_CI_AS",
    "MaxIOPS" : 150,
    "Tips" : "Run as normal",
    "SecurityIPList" : "192.168.XX.XX/24",
    "SecurityIPMode" : "normal",
    "DBInstanceClassType" : "s",
    "ProxyType" : 1,
    "CurrentKernelVersion" : "rds_20181010",
    "DBInstanceDescription": "Test database",
    "DBInstanceCPU" : "2",
    "DBInstanceNetType" : "Internet",
    "DBInstanceType" : "Primary",
    "LockReason" : "instance_expired",
    "DBInstanceStatus" : "Running",
    "DBMaxQuantity" : 200,
    "RegionId" : "cn-hangzhou ",
    "ReadonlyInstanceSQLDelayedTime" : "30",
    "VSwitchId" : "vsw-*****",
    "ResourceGroupId" : "rg-acfmy*****",
    "Category" : "Basic",
    "DBInstanceClass" : "rds.mys2.small",
    "Engine" : "MySQL",
    "SlaveZones" : [ {
      "ZoneId" : "cn-hangzhou-a"
    } ],
    "ReadOnlyDBInstanceIds" : [ {
      "DBInstanceId" : "rm-bp*****"
    } ],
    "Extra" : {
      "DBInstanceIds" : [ "rm-uf6wjk5*****" ]
    },
    "DeletionProtection" : true,
    "ServerlessConfig" : {
      "ScaleMin" : 0.5,
      "ScaleMax" : 8,
      "AutoPause" : true,
      "SwitchForce" : false
    },
    "BabelfishConfig" : {
      "BabelfishEnabled" : "true",
      "MigrationMode" : "single-db"
    },
    "kindCode" : "None",
    "InstructionSetArch" : "x86",
    "DBClusterNodes" : [ {
      "NodeRegionId" : "cn-beijing",
      "NodeZoneId" : "cn-beijing-h",
      "NodeId" : "rn-****",
      "NodeRole" : "primary",
      "ClassCode" : "mysql.n2.medium.xc"
    } ]
  } ]
}

Kode kesalahan

Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
400 ConnectTimeoutRetryLater Connect timeout retry later. Pesan kesalahan yang dikembalikan karena koneksi ke instans mengalami timeout. Coba lagi nanti.
400 DataNotExist Data not exist. Pesan kesalahan yang dikembalikan karena tidak ada data yang tersedia.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.