Policy Structure

Policy Syntax

CAM policy:

{     
        "version":"2.0", 
        "statement": 
        [ 
           { 
              "effect":"effect", 
              "action":["action"], 
              "resource":["resource"], 
               "condition": {"key":{"value"}} 
           } 
       ] 
} 

• version is required. Currently, only "2.0" is allowed.
• statement describes the details of one or more privileges. This element contains a privilege or privilege set of other elements such as effect, action, resource, and condition. One policy has only one statement.
  • effect describes whether the result produced by the statement is "allowed" (allow) or "denied" (deny). This element is required.
  • action describes the allowed or denied action. An action can be an API (described using the prefix "cdb:"). This element is required.
  • resource describes the details of authorization. A resource is described in a six-piece format. Detailed resource definitions vary by product. For more information on how to specify a resource, see the documentation for the product whose resources you are writing a statement for. This element is required.
  • condition describes the condition for the policy to take effect. A condition consists of operator, action key, and action value. A condition value may contain information such as time and IP address. Some services allow you to specify additional values in a condition. This element is optional.

Database Operations

In a TencentDB policy statement, you can specify any API action from any service that supports TencentDB. APIs prefixed with "cdb:" should be used for TencentDB, such as cdb:CreateDBInstance or cdb:CreateAccounts.

• To specify multiple actions in a single statement, separate them with commas, as shown below:

  "action":["cdb:action1","cdb:action2"]

2. You can also specify multiple actions using a wildcard. For example, you can specify all actions whose name begins with "Describe", as shown below:

   "action":["cdb:Describe*"]

3. If you want to specify all operations in TencentDB, use a wildcard as shown below:

   "action"：["cdb:*"]

TencentDB Resources

Each CAM policy statement has its own resources.
Resources are generally in the following format:

qcs:project_id:service_type:region:account:resource

• project_id describes the project information, which is only used to enable compatibility with legacy CAM logic and can be left empty.
• service_type describes the product abbreviation such as COS.
• region describes the region information, such as ap-guangzhou.
• account is the root account of the resource owner, such as uin/653339763.
• resource describes detailed resource information of each product, such as instanceId/instance_id1 or instanceId/*.

For example:

• You can specify a resource for a specific instance (cdb-k05xdcta) in a statement as shown below:

  "resource":[ "qcs::cdb:ap-guangzhou:uin/653339763:instanceId/cdb-k05xdcta"]

2. You can also use the wildcard "*" to specify it for all instances that belong to a specific account as shown below:

   "resource":[ "qcs::cdb:ap-guangzhou:uin/653339763:instanceId/*"]

3. If you want to specify all resources or if a specific API operation does not support resource-level permission control, you can use the wildcard "*" in the "resource" element as shown below:

   "resource": ["*"]

4. To specify multiple resources in a single command, separate them with commas. Below is an example where two resources are specified:

   "resource":["resource1","resource2"]

The table below describes the resources that can be used by TencentDB and the corresponding resource description methods.
In the table, words prefixed with $ are placeholders.

• “project” is project ID.
• “region” is region.
• “account” is account ID.