reserved instanceIBM Cloud

Upgrade a queue manager - go

Upgrade a queue manager.

(mqcloud *MqcloudV1) SetQueueManagerVersion(setQueueManagerVersionOptions *SetQueueManagerVersionOptions) (result *QueueManagerTaskStatus, response *core.DetailedResponse, err error)
(mqcloud *MqcloudV1) SetQueueManagerVersionWithContext(ctx context.Context, setQueueManagerVersionOptions *SetQueueManagerVersionOptions) (result *QueueManagerTaskStatus, response *core.DetailedResponse, err error)

Request

Instantiate the SetQueueManagerVersionOptions struct and set the fields to provide parameter values for the SetQueueManagerVersion 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}$/
Version
Required*
string

The version upgrade to apply to the queue manager.

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

Examples: 9.3.2_2

Example request

setQueueManagerVersionOptions := mqcloudService.NewSetQueueManagerVersionOptions(
  "a2b4d4bc-dadb-4637-bcec-9b7d1e723af8",
  "b8e1aeda078009cf3db74e90d5d42328",
  "9.3.2_2",
)

queueManagerTaskStatus, response, err := mqcloudService.SetQueueManagerVersion(setQueueManagerVersionOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(queueManagerTaskStatus, "", "  ")
fmt.Println(string(b))

Response

QueueManagerTaskStatus A URI for status that can be queried periodically to get the status of the queue manager
QueueManagerUri
Always included*
string
 Uri for the details of the queue manager.
QueueManagerStatusUri
Always included*
string
 Uri for the status of the queue manager.
QueueManagerId
Always included*
string
 The queue manager id.
Status code  
202 Returns url to track progress of the queue manager upgrade
301  
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 example

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