Actions Supported by Identity Policy-based Authorization

IAM provides system-defined identity policies to define common actions supported by cloud services. You can also create custom identity policies using the actions supported by cloud services for more refined access control.

In addition to IAM, the Organizations service provides Service Control Policies (SCPs) to set access control policies.

SCPs do not actually grant any permissions to a principal. They only set the permissions boundary for the principal. When SCPs are attached to a member account or an organizational unit (OU), they do not directly grant permissions to that member account or OU. Instead, the SCPs just determine what permissions are available for that member account or the member accounts under that OU. The granted permissions can be applied only if they are allowed by the SCPs.

To learn more about how IAM is different from Organizations for access control, see What Are the Differences in Access Control Between IAM and Organizations?

This section describes the elements used by IAM custom identity policies and Organizations SCPs. The elements include actions, resources, and conditions.

For details about how to use these elements to create an IAM custom identity policy, see Creating a Custom Identity Policy.
For details about how to use these elements to create a custom SCP, see Creating an SCP.

Actions

Actions are specific operations that are allowed or denied in an identity policy.

The Access Level column describes how the action is classified (List, Read, or Write). This classification helps you understand the level of access that an action grants when you use it in an identity policy.
The Resource Type column indicates whether the action supports resource-level permissions.
- You can use a wildcard (*) to indicate all resource types. If this column is empty (-), the action does not support resource-level permissions and you must specify all resources ("*") in your identity policy statements.
- If this column includes a resource type, you must specify the URN in the Resource element of your statements.
- Required resources are marked with asterisks (*) in the table. If you specify a resource in a statement using this action, then it must be of this type.
For details about the resource types defined by SMN, see Resources.
The Condition Key column contains keys that you can specify in the Condition element of an identity policy statement.
- If the Resource Type column has values for an action, the condition key takes effect only for the listed resource types.
- If the Resource Type column is empty (-) for an action, the condition key takes effect for all resources that action supports.
- If the Condition Key column is empty (-) for an action, the action does not support any condition keys.
For details about the condition keys defined by SMN, see Conditions.
The Alias column lists the policy actions that are configured in identity policies. With these actions, you can use APIs for policy-based authorization. For details, see Policies and Identity Policies.

The following table lists the actions that you can define in identity policy statements for SMN.

**Table 1** Actions supported by SMN
Action	Description	Access Level	Resource Type (*: Mandatory)	Condition Key	Alias
smn:topic:create	Grants permissions to create a topic.	Write	topic *	N/A	N/A
smn:topic:create	Grants permissions to create a topic.	Write	N/A	g:EnterpriseProjectId g:RequestTag/<tag-key> g:TagKeys	N/A
smn:topic:listTopic	Grants permissions to query topics.	List	topic *	N/A	smn:topic:list
smn:topic:listTopic	Grants permissions to query topics.	List	N/A	g:EnterpriseProjectId	smn:topic:list
smn:topic:updateTopic	Grants permissions to update a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:get	Grants permissions to query topic details.	Read	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:list
smn:topic:delete	Grants permissions to delete a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:topic:listAttributes	Grants permissions to query a topic policy.	List	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:list
smn:topic:deleteAttribute	Grants permissions to delete a topic policy.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:updateAttribute	Grants permissions to update a topic policy.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:updateAttribute	Grants permissions to update a topic policy.	Write	N/A	smn:TargetOrgPath smn:TargetOrgId smn:TargetAccountId	smn:topic:update
smn:topic:subscribe	Grants permissions to add a subscription to a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:subscribe	Grants permissions to add a subscription to a topic.	Write	N/A	smn:Protocol smn:Endpoint	smn:topic:update
smn:topic:listSubscriptionsByTopic	Grants permissions to query subscriptions of a topic.	List	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:list
smn:topic:listSubscriptions	Grants permissions to query subscriptions of all topics.	List	topic *	N/A	smn:topic:list
smn:topic:deleteSubscription	Grants permissions to delete a subscription from a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:updateSubscription	Grants permissions to update a subscription of a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:publish	Grants permissions to publish a message.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:template:create	Grants permissions to create a message template.	Write	template *	N/A	N/A
smn:template:listTemplates	Grants permissions to query message templates.	List	template *	N/A	smn:template:list
smn:template:update	Grants permissions to modify a message template.	Write	template *	N/A	N/A
smn:template:get	Grants permissions to query details of a message template.	Read	template *	N/A	smn:template:list
smn:template:delete	Grants permissions to delete a message template.	Write	template *	N/A	N/A
smn:tag:create	Grants permissions to add a tag for a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:tag:create	Grants permissions to add a tag for a topic.	Write	N/A	g:RequestTag/<tag-key> g:TagKeys	N/A
smn:tag:delete	Grants permissions to delete a tag of a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:tag:update
smn:tag:delete	Grants permissions to delete a tag of a topic.	Write	N/A	g:RequestTag/<tag-key> g:TagKeys	smn:tag:update
smn:tag:batchModify	Grants permissions to batch modify topic tags.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:tag:update
smn:tag:batchModify	Grants permissions to batch modify topic tags.	Write	N/A	g:RequestTag/<tag-key> g:TagKeys	smn:tag:update
smn:tag:list	Grants permissions to query tags of a topic.	Read	topic *	g:ResourceTag/<tag-key>	N/A
smn:topic:createLogTank	Grants permissions to associate a topic with a log group and log stream.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:topic:listLogTank	Grants permissions to query the log group and log stream associated with a topic.	List	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:list
smn:topic:updateLogTank	Grants permissions to update the log group and log stream associated with a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:deleteLogTank	Grants permissions to disassociate a topic from a log group and log stream.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	smn:topic:update
smn:topic:createKmsKey	Grants permissions to bind a KMS key to a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:topic:getKmsKey	Grants permissions to query the KMS key bound to a topic.	List	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:topic:updateKmsKey	Grants permissions to update the KMS key bound to a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:topic:deleteKmsKey	Grants permissions to delete the KMS key bound to a topic.	Write	topic *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	N/A
smn:topic:createNotifyPolicy	Grants permissions to create a notification policy.	Write	topic *	N/A	N/A
smn:topic:updateNotifyPolicy	Grants permissions to modify a notification policy.	Write	topic *	N/A	N/A
smn:topic:getNotifyPolicy	Grants permissions to query a notification policy.	Read	topic *	N/A	N/A
smn:topic:deleteNotifyPolicy	Grants permissions to delete a notification policy.	Write	topic *	N/A	N/A
smn:application:create	Grants permissions to create an application.	Write	application *	N/A	N/A
smn:application:delete	Grants permissions to delete an application.	Write	application *	N/A	N/A
smn:application:list	Grants permissions to query an application.	List	application *	N/A	N/A
smn:application:get	Grants permissions to query application details.	Read	application *	N/A	N/A
smn:application:publish	Grants permissions to publish messages of an application.	Write	application *	N/A	N/A
smn:application:createPlatform	Grants permissions to create a platform.	Write	application *	N/A	N/A
smn:application:deletePlatform	Grants permissions to delete a platform.	Write	application *	N/A	N/A
smn:application:updatePlatform	Grants permissions to update a platform.	Write	application *	N/A	N/A
smn:application:listPlatform	Grants permissions to query the platform list.	List	application *	N/A	N/A
smn:application:getPlatform	Grants permissions to query platform details.	Read	application *	N/A	N/A
smn:subscriptionUser:create	Grants permissions to add a subscriber.	Write	subscription_user *	N/A	N/A
smn:subscriptionUser:create	Grants permissions to add a subscriber.	Write	N/A	smn:Protocol smn:Endpoint	N/A
smn:subscriptionUser:delete	Grants permissions to delete a subscriber.	Write	subscription_user *	N/A	N/A
smn:subscriptionUser:update	Grants permissions to update a subscriber.	Write	subscription_user *	N/A	N/A
smn:subscriptionUser:list	Grants permissions to query the subscriber list.	List	subscription_user *	N/A	N/A

Each API of SMN usually supports one or more actions. Table 2 lists the supported actions and dependencies.

**Table 2** Actions and dependencies supported by SMN APIs
API	Action	Dependency
POST /v2/{project_id}/notifications/topics	smn:topic:create	N/A
GET /v2/{project_id}/notifications/topics	smn:topic:listTopic	N/A
PUT /v2/{project_id}/notifications/topics/{topic_urn}	smn:topic:updateTopic	N/A
GET /v2/{project_id}/notifications/topics/{topic_urn}	smn:topic:get	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}	smn:topic:delete	N/A
GET /v2/{project_id}/notifications/topics/{topic_urn}/attributes	smn:topic:listAttributes	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/attributes	smn:topic:deleteAttribute	N/A
PUT /v2/{project_id}/notifications/topics/{topic_urn}/attributes/{name}	smn:topic:updateAttribute	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/attributes/{name}	smn:topic:deleteAttribute	N/A
POST /v2/{project_id}/notifications/topics/{topic_urn}/subscriptions	smn:topic:subscribe	N/A
GET /v2/{project_id}/notifications/topics/{topic_urn}/subscriptions	smn:topic:listSubscriptionsByTopic	N/A
PUT /v2/{project_id}/notifications/topics/{topic_urn}/subscriptions/{subscription_urn}	smn:topic:updateSubscription	N/A
DELETE /v2/{project_id}/notifications/subscriptions/{subscription_urn}	smn:topic:deleteSubscription	N/A
DELETE /v2/{project_id}/notifications/subscriptions	smn:topic:deleteSubscription	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/subscriptions/{subscription_urn}	smn:topic:deleteSubscription	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/subscriptions	smn:topic:deleteSubscription	N/A
GET /v2/{project_id}/notifications/subscriptions	smn:topic:listSubscriptions	N/A
POST /v2/{project_id}/notifications/topics/{topic_urn}/publish	smn:topic:publish	N/A
POST /v2/{project_id}/notifications/message_template	smn:template:create	N/A
GET /v2/{project_id}/notifications/message_template	smn:template:listTemplates	N/A
PUT /v2/{project_id}/notifications/message_template/{message_template_id}	smn:template:update	N/A
GET /v2/{project_id}/notifications/message_template/{message_template_id}	smn:template:get	N/A
DELETE /v2/{project_id}/notifications/message_template/{message_template_id}	smn:template:delete	N/A
POST /v2/{project_id}/{resource_type}/{resource_id}/tags	smn:tag:create	N/A
GET /v2/{project_id}/{resource_type}/{resource_id}/tags	smn:tag:list	N/A
POST /v2/{project_id}/{resource_type}/{resource_id}/tags/action	smn:tag:batchModify	smn:tag:create smn:tag:delete
DELETE /v2/{project_id}/{resource_type}/{resource_id}/tags/{key}	smn:tag:delete	N/A
GET /v2/{project_id}/{resource_type}/tags	smn:tag:list	N/A
POST /v2/{project_id}/{resource_type}/resource_instances/action	smn:tag:list	N/A
GET /v2/{project_id}/notifications/topics/{topic_urn}/logtanks	smn:topic:listLogTank	N/A
POST /v2/{project_id}/notifications/topics/{topic_urn}/logtanks	smn:topic:createLogTank	N/A
PUT /v2/{project_id}/notifications/topics/{topic_urn}/logtanks/{logtank_id}	smn:topic:updateLogTank	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/logtanks/{logtank_id}	smn:topic:deleteLogTank	N/A
POST /v2/{project_id}/notifications/subscriptions/filter_polices	smn:topic:updateSubscription	N/A
PUT /v2/{project_id}/notifications/subscriptions/filter_polices	smn:topic:updateSubscription	N/A
DELETE /v2/{project_id}/notifications/subscriptions/filter_polices	smn:topic:updateSubscription	N/A
POST /v2/{project_id}/notifications/topics/{topic_urn}/subscriptions/from-subscription-users	smn:topic:subscribe	N/A
POST /v2/{project_id}/notifications/topics/{topic_urn}/notify-policy	smn:topic:createNotifyPolicy	smn:topic:listSubscriptionsByTopic
PUT /v2/{project_id}/notifications/topics/{topic_urn}/notify-policy/{notify_policy_id}	smn:topic:updateNotifyPolicy	smn:topic:listSubscriptionsByTopic
GET /v2/{project_id}/notifications/topics/{topic_urn}/notify-policy	smn:topic:getNotifyPolicy	N/A
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/notify-policy/{notify_policy_id}	smn:topic:deleteNotifyPolicy	N/A
GET /v2/{project_id}/notifications/topics/{topic_urn}/statistics	smn:topic:get	N/A
POST /v2/{project_id}/notifications/topics/{topic_urn}/kms	smn:topic:createKmsKey	smn:topic:get
PUT /v2/{project_id}/notifications/topics/{topic_urn}/kms/{id}	smn:topic:updateKmsKey	smn:topic:get smn:topic:getKmsKey
GET /v2/{project_id}/notifications/topics/{topic_urn}/kms	smn:topic:getKmsKey	smn:topic:get
DELETE /v2/{project_id}/notifications/topics/{topic_urn}/kms/{id}	smn:topic:deleteKmsKey	smn:topic:get smn:topic:getKmsKey
N/A	smn:application:create	N/A
N/A	smn:application:delete	N/A
N/A	smn:application:list	N/A
N/A	smn:application:get	N/A
N/A	smn:application:publish	N/A
N/A	smn:application:createPlatform	N/A
N/A	smn:application:deletePlatform	N/A
N/A	smn:application:updatePlatform	N/A
N/A	smn:application:listPlatform	N/A
N/A	smn:application:getPlatform	N/A
POST /v2/{domain_id}/subscription-users	smn:subscriptionUser:create	N/A
DELETE /v2/{domain_id}/subscription-users/{id}	smn:subscriptionUser:delete	N/A
PUT /v2/{domain_id}/subscription-users/{id}	smn:subscriptionUser:update	N/A
GET /v2/{domain_id}/subscription-users	smn:subscriptionUser:list	N/A

Resources

A resource type indicates the resources that an identity policy applies to. If you specify a resource type for any action in Table 3, a resource URN must be specified in the identity policy statements using that action, and the identity policy applies only to the resource. If no resource type is specified, the Resource element is marked with an asterisk (*) and the identity policy applies to all resources. You can also set condition keys in an identity policy to define resource types.

The following table lists the resource types that you can define in identity policy statements for SMN.

**Table 3** Resource types supported by SMN
Resource Type	URN
application	smn::<account-id>:application:<application-id>
topic	smn:<region>:<account-id>:topic:<topic-id>
subscription_user	smn::<account-id>:subscription_user:<subscription-user-id>
template	smn:<region>:<account-id>:template:<template-id>

Conditions

About condition keys

A Condition element lets you specify conditions for when an identity policy is in effect. It contains condition keys and operators.

The condition key that you specify can be a global condition key or a service-specific condition key.
- Global condition keys (with the g: prefix) apply to all actions. Cloud services do not need to provide user identity information. Instead, the system automatically obtains such information and authenticates users. For details, see Global Condition Keys.
- Service-specific condition keys (with the abbreviation of a service name plus a colon as the prefix, for example, smn:) only apply to operations of the SMN service. For details, see Table 4.
- The number of values associated with a condition key in the request context of an API call makes the condition key single-valued or multivalued. Single-valued condition keys have at most one value in the request context of an API call. Multivalued condition keys can have multiple values in the request context of an API call. For example, a request can originate from at most one VPC endpoint, so g:SourceVpce is a single-valued condition key. You can tag resources and include multiple tag key-value pairs in a request, so g:TagKeys is a multivalued condition key.
A condition operator, condition key, and a condition value together constitute a complete condition statement. An identity policy can be applied only when its request conditions are met. For supported condition operators, see Condition operators.

Service-specific condition keys supported by SMN

The following table lists the condition keys that you can define in custom identity policies for SMN. You can include these condition keys to specify conditions for when your identity policy is in effect.

**Table 4** Service-specific condition keys supported by SMN
Service-specific Condition Key	Type	Single-valued/Multivalued	Description
smn:TargetOrgPath	string	Single-valued	The organization path authorized in a topic policy.
smn:TargetOrgId	string	Single-valued	The organization ID authorized in a topic policy.
smn:TargetAccountId	string	Single-valued	The account ID authorized in a topic policy.
smn:Protocol	string	Single-valued	The subscription protocol.
smn:Endpoint	string	Single-valued	The subscription endpoint address.
smn:Protocol	string	Single-valued	The subscription protocol.
smn:Endpoint	string	Single-valued	The subscription endpoint address.