Skip to main content

shared_resources

Creates, updates, deletes, gets or lists a shared_resources resource.

Overview

Nameshared_resources
TypeResource
Idaws.mq.shared_resources

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
dns_namesarrayThe DNS names accessible by the broker.
errorobjectInformation on the error encountered by the resource.
resource_arnstringThe ARN of the shared resource.
resource_share_arnsarrayThe resource share ARNs to which the resource belongs.
statusstringThe status of the shared resource. (AVAILABLE, SETUP_IN_PROGRESS, DELETION_IN_PROGRESS, PENDING_CREATE, PENDING_DELETE, ERROR)
typestringThe type of shared resource. (RESOURCE_SHARE, RESOURCE)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_shared_resourcesselectbroker-id, regionmaxResults, nextTokenReturns the resources shared to a broker.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
broker-idstringThe unique ID that Amazon MQ generates for the broker.
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of resources that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100.
nextTokenstringThe token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty.

SELECT examples

Returns the resources shared to a broker.

SELECT
dns_names,
error,
resource_arn,
resource_share_arns,
status,
type
FROM aws.mq.shared_resources
WHERE `broker-id` = '{{ broker-id }}' -- required
AND region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;