cloudtrail:ListTags

Read

cloudtrail:ListTags is a Read access-level action in the cloudtrail service. Grants permission to list the tags for trails, event data stores, channels or dashboards in the current region

Resource types

ARNs that cloudtrail:ListTags can be scoped to in an IAM policy.

arn:${Partition}:cloudtrail:${Region}:${Account}:channel/${ChannelId}

channel

arn:${Partition}:cloudtrail:${Region}:${Account}:dashboard/${DashboardName}

dashboard

arn:${Partition}:cloudtrail:${Region}:${Account}:eventdatastore/${EventDataStoreId}

eventdatastore

arn:${Partition}:cloudtrail:${Region}:${Account}:trail/${TrailName}

trail

Condition keys

Keys you can use in the Condition block of a policy that grants cloudtrail:ListTags.

aws:ResourceTag/${TagKey} String

Filters access by the tags attached to the resource

Example IAM policy

A minimal policy that allows cloudtrail:ListTags. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowCloudtrailListTags",
      "Effect": "Allow",
      "Action": "cloudtrail:ListTags",
      "Resource": "*"
    }
  ]
}

Related actions in cloudtrail

cloudtrail:AddTags Tagging cloudtrail:CancelQuery Write cloudtrail:CreateChannel Write cloudtrail:CreateDashboard Write cloudtrail:CreateEventDataStore Write cloudtrail:CreateServiceLinkedChannel Write cloudtrail:CreateTrail Write cloudtrail:DeleteChannel Write cloudtrail:DeleteDashboard Write cloudtrail:DeleteEventDataStore Write cloudtrail:DeleteResourcePolicy Write cloudtrail:DeleteServiceLinkedChannel Write

View all cloudtrail actions →