Actions Supported by Identity Policy-based Authorization

IAM provides system-defined 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 also provides Service Control Policies (SCPs) to set access control policies.

SCPs do not actually grant any permissions to an entity. They only set the permissions boundary for the entity. When SCPs are attached to an organizational unit (OU) or a member account, the SCPs do not directly grant permissions to that OU or member account. Instead, the SCPs only determine what permissions are available for that member account or those 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 policy 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 GaussDB, see Resources.
The Condition Key column contains keys that you can specify in the Condition element of an identity policy statement. If this column is empty (-), the action does not support any condition keys.
For details about the condition keys defined by GaussDB, see Conditions.
The Alias column lists the policy actions that can be 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 GaussDB.

**Table 1** Actions supported by GaussDB
Action	Description	Access Level	Resource Type (*: required)	Condition Key	Alias
gaussdb::updateDownloadPolicy	Grants permission to edit a download policy.	write	-	gaussdb:DownloadCategory	-
gaussdb::getDownloadPolicy	Grants permission to query a download policy.	read	-	-	-
gaussdb:backup:createBackup	Grants permission to create a manual backup for a DB instance.	write	instance	-	gaussdb:backup:create
gaussdb:backup:deleteBackup	Grants permission to delete a backup.	write	instance	-	gaussdb:backup:delete
gaussdb:backup:listAll	Grants permission to query backups.	list	instance	-	gaussdb:backup:list
gaussdb:instance:updateBackupPolicy	Grants permission to configure a backup policy.	write	instance	gaussdb:BackupEnabled	gaussdb:backup:enable gaussdb:backup:switchTableBackup gaussdb:instance:modifyBackupPolicy
gaussdb:param:applyParam	Grants permission to apply a parameter template.	write	instance	-	gaussdb:param:apply gaussdb:param:modify gaussdb:instance:modifyParameter
gaussdb:tag:create	Grants permission to add tags.	tagging	instance	-	gaussdb:instance:dealTag
gaussdb:instance:bindEIP	Grants permission to bind an EIP.	write	instance	-	gaussdb:instance:bindPublicIp gaussdb:instance:modify
gaussdb:instance:check	Grants permission to query instance information.	read	instance	-	gaussdb:instance:list
gaussdb:instance:createInstance	Grants permission to create a DB instance.	write	instance	gaussdb:BackupEnabled gaussdb:Encrypted gaussdb:AvailabilityZone gaussdb:VpcId gaussdb:Subnet gaussdb:KmsId gaussdb:FlavorType	gaussdb:instance:create
gaussdb:instance:createDatabase	Grants permission to create a database.	write	instance	-	gaussdb:instance:modify
gaussdb:instance:createDatabaseSchema	Grants permission to create a database schema.	write	instance	-	gaussdb:instance:modify
gaussdb:instance:createDatabaseUser	Grants permission to create a database account.	write	instance	-	gaussdb:instance:modify
gaussdb:instance:deleteInstance	Grants permission to delete a DB instance.	write	instance	-	gaussdb:instance:delete
gaussdb:instance:get	Grants permission to query DB instance information.	read	instance	-	gaussdb:instance:list
gaussdb:instance:getBackupPolicy	Grants permission to query an automated backup policy.	read	instance	-	gaussdb:instance:list gaussdb:backup:list
gaussdb:instance:getBalanceStatus	Grants permission to check whether host load is unbalanced due to a primary/standby switchover.	read	instance	-	gaussdb:instance:list
gaussdb:instance:getDiskUsage	Grants permission to query disk usage.	read	instance	-	gaussdb:instance:list
gaussdb:instance:getRecyclePolicy	Grants permission to query the recycling policy.	read	instance	-	gaussdb:instance:list
gaussdb:instance:downloadSslCert	Grants permission to download the SSL certificate of a DB instance.	read	instance	-	gaussdb:instance:list
gaussdb:instance:grantDatabasePrivilege	Grants permission to configure permissions of database accounts.	write	instance	-	gaussdb:instance:modify
gaussdb:instance:listAll	Grants permission to query DB instances.	list	instance	-	gaussdb:instance:list
gaussdb:instance:listPublicIps	Grants permission to query EIPs bound to DB instances.	list	instance	-	gaussdb:instance:list
gaussdb:instance:listComponents	Grants permission to query instance components.	list	instance	-	gaussdb:instance:list
gaussdb:instance:listDatabases	Grants permission to query DB instances.	list	instance	-	gaussdb:instance:list
gaussdb:instance:listDatabaseUsers	Grants permission to query database users.	list	instance	-	gaussdb:instance:list
gaussdb:tag:listAll	Grants permission to query resource tags.	list	instance	-	gaussdb:instance:list
gaussdb:quota:listAll	Grants permission to query quotas.	list	instance	-	gaussdb:instance:list
gaussdb:instance:listRecoverableTimes	Grants permission to query the restoration time range.	list	instance	-	gaussdb:instance:list gaussdb:backup:list
gaussdb:instance:listSchemas	Grants permission to query database schemas.	list	instance	-	gaussdb:instance:list
gaussdb:instance:renameInstance	Grants permission to change a DB instance name.	write	instance	-	gaussdb:instance:modify gaussdb:instance:rename
gaussdb:instance:resetPassword	Grants permission to reset a database password.	write	instance	-	gaussdb:instance:modify gaussdb:instance:modifyPasswd gaussdb:instance:modifyDatabasePasswd
gaussdb:instance:resizeFlavor	Grants permission to change vCPUs and memory of a DB instance.	write	instance	-	gaussdb:instance:modify gaussdb:instance:modifySpec
gaussdb:instance:restartInstance	Grants permission to reboot a DB instance.	write	instance	-	gaussdb:instance:modify gaussdb:instance:restart
gaussdb:instance:setRecyclePolicy	Grants permission to modify the recycling policy.	write	instance	-	gaussdb:instance:modifyBackupPolicy
gaussdb:instance:switchShard	Grants permission to switch roles of the primary and standby DNs in shards.	write	instance	-	gaussdb:instance:modify
gaussdb:instance:extend	Grants permission to perform scale-out operations.	write	instance	-	gaussdb:instance:modifySpec
gaussdb:param:update	Grants permission to modify a parameter template.	write	instance	-	gaussdb:param:modify gaussdb:instance:modify gaussdb:instance:modifyParameter
gaussdb:param:check	Grants permission to check a parameter template.	read	instance	-	gaussdb:param:list gaussdb:instance:list
gaussdb:param:copy	Grants permission to replicate a parameter template.	write	instance	-	gaussdb:param:create
gaussdb:param:createParam	Grants permission to create a parameter template.	write	instance	-	gaussdb:param:create gaussdb:param:modify
gaussdb:param:deleteParam	Grants permission to delete a parameter template.	write	instance	-	gaussdb:param:delete
gaussdb:param:get	Grants permission to query details about a parameter template.	read	instance	-	gaussdb:param:list gaussdb:instance:list
gaussdb:param:compare	Grants permission to compare two parameter templates.	read	instance	-	gaussdb:param:list
gaussdb:param:listAll	Grants permission to query parameter templates.	list	instance	-	gaussdb:param:list gaussdb:instance:list
gaussdb:param:reset	Grants permission to reset a parameter template.	write	instance	-	gaussdb:param:modify
gaussdb:quota:update	Grants permission to modify quotas.	write	instance	-	gaussdb:quota:modify
gaussdb:task:listAll	Grants permission to query tasks.	list	instance	-	gaussdb:instance:list
gaussdb:task:delete	Grants permission to delete a task record.	write	instance	-	gaussdb:instance:list
gaussdb:task:get	Grants permission to query task details.	read	instance	-	gaussdb:instance:list

Each API of GaussDB usually supports one or more actions. The following table lists the supported actions and dependencies.

**Table 2** Instance management
Permission	API	Action	Dependency
Creating a DB instance	POST /v3.2/{project_id}/instances	gaussdb:instance:createInstance	If you use a KMS key to create an instance with disk encryption enabled, the following permission is required: kms:cmk:createGrant
Deleting a DB instance	DELETE /v3/{project_id}/instances/{instance_id}	gaussdb:instance:delete	-
Querying DB instances	GET /v3/{project_id}/instances	gaussdb:instance:listAll	-
Resetting a database password	POST /v3/{project_id}/instances/{instance_id}/password	gaussdb:instance:resetPassword	-
Changing a DB instance name	PUT /v3/{project_id}/instances/{instance_id}/name	gaussdb:instance:rename	-
Rebooting a DB instance	POST /v3/{project_id}/instances/{instance_id}/restart	gaussdb:instance:restart	-
Switching roles of the primary and standby DNs in shards	POST /v3/{project_id}/instances/{instance_id}/switch-shard	gaussdb:instance:switchShard	-
Querying the components of a DB instance	GET /v3/{project_id}/instances/{instance_id}/components	gaussdb:instance:listComponents	-
Changing vCPUs and memory of a DB instance	PUT /v3/{project_id}/instance/{instance_id}/flavor	gaussdb:instance:resizeFlavor	-
Checking whether host load is unbalanced due to a primary/standby switchover	GET /v3/{project_id}/instances/{instance_id}/balance	gaussdb:instance:getBalanceStatus	-
Querying solution template settings	GET /v3/{project_id}/deployment-form	gaussdb:instance:listAll	-
Querying EIPs bound to DB instances	GET /v3/{project_id}/instances/{instance_id}/public-ips?offset={offset}&limit={limit}	gaussdb:instance:listPublicIps	-
Binding or unbinding an EIP	POST /v3/{project_id}/instances/{instance_id}/nodes/{node_id}/public-ip	gaussdb:instance:bindPublicIp	-
Querying the SSL certificate download address of a DB instance	GET /v3/{project_id}/instances/{instance_id}/ssl-cert/download-link	gaussdb:instance:downloadSslCert	-
Querying the instance quotas of a tenant	GET /v3/{project_id}/project-quotas?type={type}	gaussdb:quota:listAll	-
Configuring a download policy	GET /v3/{project_id}/download/policy	gaussdb::updateDownloadPolicy	-
Querying a download policy	POST /v3/{project_id}/update/download/policy	gaussdb::getDownloadPolicy	-

**Table 3** Parameter configuration
Permission	API	Action	Dependency
Obtaining parameter templates	GET /v3/{project_id}/configurations?offset={offset}&limit={limit}	gaussdb:param:listAll	-
Obtaining parameters of a specified DB instance	GET /v3/{project_id}/instances/{instance_id}/configurations	gaussdb:instance:get	-
Modifying parameters of a specified DB instance	PUT /v3/{project_id}/instances/{instance_id}/configurations	gaussdb:param:update	-
Creating a parameter template	POST /v3/{project_id}/configurations	gaussdb:param:createParam	-
Deleting a parameter template	DELETE /v3/{project_id}/configurations/{config_id}	gaussdb:param:delete	-
Querying details about a parameter template	GET /v3/{project_id}/configurations/{config_id}	gaussdb:param:get	-
Replicating a parameter template	POST /v3/{project_id}/configurations/{config_id}/copy	gaussdb:param:copy	-
Resetting a parameter template	POST /v3/{project_id}/configurations/{config_id}/reset	gaussdb:param:reset	-
Obtaining the differences of two parameter templates	POST /v3/{project_id}/configurations/comparison	gaussdb:param:compare	-
Querying instances that a parameter template can be applied to	GET /v3/{project_id}/configurations/{config_id}/applicable-instances	gaussdb:instance:listAll	-
Checking whether a parameter template name is unique	GET /v3/{project_id}/configurations/name-validation?name={name}	gaussdb:param:check	-
Applying a parameter template	PUT /v3/{project_id}/configurations/{config_id}/apply	gaussdb:param:apply	-
Querying application records of a parameter template	GET /v3/{project_id}/configurations/{config_id}/applied-histories	gaussdb:param:listAll	-
Querying the change history of a parameter template	GET /v3/{project_id}/configurations/{config_id}/histories	gaussdb:param:listAll	-

**Table 4** Backup management
Permission	API	Action	Dependency
Configuring an automated backup policy	PUT /v3/{project_id}/instances/{instance_id}/backups/policy	gaussdb:instance:updateBackupPolicy	-
Querying an automated backup policy	GET /v3/{project_id}/instances/{instance_id}/backups/policy	gaussdb:instance:getBackupPolicy	-
Querying backups	GET /v3/{project_id}/backups?instance_id={instance_id}&backup_id={backup_id}&backup_type={backup_type}&offset={offset}&limit={limit}&begin_time={begin_time}&end_time={end_time}	gaussdb:backup:listAll	-
Creating a manual backup	POST /v3/{project_id}/backups	gaussdb:backup:create	-
Deleting a manual backup	DELETE /v3/{project_id}/backups/{backup_id}	gaussdb:backup:delete	-
Querying the restoration time range	GET /v3/{project_id}/instances/{instance_id}/restore-time?date={date}	gaussdb:instance:listRecoverableTimes	-
Restoring data to a new DB instance	POST /v3/{project_id}/instances	gaussdb:instance:createInstance	-
Querying instances that can be used for backups and restorations	GET /v3/{project_id}/restorable-instances	gaussdb:instance:listAll	-
Querying the information of the original instance based on a specific point of time or a backup file	GET /v3/{project_id}/instance-snapshot?instance_id={instance_id}&backup_id={backup_id}&restore_time={restore_time}	gaussdb:instance:get	-

**Table 5** DB engine versions and specifications
Permission	API	Action	Dependency
Querying DB engine versions	GET /v3/{project_id}/datastore/versions	gaussdb:instance:listAll	-
Querying instance specifications	GET /v3/{project_id}/flavors?limit={limit}&offset={offset}&ha_mode={ha_mode}&version={version}&spec_code={spec_code}	gaussdb:instance:listAll	-
Querying DB engines	GET /v3/{project_id}/datastores	gaussdb:instance:listAll	-
Querying specifications that a DB instance can be changed to	GET /v3/{project_id}/instances/{instance_id}/available-flavors	gaussdb:instance:listAll	-

**Table 6** Database and account management
Permission	API	Action	Dependency
Creating a database	POST /v3/{project_id}/instances/{instance_id}/database	gaussdb:instance:createDatabase	-
Creating a database account	POST /v3/{project_id}/instances/{instance_id}/db-user	gaussdb:instance:createDatabaseUser	-
Creating a database schema	POST /v3/{project_id}/instances/{instance_id}/schema	gaussdb:instance:createDatabaseSchema	-
Authorizing a database account	POST /v3/{project_id}/instances/{instance_id}/db-privilege	gaussdb:instance:grantDatabasePrivilege	-
Resetting a password for a database account	PUT /v3/{project_id}/instances/{instance_id}/db-user/password	gaussdb:instance:resetPassword	-
Querying databases	GET /v3/{project_id}/instances/{instance_id}/databases	gaussdb:instance:listDatabases	-
Querying database users	GET /v3/{project_id}/instances/{instance_id}/db-users	gaussdb:instance:listDatabaseUsers	-
Querying database schemas	GET /v3/{project_id}/instances/{instance_id}/schemas	gaussdb:instance:listSchemas	-

**Table 7** Tag management
Permission	API	Action	Dependency
Querying tags of a specific instance	GET /v3/{project_id}/instances/{instance_id}/tags	gaussdb:tag:listAll	-
Querying tags of a project	GET /v3/{project_id}/tags	gaussdb:tag:listAll	-
Querying predefined tags	GET /v3/{project_id}/predefined-tags	gaussdb:tag:listAll	-
Adding tags for a DB instance	POST /v3/{project_id}/instances/{instance_id}/tags	gaussdb:tag:create	-
Deleting instance tags in batches	DELETE /v3/{project_id}/instances/{instance_id}/tags	gaussdb:tag:delete	-

**Table 8** Storage management
Permission	API	Action	Dependency
Querying the storage usage of a DB instance	GET /v3/{project_id}/instances/{instance_id}/volume-usage	gaussdb:instance:getDiskUsage	-
Querying the database disk type	GET /v3/{project_id}/storage-type?version={version}&ha_mode={ha_mode}	gaussdb:instance:listAll	-

**Table 9** Quota management
Permission	API	Action	Dependency
Modifying enterprise project quotas	PUT /v3/{project_id}/enterprise-projects/quotas	gaussdb:quota:update	-
Querying enterprise project quotas	GET /v3/{project_id}/enterprise-projects/quotas	gaussdb:quota:listAll	-

**Table 10** Task management
Permission	API	Action	Dependency
Obtaining task information	GET /v3/{project_id}/jobs?id={id}	gaussdb:task:get	-
Querying tasks	GET /v3/{project_id}/tasks	gaussdb:task:listAll	-
Deleting a task record	DELETE /v3/{project_id}/jobs/{job_id}	gaussdb:task:delete	-

**Table 11** Recycle bin
Permission	API	Action	Dependency
Modifying the recycling policy	PUT /v3/{project_id}/recycle-policy	gaussdb:instance:setRecyclePolicy	-
Querying the recycling policy	GET /v3/{project_id}/recycle-policy	gaussdb:instance:getRecyclePolicy	-
Querying all DB engine instances in the recycle bin	GET /v3/{project_id}/recycle-instances	gaussdb:instance:listAll	-

Resources

A resource type indicates the resources that an identity policy applies to. If you specify a resource type for any action in Table 12, the resource URN must be specified in the identity policy statements using that action, and the identity policy applies only to resources of this type. 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 type that you can define in identity policy statements for GaussDB.

**Table 12** Resource type supported by GaussDB
Resource Type	URN
instance	gaussdb:<region>:<account-id>:instance:<instance-id>

Conditions

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, gaussdb:) apply only to operations of the RAM service. For details, see Table 13.
- 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.

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

**Table 13** Service-specific condition keys supported by GaussDB
Service-specific Condition Key	Type	Single-valued/Multivalued	Description
gaussdb:BackupEnabled	boolean	Single-valued	Filter access permissions based on the tag key of whether to enable the backup policy transferred in the request parameter. Select Default for Qualifier.
gaussdb:Encrypted	boolean	Single-valued	Filter access permissions based on the tag key of whether to enable disk encryption transferred in the request parameter. Select Default for Qualifier.
gaussdb:DownloadCategory	string	Single-valued	Filters access by the download policy type name that is passed in the request. Select Default for Qualifier.
gaussdb:AvailabilityZone	string	Multivalued	Filters access by the AZs that are passed in the request. Select For any value in the request or For all values in the request for Qualifier.
gaussdb:VpcId	string	Single-valued	Filters access by the VPC ID that is passed in the request. Select Default for Qualifier.
gaussdb:Subnet	string	Single-valued	Filters access by the subnet ID that is passed in the request. Select Default for Qualifier.
gaussdb:KmsId	string	Single-valued	Filters access by the disk encryption ID that is passed in the request. Select Default for Qualifier.
gaussdb:FlavorType	string	Single-valued	Filters access by the specification type that is passed in the request. Select Default for Qualifier.