Create a new queue manager - go

Create a new queue manager.

(mqcloud *MqcloudV1) CreateQueueManager(createQueueManagerOptions *CreateQueueManagerOptions) (result *QueueManagerTaskStatus, response *core.DetailedResponse, err error)

(mqcloud *MqcloudV1) CreateQueueManagerWithContext(ctx context.Context, createQueueManagerOptions *CreateQueueManagerOptions) (result *QueueManagerTaskStatus, response *core.DetailedResponse, err error)

Request

Instantiate the CreateQueueManagerOptions struct and set the fields to provide parameter values for the CreateQueueManager 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.

CreateQueueManagerOptions	The CreateQueueManager 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`
`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_.]$/` Examples:* `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-._: ])+$/` Examples: `reserved-eu-de-cluster-f884`
`Size` Required* string	The queue manager sizes of deployment available. Allowable values: [`xsmall`,`small`,`medium`,`large`] Examples: `small`
`DisplayName` string	A displayable name for the queue manager - limited only in length. Possible values: 0 ≤ length ≤ 150, Value must match regular expression `/^.$/` Examples:* `A test queue manager`
`Version` string	The IBM MQ version of the Queue Manager to deploy, if not supplied the latest version is deployed. 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

createQueueManagerOptions := mqcloudService.NewCreateQueueManagerOptions(
  "a2b4d4bc-dadb-4637-bcec-9b7d1e723af8",
  "testqm",
  "reserved-eu-de-cluster-f884",
  "small",
)

queueManagerTaskStatus, response, err := mqcloudService.CreateQueueManager(createQueueManagerOptions)
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 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 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"
}