All Products
Search
Document Center

PolarDB:DescribeAIDBClusterAttribute

Last Updated:Jun 24, 2026

Mengkueri detail instans kustom.

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

polardb:DescribeAIDBClusterAttribute

get

*AICluster

acs:polardb:{#regionId}:{#accountId}:aicluster/{#DBClusterId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DBClusterId

string

Yes

ID kluster.

pc-****************

Elemen respons

Element

Type

Description

Example

object

Skema Respons.

RequestId

string

ID permintaan.

EBEAA83D-1734-42E3-85E3-E25F6E******

DBClusterId

string

ID kluster.

pc-**************

DBClusterStatus

string

Status kluster. Nilai valid:

  • Creating: sedang dibuat

  • Running: berjalan

  • Deleting: sedang dilepas

  • DBNodeCreating: menambahkan node

  • DBNodeDeleting: menghapus node

  • ClassChanging: mengubah spesifikasi node

  • Deleted: dilepas.

Running

DBClusterDescription

string

Deskripsi kluster. Pencocokan kabur didukung.

test

RegionId

string

ID wilayah.

cn-hangzhou

ZoneId

string

ID zona node kluster PolarDB Basis Data Relasional Cloud-Native.

cn-hangzhou-d

VPCId

string

ID VPC yang ditentukan untuk alih bencana zona.

vpc-*******************

VSwitchId

string

ID vSwitch.

Catatan

Jika VPCId ditentukan, VSwitchId wajib diisi.

vsw-*********************

InternalIp

string

Alamat IP internal.

10.*.*.72

StorageType

string

Nilai valid untuk PolarDB Basis Data Relasional Cloud-Native Edisi Perusahaan:

  • PSL5

  • PSL4

Nilai valid untuk PolarDB for MySQL Edisi Standar:

  • ESSDPL0

  • ESSDPL1

  • ESSDPL2

  • ESSDPL3

  • ESSDAUTOPL.

essdpl1

DBNodes

array<object>

Detail node.

array<object>

Detail node.

DBNodeClass

string

Spesifikasi kluster.

polar.pg.g8.8xlarge.gu30

CpuCores

string

Jumlah inti CPU node.

2

MemorySize

string

Ukuran memori node. Unit: MB.

8192

GPU

string

Jumlah kartu GPU.

2

DBNodeId

string

ID node.

pi-****************

DBNodeDescription

string

Deskripsi node.

test

VSwitchId

string

ID vSwitch.

vsw-*********************

VPCId

string

ID VPC.

vpc-*******************

DBNodeStatus

string

Status node. Nilai valid:

  • Creating: sedang dibuat

  • Running: berjalan

  • Deleting: sedang dihapus

  • Rebooting: sedang dimulai ulang

  • DBNodeCreating: menambahkan node

  • DBNodeDeleting: menghapus node

  • ClassChanging: mengubah spesifikasi node

  • MinorVersionUpgrading: meningkatkan versi mesin minor

  • Maintaining: dalam pemeliharaan

  • Switching: sedang dialihkan.

Running

ZoneId

string

ID zona.

cn-hangzhou-d

VNodeId

string

ID node virtual Kubernetes.

vn-***************

LinkIP

string

Alamat IP pribadi.

10.*.*12

ChildVolumes

array<object>

Daftar cloud disk data.

object

Informasi cloud disk data.

StorageType

string

Tipe penyimpanan.

PL1

StorageCategory

string

Kategori penyimpanan.

PolarFs

SizeGB

string

Ukuran data disk dalam GB.

8192

Name

string

Nama disk.

jueming

MountPath

string

Path mount.

/tmp/CrowdStrike

PublicIp

string

Alamat IP publik.

101.101.101.101

CreationTime

string

Waktu pembuatan.

2020-08-14T05:58:42Z

LockMode

string

Mode penguncian instans. Nilai lock menunjukkan bahwa instans terkunci secara otomatis karena kedaluwarsa atau pembayaran tertunda.

Unlock

CreationTime

string

Waktu pembuatan kluster.

2020-08-14T05:58:42Z

PayType

string

Metode penagihan. Nilai valid:

  • Postpaid: bayar sesuai pemakaian.

  • Prepaid: langganan.

Postpaid

ExpireTime

string

Waktu kedaluwarsa kluster.

Catatan

Parameter ini hanya dikembalikan untuk kluster Prepaid (langganan). Nilai kosong dikembalikan untuk kluster Postpaid (bayar sesuai pemakaian).

2020-11-14T16:00:00Z

Expired

boolean

Apakah kluster telah kedaluwarsa. Nilai valid:

  • true

  • false.

false

ZoneIds

string

ID zona.

cn-hangzhou-i,cn-hangzhou-g

RunType

string

Jenis arsitektur. Nilai valid:

  • container: Kontainer AI

  • ainode: Node AI.

container

KubeClusterId

string

ID kluster ACK.

xxxxxxxxxxxxxxxxxxxxxxx

DBVersion

string

Versi kluster. Nilai valid:

1.0

2.0

3.0.

1.0

AiNodeType

string

Jenis node. Nilai valid:

  • vnode: dikelola oleh ACK

  • container: kontainer yang diaktifkan untuk masuk

  • maas: layanan model.

vnode

Volumes

array<object>

Daftar cloud disk data.

object

Informasi cloud disk data.

StorageType

string

Kelas penyimpanan.

PolarFs

StorageCategory

string

Jenis penyimpanan.

PL1

Name

string

Nama cloud disk.

jueming

SizeGB

string

Ukuran penyimpanan.

8192

MountPath

string

Jalur memasang di kontainer.

/var/run/secrets/kubernetes.io/serviceaccount

EndpointList

array<object>

Daftar alamat koneksi jaringan instans.

array<object>

Alamat koneksi jaringan instans.

NetInfoItems

array<object>

Daftar informasi jaringan instans.

object

Informasi jaringan instans.

NetType

string

Tipe jaringan endpoint. Nilai yang valid:

  • Public: Endpoint publik.

  • Private: Endpoint privat.

  • Inner: Endpoint privat di jaringan classic.

Public

ConnectionString

string

Endpoint database.

pc-**********.rwlb.rds.aliyuncs.com

Port

string

Nomor port.

3306

ModelName

string

Nama model.

Qwen3-Embedding-8B

GatewayId

string

MaxQPM

string

Jumlah maksimum permintaan per menit.

20

PublicIp

string

Alamat IP publik.

8.xxx.xxx.xxx

KVCacheInstanceId

string

ID instans KVCache.

pkv-xxxxx

EcsSecurityGroupId

string

ID grup keamanan.

sg-xxxxxx

ModelType

string

Jenis model.

custom

ApiKey

string

Kunci API.

x********

Contoh

Respons sukses

JSONformat

{
  "RequestId": "EBEAA83D-1734-42E3-85E3-E25F6E******",
  "DBClusterId": "pc-**************",
  "DBClusterStatus": "Running",
  "DBClusterDescription": "test",
  "RegionId": "cn-hangzhou",
  "ZoneId": "cn-hangzhou-d\t\n",
  "VPCId": "vpc-*******************",
  "VSwitchId": "vsw-*********************",
  "InternalIp": "10.*.*.72",
  "StorageType": "essdpl1",
  "DBNodes": [
    {
      "DBNodeClass": "\npolar.pg.g8.8xlarge.gu30",
      "CpuCores": "2",
      "MemorySize": "8192",
      "GPU": "2",
      "DBNodeId": "pi-****************",
      "DBNodeDescription": "test",
      "VSwitchId": "vsw-*********************",
      "VPCId": "vpc-*******************",
      "DBNodeStatus": "Running",
      "ZoneId": "cn-hangzhou-d\t\n",
      "VNodeId": "vn-***************",
      "LinkIP": "10.*.*12",
      "ChildVolumes": [
        {
          "StorageType": "PL1",
          "StorageCategory": "PolarFs",
          "SizeGB": "8192",
          "Name": "jueming",
          "MountPath": "/tmp/CrowdStrike"
        }
      ],
      "PublicIp": "101.101.101.101",
      "CreationTime": "2020-08-14T05:58:42Z"
    }
  ],
  "LockMode": "Unlock",
  "CreationTime": "2020-08-14T05:58:42Z",
  "PayType": "Postpaid",
  "ExpireTime": "2020-11-14T16:00:00Z",
  "Expired": false,
  "ZoneIds": "cn-hangzhou-i,cn-hangzhou-g",
  "RunType": "container",
  "KubeClusterId": "xxxxxxxxxxxxxxxxxxxxxxx",
  "DBVersion": "1.0",
  "AiNodeType": "vnode",
  "Volumes": [
    {
      "StorageType": "PolarFs",
      "StorageCategory": "PL1",
      "Name": "jueming",
      "SizeGB": "8192",
      "MountPath": "/var/run/secrets/kubernetes.io/serviceaccount"
    }
  ],
  "EndpointList": [
    {
      "NetInfoItems": [
        {
          "NetType": "Public",
          "ConnectionString": "pc-**********.rwlb.rds.aliyuncs.com",
          "Port": "3306"
        }
      ]
    }
  ],
  "ModelName": "\nQwen3-Embedding-8B",
  "GatewayId": "",
  "MaxQPM": "20",
  "PublicIp": "8.xxx.xxx.xxx",
  "KVCacheInstanceId": "pkv-xxxxx",
  "EcsSecurityGroupId": "sg-xxxxxx",
  "ModelType": "custom",
  "ApiKey": "x********"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.
404 InvalidDBClusterId.NotFound The DBInstanceId provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.