tencent cloud


Authorization Policy Syntax

Last updated: 2023-12-21 19:21:50

    Policy Syntax

    CAM policy:
    "condition": {"key":{"value"}}
    version: Required. It must be "2.0".
    statement: Detailed information of one or more permissions. Each permission is composed of a set of elements including effect, action, resource, and condition. A policy has only one statement element.
    action: Required. It describes the operations to be allowed or denied, which can be APIs (described with the "name" prefix) or a feature set (a set of specific APIs described with the "permid" prefix).
    resource: Required. It describes the specific data to be authorized in a six-segment format. Detailed resource definitions vary by product.
    condition: Optional. It describes the conditions for the policy to take effect. A condition consists of an operator, operation key, and operation value. A condition value may contain information such as a time and IP address. Some services allow you to specify other information in conditions.
    effect: Required. It describes the result returned by the statement, that is, whether the permission is allowed ("allow") or denied ("deny").

    CBS Operations

    In a CAM policy statement, you can specify any API operation from any service that supports CAM. For CBS, use the APIs prefixed with name/cvm:, for example, name/cvm:CreateDisks or name/cvm:DescribeDisks. To specify multiple operations in a single statement, separate them with commas, as shown below.
    You can also use a wildcard to specify multiple operations. For example, you can specify all operations whose names begin with "Describe", as shown below.
    To specify all operations in CVM, use the wildcard * as follows.

    CBS Resource Paths

    Every CAM policy statement contains the resources applicable to the policy itself. The general format of a resource path is shown below.
    project_id: (Optional) Project information, which is only used to enable compatibility with earlier CAM logics.
    service_type: Short name of a Tencent Cloud product, for example, "CVM".
    region: Region information, for example, "bj".
    account: Root account of a resource owner, for example, "uin/164256472".
    resource: Specific resources of a product, for example, "volume/diskid1" or "volume/*".
    You can specify a CBS resource in the statement, for example, "disk-abcdefg", as shown below.
    "resource":[ "qcs::cvm:bj:uin/164256472:volume/disk-abcdefg"]
    You can also use the wildcard * to specify all CBS resources under an account, as shown below.
    "resource":[ "qcs::cvm:bj:uin/164256472:volume/*"]
    To specify all resources, or if an API operation does not support resource-level permission control, you can use the wildcard * in the resource element, as shown below.
    "resource": ["*"]
    To specify multiple resources in one statement, separate them with commas. In the following example, two resources are specified.

    CBS Condition Keys(id:tiaojianmiyue)

    In a policy statement, you can choose to specify the conditions for the policy to take effect. Each condition contains one or more key-value pairs. Condition keys are case-insensitive.
    If you specify multiple conditions or keys in one condition, the condition is evaluated with the "AND" logical operator.
    If you specify a key with multiple values in one condition, the condition is evaluated with the "OR" logical operator. The permission can be granted only after all conditions are met. The following table describes the CBS condition keys that are used for specific services.
    Condition Key
    Reference Type
    Key-Value Pair
    where region indicates a region (for example, "ap-guangzhou").
    where disk_type indicates a disk type (for example, "CLOUD_PREMIUM").
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support