1.接口协议:
POST https://[endpoint].ctapi.ctyun.cn/v2/queue/create
请求参数 | 是否必填 | 位置 | 参数类型 | 说明 |
prodInstId | 是 | json | String | 实例ID |
vhost | 是 | json | String | vhost名称 |
name | 是 | json | String | 队列名称 |
durable | 否 | json | Boolean | 是否持久化 |
auto_delete | 否 | json | Boolean | 是否自动删除 |
x-message-ttl | 否 | json | int | 消息过期时间(单位ms) |
x-expires | 否 | json | int | 队列过期时间,过期后队列自动删除 (单位ms) |
x-max-length | 否 | json | int | 队列能保存的最大消息数 |
x-dead-letter-exchange | 否 | json | String | 死信交换器名称,(死信交换机必须提前创建,否则接口返回成功但不会真正创建队列) |
x-dead-letter-routing-key | 否 | json | String | 死信路由键。(当指定x-dead-letter-routing-key时必须同时指定x-dead-letter-exchange) |
x-max-priority | 否 | json | int | 队列最大优先级:要开启消息的优先级,必须设置消息所在队列的优先级,0~ 255 |
响应参数 | 参数类型 | 描述 |
statusCode | String | 接口系统层面状态码。成功:800,失败:900 |
message | String | 描述状态 |
returnObj | String | 返回对象。此参数所包含的参数请见“响应示例"里面的注释 |
2.请求示例:
POST https://[endpoint].ctapi.ctyun.cn/v2/queue/create
{
"prodInstId":"9b9bea76b7ce412ca18f99ccc1ea717b" ,
"vhost": "/",
"name": "ssaaax",
"durable": true,
"auto_delete": true
}
3.返回示例:
成功响应示例
{
"returnObj": {
"data": null
},
"message": "success",
"statusCode": "800"
}
失败响应示例
{
"returnObj": {
"data": "{\"error\":\"not_found\",\"reason\":\"vhost_not_found\"}"
},
"message": "404 Not Found",
"statusCode": "900"
}