使用 DescribeAIDBClusterAttribute 查詢 AI DB 叢集屬性 - 雲原生資料庫 PolarDB - 阿里雲 - PolarDB

檢視 custom 執行個體詳細資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardb:DescribeAIDBClusterAttribute

get

*AICluster

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

無

請求參數

名稱	類型	必填	描述	樣本值
DBClusterId	string	是	叢集 ID。	pc-****************

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	Id of the request	EBEAA83D-1734-42E3-85E3-E25F6E******
DBClusterId	string	叢集 ID。	pc-**************
DBClusterStatus	string	叢集狀態，取值範圍如下： Creating：建立中 Running：執行中 Deleting：釋放中 DBNodeCreating：正在增加節點 DBNodeDeleting：正在刪除節點 ClassChanging：正在變更節點規格 Deleted：已釋放	Running
DBClusterDescription	string	叢集描述，可模糊查詢。	test
RegionId	string	地域 ID。	cn-hangzhou
ZoneId	string	PolarDB 叢集節點的可用區 ID。	cn-hangzhou-d
VPCId	string	切換可用區支援指定的專屬網路 ID。	vpc-*******************
VSwitchId	string	虛擬交換器 ID。說明如果已選擇 VPCId，則 VSwitchId 必選。	vsw-*********************
InternalIp	string	內網 IP。	10...72
StorageType	string	企業版儲存類型取值如下： PSL5 PSL4 標準版儲存類型取值如下： ESSDPL0 ESSDPL1 ESSDPL2 ESSDPL3 ESSDAUTOPL	essdpl1
DBNodes	array<object>	節點資訊詳情。
	array<object>	節點資訊詳情。
DBNodeClass	string	叢集規格。	polar.pg.g8.8xlarge.gu30
CpuCores	string	節點 CPU 核心數。	2
MemorySize	string	節點記憶體大小，單位：MB。	8192
GPU	string	GPU 卡數。	2
DBNodeId	string	節點 ID。	pi-****************
DBNodeDescription	string	節點描述。	test
VSwitchId	string	虛擬交換器 ID。	vsw-*********************
VPCId	string	專屬網路 ID。	vpc-*******************
DBNodeStatus	string	節點狀態，取值範圍如下： Creating：建立中 Running：執行中 Deleting：刪除中 Rebooting：重新啟動中 DBNodeCreating：正在增加節點 DBNodeDeleting：正在刪除節點 ClassChanging：正在變更節點規格 MinorVersionUpgrading：小版本升級中 Maintaining：執行個體維護中 Switching：切換中	Running
ZoneId	string	可用區。	cn-hangzhou-d
VNodeId	string	k8s 虛擬節點 ID。	vn-***************
LinkIP	string	私網 IP。	10..12
ChildVolumes	array<object>	資料磁碟清單。
	object	資料磁碟資訊。
StorageType	string	儲存類別	PL1
StorageCategory	string	儲存類型	PolarFs
SizeGB	string	儲存盤大小	8192
Name	string	磁碟名	jueming
MountPath	string	實際掛載路徑	/tmp/CrowdStrike
PublicIp	string	公網 IP。	101.101.101.101
CreationTime	string	建立時間。	2020-08-14T05:58:42Z
LockMode	string	執行個體鎖定模式，取值為 lock，表示執行個體自動過期或欠費。	Unlock
CreationTime	string	叢集建立時間。	2020-08-14T05:58:42Z
PayType	string	付費類型。取值範圍如下： Postpaid：按量付費。 Prepaid：預付費（包年包月）。	Postpaid
ExpireTime	string	叢集到期時間。說明僅付費方式為 Prepaid（包年包月）的叢集會返回具體參數值，Postpaid（按量付費）叢集則返回空值。	2020-11-14T16:00:00Z
Expired	boolean	叢集是否已過期。取值範圍如下： true false	false
ZoneIds	string	可用區 ID。	cn-hangzhou-i,cn-hangzhou-g
RunType	string	架構類型。可選： container：AI 容器 ainode：AI 節點。	container
KubeClusterId	string	ACK 叢集 ID。	xxxxxxxxxxxxxxxxxxxxxxx
DBVersion	string	叢集版本，取值為： 1.0 2.0 3.0。	1.0
AiNodeType	string	節點類型。可選： vnode：ACK 納管 container：可登入容器 maas：模型服務	vnode
Volumes	array<object>	資料磁碟清單。
	object	資料磁碟資料。
StorageType	string	儲存類別。	PolarFs
StorageCategory	string	儲存類型。	PL1
Name	string	磁碟名稱。	jueming
SizeGB	string	儲存大小。	8192
MountPath	string	容器內掛載路徑。	/var/run/secrets/kubernetes.io/serviceaccount
EndpointList	array<object>	執行個體的網路連結位址清單。
	array<object>	執行個體的網路連結位址。
NetInfoItems	array<object>	執行個體的網路資訊清單。
	object	執行個體的網路資訊清單。
NetType	string	連線串網路類型，取值範圍如下： Public：公網地址 Private：私網地址 Inner：私網地址（經典網路）	Public
ConnectionString	string	資料庫連線地址。	pc-**********.rwlb.rds.aliyuncs.com
Port	string	埠號。	3306
ModelName	string	模型名稱。	Qwen3-Embedding-8B
GatewayId	string
MaxQPM	string	每分鐘最大請求數。	20
PublicIp	string	公網 IP 位址。	8.xxx.xxx.xxx
KVCacheInstanceId	string	KVCache 執行個體 ID。	pkv-xxxxx
EcsSecurityGroupId	string	安全性群組 ID。	sg-xxxxxx
ModelType	string	模型類型。	custom
ApiKey	string	API 金鑰。	x********
TimeSlicesType	string
VnodeKubernetesConfig	object
Labels	array<object>
	object
Key	string
Value	string
Taints	array<object>
	object
Key	string
Value	string
Effect	string
TimeSlicesInfo	object
TimeSlices	array<object>
	object
BeginTime	string
EndTime	string

樣本

正常返回樣本

JSON格式

{
  "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********",
  "TimeSlicesType": "",
  "VnodeKubernetesConfig": {
    "Labels": [
      {
        "Key": "",
        "Value": ""
      }
    ],
    "Taints": [
      {
        "Key": "",
        "Value": "",
        "Effect": ""
      }
    ]
  },
  "TimeSlicesInfo": {
    "TimeSlices": [
      {
        "BeginTime": "",
        "EndTime": ""
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	我們的記錄中不存在提供的 DBClusterId。
404	InvalidDBClusterId.NotFound	The DBInstanceId provided does not exist in our records.	目前的記錄中不存在提供的 DBClusterId。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。