View a markdown version of this page

Actions, resources, and condition keys for AWS CodeStar Notifications - Service Authorization Reference

Actions, resources, and condition keys for AWS CodeStar Notifications

AWS CodeStar Notifications (service prefix: codestar-notifications) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by AWS CodeStar Notifications

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation IAM action Condition key Possible value(s) Access level

CreateNotificationRule

codestar-notifications:CreateNotificationRule

Write

DeleteNotificationRule

codestar-notifications:DeleteNotificationRule

Write

DeleteTarget

codestar-notifications:DeleteTarget

Write

DescribeNotificationRule

codestar-notifications:DescribeNotificationRule

Read

ListEventTypes

codestar-notifications:ListEventTypes

List

ListNotificationRules

codestar-notifications:ListNotificationRules

List

ListTagsForResource

codestar-notifications:ListTagsForResource

List

ListTargets

codestar-notifications:ListTargets

List

Subscribe

codestar-notifications:Subscribe

Write

TagResource

codestar-notifications:TagResource

Tagging, Write

Unsubscribe

codestar-notifications:Unsubscribe

Write

UntagResource

codestar-notifications:UntagResource

Tagging, Write

UpdateNotificationRule

codestar-notifications:UpdateNotificationRule

Write

Actions defined by AWS CodeStar Notifications

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

CreateNotificationRule

Grants permission to create a notification rule for a resource

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

codestar-notifications:NotificationsForResource

Write

DeleteNotificationRule

Grants permission to delete a notification rule for a resource

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

codestar-notifications:NotificationsForResource

Write

DeleteTarget

Grants permission to delete a target for a notification rule

aws:RequestTag/${TagKey}

aws:TagKeys

Write

DescribeNotificationRule

Grants permission to get information about a notification rule

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

codestar-notifications:NotificationsForResource

Read

ListEventTypes

Grants permission to list notifications event types

List

ListNotificationRules

Grants permission to list notification rules in an AWS account

List

ListTagsForResource

Grants permission to list the tags attached to a notification rule resource ARN

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

List

ListTargets

Grants permission to list the notification rule targets for an AWS account

aws:RequestTag/${TagKey}

aws:TagKeys

List

Subscribe

Grants permission to create an association between a notification rule and an Amazon SNS topic

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

codestar-notifications:NotificationsForResource

Write

TagResource

Grants permission to attach resource tags to a notification rule resource ARN

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

Unsubscribe

Grants permission to remove an association between a notification rule and an Amazon SNS topic

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

codestar-notifications:NotificationsForResource

Write

UntagResource

Grants permission to disassociate resource tags from a notification rule resource ARN

notificationrule*

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

UpdateNotificationRule

Grants permission to change a notification rule for a resource

notificationrule*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

codestar-notifications:NotificationsForResource

Write

Resource types defined by AWS CodeStar Notifications

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

notificationrule

arn:${Partition}:codestar-notifications:${Region}:${Account}:notificationrule/${NotificationRuleId}

aws:ResourceTag/${TagKey}

Condition keys for AWS CodeStar Notifications

AWS CodeStar Notifications defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:RequestTag/${TagKey}

Filters actions based on the presence of tag key-value pairs in the request

String

aws:ResourceTag/${TagKey}

Filters actions based on tag key-value pairs attached to the resource

String

aws:TagKeys

Filters actions based on the presence of tag keys in the request

ArrayOfString

codestar-notifications:NotificationsForResource

Filters access based on the ARN of the resource for which notifications are configured

ARN