reserved instanceIBM Cloud

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

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

(mqcloud *MqcloudV1) GetQueueManagerAvailableUpgradeVersions(getQueueManagerAvailableUpgradeVersionsOptions *GetQueueManagerAvailableUpgradeVersionsOptions) (result *QueueManagerVersionUpgrades, response *core.DetailedResponse, err error)
(mqcloud *MqcloudV1) GetQueueManagerAvailableUpgradeVersionsWithContext(ctx context.Context, getQueueManagerAvailableUpgradeVersionsOptions *GetQueueManagerAvailableUpgradeVersionsOptions) (result *QueueManagerVersionUpgrades, response *core.DetailedResponse, err error)

Request

Instantiate the GetQueueManagerAvailableUpgradeVersionsOptions struct and set the fields to provide parameter values for the GetQueueManagerAvailableUpgradeVersions method.

parameter WithContext method only
ctx
Context
 A context.Context instance that you can use to specify a timeout for the operation or to cancel an in-flight request.
SetQueueManagerVersionOptions The SetQueueManager options
ServiceInstanceGuid
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
QueueManagerId
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 request

getQueueManagerAvailableUpgradeVersionsOptions := mqcloudService.NewGetQueueManagerAvailableUpgradeVersionsOptions(
  "a2b4d4bc-dadb-4637-bcec-9b7d1e723af8",
  "b8e1aeda078009cf3db74e90d5d42328",
)

queueManagerVersionUpgrades, response, err := mqcloudService.GetQueueManagerAvailableUpgradeVersions(getQueueManagerAvailableUpgradeVersionsOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(queueManagerVersionUpgrades, "", "  ")
fmt.Println(string(b))

Response

Response Body
QueueManagerVersionUpgrades

The list of available versions that this queue manger can upgrade to
TotalCount
Always included*
int64
 Total count of versions available.
Versions
Always included*

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

  • TargetDate
    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 url to track progress of the queue manager upgrade
301 URI has permanently Moved
400 Bad Request
401 Unauthorized
404 Method not allowed
429 Service Is Overused
500 Internal Server Error

Example response

Success example

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