Updated on 2024-07-05 GMT+08:00

Enterprise Router (ER)

The Organizations service provides Service Control Policies (SCPs) to set access control policies.

SCPs do not actually grant any permissions to a principal. They only set the permissions boundary for the principal. When SCPs are attached to a member account or an organizational unit (OU), they do not directly grant permissions to that member account or OU. Instead, the SCPs just determine what permissions are available for that member account or the member accounts under that OU.

This section describes the elements used by Organizations SCPs. The elements include actions, resources, and conditions.

For details about how to use these elements to create a custom SCP, see Creating an SCP.

Actions

Actions are specific operations that are allowed or denied in an SCP.

  • The Access Level column describes how the action is classified (list, read, or write). This classification helps you understand the level of access that an action grants when you use it in an SCP.
  • The Resource Type column indicates whether the action supports resource-level permissions.
    • You can use a wildcard (*) to indicate all resource types. If this column is empty (-), the action does not support resource-level permissions and you must specify all resources ("*") in your policy statements.
    • If this column includes a resource type, you must specify the URN in the Resource element of your statements.
    • Required resources are marked with asterisks (*) in the table. If you specify a resource in a statement using this action, then it must be of this type.

    For details about the resource types defined by Enterprise Router, see Resources.

  • The Condition Key column contains keys that you can specify in the Condition element of an SCP statement.
    • If the Resource Type column has values for an action, the condition key takes effect only for the listed resource types.
    • If the Resource Type column is empty (-) for an action, the condition key takes effect for all resources that action supports.
    • If the Condition Key column is empty (-) for an action, the action does not support any condition keys.

    For details about the condition keys defined by Enterprise Router, see Conditions.

The following table lists the actions that you can define in SCP statements for Enterprise Router.

Table 1 Actions supported by Enterprise Router

Action

Description

Access Level

Resource Type (*: required)

Condition Key

Alias

er:instances:get

Grants permission to query the details of an enterprise router.

read

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

er:instances:create

Grants permission to create an enterprise router.

write

instances *

g:EnterpriseProjectId

-

-

  • g:RequestTag/<tag-key>
  • g:TagKeys

er:instances:list

Grants permission to list the enterprise routers.

list

instances *

-

-

er:instances:update

Grants permission to update an enterprise router.

write

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

er:instances:delete

Grants permission to delete an enterprise router.

write

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

er:instances:createVpcAttachment

Grants permission to create a VPC attachment.

write

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:attachments:create

er:instances:showVpcAttachment

Grants permission to query the details of a VPC attachment.

read

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:attachments:get

er:instances:listVpcAttachments

Grants permission to list the VPC attachments.

list

instances *

-

er:attachments:list

er:instances:updateVpcAttachment

Grants permission to update a VPC attachment.

write

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:attachments:update

er:instances:deleteVpcAttachment

Grants permission to delete a VPC attachment.

write

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:attachments:delete

er:commonAttachments:get

Grants permission to query the details of an attachment.

read

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:attachments:get

er:commonAttachments:list

Grants permission to query the attachment list.

list

attachments *

-

er:attachments:list

er:commonAttachments:update

Grants permission to update an attachment.

write

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:attachments:update

er:routeTables:get

Grants permission to query the details of a route table.

read

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

er:routeTables:create

Grants permission to create a route table.

write

routeTables *

-

-

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

  • g:RequestTag/<tag-key>
  • g:TagKeys

er:routeTables:list

Grants permission to list the route tables.

list

routeTables *

-

-

er:routeTables:update

Grants permission to update a route table.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

er:routeTables:delete

Grants permission to delete a route table.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

er:routeTables:associate

Grants permission to associate an attachment with a route table.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:associations:associate

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routeTables:disassociate

Grants permission to disassociate an attachment from a route table.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:associations:disassociate

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routeTables:listAssociations

Grants permission to list the associations.

list

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:associations:list

er:routeTables:enablePropagation

Grants permission to allow an attachment to propagate routes to the specified propagation route table.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:propagations:enable

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routeTables:disablePropagation

Grants permission to prohibit an attachment from propagating routes to the specified propagation route table.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:propagations:disable

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routeTables:listPropagations

Grants permission to list the propagations.

list

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:propagations:list

er:staticRoutes:list

Grants permission to list the static routes.

list

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routes:list

er:staticRoutes:create

Grants permission to create a static route.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routes:create

attachments

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:effectiveRoutes:list

Grants permission to list the effective routes.

list

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routes:list

er:staticRoutes:delete

Grants permission to delete a static route.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routes:delete

er:staticRoutes:update

Grants permission to update a static route.

write

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routes:update

attachments

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:staticRoutes:get

Grants permission to query a static route.

read

routeTables *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:routes:get

er:tags:singleCreate

Grants permission to create a resource tag.

write

routeTables

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:tags:create

instances

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

attachments

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:tags:delete

Grants permission to delete a resource tag.

write

routeTables

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

instances

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

attachments

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:tags:batchOperation

Grants permission to add tags in batches.

write

routeTables

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:tags:create

instances

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

attachments

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:tags:get

Grants permission to query tags of a specific resource.

read

routeTables

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

instances

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

attachments

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

er:tags:list

Grants permission to list the tags.

list

-

-

-

er:quotas:list

Grants permission to query resource quotas.

list

-

-

-

er:flowLogs:create

Grants permission to create a flow log.

write

instances *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

-

attachments *

  • g:EnterpriseProjectId
  • g:ResourceTag/<tag-key>

flowLogs *

-

er:flowLogs:list

Grants permission to list the flow logs.

list

flowLogs *

-

-

er:flowLogs:get

Grants permission to query the details of a flow log.

read

flowLogs *

-

-

er:flowLogs:update

Grants permission to update a flow log.

write

flowLogs *

-

-

er:flowLogs:delete

Grants permission to delete a flow log.

write

flowLogs *

-

-

er:flowLogs:enable

Grants permission to enable flow logging.

write

flowLogs *

-

-

er:flowLogs:disable

Grants permission to disable flow logging.

write

flowLogs *

-

-

Each API of Enterprise Router usually supports one or more actions. Table 2 lists the supported actions and dependencies.

Table 2 Actions and dependencies supported by Enterprise Router APIs

API

Action

Dependency

POST /v3/{project_id}/enterprise-router/instances

er:instances:create

-

PUT /v3/{project_id}/enterprise-router/instances/{er_id}

er:instances:update

-

GET /v3/{project_id}/enterprise-router/instances/{er_id}

er:instances:get

-

GET /v3/{project_id}/enterprise-router/instances

er:instances:list

-

DELETE /v3/{project_id}/enterprise-router/instances/{er_id}

er:instances:delete

-

POST /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments

er:instances:createVpcAttachment

-

PUT /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments/{vpc_attachment_id}

er:instances:updateVpcAttachment

-

GET /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments/{vpc_attachment_id}

er:instances:showVpcAttachment

-

GET /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments

er:instances:listVpcAttachments

-

DELETE /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments/{vpc_attachment_id}

er:instances:deleteVpcAttachment

-

PUT /v3/{project_id}/enterprise-router/{er_id}/attachments/{attachment_id}

er:commonAttachments:update

-

GET /v3/{project_id}/enterprise-router/{er_id}/attachments/{attachment_id}

er:commonAttachments:get

-

GET /v3/{project_id}/enterprise-router/{er_id}/attachments

er:commonAttachments:list

-

POST /v3/{project_id}/enterprise-router/{er_id}/route-tables

er:routeTables:create

-

PUT /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}

er:routeTables:update

-

GET /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}

er:routeTables:get

-

GET /v3/{project_id}/enterprise-router/{er_id}/route-tables

er:routeTables:list

-

DELETE /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}

er:routeTables:delete

-

POST /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}/associate

er:routeTables:associate

-

GET /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}/associations

er:routeTables:listAssociations

-

POST /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}/disassociate

er:routeTables:disassociate

-

POST /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}/enable-propagations

er:routeTables:enablePropagation

-

GET /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}/propagations

er:routeTables:listPropagations

-

POST /v3/{project_id}/enterprise-router/{er_id}/route-tables/{route_table_id}/disable-propagations

er:routeTables:disablePropagation

-

POST /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes

er:staticRoutes:create

-

PUT /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes/{route_id}

er:staticRoutes:update

-

GET /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes/{route_id}

er:staticRoutes:get

-

GET /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes

er:staticRoutes:list

-

GET /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/routes

er:effectiveRoutes:list

-

DELETE /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes/{route_id}

er:staticRoutes:delete

-

GET /v3/{project_id}/{resource_type}/tags

er:tags:list

-

GET /v3/{project_id}/{resource_type}/{resource_id}/tags

er:tags:get

-

POST /v3/{project_id}/{resource_type}/{resource_id}/tags

er:tags:singleCreate

-

POST /v3/{project_id}/{resource_type}/{resource_id}/tags/action

er:tags:batchOperation

-

DELETE /v3/{project_id}/{resource_type}/{resource_id}/tags/{key}

er:tags:delete

-

GET /v3/{project_id}/enterprise-router/quotas

er:quotas:list

-

POST /v3/{project_id}/enterprise-router/{er_id}/flow-logs

er:flowLogs:create

-

GET /v3/{project_id}/enterprise-router/{er_id}/flow-logs

er:flowLogs:list

-

GET /v3/{project_id}/enterprise-router/{er_id}/flow-logs/{flow_log_id}

er:flowLogs:get

-

PUT /v3/{project_id}/enterprise-router/{er_id}/flow-logs/{flow_log_id}

er:flowLogs:update

-

DELETE /v3/{project_id}/enterprise-router/{er_id}/flow-logs/{flow_log_id}

er:flowLogs:delete

-

POST /v3/{project_id}/enterprise-router/{er_id}/flow-logs/{flow_log_id}/enable

er:flowLogs:enable

-

POST /v3/{project_id}/enterprise-router/{er_id}/flow-logs/{flow_log_id}/disable

er:flowLogs:disable

-

Resources

A resource type indicates the resources that an SCP policy applies to. If you specify a resource type for any action in Table 3, the resource URN must be specified in the SCP statements using that action, and the SCP applies only to resources of this type. If no resource type is specified, the Resource element is marked with an asterisk (*) and the SCP applies to all resources. You can also set condition keys in an SCP policy to define resource types.

The following table lists the resource types that you can define in SCP statements for Enterprise Router.

Table 3 Resource types supported by Enterprise Router

Resource Type

URN

instances

er:<region>:<account-id>:instances:<instance-id>

routeTables

er:<region>:<account-id>:routeTables:<route-table-id>

flowLogs

er:<region>:<account-id>:flowFlogs:<flow-log-id>

attachments

er:<region>:<account-id>:attachments:<attachment-id>

Conditions

Enterprise Router does not support service-specific condition keys in an SCP.

Enterprise Router can only use global condition keys applicable to all services. For details, see Global Condition Keys