您可以通过GetClusterQueueInfo查询集群上已存在的Queue的信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

GET /api/v2/clusters/[clusterId]/queueinfo HTTPS

请求参数

名称 类型 是否必选 示例值 描述
clusterId String d6wxwo5tnrmuamx2ly3m

集群ID

RegionId String cn-hangzhou

区域ID

说明 公共云用户忽略此参数。

返回数据

名称 类型 示例值 描述
Queues Array

返回结果的数据内容

Queue
ClusterId String d6wxwo5tnrmuamx2ly3m****

集群名称

ExternalInfo String {"minGpu":0,"maxGpu":0,"name":"root.default","minMem":10526,"usedVCore":450,"usedGpu":0,"usedMem":15360,"minVCore":228,"maxVCore":1000,"maxMem":40960}"}

未转换为INTEGER时的原始信息

说明
  • 仅在aliyun-java-sdk-foas 2.7.0及以上版本返回ExternalInfo。
  • Integer类型返回-9999时,表示该数值超过Integer能表示的大小,请从ExternalInfo中取值。
MaxGpu Integer 0

最大GPU

MaxMem Integer 2048

内存最大值(MB)

MaxVCore Integer 100

最大Vcore数

MinGpu Integer 0

最小GPU

MinMem Integer 1024

最小内存数(MB)

MinVCore Integer 50

最小Vcore数

QueueName String root.default

队列名称

UsedGpu Integer 5

已使用GPU

UsedMem Integer 512

已使用内存(MB)

UsedVCore Integer 100

已使用Vcore

RequestId String FD0FF8C0-779A-45EB-9674-FF3E127B****

请求ID

示例

请求示例

http(s)://[Endpoint]/?clusterId=cmy99ugusuco66x9qc6k****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

<o>
      <requestId>F30CF229-AC71-4359-95FC-xxxxx</requestId>
      <queues>
          <clusterId>xxxxx</clusterId>
          <queueName>root.default</queueName>
          <minGpu>0</minGpu>
          <maxGpu>0</maxGpu>
          <minMem>36099</minMem>
          <usedVCore>700</usedVCore>
          <usedGpu>0</usedGpu>
          <usedMem>24192</usedMem>
          <minVCore>783</minVCore>
          <maxVCore>1000</maxVCore>
          <maxMem>40960</maxMem>
          <externalInfo>{"minGpu":0,"maxGpu":0,"name":"root.default","minMem":36099,"usedVCore":700,"usedGpu":0,"usedMem":24192,"minVCore":783,"maxVCore":1000,"maxMem":40960}</externalInfo>
      </queues>
      <queues>
          <clusterId>xxxx</clusterId>
          <queueName>root.test</queueName>
          <minGpu>0</minGpu>
          <maxGpu>0</maxGpu>
          <minMem>884437</minMem>
          <usedVCore>5925</usedVCore>
          <usedGpu>0</usedGpu>
          <usedMem>268288</usedMem>
          <minVCore>19193</minVCore>
          <maxVCore>49000</maxVCore>
          <maxMem>2007040</maxMem>
          <externalInfo>{"minGpu":0,"maxGpu":0,"name":"root.test","minMem":884437,"usedVCore":5925,"usedGpu":0,"usedMem":268288,"minVCore":19193,"maxVCore":49000,"maxMem":2007040}</externalInfo>
      </queues>
  </o>

JSON 格式

{
    "requestId":"F30CF229-AC71-4359-95FC-xxxxx",
    "queues":[
        {
            "clusterId":"xxxxx",
            "queueName":"root.default",
            "minGpu":0,
            "maxGpu":0,
            "minMem":36099,
            "usedVCore":700,
            "usedGpu":0,
            "usedMem":24192,
            "minVCore":783,
            "maxVCore":1000,
            "maxMem":40960,
            "externalInfo":"{\"minGpu\":0,\"maxGpu\":0,\"name\":\"root.default\",\"minMem\":36099,\"usedVCore\":700,\"usedGpu\":0,\"usedMem\":24192,\"minVCore\":783,\"maxVCore\":1000,\"maxMem\":40960}"
        },
        {
            "clusterId":"xxxx",
            "queueName":"root.test",
            "minGpu":0,
            "maxGpu":0,
            "minMem":884437,
            "usedVCore":5925,
            "usedGpu":0,
            "usedMem":268288,
            "minVCore":19193,
            "maxVCore":49000,
            "maxMem":2007040,
            "externalInfo":"{\"minGpu\":0,\"maxGpu\":0,\"name\":\"root.test\",\"minMem\":884437,\"usedVCore\":5925,\"usedGpu\":0,\"usedMem\":268288,\"minVCore\":19193,\"maxVCore\":49000,\"maxMem\":2007040}"
        }]
}

错误码

访问错误中心查看更多错误码。