reserved instance

Return configuration options - curl

Return configuration options (for example, available deployment locations, queue manager sizes).

GET /v1/{service_instance_guid}/options

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

Example request

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

Response

Response Body
ConfigurationOptions
 ConfigurationOptions (for example, available deployment locations, queue manager sizes)
locations
string[]

List of deployment locations.

Possible values: 1 ≤ number of items ≤ 20, 2 ≤ length ≤ 150, Value must match regular expression ^([^[:ascii:]]|[a-zA-Z0-9-._: ])+$
sizes
string[]

List of queue manager sizes.

Possible values: [xsmall,small,medium,large]

Possible values: 1 ≤ number of items ≤ 20
versions
string[]

List of queue manager versions.

Possible values: 1 ≤ number of items ≤ 12
latest_version
string

The latest Queue manager version.

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

Example: 9.3.2_2
Status code  
200 Configuration options
301 URI has permanently Moved
400 Bad Request
401 Unauthorized
404 Resource not found
429 Service Is Overused
500 Internal Server Error

Example response

Status 200

{
  "locations": [
    "ibmcloud_eu_de"
  ],
  "sizes": [
    "xsmall",
    "small",
    "medium",
    "large"
  ],
  "versions": [
    "9.3.3_1"
  ],
  "latest_version": "9.3.3_1"
}