Lists the tags that are attached to the specified role. The returned list of tags is sorted by tag key. For more information about tagging, see Tagging IAM Identities in the IAM User Guide .
See also: AWS API Documentation
See ‘aws help’ for descriptions of global parameters.
list-role-tags
--role-name <value>
[--marker <value>]
[--max-items <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--cli-auto-prompt <value>]
--role-name
(string)
The name of the IAM role for which you want to see the list of tags.
This parameter accepts (through its regex pattern ) a string of characters that consist of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-
--marker
(string)
Use this parameter only when paginating results and only after you receive a response indicating that the results are truncated. Set it to the value of the
Marker
element in the response that you received to indicate where the next call should start.
--max-items
(integer)
(Optional) Use this only when paginating results to indicate the maximum number of items that you want in the response. If additional items exist beyond the maximum that you specify, the
IsTruncated
response element istrue
.If you do not include this parameter, it defaults to 100. Note that IAM might return fewer results, even when more results are available. In that case, the
IsTruncated
response element returnstrue
, andMarker
contains a value to include in the subsequent call that tells the service where to continue from.
--cli-input-json
| --cli-input-yaml
(string)
Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton
. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml
.
--generate-cli-skeleton
(string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input
, prints a sample input JSON that can be used as an argument for --cli-input-json
. Similarly, if provided yaml-input
it will print a sample input YAML that can be used with --cli-input-yaml
. If provided with the value output
, it validates the command inputs and returns a sample output JSON for that command.
--cli-auto-prompt
(boolean)
Automatically prompt for CLI input parameters.
See ‘aws help’ for descriptions of global parameters.
To list the tags attached to a role
The following list-role-tags
command retrieves the list of tags associated with the specified role.
aws iam list-role-tags --role-name production-role
Output::
{
"Tags": [
{
"Key": "Department",
"Value": "Accounting"
},
{
"Key": "DeptID",
"Value": "12345"
}
],
"IsTruncated": false
}
For more information, see Tagging IAM Entities in the AWS IAM User Guide
Tags -> (list)
The list of tags currently that is attached to the role. Each tag consists of a key name and an associated value. If no tags are attached to the specified role, the response contains an empty list.
(structure)
A structure that represents user-provided metadata that can be associated with a resource such as an IAM user or role. For more information about tagging, see Tagging IAM Identities in the IAM User Guide .
Key -> (string)
The key name that can be used to look up or retrieve the associated value. For example,
Department
orCost Center
are common choices.Value -> (string)
The value associated with this tag. For example, tags with a key name of
Department
could have values such asHuman Resources
,Accounting
, andSupport
. Tags with a key name ofCost Center
might have values that consist of the number associated with the different cost centers in your company. Typically, many resources have tags with the same key name but with different values.Note
AWS always interprets the tag
Value
as a single string. If you need to store an array, you can store comma-separated values in the string. However, you must interpret the value in your code.
IsTruncated -> (boolean)
A flag that indicates whether there are more items to return. If your results were truncated, you can use the
Marker
request parameter to make a subsequent pagination request that retrieves more items. Note that IAM might return fewer than theMaxItems
number of results even when more results are available. CheckIsTruncated
after every call to ensure that you receive all of your results.
Marker -> (string)
When
IsTruncated
istrue
, this element is present and contains the value to use for theMarker
parameter in a subsequent pagination request.