Adding Queue Properties

Function

This API is used to add queue properties. You can add multiple properties at a time.

Currently, the following queue properties can be set:

Spark driver parameters: Set them to improve the scheduling efficiency of queues.

Notes and Constraints

• Only SQL queues of the Spark engine support configuring queue properties.
• Queue properties can only be set after a queue is created.
• Currently, only queue properties related to the Spark driver can be set.
• You cannot set queue properties in batches.

URI

• URI format

  POST /v3/{project_id}/queues/{queue_name}/properties

• Parameter descriptions

  Table 1 URI parameters

  Parameter	Mandatory	Type	Description
  project_id	Yes	String	Project ID, which is used for resource isolation. For how to obtain a project ID, see Obtaining a Project ID.
  queue_name	Yes	String	Queue name.

Request Parameters

Response Parameters

Example Request

Set queue properties.

{
  "properties" : {
    "computeEngine.maxInstance" : 2,
    "job.maxConcurrent" : 32,
    "computeEngine.maxPrefetchInstance" : 1
  }
}

Example Response

None

Status Codes

Table 5 describes the status codes.

Error Codes

If an error occurs when this API is called, an error code and message are returned. For details, see Error Codes.