調用ListQueues API查詢叢集的隊列列表-彈性高效能運算-阿里雲

查詢指定E-HPC叢集的隊列列表。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ehpc:ListQueues

list

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
ClusterId	string	否	叢集 ID。	ehpc-hz-FYUr32****
QueueNames	array	否	待查詢隊列名稱列表，N 的取值範圍：0～8。
	string	否	隊列名稱。	comp

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	C6E5005C-00B0-4F27-98BB-95AB88016C22
TotalCount	integer	查詢結果條數。	1
ClusterId	string	叢集 ID。您可以通過調用 ListClusters 擷取叢集 ID。	ehpc-hz-FYUr32****
PageNumber	integer	當前頁碼。	1
PageSize	integer	分頁查詢時設定的本頁條數。	10
Queues	array<object>	查詢隊列的詳細資料。
	array<object>	隊列詳細資料。
QueueName	string	隊列名稱。	comp
EnableScaleOut	boolean	隊列是否開啟自動擴容。取值範圍： true false	true
EnableScaleIn	boolean	隊列是否開啟自動縮容。取值範圍： true false	true
MinCount	integer	隊列保有的最小計算節點數量。	0
MaxCount	integer	隊列保有的最大計算節點數量。	100
MaxCountPerCycle	integer	隊列在每個擴容輪次中最小擴容的計算節點數量。	1
ComputeNodes	array	隊列自動擴容時計算節點的硬體設定列表。N 的取值範圍：0～5。
	NodeTemplate	計算節點的硬體設定。
VSwitchIds	array	隊列自動擴容時可使用的交換器列表。N 的取值範圍是：0～3。
	string	交換器 ID。	vsw-bp12pmqe9gh0pi7i1f2ed
Nodes	object	隊列保有的計算節點數量資訊。
RunningCounts	integer	處於運行狀態的計算節點數量。	1
ExceptionCounts	integer	處於異常狀態的計算節點數量。	0
CreatingCounts	integer	未就緒的計算節點數量。	2
CreateTime	string	隊列的建立時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。	2023-11-10T02:04:00Z
UpdateTime	string	隊列的更新時間。以 ISO 8601 為標準，並使用 UTC+0 時間，格式為 yyyy-MM-ddTHH:mmZ。更多資訊，請參見ISO 8601。	2024-04-25T02:02:32
TotalCores	integer	隊列中所有計算節點的總 vCPU 數。	24

樣本

正常返回樣本

JSON格式

{
  "RequestId": "C6E5005C-00B0-4F27-98BB-95AB88016C22",
  "TotalCount": 1,
  "ClusterId": "ehpc-hz-FYUr32****",
  "PageNumber": 1,
  "PageSize": 10,
  "Queues": [
    {
      "QueueName": "comp",
      "EnableScaleOut": true,
      "EnableScaleIn": true,
      "MinCount": 0,
      "MaxCount": 100,
      "MaxCountPerCycle": 1,
      "ComputeNodes": [
        {
          "InstanceType": "ecs.c7.4xlarge",
          "ImageId": "aliyun_3_x64_20G_alibase_20221102.vhd",
          "InstanceChargeType": "PostPaid",
          "PeriodUnit": "Month",
          "Period": 1,
          "AutoRenew": false,
          "AutoRenewPeriod": 1,
          "SpotStrategy": "NoSpot",
          "SpotPriceLimit": 0.97,
          "Duration": 1,
          "EnableHT": true,
          "SystemDisk": {
            "Category": "cloud_essd",
            "Size": 40,
            "Level": "PL0"
          },
          "DataDisks": [
            {
              "Category": "cloud_essd",
              "Size": 40,
              "Level": "PL0",
              "DeleteWithInstance": false,
              "MountDir": "/data1",
              "Device": "/dev/xvdb",
              "SnapshotId": "s-bp1ei2b44ripxuo46hym"
            }
          ]
        }
      ],
      "VSwitchIds": [
        "vsw-bp12pmqe9gh0pi7i1f2ed"
      ],
      "Nodes": {
        "RunningCounts": 1,
        "ExceptionCounts": 0,
        "CreatingCounts": 2
      },
      "CreateTime": "2023-11-10T02:04:00Z",
      "UpdateTime": "2024-04-25T02:02:32",
      "TotalCores": 24
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
404	ClusterNotFound	The specified cluster does not exist.	指定的叢集不存在，請您檢查該參數是否正確。
503	ServiceUnavailable	The request has failed due to a temporary failure of the server	請求失敗，服務暫時不可用

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

變更歷史

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