访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM中使用获取最小权限策略描述授权的具体内容。

本文为您介绍API 网关(CloudAPI)为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。API 网关(CloudAPI)的RAM代码(RamCode)为 apigateway、cloudapi,支持的授权粒度为资源级

权限策略通用结构

权限策略支持JSON格式,其通用结构如下:展开详情

操作(Action)

下表是API 网关(CloudAPI)定义的操作,这些操作可以在RAM权限策略语句的Action元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:展开详情

操作API访问级别资源类型条件关键字关联操作
apigateway:AbolishApi
下线指定运行环境的指定API
Update
ApiGroup
acs:apigateway:{#regionId}:{#accountId}:apigroup/{#GroupId}
apigateway:AcquireGatewayToken
Get
Instance
acs:apigateway:{#regionId}:{#accountId}:instance/{#InstanceId}
apigateway:AddAccessControlListEntry
本功能为API网关专享实例提供实例级别的访问控制能力; 在实例的访问控制策略中添加IP条目
Update
AccessControlList
acs:apigateway:{#regionId}:{#accountId}:accesscontrollist/{#AclId}
apigateway:AddInstanceIntoInstanceCluster
Update
全部资源
*
apigateway:AddIpControlPolicyItem
向某个已存在的IP访问控制增加一条策略
Create
IpControl
acs:apigateway:{#regionId}:{#accountId}:ipcontrol/{#IpControlId}
apigateway:AddTrafficSpecialControl
在指定流控策略下添加用户自定义特殊流控策略
Create
TrafficControl
acs:apigateway:{#regionId}:{#accountId}:trafficcontrol/{#TrafficControlId}
apigateway:ApiDiff
None
全部资源
*
apigateway:AssociateInstanceWithPrivateDNS
关联内网域名解析到专享实例
Update
全部资源
*
apigateway:AttachApiProduct
将API绑定到指定的API产品(如果指定的API产品不存在,将自动创建)
Create
全部资源
*
apigateway:AttachGroupPlugin
分组绑定插件
None
Plugin
acs:apigateway:{#regionId}:{#accountId}:plugin/{#PluginId}
资源(Resource)

下表是API 网关(CloudAPI)定义的资源,这些资源可以在RAM权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。

其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:

  • {#}为变量标识,需要您替换为实际值。例如: {#ramcode} 需要您替换为实际的云服务RAM代码。
  • *表示全部。例如:
    • {#resourceType}/* :表示全部资源。
    • {#regionId}*时:表示全部地域。
    • {#accountId}*时:表示全部阿里云账号。
资源类型资源ARN
AccessControl
  • acs:apigateway:{#regionId}:{#accountId}:accesscontrol/{#AclId}
  • acs:apigateway:{#regionId}:{#accountId}:accesscontrol/*
  • acs:cloudapi:{#regionId}:{#accountId}:accesscontrol/{#AclId}
AccessControlList
  • acs:apigateway:{#regionId}:{#accountId}:accesscontrollist/{#AclId}
  • acs:apigateway:{#regionId}:{#accountId}:accesscontrollist/*
ApiGroup
  • acs:apigateway:{#regionId}:{#accountId}:apigroup/{#GroupId}
  • acs:apigateway:{#regionId}:{#accountId}:apigroup/*
  • acs:apigateway::{#accountId}:apigroup/*
  • acs:apigateway:{#regionId}:{#accountId}:apigroup/{#ResourceId}
  • acs:apigateway:{#Region}:{#accountId}:apigroup/{#SourceGroupId}
  • acs:apigateway:{#regionId}:{#accountId}:apigroup/{#TargetGroupId}
  • acs:apigateway:{#regionId}:{#accountId}:apigroup/{#SourceGroupId}
  • acs:apigateway:{#regionId}:{#accountId}:apiproduct/{#ApiProductId}
App
  • acs:apigateway:{#regionId}:{#accountId}:app/*
  • acs:apigateway:{#regionId}:{#accountId}:app/{#AppId}
  • acs:apigateway:{#regionId}:{#accountId}:app/{#ResourceId}
  • acs:apigateway:{#regionId}:{#accountId}:app/{#AppIds}
Backend
  • acs:apigateway:{#regionId}:{#accountId}:backend/{#BackendId}
  • acs:apigateway:{#regionId}:{#accountId}:backend/*
Dataset
  • acs:apigateway:{#regionId}:{#accountId}:dataset/{#DatasetId}
  • acs:apigateway:{#regionId}:{#accountId}:dataset/*
Instance
  • acs:apigateway:{#regionId}:{#accountId}:instance/*
  • acs:apigateway:{#Region}:{#accountId}:instance/*
  • acs:apigateway:{#regionId}:{#accountId}:instance/{#InstanceId}
IpControl
  • acs:apigateway:{#regionId}:{#accountId}:ipcontrol/{#RuleId}
  • acs:apigateway:{#regionId}:{#accountId}:ipcontrol/{#IpControlId}
  • acs:apigateway:{#regionId}:{#accountId}:ipcontrol/*
LogConfig
  • acs:apigateway:{#regionId}:{#accountId}:logconfig/{#LogType}
  • acs:apigateway:{#regionId}:{#accountId}:logconfig/*
Plugin
  • acs:apigateway:{#regionId}:{#accountId}:plugin/*
  • acs:apigateway:{#regionId}:{#accountId}:plugin/{#PluginId}
条件(Condition)

API 网关(CloudAPI)未定义产品级别的条件关键字。如需查看适用于所有云产品的通用条件关键字,请参见通用条件关键字

相关操作

您可以创建自定义权限策略,并将权限策略授予RAM用户、RAM用户组或RAM角色。具体操作如下: