访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用RAM可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM中使用权限策略描述授权的具体内容。
本文为您介绍API 网关(APIG)为RAM权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。API 网关(APIG)的RAM代码(RamCode)为 apig,支持的授权粒度为资源级。
权限策略通用结构
权限策略支持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 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|
操作 | API | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|---|
apig:AddGatewaySecurityGroupRule | AddGatewaySecurityGroupRule | none | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:ChangeResourceGroup | ChangeResourceGroup | none | *全部资源 * | 无 | 无 |
apig:CreateDomain | CreateDomain | create | *Domain acs:apig:{#regionId}:{#accountId}:domain/* | 无 | 无 |
apig:CreateEnvironment | CreateEnvironment | none | *Environment acs:apig:{#regionId}:{#accountId}:environment/* | 无 | 无 |
apig:CreateHttpApi | CreateHttpApi | create | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/* | 无 | 无 |
apig:CreateHttpApiOperation | CreateHttpApiOperation | create | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:CreateHttpApiRoute | CreateHttpApiRoute | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:CreatePolicy | CreatePolicy | none | *全部资源 * | 无 | 无 |
apig:CreatePolicyAttachment | CreatePolicyAttachment | create | *全部资源 * | 无 | 无 |
apig:CreateService | CreateService | none | *Service acs:apig:{#regionId}:{#accountId}:service/* | 无 | 无 |
apig:DeleteDomain | DeleteDomain | none | *Domain acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} | 无 | 无 |
apig:DeleteEnvironment | DeleteEnvironment | none | *Environment acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId} | 无 | 无 |
apig:DeleteGateway | DeleteGateway | delete | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:DeleteGatewaySecurityGroupRule | DeleteGatewaySecurityGroupRule | none | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:DeleteHttpApi | DeleteHttpApi | delete | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:DeleteHttpApiOperation | DeleteHttpApiOperation | delete | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:DeleteHttpApiRoute | DeleteHttpApiRoute | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:DeletePolicy | DeletePolicy | delete | *全部资源 * | 无 | 无 |
apig:DeletePolicyAttachment | DeletePolicyAttachment | delete | *全部资源 * | 无 | 无 |
apig:DeployHttpApi | DeployHttpApi | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:ExportHttpApi | ExportHttpApi | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetDashboard | GetDashboard | get | *全部资源 * | 无 | 无 |
apig:GetDomain | GetDomain | get | *Domain acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} | 无 | 无 |
apig:GetEnvironment | GetEnvironment | none | *Environment acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId} | 无 | 无 |
apig:GetGateway | GetGateway | get | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:GetHttpApi | GetHttpApi | get | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetHttpApiOperation | GetHttpApiOperation | get | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetHttpApiRoute | GetHttpApiRoute | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:GetPolicy | GetPolicy | get | *Policy acs:apig:{#regionId}:{#accountId}:policy/{#PolicyId} | 无 | 无 |
apig:GetPolicyAttachment | GetPolicyAttachment | get | *全部资源 * | 无 | 无 |
apig:GetResourceOverview | GetResourceOverview | get | *全部资源 * | 无 | 无 |
apig:GetService | GetService | none | *Service acs:apig:{#regionId}:{#accountId}:service/{#ServiceId} | 无 | 无 |
apig:GetTraceConfig | GetTraceConfig | get | *全部资源 * | 无 | 无 |
apig:ImportHttpApi | ImportHttpApi | none | *全部资源 * | 无 | 无 |
apig:ListDomains | ListDomains | none | *Domain acs:apig:{#regionId}:{#accountId}:domain/* | 无 | 无 |
apig:ListEnvironments | ListEnvironments | list | *Environment acs:apig:{#regionId}:{#accountId}:environment/* | 无 | 无 |
apig:ListGateways | ListGateways | list | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/* | 无 | 无 |
apig:ListHttpApiOperations | ListHttpApiOperations | list | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:ListHttpApiRoutes | ListHttpApiRoutes | list | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:ListHttpApis | ListHttpApis | list | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/* | 无 | 无 |
apig:ListPolicyClasses | ListPolicyClasses | none | *全部资源 * | 无 | 无 |
apig:ListServices | ListServices | none | *Service acs:apig:{#regionId}:{#accountId}:service/* | 无 | 无 |
apig:ListSslCerts | ListSslCerts | none | *全部资源 * | 无 | 无 |
apig:ListZones | ListZones | none | *全部资源 * | 无 | 无 |
apig:RestartGateway | RestartGateway | none | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UndeployHttpApi | UndeployHttpApi | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:UpdateDomain | UpdateDomain | none | *Domain acs:apig:{#regionId}:{#accountId}:domain/{#DomainId} | 无 | 无 |
apig:UpdateEnvironment | UpdateEnvironment | none | *Environment acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId} | 无 | 无 |
apig:UpdateGatewayFeature | UpdateGatewayFeature | none | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UpdateGatewayName | UpdateGatewayName | update | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
apig:UpdateHttpApi | UpdateHttpApi | update | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:UpdateHttpApiOperation | UpdateHttpApiOperation | update | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:UpdateHttpApiRoute | UpdateHttpApiRoute | none | *HttpApi acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId} | 无 | 无 |
apig:UpdatePolicy | UpdatePolicy | update | *全部资源 * | 无 | 无 |
apig:UpgradeGateway | UpgradeGateway | none | *Gateway acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId} | 无 | 无 |
资源(Resource)
下表是API 网关(APIG)定义的资源,这些资源可以在RAM权限策略语句的Resource
元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:{#}
为变量标识,需要您替换为实际值。例如:{#ramcode}
需要您替换为实际的云服务RAM代码。-
*
表示全部。例如:{#resourceType}
为*
时:表示全部资源。{#regionId}
为*
时:表示全部地域。{#accountId}
为*
时:表示全部阿里云账号。
资源类型 | 资源ARN |
---|
资源类型 | 资源ARN |
---|---|
ConsumerAuthorizationRule |
|
Domain |
|
Environment |
|
Gateway |
|
HttpApi |
|
Policy |
|
Service |
|
Source |
|
条件(Condition)
API 网关(APIG)未定义产品级别的条件关键字。如需查看适用于所有云产品的通用条件关键字,请参见通用条件关键字。