RAM authorization - Express Connect - Alibaba Cloud Documentation Center

Resource Access Management (RAM) is a service provided by Alibaba Cloud to manage user identities and resource access permissions. You can use RAM to prevent RAM users from sharing the AccessKey pairs of your Alibaba Cloud account. You can also use RAM to grant minimum permissions to RAM users. RAM uses policies to define permissions.

This topic describes the elements, such as Action, Resource, and Condition, which are defined by VPC. You can use the elements to create policies in RAM. The code (RamCode) in RAM that is used to indicate VPC is vpc. You can grant permissions on VPC at the RESOURCE.

General structure of a policy

Policies can be stored as JSON files. The following code provides an example on the general structure of a policy:

{
  "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:

Effect: specifies the authorization effect. Valid values: Allow, Deny.
Action: specifies one or more API operations that are allowed or denied. For more information, see the Action section of this topic.
Resource: specifies one or more resources to which the policy applies. You can use an Alibaba Cloud Resource Name (ARN) to specify a resource. For more information, see the Resource section of this topic.
Condition: specifies one or more conditions that are required for the policy to take effect. This is an optional field. For more information, see the Condition section of this topic.
- Condition_operator: specifies the conditional operators. Different types of conditions support different conditional operators. For more information, see Policy elements.
- Condition_key: specifies the condition keys.
- Condition_value: specifies the condition values.

Action

VPC defines the values that you can use in the Action element of a policy statement. The following table describes the values.

Operation: the value that you can use in the Action element to specify the operation on a resource.
API operation: the API operation that you can call to perform the operation.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition key: the condition keys that are defined by the Alibaba Cloud service. The Condition key column does not list the common condition keys that are defined by Alibaba Cloud. For more information about the common condition keys, see Generic Condition Keyword.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Actions	API operation	Access level	Resource type	Condition key	Associated operation
vpc:ActivateRouterInterface	ActivateRouterInterface	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}	None	None
vpc:AddBgpNetwork	AddBgpNetwork	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:ApplyPhysicalConnectionLOA	ApplyPhysicalConnectionLOA	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:AssociatePhysicalConnectionToVirtualBorderRouter	AssociatePhysicalConnectionToVirtualBorderRouter	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId} VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:AttachVbrToVpconn	AttachVbrToVpconn	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#virtualborderrouterId}	None	None
vpc:CancelPhysicalConnection	CancelPhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:CompletePhysicalConnectionLOA	CompletePhysicalConnectionLOA	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:ConfirmPhysicalConnection	ConfirmPhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionid}:{#accountid}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:ConnectRouterInterface	ConnectRouterInterface	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}	None	None
vpc:CreateBgpGroup	CreateBgpGroup	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:CreateBgpPeer	CreateBgpPeer	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:CreatePhysicalConnection	CreatePhysicalConnection	Write	physicalconnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/*	None	None
vpc:CreatePhysicalConnectionOccupancyOrder	CreatePhysicalConnectionOccupancyOrder	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/*	None	None
vpc:CreatePhysicalConnectionSetupOrder	CreatePhysicalConnectionSetupOrder	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/*	None	None
vpc:CreateRouteEntry	CreateRouteEntry	Write	RouteTable acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}	None	None
vpc:CreateRouterInterface	CreateRouterInterface	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/* VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId} VRouter acs:vpc:{#regionId}:{#accountId}:vrouter/{#VRouterId}	vpc:TargetAccountRDId	None
vpc:CreateVbrHa	CreateVbrHa	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	None	None
vpc:CreateVirtualBorderRouter	CreateVirtualBorderRouter	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId} VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	None	None
vpc:CreateVirtualPhysicalConnection	CreateVirtualPhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#physicalconnectionId}	None	None
vpc:CreateVpconnFromVbr	CreateVpconnFromVbr	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#virtualborderrouterId}	None	None
vpc:DeactivateRouterInterface	DeactivateRouterInterface	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}	None	None
vpc:DeleteBgpGroup	DeleteBgpGroup	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:DeleteBgpNetwork	DeleteBgpNetwork	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:DeleteBgpPeer	DeleteBgpPeer	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:DeletePhysicalConnection	DeletePhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:DeleteRouteEntry	DeleteRouteEntry	Write	RouteTable acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}	None	None
vpc:DeleteRouterInterface	DeleteRouterInterface	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}	None	None
vpc:DeleteVirtualBorderRouter	DeleteVirtualBorderRouter	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:DescribeBgpGroups	DescribeBgpGroups	Read	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	None	None
vpc:DescribeBgpNetworks	DescribeBgpNetworks	Read	virtualborderrouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/* VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:DescribeBgpPeers	DescribeBgpPeers	Read	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	None	None
vpc:DescribePhysicalConnectionLOA	DescribePhysicalConnectionLOA	List	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/*	None	None
vpc:DescribePhysicalConnections	DescribePhysicalConnections	List	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/*	None	None
vpc:DescribeRouteEntryList	DescribeRouteEntryList	List	RouteTable acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}	None	None
vpc:DescribeRouterInterfaceAttribute	DescribeRouterInterfaceAttribute	Read	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/*	None	None
vpc:DescribeRouterInterfaces	DescribeRouterInterfaces	List	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/*	None	None
vpc:DescribeVbrHa	DescribeVbrHa	Read	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	None	None
vpc:DescribeVirtualBorderRouters	DescribeVirtualBorderRouters	List	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	None	None
vpc:DescribeVirtualBorderRoutersForPhysicalConnection	DescribeVirtualBorderRoutersForPhysicalConnection	List	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/*	vpc:PhysicalConnection	None
vpc:EnablePhysicalConnection	EnablePhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:GetPhysicalConnectionServiceStatus	GetPhysicalConnectionServiceStatus	Read	All Resources acs:vpc::{#accountId}:*	None	None
vpc:ListVirtualPhysicalConnections	ListVirtualPhysicalConnections	List	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/* PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#physicalconnectionId}	None	None
vpc:ModifyBgpGroupAttribute	ModifyBgpGroupAttribute	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:ModifyBgpPeerAttribute	ModifyBgpPeerAttribute	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:ModifyPhysicalConnectionAttribute	ModifyPhysicalConnectionAttribute	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:ModifyRouteEntry	ModifyRouteEntry	Write	RouteTable acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}	None	None
vpc:ModifyRouterInterfaceAttribute	ModifyRouterInterfaceAttribute	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}	vpc:TargetAccountRDId	None
vpc:ModifyRouterInterfaceSpec	ModifyRouterInterfaceSpec	Write	RouterInterface acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}	None	None
vpc:ModifyVirtualBorderRouterAttribute	ModifyVirtualBorderRouterAttribute	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:OpenPhysicalConnectionService	OpenPhysicalConnectionService	Read	All Resources acs:vpc::{#accountId}:	None	None
vpc:RecoverPhysicalConnection	RecoverPhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#physicalconnectionId}	None	None
vpc:RecoverVirtualBorderRouter	RecoverVirtualBorderRouter	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:TerminatePhysicalConnection	TerminatePhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	None	None
vpc:TerminateVirtualBorderRouter	TerminateVirtualBorderRouter	Write	VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:UnassociatePhysicalConnectionFromVirtualBorderRouter	UnassociatePhysicalConnectionFromVirtualBorderRouter	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId} VirtualBorderRouter acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:UpdateVirtualBorderBandwidth	UpdateVirtualBorderBandwidth	Write	VirtualBorderRouter acs:vpc:*:{#accountId}:virtualborderrouter/{#VirtualBorderRouterId}	None	None
vpc:UpdateVirtualPhysicalConnection	UpdateVirtualPhysicalConnection	Write	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#physicalconnectionId}	None	None

Resource

VPC defines the values that you can use in the Resource. You can attach the policy to a RAM user or a RAM role so that the RAM user or the RAM role can perform a specific operation on a specific resource. The ARN is the unique identifier of the resource on Alibaba Cloud. Take note of the following items:

{#}indicates a variable. {#} must be replaced with an actual value. For example, {#ramcode} must be replaced with the actual code of an Alibaba Cloud service in RAM.
An asterisk (*) is used as a wildcard. Examples:
- {#resourceType} is set to *, all resources are specified.
- {#regionId} is set to *, all regions are specified.
- {#accountId} is set to *, all Alibaba Cloud accounts are specified.

Resource type	ARN
VPC	acs:{#ramcode}:{#regionId}:{#accountId}:vpc/{#VpcId}
PrefixList	acs:{#ramcode}:{#regionId}:{#accountId}:prefixlist/{#PrefixListId}
RouteTable	acs:{#ramcode}:{#regionId}:{#accountId}:routetable/{#RouteTableId}
DhcpOptionsSet	acs:{#ramcode}:{#regionId}:{#accountId}:dhcpoptionsset/{#DhcpOptionsSetId}
TrafficMirrorFilter	acs:{#ramcode}:{#regionId}:{#accountId}:trafficmirrorfilter/{#TrafficMirrorFilterId}
FlowLogService	acs:{#ramcode}:{#regionId}:{#accountId}:flowlogservice/{#FlowLogServiceId}
TrafficMirrorSession	acs:{#ramcode}:{#regionId}:{#accountId}:trafficmirrorsession/{#TrafficMirrorSessionId}
Ipv6Gateway	acs:{#ramcode}:{#regionId}:{#accountId}:ipv6gateway/{#Ipv6GatewayId}
VSwitch	acs:{#ramcode}:{#regionId}:{#accountId}:vswitch/{#VSwitchId}
NetworkAcl	acs:{#ramcode}:{#regionId}:{#accountId}:networkacl/{#NetworkAclId}
GlobalAccelerationInstance	acs:{#ramcode}:{#regionId}:{#accountId}:globalaccelerationinstance/{#GlobalAccelerationInstanceId}
Ipv6EgressRule	acs:{#ramcode}:{#regionId}:{#accountId}:ipv6egressrule/{#Ipv6GatewayId}/{#Ipv6EgressRuleId}
PublicIpAddressPool	acs:{#ramcode}:{#regionId}:{#accountId}:publicipaddresspool/{#PublicIpAddressPoolId}
GatewayEndpoint	acs:{#ramcode}:{#regionId}:{#accountId}:gatewayendpoint/{#GatewayEndpointId}
VSwitchCidrReservation	acs:{#ramcode}:{#regionId}:{#accountId}:vswitchcidrreservation/{#VSwitchId}/{#VSwitchCidrReservationId}
VRouter	acs:{#ramcode}:{#regionId}:{#accountId}:vrouter/{#VRouterId}
Ipv6InternetBandwidth	acs:{#ramcode}:{#regionId}:{#accountId}:ipv6internetbandwidth/{#Ipv6InternetBandwidthId}
Ipv4Gateway	acs:{#ramcode}:{#regionId}:{#accountId}:ipv4gateway/{#Ipv4GatewayId}
HaVip	acs:{#ramcode}:{#regionId}:{#accountId}:havip/{#HaVipId}
TrafficMirrorService	acs:{#ramcode}:*:{#accountId}:trafficmirrorservice
FlowLog	acs:{#ramcode}:{#regionId}:{#accountId}:flowlog/{#FlowLogId}
RouteEntry	acs:{#ramcode}:{#regionId}:{#accountId}:routeentry/{#RouteEntryId}
GrantRuleToCen	acs:{#ramcode}:{#regionId}:{#accountId}:grantruletocen/{#InstanceId}/{#CenId}

Condition

VPC defines the values that you can use in the Condition element of a policy statement. The following table describes the values. The following table describes the service-specific condition keys. The common condition keys that are defined by Alibaba Cloud also apply to VPC. For more information about the common condition keys, see Generic Condition Keyword.

The data type determines the conditional operators that you can use to compare the value in a request with the value in a policy statement. You must use conditional operators that are supported by the data type. Otherwise, you cannot compare the value in the request with the value in the policy statement. In this case, the authorization is invalid. For more information about the conditional operators that are supported by each data type, see Policy elements.

Condition key	Description	Data type
vpc:PhysicalConnection	Physical connection	String
vpc:VBR	VBR	String
vpc:VPC	VPC	String
vpc:VRouter	VRouter	String
vpc:tag	Tag	String
vpc:TargetAccountRDId	Target account RDId	String

What to do next

You can create a custom policy and attach the policy to a RAM user, RAM user group, or RAM role. For more information, see the following topics: