创建队列
功能介绍
该API用于创建队列，该队列将会绑定用户指定的计算资源。
新队列第一次运行作业时，需要一定的时间，通常为5~15分钟。
URI
- URI格式：
- 参数说明
表1 URI参数 参数名称
是 否必选
参数类型
说明
project_id
是
String
项目编号，用于资源隔离。获取方式请参考获取项目ID。
请求消息
|
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
queue_name |
是 |
String |
新建的队列名称，名称只能包含数字、英文字母和下划线，但不能是纯数字，且不能以下划线开头。长度限制：1~128个字符。
说明：
队列名称不区分大小写，系统会自动转换为小写。 |
|
queue_type |
否 |
String |
队列的类型,。有如下类型：
说明：
如果不指定类型，则默认为“sql”。 |
|
description |
否 |
String |
队列的描述信息。 |
|
cu_count |
是 |
Integer |
与队列绑定的最小计算单元个数。设置值当前只支持16，64，256。 |
|
enterprise_project_id |
否 |
String |
企业项目ID，“0”表示default，即默认的企业项目。
说明：
开通了企业管理服务的用户可设置该参数绑定指定的项目。 |
|
platform |
否 |
String |
队列计算资源的cpu架构。
|
|
resource_mode |
否 |
Integer |
队列资源模式。支持以下两种类型： 0：共享资源模式 1：专属资源模式 |
|
labels |
否 |
Array of Strings |
创建队列的标签信息，目前包括队列是否跨AZ的标签信息（Json字符串），且只支持值为“2”，即创建一个计算资源分布在2个可用区的双AZ队列。 |
|
tags |
否 |
Array of Objects |
队列的标签，使用标签标识云资源。包括“标签键”和“标签值”，具体请参考表3。 |
响应消息
|
参数名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
is_success |
否 |
Boolean |
请求执行是否成功。“true”表示请求执行成功。 |
|
message |
否 |
String |
系统提示信息，执行成功时，信息可能为空。 |
|
queue_name |
否 |
String |
新增队列的名称。
说明：
队列名称不区分大小写，系统会自动转换为小写。 |
请求示例
{
"queue_name": "queue1",
"description": "test",
"cu_count": 16,
"resource_mode": 1,
"queue_type": "general",
"labels": ["multi_az=2"]
}
响应示例
{
"is_success": true,
"message": "",
"queue_name": "queue1"
}
错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见错误码。
