Kueri Atribut Kluster AI DB melalui DescribeAIDBClusterAttribute - PolarDB - Alibaba Cloud - PolarDB

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

Parameter permintaan

Parameter	Type	Required	Description	Example
DBClusterId	string	Yes	ID kluster.	pc-****************

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
AiNodeType	string	Tipe node. Nilai valid: vnode: Dikelola oleh ACK container: Kontainer yang dapat diakses maas: Layanan model	vnode
ApiKey	string	Kunci API.	x********
CreationTime	string	Waktu saat kluster dibuat. Waktu dalam format ISO 8601 UTC (format: YYYY-MM-DDTHH:mm:ssZ).	2020-08-14T05:58:42Z
CustomOssPath	string	Jalur OSS model kustom yang saat ini digunakan oleh instans.	/my-model-bucket/models/qwen3
DBClusterDescription	string	Deskripsi kluster. Pencocokan kabur didukung.	test
DBClusterId	string	ID kluster.	pc-**************
DBClusterStatus	string	Status kluster. Nilai valid: Creating: Kluster sedang dibuat. Running: Kluster sedang berjalan. Deleting: Kluster sedang dilepas. DBNodeCreating: Node sedang ditambahkan. DBNodeDeleting: Node sedang dihapus. ClassChanging: Spesifikasi node sedang diubah. Deleted: Kluster telah dilepas.	Running
DBInstanceStatusDesc	string
DBNodes	array<object>	Detail node.
	array<object>	Detail node.
ChildVolumes	array<object>	Daftar cloud disk data.
	object	Informasi cloud disk data.
MountPath	string	Jalur pemasangan aktual.	/tmp/CrowdStrike
Name	string	Nama disk.	jueming
SizeGB	string	Ukuran disk penyimpanan.	8192
StorageCategory	string	Tipe penyimpanan.	PolarFs
StorageType	string	Kategori penyimpanan.	PL1
CpuCores	string	Jumlah inti CPU node.	2
CreationTime	string	Waktu pembuatan. Waktu dalam format ISO 8601 UTC (format: YYYY-MM-DDTHH:mm:ssZ).	2020-08-14T05:58:42Z
DBNodeClass	string	Spesifikasi kluster.	polar.pg.g8.8xlarge.gu30
DBNodeDescription	string	Deskripsi node.	test
DBNodeId	string	ID node.	pi-****************
DBNodeStatus	string	Status node. Nilai valid: Creating: Node sedang dibuat. Running: Node sedang berjalan. Deleting: Node sedang dihapus. Rebooting: Node sedang dimulai ulang. DBNodeCreating: Node sedang ditambahkan. DBNodeDeleting: Node sedang dihapus. ClassChanging: Spesifikasi node sedang diubah. MinorVersionUpgrading: Pembaruan versi mesin minor sedang berlangsung. Maintaining: Instans sedang dalam pemeliharaan. Switching: Alih bencana sedang berlangsung.	Running
GPU	string	Jumlah kartu GPU.	2
LinkIP	string	Alamat IP pribadi.	10..12
MemorySize	string	Ukuran memori node. Unit: MB.	8192
ModelName	string
PublicIp	string	Alamat IP publik.	101.101.101.101
SupportedApis	array<object>	API yang didukung.
	object
ApiName	string	Nama API yang didukung oleh node database.
GenerationMode	string
Path	string	Jalur API yang didukung.
Protocol	string	Jenis protokol API yang didukung.
VNodeId	string	ID node virtual Kubernetes.	vn-***************
VPCId	string	ID VPC.	vpc-*******************
VSwitchId	string	ID vSwitch.	vsw-*********************
ZoneId	string	ID zona.	cn-hangzhou-d
DBVersion	string	Versi kluster. Nilai valid: 1.0 2.0 3.0	1.0
DedicatedHostModel	boolean
EcsSecurityGroupId	string	ID grup keamanan.	sg-xxxxxx
EndpointList	array<object>	Daftar titik akhir jaringan instans.
	array<object>	Titik akhir jaringan instans.
NetInfoItems	array<object>	Daftar informasi jaringan instans.
	object	Informasi jaringan instans.
ConnectionString	string	Titik akhir database.	pc-**********.rwlb.rds.aliyuncs.com
NetType	string	Jenis jaringan titik akhir. Nilai valid: Public: Titik akhir publik Private: Titik akhir pribadi Inner: Titik akhir pribadi (jaringan klasik)	Public
Port	string	Nomor port.	3306
ExpireTime	string	Waktu kedaluwarsa kluster. Catatan Hanya kluster dengan metode penagihan Prepaid (langganan) yang mengembalikan nilai tertentu. Kluster Postpaid (bayar sesuai pemakaian) mengembalikan nilai kosong. Waktu dalam format ISO 8601 UTC (format: YYYY-MM-DDTHH:mm:ssZ).	2020-11-14T16:00:00Z
Expired	boolean	Apakah kluster telah kedaluwarsa. Nilai valid: true false	false
GatewayId	string
InferenceEngine	string
InternalIp	string	Alamat IP internal.	10...72
KVCacheInstanceId	string	ID instans KVCache.	pkv-xxxxx
KubeClusterId	string	ID kluster ACK.	xxxxxxxxxxxxxxxxxxxxxxx
LockMode	string	Mode kunci instans. Nilainya adalah lock, yang menunjukkan bahwa instans telah kedaluwarsa secara otomatis atau memiliki pembayaran tertunda.	Unlock
MaxQPM	string	Jumlah maksimum permintaan per menit.	20
MaxTPM	string
ModelName	string	Nama model.	Qwen3-Embedding-8B
ModelSpaceName	string
ModelType	string	Tipe model.	custom
PayType	string	Metode penagihan. Nilai valid: Postpaid: Bayar sesuai pemakaian. Prepaid: Langganan.	Postpaid
PreviousCustomOssPath	string	Jalur OSS model kustom sebelum perubahan terakhir.	/my-model-bucket/models/qwen2
PublicIp	string	Alamat IP publik.	8.xxx.xxx.xxx
RegionId	string	ID wilayah.	cn-hangzhou
RequestId	string	ID permintaan.	EBEAA83D-1734-42E3-85E3-E25F6E******
RunType	string	Tipe arsitektur. Nilai valid: container: Kontainer AI ainode: Node AI	Kontainer
StorageType	string	Nilai valid untuk tipe penyimpanan Edisi Perusahaan: PSL5 PSL4 Nilai valid untuk tipe penyimpanan Edisi Standar: ESSDPL0 ESSDPL1 ESSDPL2 ESSDPL3 ESSDAUTOPL	essdpl1
TimeSlicesInfo	object
TimeSlices	array<object>
	object
BeginTime	string
EndTime	string
TimeSlicesType	string
VPCId	string	ID VPC yang dapat ditentukan untuk alih bencana lintas zona.	vpc-*******************
VSwitchId	string	ID vSwitch. Catatan Jika VPCId ditentukan, VSwitchId wajib diisi.	vsw-*********************
VnodeKubernetesConfig	object
Labels	array<object>
	object
Key	string
Value	string
Taints	array<object>
	object
Effect	string
Key	string
Value	string
Volumes	array<object>	Daftar cloud disk data.
	object	Informasi cloud disk data.
MountPath	string	Jalur pemasangan di dalam kontainer.	/var/run/secrets/kubernetes.io/layananaccount
Name	string	Nama disk.	jueming
SizeGB	string	Ukuran penyimpanan.	8192
StorageCategory	string	Tipe penyimpanan.	PL1
StorageType	string	Kategori penyimpanan.	PolarFs
ZoneId	string	ID zona node kluster PolarDB Basis Data Relasional Cloud-Native.	cn-hangzhou-d
ZoneIds	string	ID zona.	cn-hangzhou-i,cn-hangzhou-g

Contoh

Respons sukses

JSONformat

{
  "AiNodeType": "vnode",
  "ApiKey": "x********",
  "CreationTime": "2020-08-14T05:58:42Z",
  "CustomOssPath": "/my-model-bucket/models/qwen3",
  "DBClusterDescription": "test",
  "DBClusterId": "pc-**************",
  "DBClusterStatus": "Running",
  "DBInstanceStatusDesc": "",
  "DBNodes": [
    {
      "ChildVolumes": [
        {
          "MountPath": "/tmp/CrowdStrike",
          "Name": "jueming",
          "SizeGB": "8192",
          "StorageCategory": "PolarFs",
          "StorageType": "PL1"
        }
      ],
      "CpuCores": "2",
      "CreationTime": "2020-08-14T05:58:42Z",
      "DBNodeClass": "\npolar.pg.g8.8xlarge.gu30",
      "DBNodeDescription": "test",
      "DBNodeId": "pi-****************",
      "DBNodeStatus": "Running",
      "GPU": "2",
      "LinkIP": "10.*.*12",
      "MemorySize": "8192",
      "ModelName": "",
      "PublicIp": "101.101.101.101",
      "SupportedApis": [
        {
          "ApiName": "",
          "GenerationMode": "",
          "Path": "",
          "Protocol": ""
        }
      ],
      "VNodeId": "vn-***************",
      "VPCId": "vpc-*******************",
      "VSwitchId": "vsw-*********************",
      "ZoneId": "cn-hangzhou-d"
    }
  ],
  "DBVersion": "1.0",
  "DedicatedHostModel": false,
  "EcsSecurityGroupId": "sg-xxxxxx",
  "EndpointList": [
    {
      "NetInfoItems": [
        {
          "ConnectionString": "pc-**********.rwlb.rds.aliyuncs.com",
          "NetType": "Public",
          "Port": "3306"
        }
      ]
    }
  ],
  "ExpireTime": "2020-11-14T16:00:00Z",
  "Expired": false,
  "GatewayId": "",
  "InferenceEngine": "",
  "InternalIp": "10.*.*.72",
  "KVCacheInstanceId": "pkv-xxxxx",
  "KubeClusterId": "xxxxxxxxxxxxxxxxxxxxxxx",
  "LockMode": "Unlock",
  "MaxQPM": "20",
  "MaxTPM": "",
  "ModelName": "\nQwen3-Embedding-8B",
  "ModelSpaceName": "",
  "ModelType": "custom",
  "PayType": "Postpaid",
  "PreviousCustomOssPath": "/my-model-bucket/models/qwen2",
  "PublicIp": "8.xxx.xxx.xxx",
  "RegionId": "cn-hangzhou",
  "RequestId": "EBEAA83D-1734-42E3-85E3-E25F6E******",
  "RunType": "Kontainer",
  "StorageType": "essdpl1",
  "TimeSlicesInfo": {
    "TimeSlices": [
      {
        "BeginTime": "",
        "EndTime": ""
      }
    ]
  },
  "TimeSlicesType": "",
  "VPCId": "vpc-*******************",
  "VSwitchId": "vsw-*********************",
  "VnodeKubernetesConfig": {
    "Labels": [
      {
        "Key": "",
        "Value": ""
      }
    ],
    "Taints": [
      {
        "Effect": "",
        "Key": "",
        "Value": ""
      }
    ]
  },
  "Volumes": [
    {
      "MountPath": "/var/run/secrets/kubernetes.io/layananaccount",
      "Name": "jueming",
      "SizeGB": "8192",
      "StorageCategory": "PL1",
      "StorageType": "PolarFs"
    }
  ],
  "ZoneId": "cn-hangzhou-d",
  "ZoneIds": "cn-hangzhou-i,cn-hangzhou-g"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	DBClusterId yang ditentukan tidak ada dalam catatan kami.
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.	DBClusterId yang ditentukan tidak ada dalam catatan saat ini.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.