Lists the attributes for Amazon ECS resources within a specified target
type and cluster. When you specify a target type and cluster,
list_attributes
returns a list of attribute
objects, one for each attribute on each resource. You can filter the
list of results to a single attribute name to only return results that
have that name. You can also filter the results by attribute name and
value, for example, to see which container instances in a cluster are
running a Linux AMI (ecs.os-type=linux
).
ecs_list_attributes(cluster, targetType, attributeName, attributeValue,
nextToken, maxResults)
A list with the following syntax:
list(
attributes = list(
list(
name = "string",
value = "string",
targetType = "container-instance",
targetId = "string"
)
),
nextToken = "string"
)
The short name or full Amazon Resource Name (ARN) of the cluster to list attributes. If you do not specify a cluster, the default cluster is assumed.
[required] The type of the target with which to list attributes.
The name of the attribute with which to filter the results.
The value of the attribute with which to filter results. You must also specify an attribute name to use this parameter.
The nextToken
value returned from a
list_attributes
request indicating that more
results are available to fulfill the request and further calls will be
needed. If maxResults
was provided, it is possible the number of
results to be fewer than maxResults
.
This token should be treated as an opaque identifier that is only used to retrieve the next items in a list and not for other programmatic purposes.
The maximum number of cluster results returned by
list_attributes
in paginated output. When this
parameter is used, list_attributes
only returns
maxResults
results in a single page along with a nextToken
response
element. The remaining results of the initial request can be seen by
sending another list_attributes
request with
the returned nextToken
value. This value can be between 1 and 100. If
this parameter is not used, then
list_attributes
returns up to 100 results and a
nextToken
value if applicable.
svc$list_attributes(
cluster = "string",
targetType = "container-instance",
attributeName = "string",
attributeValue = "string",
nextToken = "string",
maxResults = 123
)