更新时间:2022-08-12 GMT+08:00

创建队列

场景描述

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

约束限制

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

涉及接口

操作步骤

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

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

    • 请求示例
      • 描述:在项目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}

    • 请求示例
      • 描述:查询项目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
      }