reserved instance

Create a new queue manager - curl

Create a new queue manager.

POST /v1/{service_instance_guid}/queue_managers

Request

Custom Headers  
Accept-Language
string

The acceptable list of languages supported in the client.

Possible values: 1 ≤ length ≤ 256, Value must match regular expression [a-zA-Z0-9\-;,\s.]*

Example: en-US,en;q=0.5
Path Parameters  
service_instance_guid
Required*
string

The GUID that uniquely identifies the IBM® MQ as a Service instance.

Possible values: length = 36, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Example: a2b4d4bc-dadb-4637-bcec-9b7d1e723af8
Request Body
Required*
QueueManagerDetailsPrototype
 Queue manager to add to the list
name
Required*
string

The name of the queue manager - conforming to MQ rules.

Possible values: 1 ≤ length ≤ 48, Value must match regular expression ^[a-zA-Z0-9_.]*$

Example: testqm
location
Required*
string

The locations in which the queue manager could be deployed.

Possible values: 2 ≤ length ≤ 150, Value must match regular expression ^([^[:ascii:]]|[a-zA-Z0-9-._: ])+$

Example: reserved-eu-de-cluster-f884
size
Required*
string

List of queue manager sizes.

Allowable values: [xsmall,small,medium,large]

Example:small
display_name
Required*
string

A displayable name for the queue manager - limited only in length.

Possible values: 0 ≤ length ≤ 150, Value must match regular expression ^.*$

Example: A test queue manager
version
Required*
string

The IBM MQ version of the Queue Manager to deploy if not supplied the latest version will be deployed.

Possible values: 7 ≤ length ≤ 15, Value must match regular expression ^[0-9]+.[0-9]+.[0-9]+_[0-9]+$

Example: 9.3.2_2

Example request

curl -X POST --location --header "Authorization: Bearer ${iam_token}" --header "Accept: application/json" --header "Content-Type: application/json" --data '{ "name": "testqm", "location": "reserved-eu-de-cluster-f884", "size": "small" }' "${base_url}/v1/${service_instance_guid}/queue_managers"

Response

Response Body
QueueManagerTaskStatus
 A URI for status that can be queried periodically to get the status of the queue manager
queue_manager_uri
Always included*
string
 Uri for the details of the queue manager.
queue_manager_status_uri
Always included*
string
 Uri for the status of the queue manager.
queue_manager_id
Always included*
string
 The queue manager id.
Status code  
202 Returns url to track progress of the queue manager deployment
301 URI has permanently Moved
400 Bad Request
401 Unauthorized
405 Method not allowed
409 Conflict
429 Service Is Overused
500 Internal Server Error
503 Service Unavailable Error

Example response

Success 202

{
  "queue_manager_uri": "/v1/a2b4d4bc-dadb-4637-bcec-9b7d1e723af8/queue_managers",
  "queue_manager_status_uri": "/v1/a2b4d4bc-dadb-4637-bcec-9b7d1e723af8/queue_managers/b8e1aeda078009cf3db74e90d5d42328/status",
  "queue_manager_id": "b8e1aeda078009cf3db74e90d5d42328"
}