All Products
Search
Document Center

PolarDB:Use RAM for resource authorization

Last Updated:Mar 28, 2026

Resource Access Management (RAM) lets you grant sub-accounts fine-grained access to PolarDB-X 1.0 resources. This page lists the RAM authorization rules supported by PolarDB-X 1.0 and the regions where RAM is available.

How authorization rules work

Each RAM policy statement requires an Action and a Resource. For PolarDB-X 1.0, resources follow this pattern:

acs:drds:<regionId>:<accountId>:<resourcePath>

Replace the placeholders with actual values:

PlaceholderDescriptionExample
<regionId>Region ID where the instance resides. See Regions that support RAM.cn-hangzhou
<accountId>Your Alibaba Cloud account ID123456789012
<resourcePath>The resource path. See the authorization rules tables below.instance/drds-abc123

Example: To grant access to a specific instance in China (Hangzhou):

acs:drds:cn-hangzhou:123456789012:instance/drds-abc123

Resource types

PolarDB-X 1.0 supports five resource patterns:

Resource patternScope
instance/*All instances (wildcard)
instance/$instanceidA specific instance
instance/$instanceid/db/*All databases in a specific instance (wildcard)
instance/$instanceid/db/$dbnameA specific database in a specific instance
contacts/*All alert contacts (wildcard)

Authorization rules

The following tables list all supported actions, grouped by access level. Use these tables to build RAM policies with the minimum required permissions.

Replace all $-prefixed parameters in the Authorization rule column with actual values. For $regionId, use the region ID from Regions that support RAM.

Instance management

These actions operate at the instance level (instance/* or instance/$instanceid).

ActionAuthorization ruleDescription
CreateDrdsInstanceacs:drds:$regionid:$accountid:instance/*Create an instance
DescribeDrdsInstanceListacs:drds:$regionid:$accountid:instance/*List instances
UpgradeDrdsInstanceacs:drds:$regionid:$accountid:instance/$instanceidChange instance configurations
RemoveDRDSInstanceacs:drds:$regionid:$accountid:instance/$instanceidRelease an instance
DescribeDrdsInstanceacs:drds:$regionid:$accountid:instance/$instanceidGet instance details
VersionChanageacs:drds:$regionid:$accountid:instance/$instanceidUpgrade or roll back the instance version
CreateInternetAddressacs:drds:$regionid:$accountid:instance/$instanceidCreate a public IP address for the instance
ReleaseInternetAddressacs:drds:$regionid:$accountid:instance/$instanceidRelease the public IP address of the instance
DescribeInstanceMonitoracs:drds:$regionid:$accountid:instance/$instanceidGet instance monitoring information
DescribeSlowSqlacs:drds:$regionid:$accountid:instance/$instanceidQuery slow SQL statements

Database management

These actions operate at the database level (instance/$instanceid/db/* or instance/$instanceid/db/$dbname).

ActionAuthorization ruleDescription
CreateDrdsDBacs:drds:$regionid:$accountid:instance/$instanceid/db/*Create a database
DescribeDrdsDbListacs:drds:$regionid:$accountid:instance/$instanceid/db/*List databases in the instance
DescribeDrdsDbacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameGet database details
DeleteDrdsDbacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameDelete a database
ModifyReadWriteWeightacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameModify the read policy
DescribeLogicTableListacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameList tables in the database
ExecuteDDLacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameExecute a data definition language (DDL) statement in the PolarDB-X 1.0 console
ModifyDrdsIpWhiteListacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameModify the IP address whitelist of the database
DrdsDataImportacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameImport data
DrdsSmoothExpandacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnamePerform smooth scale-out
CreateReadOnlyAccountacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameCreate a read-only account
ModifyReadOnlyAccountPasswordacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameChange the password of a read-only account
RemoveReadOnlyAccountacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameDelete a read-only account
DrdsShardToolacs:drds:$regionid:$accountid:instance/$instanceid/db/$dbnameUse the shard change tool

Alert management

Alert contact and group actions use the contacts/* wildcard and cannot be scoped to individual contacts. Alert rule actions operate at the instance level.

CreateAlarmRule and ModifyAlarmRule require the DescribeAlarmGroup permission to query alert contact groups.
ActionAuthorization ruleDescription
DescribeAlarmContactsacs:drds:$regionid:$accountid:contacts/*List alert contacts
AddAlarmContactsacs:drds:$regionid:$accountid:contacts/*Add an alert contact
ModifyAlarmContactsacs:drds:$regionid:$accountid:contacts/*Modify an alert contact
RemoveAlarmContactsacs:drds:$regionid:$accountid:contacts/*Delete an alert contact
DescribeAlarmGroupacs:drds:$regionid:$accountid:contacts/*List alert contact groups
AddAlarmGroupacs:drds:$regionid:$accountid:contacts/*Add an alert contact group
ModifyAlarmGroupacs:drds:$regionid:$accountid:contacts/*Modify an alert contact group
RemoveAlarmGroupacs:drds:$regionid:$accountid:contacts/*Delete an alert contact group
DescribeAlarmRuleacs:drds:$regionid:$accountid:instance/$instanceidList alert rules
CreateAlarmRuleacs:drds:$regionid:$accountid:instance/$instanceidCreate an alert rule
ModifyAlarmRuleacs:drds:$regionid:$accountid:instance/$instanceidModify an alert rule
RemoveAlarmRuleacs:drds:$regionid:$accountid:instance/$instanceidDelete an alert rule
DescribeAlarmHistoryacs:drds:$regionid:$accountid:instance/$instanceidQuery alert history

Regions that support RAM

RAM authorization is supported in the following regions. Use the Region ID value as $regionId in your authorization rules.

Region IDRegion name
cn-hangzhouChina (Hangzhou)
cn-shenzhenChina (Shenzhen)
cn-shanghaiChina (Shanghai)
cn-qingdaoChina (Qingdao)
cn-beijingChina (Beijing)