创建队列

场景描述

本章节指导用户通过API创建队列。API的调用方法请参见如何调用API。

约束限制

• 该接口创建的队列将会绑定用户指定的计算资源。
• 新队列第一次运行作业时，需要一定的时间，通常为6~10分钟。

涉及接口

• 创建队列：创建队列。
• 查询队列详情：确认队列创建成功。

操作步骤

1. 创建队列。
   • 接口相关信息

     URI格式：POST /v1.0/{project_id}/queues

     • {project_id}信息请从获取项目ID获取。
     • 请求参数说明详情，请参见创建队列。
   • 请求示例
     • 描述：在项目ID为48cc2c48765f481480c7db940d6409d1的项目下创建一个sql类型名称为queue1的队列。
     • 示例URL：POST https://{endpoint}/v1.0/48cc2c48765f481480c7db940d6409d1/queues
     • Body：

       {
           "queue_name": "queue1",
           "description": "test",
           "cu_count": 16,
           "resource_mode": 1,
           "queue_type": "sql"
       }

   • 响应示例

     {
       "is_success": true,
       "message": "",
       "queue_name": "queue1"
     }

2. 确认队列创建成功。
   • 接口相关信息

     URI格式：GET /v1.0/{project_id}/queues/{queue_name}

     • {project_id}信息请从获取项目ID获取。
     • 查询参数说明详情，请参见查询队列详情。
   • 请求示例
     • 描述：查询项目ID为48cc2c48765f481480c7db940d6409d1的项目下queue1队列的详情。
     • 示例URL：GET https://{endpoint}/v1.0/48cc2c48765f481480c7db940d6409d1/queues/queue1
     • Body：

       {}

   • 响应示例

     {
         "is_success": true,
         "message": "",
         "owner": "testuser",
         "description": "",
         "queue_name": "queue1",
         "create_time": 1587613028851,
         "queue_type": "sql",
         "cu_count": 16,
         "resource_id": "03d51b88-db63-4611-b779-9a72ba0cf58b",
         "resource_mode": 0
     }