reserved instance

Upgrade a queue manager - curl

Upgrade a queue manager.

PUT /v1/{service_instance_guid}/queue_managers/{queue_manager_id}/version

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
queue_manager_id
Required*
string

The id of the queue manager to retrieve its full details.

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

Example: b8e1aeda078009cf3db74e90d5d42328
Request Body
Required*
UpgradeQueueManagerBody
 Version to upgrade Queue Manager to
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 PUT --location --header "Authorization: Bearer ${iam_token}" --header "Accept: application/json" --header "Content-Type: application/json" --data '{"version":"9.3.2_2"}' "${base_url}/v1/${service_instance_guid}/queue_managers/${queue_manager_id}/version"

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 upgrade
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"
}