授权信息

更新时间:2025-03-24 05:59:25
访问控制(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:AddGatewaySecurityGroupRuleAddGatewaySecurityGroupRulenone
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:ChangeResourceGroupChangeResourceGroupnone
*全部资源
*
apig:CreateDomainCreateDomaincreate
*Domain
acs:apig:{#regionId}:{#accountId}:domain/*
apig:CreateEnvironmentCreateEnvironmentnone
*Environment
acs:apig:{#regionId}:{#accountId}:environment/*
apig:CreateHttpApiCreateHttpApicreate
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/*
apig:CreateHttpApiOperationCreateHttpApiOperationcreate
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:CreateHttpApiRouteCreateHttpApiRoutenone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:CreatePolicyCreatePolicynone
*全部资源
*
apig:CreatePolicyAttachmentCreatePolicyAttachmentcreate
*全部资源
*
apig:CreateServiceCreateServicenone
*Service
acs:apig:{#regionId}:{#accountId}:service/*
apig:DeleteDomainDeleteDomainnone
*Domain
acs:apig:{#regionId}:{#accountId}:domain/{#DomainId}
apig:DeleteEnvironmentDeleteEnvironmentnone
*Environment
acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId}
apig:DeleteGatewayDeleteGatewaydelete
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:DeleteGatewaySecurityGroupRuleDeleteGatewaySecurityGroupRulenone
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:DeleteHttpApiDeleteHttpApidelete
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:DeleteHttpApiOperationDeleteHttpApiOperationdelete
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:DeleteHttpApiRouteDeleteHttpApiRoutenone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:DeletePolicyDeletePolicydelete
*全部资源
*
apig:DeletePolicyAttachmentDeletePolicyAttachmentdelete
*全部资源
*
apig:DeployHttpApiDeployHttpApinone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:ExportHttpApiExportHttpApinone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:GetDashboardGetDashboardget
*全部资源
*
apig:GetDomainGetDomainget
*Domain
acs:apig:{#regionId}:{#accountId}:domain/{#DomainId}
apig:GetEnvironmentGetEnvironmentnone
*Environment
acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId}
apig:GetGatewayGetGatewayget
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:GetHttpApiGetHttpApiget
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:GetHttpApiOperationGetHttpApiOperationget
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:GetHttpApiRouteGetHttpApiRoutenone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:GetPolicyGetPolicyget
*Policy
acs:apig:{#regionId}:{#accountId}:policy/{#PolicyId}
apig:GetPolicyAttachmentGetPolicyAttachmentget
*全部资源
*
apig:GetResourceOverviewGetResourceOverviewget
*全部资源
*
apig:GetServiceGetServicenone
*Service
acs:apig:{#regionId}:{#accountId}:service/{#ServiceId}
apig:GetTraceConfigGetTraceConfigget
*全部资源
*
apig:ImportHttpApiImportHttpApinone
*全部资源
*
apig:ListDomainsListDomainsnone
*Domain
acs:apig:{#regionId}:{#accountId}:domain/*
apig:ListEnvironmentsListEnvironmentslist
*Environment
acs:apig:{#regionId}:{#accountId}:environment/*
apig:ListGatewaysListGatewayslist
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/*
apig:ListHttpApiOperationsListHttpApiOperationslist
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:ListHttpApiRoutesListHttpApiRouteslist
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:ListHttpApisListHttpApislist
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/*
apig:ListPolicyClassesListPolicyClassesnone
*全部资源
*
apig:ListServicesListServicesnone
*Service
acs:apig:{#regionId}:{#accountId}:service/*
apig:ListSslCertsListSslCertsnone
*全部资源
*
apig:ListZonesListZonesnone
*全部资源
*
apig:RestartGatewayRestartGatewaynone
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:UndeployHttpApiUndeployHttpApinone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:UpdateDomainUpdateDomainnone
*Domain
acs:apig:{#regionId}:{#accountId}:domain/{#DomainId}
apig:UpdateEnvironmentUpdateEnvironmentnone
*Environment
acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId}
apig:UpdateGatewayFeatureUpdateGatewayFeaturenone
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:UpdateGatewayNameUpdateGatewayNameupdate
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
apig:UpdateHttpApiUpdateHttpApiupdate
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:UpdateHttpApiOperationUpdateHttpApiOperationupdate
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:UpdateHttpApiRouteUpdateHttpApiRoutenone
*HttpApi
acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
apig:UpdatePolicyUpdatePolicyupdate
*全部资源
*
apig:UpgradeGatewayUpgradeGatewaynone
*Gateway
acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}

资源(Resource)

下表是API 网关(APIG)定义的资源,这些资源可以在RAM权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源ARN是资源在阿里云上的唯一标识。具体说明如下:
  • {#}为变量标识,需要您替换为实际值。例如:{#ramcode}需要您替换为实际的云服务RAM代码。
  • *表示全部。例如:
    • {#resourceType}*时:表示全部资源。
    • {#regionId}*时:表示全部地域。
    • {#accountId}*时:表示全部阿里云账号。
资源类型资源ARN
资源类型资源ARN
ConsumerAuthorizationRule
  • acs:apig:{#regionId}:{#accountId}:consumerauthorizationrule/*
Domain
  • acs:apig:{#regionId}:{#accountId}:consumer/*
  • acs:apig:{#regionId}:{#accountId}:consumer/{#ConsumerId}
  • acs:apig:{#regionId}:{#accountId}:domain/{#DomainId}
  • acs:apig:{#regionId}:{#accountId}:domain/*
Environment
  • acs:apig:{#regionId}:{#accountId}:environment/*
  • acs:apig:{#regionId}:{#accountId}:environment/{#EnvironmentId}
Gateway
  • acs:apig:{#regionId}:{#accountId}:gateway/{#GatewayId}
  • acs:apig:{#regionId}:{#accountId}:gateway/*
HttpApi
  • acs:apig:{#regionId}:{#accountId}:httpapi/*
  • acs:apig:{#regionId}:{#accountId}:httpapi/{#HttpApiId}
Policy
  • acs:apig:{#regionId}:{#accountId}:policy/{#PolicyId}
  • acs:apig:{#regionId}:{#accountId}:policy/*
Service
  • acs:apig:{#regionId}:{#accountId}:service/{#ServiceId}
  • acs:apig:{#regionId}:{#accountId}:service/*
Source
  • acs:apig:{#regionId}:{#accountId}:source/{#SourceId}
  • acs:apig:{#regionId}:{#accountId}:source/{SourceId]
  • acs:apig:{#regionId}:{#accountId}:source/*

条件(Condition)

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

相关操作

您可以创建自定义权限策略,并将权限策略授予RAM用户、RAM用户组或RAM角色。具体操作如下:
  • 本页导读 (1)
  • 权限策略通用结构
  • 操作(Action)
  • 资源(Resource)
  • 条件(Condition)
  • 相关操作