RAM authorization

Updated at:

Resource Access Management (RAM) is a service provided by Alibaba Cloud to manage user identities and resource access permissions. Using RAM helps you avoid sharing your Alibaba Cloud account keys with other users and allows you to grant users the least privilege access. RAM uses permission policies to define authorizations. This topic describes the general structure of a RAM policy, and the policy statement elements (Action, Resource, and Condition) defined by Intelligent Computing LINGJUN for RAM permission policies. The RAM code (RamCode) for Intelligent Computing LINGJUN is eflo , and the supported authorization granularity is RESOURCE .

General structure of a policy

Permission policies support JSON format with the following general structure:

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}        

The following list describes the fields in the policy:

  • Version: Specifies the policy version number. It is fixed at 1.

  • Statement:

    • Effect: Specifies the authorization result. Valid values: Allow and Deny.

    • Action: Specifies one or more operations that are allowed or denied.

    • Resource: Specifies the specific objects affected by the operations. You can use Alibaba Cloud Resource Names (ARNs) to describe specific resources.

    • Condition: Specifies the conditions for the authorization to take effect. This field is optional.

      • Condition operator: Specifies the conditional operators. Different types of conditions support different conditional operators.

      • Condition_key: Specifies the condition keys.

      • Condition_value: Specifies the condition values.

Action

The following table lists the actions defined by Intelligent Computing LINGJUN. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that support authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding ARN in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys that are applicable across all RAM-integrated services. For more information, see Common condition keys.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

API

Access level

Resource type

Condition key

Dependent action

eflo:CreateEr CreateEr create

*Er

acs:eflo:{#regionId}:{#accountId}:Er/*

None None
eflo:SwitchVccConnection SwitchVccConnection update

*Vcc

acs:eflo:{#regionId}:{#accountId}:vcc/{#VccId}

None None
eflo:AttachElasticNetworkInterface AttachElasticNetworkInterface update

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:GetEr GetEr get

*Er

acs:eflo:{#regionId}:{#accountId}:Er/{#ErId}

None None
eflo:AssignPrivateIpAddress AssignPrivateIpAddress create

*PrivateIpAddress

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}

None None
eflo:ListVccs ListVccs get

*Vcc

acs:eflo:{#regionId}:{#accountId}:vcc/*

None None
eflo:GetErAttachment GetErAttachment get

*ErAttachment

acs:eflo:{#regionId}:{#accountId}:Er_Attachment/{#ErAttachmentId}

None None
eflo:GetVpdGrantRule GetVpdGrantRule get

*VpdGrantRule

acs:eflo:{#regionId}:{#accountId}:VpdGrantRule/{#GrantRuleId}

None None
eflo:CreateVpd CreateVpd create

*Vpd

acs:eflo:{#regionId}:{#accountId}:vpd/*

None None
eflo:GetVpd GetVpd get

*Vpd

acs:eflo:{#regionId}:{#accountId}:vpd/{#VpdId}

None None
eflo:ListVccFlowInfos ListVccFlowInfos list

*Vcc

acs:eflo:{#regionId}:{#accountId}:Vcc/{#VccId}

None None
eflo:UpdateEr UpdateEr update

*Er

acs:eflo:{#regionId}:{#accountId}:Er/{#ErId}

None None
eflo:GetSubnet GetSubnet get

*Subnet

acs:eflo:{#regionId}:{#accountId}:subnet/{#SubnetId}

None None
eflo:DeleteVpdGrantRule DeleteVpdGrantRule delete

*VpdGrantRule

acs:eflo:{#regionId}:{#accountId}:VpdGrantRule/{#GrantRuleId}

None None
eflo:CreateVpdGrantRule CreateVpdGrantRule create

*VpdGrantRule

acs:eflo:{#regionId}:{#accountId}:VpdGrantRule/*

None None
eflo:ListVpds ListVpds get

*Vpd

acs:eflo:{#regionId}:{#accountId}:vpd/*

None None
eflo:GetElasticNetworkInterface GetElasticNetworkInterface get

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:DeleteErAttachment DeleteErAttachment delete

*ErAttachment

acs:eflo:{#regionId}:{#accountId}:Er_Attachment/{#ErAttachmentId}

None None
eflo:DetachElasticNetworkInterface DetachElasticNetworkInterface update

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:ListVpdRouteEntries ListVpdRouteEntries list

*VpdRouteEntry

acs:eflo:{#regionId}:{#accountId}:Vpd_Rte/*

None None
eflo:CreateErRouteMap CreateErRouteMap create

*ErRouteMap

acs:eflo:{#regionId}:{#accountId}:Er_RMap/*

None None
eflo:GetVpdRouteEntry GetVpdRouteEntry get

*VpdRouteEntry

acs:eflo:{#regionId}:{#accountId}:Vpd_Rte/{#VpdRouteEntryId}

None None
eflo:UpdateErRouteMap UpdateErRouteMap update

*ErRouteMap

acs:eflo:{#regionId}:{#accountId}:Er_RMap/{#ErRouteMapId}

None None
eflo:CreateVccRouteEntry CreateVccRouteEntry create

*VccRouteEntry

acs:eflo:{#regionId}:{#accountId}:Vcc_Rte/*

None None
eflo:ListSubnets ListSubnets get

*Subnet

acs:eflo:{#regionId}:{#accountId}:Subnet/*

None None
eflo:UpdateVcc UpdateVcc update

*Vcc

acs:eflo:{#regionId}:{#accountId}:vcc/{#VccId}

None None
eflo:ListVccGrantRules ListVccGrantRules list

*VccGrantRule

acs:eflo:{#regionId}:{#accountId}:VccGrantRule/*

None None
eflo:UnAssociateVpdCidrBlock UnAssociateVpdCidrBlock delete

*Vpd

acs:eflo:{#regionId}:{#accountId}:Vpd/{#VpdId}

None None
eflo:QueryInstanceNcd QueryInstanceNcd get

*All Resource

*

None None
eflo:DeleteSubnet DeleteSubnet delete

*Subnet

acs:eflo:{#regionId}:{#accountId}:subnet/{#SubnetId}

None None
eflo:RefundVcc RefundVcc delete

*Vcc

acs:eflo:{#regionId}:{#accountId}:Vcc/{#VccId}

None None
eflo:AssociateVpdCidrBlock AssociateVpdCidrBlock create

*Vpd

acs:eflo:{#regionId}:{#accountId}:Vpd/{#VpdId}

None None
eflo:DeleteVpd DeleteVpd delete

*Vpd

acs:eflo:{#regionId}:{#accountId}:vpd/{#VpdId}

None None
eflo:ListErs ListErs list

*Er

acs:eflo:{#regionId}:{#accountId}:er/*

None None
eflo:UpdateLeniPrivateIpAddress UpdateLeniPrivateIpAddress update

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:Elasticnetworkinterface/{#ElasticNetworkInterfaceId}

None None
eflo:DeleteEr DeleteEr delete

*Er

acs:eflo:{#regionId}:{#accountId}:Er/{#ErId}

None None
eflo:CreateSubnet CreateSubnet create

*Subnet

acs:eflo:{#regionId}:{#accountId}:Subnet/*

None None
eflo:ListLeniPrivateIpAddresses ListLeniPrivateIpAddresses list

*ElasticNetworkInterfacePrivateIp

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/*

None None
eflo:DeleteVccRouteEntry DeleteVccRouteEntry delete

*VccRouteEntry

acs:eflo:{#regionId}:{#accountId}:Vcc_Rte/{#VccRouteEntryId}

None None
eflo:CreateElasticNetworkInterface CreateElasticNetworkInterface create

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/*

None None
eflo:DeleteVccGrantRule DeleteVccGrantRule delete

*VccGrantRule

acs:eflo:{#regionId}:{#accountId}:VccGrantRule/{#GrantRuleId}

None None
eflo:CreateErAttachment CreateErAttachment create

*ErAttachment

acs:eflo:{#regionId}:{#accountId}:Er_Attachment/*

None None
eflo:GetNodeInfoForPod GetNodeInfoForPod get

*All Resource

*

None None
eflo:ListErRouteEntries ListErRouteEntries list

*ErRouteEntry

acs:eflo:{#regionId}:{#accountId}:Er_Rte/*

None None
eflo:UpdateVpd UpdateVpd update

*Vpd

acs:eflo:{#regionId}:{#accountId}:vpd/{#VpdId}

None None
eflo:ListNetworkInterfaces ListNetworkInterfaces list

*NetworkInterface

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/*

None None
eflo:GetNetworkInterface GetNetworkInterface get

*NetworkInterface

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}

None None
eflo:UpdateSubnet UpdateSubnet update

*Subnet

acs:eflo:{#regionId}:{#accountId}:Subnet/{#SubnetId}

None None
eflo:ListErRouteMaps ListErRouteMaps list

*ErRouteMap

acs:eflo:{#regionId}:{#accountId}:Er_RMap/{#ErRouteMapId}

None None
eflo:GetLniPrivateIpAddress GetLniPrivateIpAddress get

*PrivateIpAddress

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}

None None
eflo:ListVccRouteEntries ListVccRouteEntries list

*VccRouteEntry

acs:eflo:{#regionId}:{#accountId}:Vcc_Rte/*

None None
eflo:RetryVcc RetryVcc update

*Vcc

acs:eflo:{#regionId}:{#accountId}:vcc/{#VccId}

None None
eflo:ListElasticNetworkInterfaces ListElasticNetworkInterfaces list

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/*

None None
eflo:CreateVccGrantRule CreateVccGrantRule create

*VccGrantRule

acs:eflo:{#regionId}:{#accountId}:VccGrantRule/*

None None
eflo:UpdateErAttachment UpdateErAttachment update

*ErAttachment

acs:eflo:{#regionId}:{#accountId}:Er_Attachment/{#ErAttachmentId}

None None
eflo:DeleteElasticNetworkInterface DeleteElasticNetworkInterface delete

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:ListInstancesByNcd ListInstancesByNcd get

*All Resource

*

None None
eflo:GetDestinationCidrBlock GetDestinationCidrBlock get

*All Resource

*

None None
eflo:ListNodeInfosForPod ListNodeInfosForPod list

*All Resource

*

None None
eflo:GetLeniPrivateIpAddress GetLeniPrivateIpAddress get

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:GetFabricTopology GetFabricTopology get

*All Resource

*

None None
eflo:ListVpdGrantRules ListVpdGrantRules list

*VpdGrantRule

acs:eflo:{#regionId}:{#accountId}:VpdGrantRule/*

None None
eflo:UnassignLeniPrivateIpAddress UnassignLeniPrivateIpAddress update

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:ListErAttachments ListErAttachments list

*ErAttachment

acs:eflo:{#regionId}:{#accountId}:Er_Attachment/*

None None
eflo:GetVcc GetVcc get

*Vcc

acs:eflo:{#regionId}:{#accountId}:vcc/{#VccId}

None None
eflo:AssignLeniPrivateIpAddress AssignLeniPrivateIpAddress update

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}

None None
eflo:GetErRouteEntry GetErRouteEntry get

*ErRouteEntry

acs:eflo:{#regionId}:{#accountId}:Er_Rte/{#ErRouteEntryId}

None None
eflo:GetVccGrantRule GetVccGrantRule get

*VccGrantRule

acs:eflo:{#regionId}:{#accountId}:VccGrantRule/{#GrantRuleId}

None None
eflo:UpdateElasticNetworkInterface UpdateElasticNetworkInterface update

*ElasticNetworkInterface

acs:eflo:{#regionId}:{#accountId}:Elasticnetworkinterface/{#ElasticNetworkInterfaceId}

None None
eflo:DeleteErRouteMap DeleteErRouteMap delete

*ErRouteMap

acs:eflo:{#regionId}:{#accountId}:Er_RMap/{#ErRouteMapId}

None None
eflo:GetVccRouteEntry GetVccRouteEntry get

*VccRouteEntry

acs:eflo:{#regionId}:{#accountId}:Vcc_Rte/{#VccRouteEntryId}

None None
eflo:ListLniPrivateIpAddress ListLniPrivateIpAddress get

*PrivateIpAddress

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/*

None None
eflo:DescribeSlr DescribeSlr get

*All Resource

*

None None
eflo:GetErRouteMap GetErRouteMap get

*ErRouteMap

acs:eflo:{#regionId}:{#accountId}:Er_RMap/{#ErRouteMapId}

None None
eflo:CreateVcc CreateVcc create

*Vcc

acs:eflo:{#regionId}:{#accountId}:Vcc/*

None None
eflo:UnAssignPrivateIpAddress UnAssignPrivateIpAddress delete

*PrivateIpAddress

acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}

None None
eflo:InitializeVcc InitializeVcc none

*All Resource

*

None

ram:CreateServiceLinkedRole

Resource

The following table lists the resources defined by Intelligent Computing LINGJUN. Specify them in the Resource element of RAM policy statements to grant permissions for specific operations. They are uniquely identified by ARNs. Format: acs:{#ramcode}:{#regionId}:{#accountId}:{#resourceType}:

  • acs: The initialism of Alibaba Cloud service, which indicates the public cloud of Alibaba Cloud.

  • {#ramcode}: The code used in RAM to indicate an Alibaba Cloud service.

  • {#regionId}: The region ID. If the resource covers all regions, set it to an asterisk (*).

  • {#accountId}: The ID of the Alibaba Cloud account. If the resource covers all Alibaba Cloud accounts, set it to an asterisk (*).

  • {#resourceType}: The service-defined resource identifier. It supports a hierarchical structure, which is similar to a file path. If the statement covers global resources, set it to an asterisk (*).

Resource type

ARN

Er
  • acs:eflo:{#regionId}:{#accountId}:Er/*
  • acs:eflo:{#regionId}:{#accountId}:Er/{#ErId}
  • acs:eflo:{#regionId}:{#accountId}:er/*
Vcc
  • acs:eflo:{#regionId}:{#accountId}:vcc/{#VccId}
  • acs:eflo:{#regionId}:{#accountId}:vcc/*
  • acs:eflo:{#regionId}:{#accountId}:Vcc/{#VccId}
  • acs:eflo:{#regionId}:{#accountId}:Vcc/*
ElasticNetworkInterface
  • acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/{#ElasticNetworkInterfaceId}
  • acs:eflo:{#regionId}:{#accountId}:Elasticnetworkinterface/{#ElasticNetworkInterfaceId}
  • acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/*
PrivateIpAddress
  • acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}
  • acs:eflo:{#regionId}:{#accountId}:NetworkInterface/*
ErAttachment
  • acs:eflo:{#regionId}:{#accountId}:Er_Attachment/{#ErAttachmentId}
  • acs:eflo:{#regionId}:{#accountId}:Er_Attachment/*
VpdGrantRule
  • acs:eflo:{#regionId}:{#accountId}:VpdGrantRule/{#GrantRuleId}
  • acs:eflo:{#regionId}:{#accountId}:VpdGrantRule/*
Vpd
  • acs:eflo:{#regionId}:{#accountId}:vpd/*
  • acs:eflo:{#regionId}:{#accountId}:vpd/{#VpdId}
  • acs:eflo:{#regionId}:{#accountId}:Vpd/{#VpdId}
Subnet
  • acs:eflo:{#regionId}:{#accountId}:subnet/{#SubnetId}
  • acs:eflo:{#regionId}:{#accountId}:Subnet/*
  • acs:eflo:{#regionId}:{#accountId}:Subnet/{#SubnetId}
VpdRouteEntry
  • acs:eflo:{#regionId}:{#accountId}:Vpd_Rte/*
  • acs:eflo:{#regionId}:{#accountId}:Vpd_Rte/{#VpdRouteEntryId}
ErRouteMap
  • acs:eflo:{#regionId}:{#accountId}:Er_RMap/*
  • acs:eflo:{#regionId}:{#accountId}:Er_RMap/{#ErRouteMapId}
VccRouteEntry
  • acs:eflo:{#regionId}:{#accountId}:Vcc_Rte/*
  • acs:eflo:{#regionId}:{#accountId}:Vcc_Rte/{#VccRouteEntryId}
VccGrantRule
  • acs:eflo:{#regionId}:{#accountId}:VccGrantRule/*
  • acs:eflo:{#regionId}:{#accountId}:VccGrantRule/{#GrantRuleId}
ElasticNetworkInterfacePrivateIp
  • acs:eflo:{#regionId}:{#accountId}:ElasticNetworkInterface/*
Node
  • acs:eflo:{#regionId}:{#accountId}:node/{#NodeId}
  • acs:eflo:{#regionId}:{#accountId}:node/*
ErRouteEntry
  • acs:eflo:{#regionId}:{#accountId}:Er_Rte/*
  • acs:eflo:{#regionId}:{#accountId}:Er_Rte/{#ErRouteEntryId}
NetworkInterface
  • acs:eflo:{#regionId}:{#accountId}:NetworkInterface/*
  • acs:eflo:{#regionId}:{#accountId}:NetworkInterface/{#NetworkInterfaceId}
  • acs:eflo:{#regionId}:{#accountId}:networkinterface/{#NetworkInterfaceId}

Condition

The following table lists the product-level condition keys defined by Intelligent Computing LINGJUN. You can also use Alibaba Cloud's Common condition keys. Specify these keys in the Condition element of RAM policy statements to define granular authorization rules. In the condition key, specify the condition values in the Condition_value element of the policy.

Each condition key has a specific data type, such as string, number, Boolean, or IP address. The data type determines which conditional operators can be used to compare the request values against policy values. You must specify the conditional operators compatible with the data type of the condition key. Mismatched operators will invalidate the policy. See Condition operator for valid combinations.

Condition key

Description

Data type

eflo:CommandRunAs The operating system user that runs Cloud Assistant commands. String
eflo:ImageSource The source of the image. String
eflo:ImageOwnerId The UID of the image owner. String

How to create custom RAM policies?

You can create custom policies and grant them to RAM users, RAM user groups, or RAM roles. For instructions, see: