访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM中使用权限策略描述授权的具体内容。
本文为您介绍API 网关(APIG)为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。API 网关(APIG)的RAM代码(RamCode)为apig,支持的授权粒度为RESOURCE。
权限策略通用结构
权限策略支持JSON格式,其通用结构如下:
{
"Version": "1",
"Statement": [
{
"Effect": "<Effect>",
"Action": "<Action>",
"Resource": "<Resource>",
"Condition": {
"<Condition_operator>": {
"<Condition_key>": [
"<Condition_value>"
]
}
}
}
]
}
- Effect:权限策略效果。取值:Allow(允许)、Deny(拒绝)。
- Action:授予允许或拒绝权限的具体操作。具体信息,请参见操作(Action)。
- Resource:受操作影响的具体对象,您可以使用资源ARN来描述指定资源。具体信息,请参见资源(Resource)。
- Condition:指授权生效的条件。可选字段。具体信息,请参见条件(Condition)。
- Condition_operator:条件运算符,不同类型的条件对应不同的条件运算符。具体信息,请参见权限策略基本元素。
- Condition_key:条件关键字。
- Condition_value:条件关键字对应的值。
操作(Action)
下表是API 网关(APIG)定义的操作,这些操作可以在RAM权限策略语句的Action
元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:- 操作:是指具体的权限点。
- API:是指操作对应的API接口。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。该列不体现适用于任何操作的通用条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | API | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|---|
apig:ListEnvironments | ListEnvironments | none | 全部资源 * | 无 | 无 |
apig:CreateGatewayServiceVersion | CreateGatewayServiceVersion | create | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:DeleteGatewayService | DeleteGatewayService | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:CreateEnvironment | CreateEnvironment | none | 全部资源 * | 无 | 无 |
apig:UpdateGatewayService | UpdateGatewayService | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:DeleteHttpApi | DeleteHttpApi | delete | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:UpdateHttpApi | UpdateHttpApi | update | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:ListHttpApiOperations | ListHttpApiOperations | list | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetGatewayService | GetGatewayService | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:CreateHttpApiOperation | CreateHttpApiOperation | create | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:UpdateGatewayServiceVersion | UpdateGatewayServiceVersion | update | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:OfflineGatewayRoute | OfflineGatewayRoute | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UpdateEnvironment | UpdateEnvironment | none | 全部资源 * | 无 | 无 |
apig:GetGatewayRoute | GetGatewayRoute | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UpdateGatewayRoute | UpdateGatewayRoute | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:GetGateway | GetGateway | get | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:GetEnvironment | GetEnvironment | none | 全部资源 * | 无 | 无 |
apig:UpdateDomain | UpdateDomain | none | Domain acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} | 无 | 无 |
apig:DeleteGateway | DeleteGateway | delete | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:DeleteGatewayRoute | DeleteGatewayRoute | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:ListGatewayRoutes | ListGatewayRoutes | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:PublishHttpApi | PublishHttpApi | none | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetHttpApi | GetHttpApi | get | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetDomain | GetDomain | get | Domain acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} | 无 | 无 |
apig:DeleteEnvironment | DeleteEnvironment | none | 全部资源 * | 无 | 无 |
apig:ListDomains | ListDomains | none | 全部资源 * | 无 | 无 |
apig:PublishGatewayRoute | PublishGatewayRoute | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:CreateHttpApi | CreateHttpApi | create | 全部资源 * | 无 | 无 |
apig:DeleteServiceSource | DeleteServiceSource | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:CreateGatewayService | CreateGatewayService | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UpdateHttpApiOperation | UpdateHttpApiOperation | update | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:DeleteGatewayServiceVersion | DeleteGatewayServiceVersion | delete | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:AddGatewaySecurityGroupRule | AddGatewaySecurityGroupRule | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UpdateServiceSource | UpdateServiceSource | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:ListGateways | ListGateways | list | 全部资源 * | 无 | 无 |
apig:ListGatewayServices | ListGatewayServices | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:DeleteHttpApiOperation | DeleteHttpApiOperation | delete | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:CreateDomain | CreateDomain | create | 全部资源 * | 无 | 无 |
apig:DeleteDomain | DeleteDomain | none | Domain acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} | 无 | 无 |
apig:OfflineHttpApi | OfflineHttpApi | none | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetHttpApiOperation | GetHttpApiOperation | get | HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:ListHttpApis | ListHttpApis | list | 全部资源 * | 无 | 无 |
apig:CreateGatewayRoute | CreateGatewayRoute | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:CreateServiceSource | CreateServiceSource | none | Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
资源(Resource)
下表是API 网关(APIG)定义的资源,这些资源可以在RAM权限策略语句的Resource
元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:{#}
为变量标识,需要您替换为实际值。例如:{#ramcode}
需要您替换为实际的云服务RAM代码。-
*
表示全部。例如:{#resourceType}
为*
时:表示全部资源。{#regionId}
为*
时:表示全部地域。{#accountId}
为*
时:表示全部阿里云账号。
资源类型 | 资源ARN |
---|---|
Environment | acs:apig:{#regionId}:{#accountId}:environment/* |
Gateway | acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} |
HttpApi | acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} |
Gateway | acs:apig:{#regionId}:{#accountId}:gateway/* |
Environment | acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId} |
Service | acs:apig:{#regionId}:{#accountId}:service/{#ServiceId} |
Service | acs:apig:{#regionId}:{#accountId}:service/* |
Domain | acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} |
HttpApi | acs:apig:{#regionId}:{#accountId}:httpapi/* |
Domain | acs:apig:{#regionId}:{#accountId}:domain/* |
Policy | acs:apig:{#regionId}:{#accountId}:policy/{#PolicyId} |
Policy | acs:apig:{#regionId}:{#accountId}:policy/* |
条件(Condition)
API 网关(APIG)未定义产品级别的条件关键字。如需查看适用于所有云产品的通用条件关键字,请参见通用条件关键字。