Permissions Policies and Supported Actions

This chapter describes fine-grained permissions management for your DCS. If your account does not need individual IAM users, then you may skip over this chapter.

By default, new IAM users do not have any permissions assigned. You need to add a user to one or more groups, and assign permissions policies to these groups. The user then inherits permissions from the groups it is a member of. This process is called authorization. After authorization, the user can perform specified operations on cloud services based on the permissions.

You can grant users permissions by using roles and policies. Roles are a type of coarse-grained authorization mechanism that defines permissions related to user responsibilities. Policies define API-based permissions for operations on specific resources under certain conditions, allowing for more fine-grained, secure access control of cloud resources.

Policy-based authorization is recommended if you want to allow or deny the access to an API.

An account has all of the permissions required to call all APIs, but IAM users must be assigned the required permissions. The permissions required for calling an API are determined by the actions supported by the API. Only users that have been granted permissions allowing the actions can call the API successfully. For example, if an IAM user wants to query ECSs using an API, the user must have been granted permissions that allow the dcs:servers:list action.

Supported Actions

DCS provides system-defined policies, which can be directly used in IAM. You can also create custom policies to supplement system-defined policies for more refined access control. Actions supported by policies are specific to APIs. Common concepts related to policies include:

Permissions: Allow or deny certain operations.
APIs: APIs that will be called for performing certain operations.
Actions: added to a custom policy to control permissions for specific operations.
Dependent actions: When assigning permissions for an action, you also need to assign permissions for the dependent actions.
IAM projects and enterprise projects: type of projects for which an action will take effect. Policies that contain actions supporting both IAM and enterprise projects can be assigned to user groups and take effect in both IAM and Enterprise Management. If an action supports only IAM projects, the policy will take effect only for user groups assigned in IAM. Administrators can check whether an action supports IAM projects or enterprise projects in the action list. "√" indicates that the action supports the project and "×" indicates that the action does not support the project. For details about the differences between IAM and enterprise management, see What Are the Differences Between IAM and Enterprise Management?

Table 1 lists the API actions supported by DCS.

**Table 1** DCS actions
Permission	Action	API	IAM Projects	Enterprise Project
Creating a DCS instance	dcs:instance:create	POST /v2/{project_id}/instances	√	√
Querying an instance	dcs:instance:get	GET /v2/{project_id}/instances/{instance_id}	√	√
Modifying the information about an instance	dcs:instance:modify	PUT /v2/{project_id}/instances/{instance_id}	√	√
Deleting an instance	dcs:instance:delete	DELETE /v2/{project_id}/instances/{instance_id}	√	√
Expanding instance capacity	dcs:instance:scale	POST /v2/{project_id}/instances/{instance_id}/resize	√	√
Querying all instances	dcs:instance:list	GET /v2/{project_id}/instances	√	√
Querying instance configuration parameters	dcs:instance:getConfiguration	GET /v2/{project_id}/instances/{instance_id}/configs	√	√
Modifying instance configuration parameters	dcs:instance:modifyConfigureation	PUT /v2/{project_id}/instances/{instance_id}/configs	√	√
Restarting an instance or clearing instance data	dcs:instance:modifyStatus	PUT /v2/{project_id}/instances/status	√	√
Changing the instance password	dcs:instance:modifyAuthInfo	PUT /v2/{project_id}/instances/{instance_id}/password	√	√
Backing up an instance	dcs:instance:backupData	POST /v2/{project_id}/instances/{instance_id}/backups	√	√
Restoring an instance	dcs:instance:restoreData	POST /v2/{project_id}/instances/{instance_id}/restores	√	√
Querying backup records	dcs:instance:getDataBackupLog	GET /v2/{project_id}/instances/{instance_id}/backups	√	√
Querying restoration records	dcs:instance:getDataRestoreLog	GET /v2/{project_id}/instances/{instance_id}/restores	√	√
Deleting backup files	dcs:instance:deleteDataBackupFile	DELETE /v2/{project_id}/instances/{instance_id}/backups/{backup_id}	√	√
Listing background tasks	dcs:instance:getBackgroundTask	GET /v2/{project_id}/instances/{instance_id}/tasks	√	√
Deleting a background task	dcs:instance:deleteBackgroundTask	DELETE /v2/{project_id}/instances/{instance_id}/tasks/{task_id}	√	√
Resetting the instance password	dcs:instance:resetAuthInfo	POST /v2/{project_id}/instances/{instance_id}/password/reset	√	√
Downloading backup files	dcs:instance:downloadBackupData	POST /v2/{project_id}/instances/{instance_id}/backups/{backup_id}/links	√	√
Migrating data	dcs:instance:migrateData	-	√	√
Web CLI	dcs:instance:webcli	-	√	√
Creating a migration task	dcs:migrationTask:create	POST /v2/{project_id}/migration-task	√	X
Modifying migration task configurations or stopping a migration task	dcs:migrationTask:modify	POST /v2/{project_id}/migration-task/{task_id}/stop	√	X
Deleting a migration task	dcs:migrationTask:delete	DELETE /v2/{project_id}/migration-tasks/delete	√	X
Listing migration tasks	dcs:migrationTask:list	GET /v2/{project_id}/migration-tasks	√	X
Querying details of a data migration task	dcs:migrationTask:get	GET /v2/{project_id}/migration-task/{task_id}	√	X
Diagnosing an instance	dcs:instance:diagnosis	POST /v2/{project_id}/instances/{instance_id}/diagnosis	√	√
Viewing parameter templates	dcs:template:list	GET /v2/{project_id}/config-templates	√	X
Creating a parameter template	dcs:template:create	POST /v2/{project_id}/config-templates	√	X
Performing a master/standby switchover	dcs:instance:swap	POST /v2/{project_id}/instances/{instance_id}/swap	√	√
Modifying the whitelist of an instance	dcs:whitelist:modify	PUT /v2/{project_id}/instance/{instance_id}/whitelist	√	√
Obtaining the whitelist of an instance	dcs:whitelist:list	GET /v2/{project_id}/instance/{instance_id}/whitelist	√	√
Creating a user for accessing an instance	dcs:aclaccount:create	POST /v2/{project_id}/instances/{instance_id}/accounts	√	√
Deleting an instance user	dcs:aclaccount:delete	DELETE /v2/{project_id}/instances/{instance_id}/accounts/{account_id}	√	√
Modifying the information about an instance user	dcs:aclaccount:modify	PUT /v2/{project_id}/instances/{instance_id}/accounts/{account_id}	√	√
Obtaining the list of instance users	dcs:aclaccount:list	GET /v2/{project_id}/instances/{instance_id}/accounts	√	√
Querying slow logs	dcs:slowlog:list	GET /v2/{project_id}/instances/{instance_id}/slowlog	√	√
Viewing parameter templates	dcs:template:get	-	√	X
Viewing the task progress	dcs:job:get	-	√	√
Viewing audit logs	dcs:auditlog:get	-	√	√
Querying instance upgrade information	dcs:instance:getUpgradeInfo	-	√	√
Querying SSL encryption of an instance	dcs:ssl:get	-	√	√
Updating domain names	dcs:domainname:rebuild	-	√	√
Switching IP addresses	dcs:migrationTask:exchangeIp	-	√	X
Rolling back IP address switching	dcs:migrationTask:rollbackIp	-	√	X
Killing Redis sessions	dcs:clients:kill	-	√	√
Modifying a parameter template	dcs:template:modify	-	√	X
Enabling or disabling public domain name resolution	dcs:publicdomainname:update	-	√	√
Deleting a parameter template	dcs:template:delete	-	√	X
Releasing historical domain names	dcs:histroydomainname:release	-	√	√
Analyzing big or hot keys	dcs:instance:analyze	-	√	√
Enabling or disabling audit logging	dcs:auditlog:modify	-	√	√
Enabling or disabling client IP pass-through	dcs:clientiptrans:modify	-	√	√
Modifying SSL encryption for an instance	dcs:ssl:modify	-	√	√
Querying the Redis session list	dcs:clients:list	-	√	√
Modifying instance bandwidth	dcs:bandwidth:modify	-	√	√
Querying instance bandwidth	dcs:bandwidth:get	-	√	√
Listing tags of a DCS instance	dcs:tag:list	-	√	X
Viewing tags of a DCS instance	dcs:tag:get	GET /v2/{project_id}/dcs/tags	√	√
Modifying an instance tag	dcs:tag:modify	-	√	√