Menu
AWS OpsWorks
API Reference (API Version 2013-02-18)

ListTags

Returns a list of tags that are applied to the specified stack or layer.

Request Syntax

{ "MaxResults": number, "NextToken": "string", "ResourceArn": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

MaxResults

Do not use. A validation exception occurs if you add a MaxResults parameter to a ListTagsRequest call.

Type: Integer

Required: No

NextToken

Do not use. A validation exception occurs if you add a NextToken parameter to a ListTagsRequest call.

Type: String

Required: No

ResourceArn

The stack or layer's Amazon Resource Number (ARN).

Type: String

Required: Yes

Response Syntax

{ "NextToken": "string", "Tags": { "string" : "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NextToken

If a paginated request does not return all of the remaining results, this parameter is set to a token that you can assign to the request object's NextToken parameter to get the next set of results. If the previous paginated request returned all of the remaining results, this parameter is set to null.

Type: String

Tags

A set of key-value pairs that contain tag keys and tag values that are attached to a stack or layer.

Type: String to string map

Errors

For information about the errors that are common to all actions, see Common Errors.

ResourceNotFoundException

Indicates that a resource was not found.

HTTP Status Code: 400

ValidationException

Indicates that a request was not valid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: