查询所有队列
功能介绍
该API用于列出该project下所有的队列。
调试
您可以在API Explorer中调试该接口。
URI
- URI格式:
- 参数说明
表1 URI参数 参数名称
是否必选
参数类型
说明
project_id
是
String
项目编号,用于资源隔离。获取方式请参考获取项目ID。
表2 query参数 参数名称
是否必选
参数类型
说明
queue_type
否
String
队列的类型,有如下三种类型:
- sql:查询SQL队列类型的队列。
- general:查询通用队列类型的队列。
- all:查询所有类型的队列。
如果不指定,默认为sql。
with-priv
否
Boolean
是否返回权限信息。
with-charge-info
否
Boolean
是否返回收费信息。
page-size
否
Integer
每页显示的最大结果行数,默认值Integer.MAX_VALUE(也即不分页)。
current-page
否
Integer
当前页码,默认为第一页。
order
否
String
指定队列排序方式。
默认为queue_name_asc(队列名称升序),支持queue_name_asc(队列名称升序)、queue_name_desc(队列名称降序)、cu_asc(CU数升序)、cu_desc(CU数降序)四种排序。
tags
否
String
查询根据标签进行过滤。
请求消息
无请求参数。
响应消息
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
is_success |
否 |
Boolean |
请求执行是否成功。“true”表示请求执行成功。 |
message |
否 |
String |
系统提示信息,执行成功时,信息可能为空。 |
queues |
否 |
Array of Object |
队列信息。具体请参考表4。 |
参数名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
queue_id |
否 |
Long |
队列ID。 |
queue_name |
否 |
String |
队列名称。 |
description |
否 |
String |
队列描述信息。 |
owner |
否 |
String |
创建队列的用户。 |
create_time |
否 |
Long |
创建队列的时间。单位为“毫秒”的时间戳。 |
queue_type |
否 |
String |
队列的类型,。
如果不指定,默认为“sql”。 |
cu_count |
否 |
Integer |
与该队列绑定的计算单元数,即当前队列的CU数。 |
charging_mode |
否 |
Integer |
队列的收费模式。
|
resource_id |
否 |
String |
队列的资源ID。 |
enterprise_project_id |
否 |
String |
企业项目ID。0”表示default,即默认的企业项目。关于如何设置企业项目请参考《企业管理用户指南》。
说明:
开通了企业管理服务的用户可设置该参数绑定指定的项目。 |
cidr_in_vpc |
否 |
String |
队列的虚拟私有云(VPC)的网段。例如:10.0.0.0/8~24,172.16.0.0/12~24,192.168.0.0/16~24。 |
cidr_in_mgntsubnet |
否 |
String |
管理子网的网段。 |
cidr_in_subnet |
否 |
String |
子网网段。 |
resource_mode |
否 |
Integer |
资源模式。
|
platform |
否 |
String |
队列计算资源的cpu架构。
|
is_restarting |
否 |
Boolean |
是否重启队列。默认值为“false”。 |
labels |
否 |
String |
创建队列的标签信息,目前包括队列是否跨AZ的标签信息的Json字符串。目前只支持值为“2”,即创建两个队列。 |
feature |
否 |
String |
队列的镜像类型。支持以下两种类型:
默认值为“basic”。
说明:
AI增强型即队列加载了AI镜像,该镜像在基础镜像的基础上集成了AI相关的算法包。 |
resource_type |
否 |
String |
队列所属资源类型。
|
cu_spec |
否 |
Integer |
队列的规格大小。对于包周期队列,表示包周期部分的CU值;对于按需队列,表示用户购买队列时的初始值。 |
cu_scale_out_limit |
否 |
Integer |
当前队列弹性扩缩容的CU值上限。 |
cu_scale_in_limit |
否 |
Integer |
当前队列弹性扩缩容的CU值下限。 |
elastic_resource_pool_name |
是 |
String |
弹性资源池名称。 |
请求示例
无
响应示例
{ "is_success": "true", "message": "", "queues": [ { "queue_name": "test", "owner": "testuser", "description": "", "create_time": 1562221422671, "queue_type": "spark", "cu_count": 16, "charging_mode": 2, "resource_id": "26afb850-d3c9-42c1-81c0-583d1163e80f", "enterprise_project_id": "0", "cidr_in_vpc": "10.0.0.0/8", "cidr_in_subnet": "10.0.0.0/24", "cidr_in_mgntsubnet": "10.23.128.0/24", "resource_mode": 1, "platform": "x86_64", "is_restarting": "false", "labels": "multi_az=2", "resource_type": "vm", "cu_spec": 16 } ] }
错误码
调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码。