reserved instance

Get the list of available versions that this queue manager can be upgraded to - curl

Get the list of available versions that this queue manager can be upgraded to.

GET /v1/{service_instance_guid}/queue_managers/{queue_manager_id}/available_versions

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

Example request

curl -X GET --location --header "Authorization: Bearer ${iam_token}" --header "Accept: application/json" "${base_url}/v1/${service_instance_guid}/queue_managers/${queue_manager_id}/available_versions"

Response

Response Body
QueueManagerVersionUpgrades
 QueueManagerVersionUpgrades

The list of available versions that this queue manger can upgrade to
total_count
Always included*
int32
 Total count of versions available.
versions
Always included*
string

The list of available versions that this queue manger can upgrade to.

Possible values: 0 ≤ number of items ≤ 12
 
  • version
    Always included*
    string

    The target version of the queue manager upgrade.

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

    Example: 9.3.2_2

  • target_date
    Always included*
    date-time

    RFC3339 formatted UTC date for when the queue manager will automatically be updated.

    Example: 2023-01-13T15:39:35.000Z
Status code  
200 Returns information about the available versions that this queue manager can be upgraded to
301 URI has permanently Moved
400 Bad Request
401 Unauthorized
404 Resource not found
429 Service Is Overused
500 Internal Server Error

Example response

Success 202

{
  "total_count": 1,
  "versions": [
    {
      "version": "9.3.2_2",
      "target_date": "2023-01-13T15:39:35.000Z"
    }
  ]
}