RAM authorization - ActionTrail

Resource Access Management (RAM) is a service provided by Alibaba Cloud to manage user identities and resource access permissions. You can use RAM to prevent RAM users from sharing the AccessKey pairs of your Alibaba Cloud account. You can also use RAM to grant minimum permissions to RAM users. RAM uses policies to define permissions.

This topic describes the elements, such as Action, Resource, and Condition, which are defined by ActionTrail. You can use the elements to create policies in RAM. The code (RamCode) in RAM that is used to indicate ActionTrail is actiontrail. You can grant permissions on ActionTrail at the OPERATION.

General structure of a policy

Policies can be stored as JSON files. The following code provides an example on the general structure of a policy:

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}

The following list describes the fields in the policy:

Effect: specifies the authorization effect. Valid values: Allow, Deny.
Action: specifies one or more API operations that are allowed or denied. For more information, see the Action section of this topic.
Resource: specifies one or more resources to which the policy applies. You can use an Alibaba Cloud Resource Name (ARN) to specify a resource. For more information, see the Resource section of this topic.
Condition: specifies one or more conditions that are required for the policy to take effect. This is an optional field. For more information, see the Condition section of this topic.
- Condition_operator: specifies the conditional operators. Different types of conditions support different conditional operators. For more information, see Policy elements.
- Condition_key: specifies the condition keys.
- Condition_value: specifies the condition values.

Action

ActionTrail defines the values that you can use in the Action element of a policy statement. The following table describes the values.

Operation: the value that you can use in the Action element to specify the operation on a resource.
API operation: the API operation that you can call to perform the operation.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition key: the condition keys that are defined by the Alibaba Cloud service. The Condition key column does not list the common condition keys that are defined by Alibaba Cloud. For more information about the common condition keys, see Generic Condition Keyword.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Actions	API operation	Access level	Resource type	Condition key	Associated operation
actiontrail:GetAccessKeyLastUsedProducts	GetAccessKeyLastUsedProducts	list	All Resources *	None	None
actiontrail:UpdateTrail	UpdateTrail	update	All Resources *	None	None
actiontrail:GetDeliveryHistoryJob	GetDeliveryHistoryJob	get	All Resources *	None	None
actiontrail:StartLogging	StartLogging	update	All Resources *	None	None
actiontrail:CreateDeliveryHistoryJob	CreateDeliveryHistoryJob	create	All Resources *	None	None
actiontrail:GetAccessKeyLastUsedResources	GetAccessKeyLastUsedResources	list	All Resources *	None	None
actiontrail:ListDeliveryHistoryJobs	ListDeliveryHistoryJobs	get	All Resources *	None	None
actiontrail:GetAccessKeyLastUsedIps	GetAccessKeyLastUsedIps	list	All Resources *	None	None
actiontrail:DeleteDeliveryHistoryJob	DeleteDeliveryHistoryJob	delete	All Resources *	None	None
actiontrail:StopLogging	StopLogging	update	All Resources *	None	None
actiontrail:DescribeTrails	DescribeTrails	get	All Resources *	None	None
actiontrail:GetAccessKeyLastUsedEvents	GetAccessKeyLastUsedEvents	list	All Resources *	None	None
actiontrail:GetTrailStatus	GetTrailStatus	get	All Resources *	None	None
actiontrail:EnableInsight	EnableInsight	update	All Resources *	None	None
actiontrail:CreateTrail	CreateTrail	create	All Resources *	None	None
actiontrail:LookupEvents	LookupEvents	get	All Resources *	None	None
actiontrail:DeleteTrail	DeleteTrail	delete	All Resources *	None	None
actiontrail:GetAccessKeyLastUsedInfo	GetAccessKeyLastUsedInfo	get	All Resources *	None	None

Resource

In ActionTrail, you cannot specify an ARN in the Resource element in a policy statement. If you want to authorize a RAM user or a RAM role to access ActionTrail, you cannot specify an ARN in the "Resource": "*".

Condition

ActionTrail does not define service-specific condition keys. For more information about common condition keys that are defined by Alibaba Cloud, see Generic Condition Keyword.

What to do next

You can create a custom policy and attach the policy to a RAM user, RAM user group, or RAM role. For more information, see the following topics: