全部產品
Search
文件中心

Platform For AI:DescribeNodeGroup - 查詢節點群組詳細資料

更新時間:Mar 31, 2026

查詢節點分組。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

eflo:DescribeNodeGroup

get

*Cluster

acs:eflo:{#regionId}:{#accountId}:cluster/{#ClusterId}

請求參數

名稱

類型

必填

描述

樣本值

NodeGroupId

string

節點群組 id

i128903591758597631635

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

Id of the request

83896080-59E3-5775-BDDC-8084691C3D96

ImageName

string

鏡像名

Alinux3_x86_5.10.134-16.3_NV_RunC_D3_E3C7_570.133.20_V1.0_250428

NodeGroupDescription

string

節點群組描述

lingjun alinux node group

NodeGroupName

string

節點群組名稱

test-ack

NodeCount

string

節點數量

1

ClusterId

string

叢集 id

i111987311754895199538

NodeGroupId

string

節點群組 id

i120982301752461697971

CreateTime

string

建立時間

2025-07-07T17:19:42.980000

MachineType

string

機型

efg2.NH2cn

ImageId

string

鏡像 id

i190720111752146430748

UpdateTime

string

更新時間

2025-08-20T11:18:11.164000

ClusterName

string

叢集名稱

aliyun-basic-cluster

Az

string

可用性區域

cn-wulanchabu-a

UserData

string

使用者自訂指令碼

#!/bin/bash uptime echo "aaaaaaa" >> /tmp/tttest.sh

SystemDisk

object

雲系統硬碟資訊。

Size

integer

系統硬碟大小,單位為 GiB。取值範圍:

  • 普通雲端硬碟:20~500。

  • ESSD 雲端硬碟:
    • PL0:1~2048。

    • PL1:20~2048。

    • PL2:461~2048。

    • PL3:1261~2048。

  • ESSD AutoPL 雲端硬碟:1~2048。

  • 其他雲端硬碟類型:20~2048。

預設值:max{20, 參數 ImageId 對應的鏡像大小}。

1024

PerformanceLevel

string

建立 ESSD 雲端硬碟作為系統硬碟使用時,設定雲端硬碟的效能等級。取值範圍:

  • PL0:單盤最高隨機讀寫 IOPS 1 萬。

  • PL1:單盤最高隨機讀寫 IOPS 5 萬。

PL0

Category

string

雲端硬碟種類。

system

FileSystemMountEnabled

boolean

是否支援檔案儲存體掛載

True

VirtualGpuEnabled

boolean

是否支援 GPU 虛擬化切分

False

KeyPairName

string

金鑰組名稱。

k8s-key

LoginType

string

枚舉值: • password- 當前分組只支援密碼登入 • keypair- 當前分組只支援通行金鑰對登入 • both - 當前分組同時支援密碼和金鑰組登入

如果返回為空白,代表分組上沒有設定任何登入方式

password

RamRoleName

string

樣本

正常返回樣本

JSON格式

{
  "RequestId": "83896080-59E3-5775-BDDC-8084691C3D96",
  "ImageName": "Alinux3_x86_5.10.134-16.3_NV_RunC_D3_E3C7_570.133.20_V1.0_250428",
  "NodeGroupDescription": "lingjun alinux node group",
  "NodeGroupName": "test-ack",
  "NodeCount": "1",
  "ClusterId": "i111987311754895199538",
  "NodeGroupId": "i120982301752461697971",
  "CreateTime": "2025-07-07T17:19:42.980000",
  "MachineType": "efg2.NH2cn",
  "ImageId": "i190720111752146430748",
  "UpdateTime": "2025-08-20T11:18:11.164000",
  "ClusterName": "aliyun-basic-cluster",
  "Az": "cn-wulanchabu-a",
  "UserData": "#!/bin/bash\nuptime\necho \"aaaaaaa\" >> /tmp/tttest.sh",
  "SystemDisk": {
    "Size": 1024,
    "PerformanceLevel": "PL0",
    "Category": "system"
  },
  "FileSystemMountEnabled": true,
  "VirtualGpuEnabled": true,
  "KeyPairName": "k8s-key",
  "LoginType": "password",
  "RamRoleName": ""
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情