更新时间:2025-09-26 GMT+08:00
分享

客户运营能力

云服务在IAM预置了常用授权项,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。

除IAM服务外,Organizations服务中的服务控制策略(Service Control Policies,以下简称SCP)也可以使用这些授权项元素设置访问控制策略。

SCP不直接进行授权,只划定权限边界。将SCP绑定到组织单元或者成员帐号时,并没有直接对组织单元或成员帐号授予操作权限,而是规定了成员帐号或组织单元包含的成员帐号的授权范围。IAM策略授予权限的有效性受SCP限制,只有在SCP允许范围内的权限才能生效。

IAM服务与Organizations服务在使用这些元素进行访问控制时,存在着一些区别,详情请参见:IAM服务与Organizations服务权限访问控制的区别

本章节介绍IAM服务基于身份策略授权场景中自定义策略和组织服务中SCP使用的元素,这些元素包含了操作(Action)、资源(Resource)和条件(Condition)

操作(Action)

操作(Action)即为身份策略中支持的授权项。

  • “访问级别”列描述如何对操作进行分类(list、read和write等)。此分类可帮助您了解在策略中相应操作对应的访问级别。
  • “资源类型”列指每个操作是否支持资源级权限。
    • 资源类型支持通配符号*表示所有。如果此列没有值(-),则必须在策略语句的Resource元素中指定所有资源类型(“*”)。
    • 如果该列包含资源类型,则必须在具有该操作的语句中指定该资源的URN。
    • 资源类型列中必需资源在表中用星号(*)标识,表示使用此操作必须指定该资源类型。

    关于BSS 定义的资源类型的详细信息请参见资源类型(Resource)

  • “条件键”列包括了可以在策略语句的Condition元素中支持指定的键值。
    • 如果该授权项资源类型列存在值,则表示条件键仅对列举的资源类型生效。
    • 如果该授权项资源类型列没有值(-),则表示条件键对整个授权项生效。
    • 如果此列条件键没有值(-),表示此操作不支持指定条件键。

    关于BSS 定义的条件键的详细信息请参见条件(Condition)

  • 别名”列包括了可以在身份策略中配置的策略授权项。通过这些授权项,可以控制支持策略授权的API访问。详细信息请参见身份策略兼容性说明

您可以在身份策略语句的Action元素中指定以下API的相关操作。

billing:contract:viewDiscount 授权项仅影响响应中的折扣信息返回。即使没有该权限,接口仍可正常调用,但响应中将不返回折扣信息。

表1 BSS 支持的授权项

授权项

描述

访问级别

资源类型(*为必须)

条件键

别名

billing:contract:viewDiscount

授予查看商务折扣的权限

read

-

-

  

billing:balance:view

授予查看收支明细,付款历史记录,消费配额,调账记录,欠费查询的权限

list

-

-

  

billing:coupon:view

授予查看优惠券、储值卡、激活代金券的权限

read

-

-

  

billing:order:view

授予查看订单信息、查看按需套餐包的权限

list

-

-

  

billing:order:pay

授予支付订单的权限

write

-

-

  

billing:subscription:renew

授予续费、设置自动续费、设置到期策略、按需转包年/包月的权限

write

        

billing:subscription:unsubscribe

授予查看可退订资源,退订资源,取消发货,硬件退换货的权限

write

-

-

  

billing:resourcePackages:view

授予查看资源包,剩余量汇总,使用明细查询/导出的权限

list

-

-

  

billing:billDetail:view

授予查看账单明细的权限

read

-

-

  

billing:bill:view

授予查看账单、本月消费、近7天扣费资源,消费走势的权限

list

-

-

  

costCenter:costAnalysis:listCosts

授予查看成本分析的权限

read

-

-

  

Billing::activeEPFinance

授予开通企业项目功能的权限

write

-

-

  

businessUnitCenter:businessUnit:view

授予查看组织与账号的权限

read

-

-

  

businessUnitCenter:businessUnitFinance:view

授予查看企业组织财务信息的权限

read

-

-

  

businessUnitCenter:businessUnit:update

授予修改企业组织与子账号的权限

write

-

-

  

businessUnitCenter:businessUnitFinance:update

授予修改企业组织财务信息的权限

write

-

-

  

Billing::updateEPFundQuota

授予开通企业项目功能的权限

write

-

-

  

Billing::viewEPFundQuota

授予查询企业项目资金配额的权限

read

-

-

  

Billing::activeEPFundQuota

授予开通/关闭企业项目资金配额功能的权限

write

-

-

  

BSS的API通常对应着一个或多个授权项。表1展示了API与授权项的关系,以及该API需要依赖的授权项。

表2 API与授权项的关系

细粒度鉴权失败情况下,响应字段encoded_authorization_message的值需要调安全令牌服务STS提供的接口解密后才能查看。解密接口的APIE地址:解密鉴权失败的原因

注意:调用者需要有 sts::decodeAuthorizationMessage 的权限才在APIE调用解密接口,否则报错:STS5.1001。

场景

子场景

接口名称

接口URL(API)

对应的授权项

授权项名称

依赖的授权项

管理产品

查询商品价格

查询按需产品价格

POST /v2/bills/ratings/on-demand-resources

billing:contract:viewDiscount

查看折扣、价格信息。

-

查询包年/包月产品价格

POST /v2/bills/ratings/period-resources/subscribe-rate

billing:contract:viewDiscount

查看折扣、价格信息

  

查询待续订包年/包月资源的续订金额

POST /v2/bills/ratings/period-resources/renew-rate

billing:contract:viewDiscount

查看折扣、价格信息。

  

管理账户

管理账户

查询账户余额

GET /v2/accounts/customer-accounts/balances

billing:balance:view

查看账户信息。

  

查询储值卡列表

GET /v2/promotions/benefits/stored-value-cards

billing:coupon:view

查看优惠券、现金券、代金券。

  

查询收支明细

GET /v2/accounts/customer-accounts/account-change-records

billing:balance:view

查看账户信息。

  

管理交易

管理优惠券

查询优惠券列表

GET /v2/promotions/benefits/coupons

billing:coupon:view

查看优惠券、现金券、代金券。

  

管理包年/包月订单

查询订单列表

GET /v2/orders/customer-orders

billing:order:view

查看订单信息。

  

查询订单详情

GET /v2/orders/customer-orders/details/{order_id}

billing:order:view

查看订单信息。

  

支付包年/包月产品订单

POST /v2/orders/customer-orders/pay

billing:order:pay

订单支付。

  

查询订单可用优惠券

GET /v2/orders/customer-orders/order-coupons

billing:order:view

查看订单信息。

  

查询订单可用折扣

GET /v2/orders/customer-orders/order-discounts

billing:contract:viewDiscount

查看折扣、价格信息。

  

支付包年/包月产品订单

POST /v3/orders/customer-orders/pay

billing:order:pay

订单支付。

  

查询退款订单的金额详情

GET /v2/orders/customer-orders/refund-orders

billing:order:view

查看订单信息。

  

管理包年/包月资源

查询客户包年/包月资源列表

POST /v2/orders/suscriptions/resources/query

  • billing:subscription:view
  • billing:order:view(待下线)

查看订单信息。

  

续订包年/包月资源

POST /v2/orders/subscriptions/resources/renew

billing:subscription:renew

下单、取消订单、修改收货地址。

  

退订包年/包月资源

POST /v2/orders/subscriptions/resources/unsubscribe

billing:subscription:unsubscribe

下单、取消订单、修改收货地址。

云服务粒度退订鉴权常见问题.

  

设置包年/包月资源自动续费

POST /v2/orders/subscriptions/resources/autorenew/**

billing:subscription:renew

下单、取消订单、修改收货地址。

  

取消包年/包月资源自动续费

DELETE /v2/orders/subscriptions/resources/autorenew/{resource_id}

billing:subscription:renew

下单、取消订单、修改收货地址。

  

设置或取消包年/包月资源到期转按需

POST /v2/orders/subscriptions/resources/to-on-demand

billing:subscription:renew

下单、取消订单、修改收货地址。

  

设置包年/包月资源自动续费扣款日和续费后资源统一到期日

POST /v2/orders/subscriptions/resources/renew/config

billing:subscription:renew

下单、取消订单、修改收货地址。

  

管理资源包

查询资源包列表

POST /v3/payments/free-resources/query

billing:resourcePackages:view

查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。

  

查询资源包使用明细

GET /v2/bills/customer-bills/free-resources-usage-records

  • billing:resourcePackages:view
  • billing:billDetail:view(待下线)

查看消费明细、资源消费、账单分析、付款历史记录。

  

查询资源包使用量

POST /v2/payments/free-resources/usages/details/query

billing:resourcePackages:view

查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。

  

管理账单

管理账单

查询资源详单

POST /v2/bills/customer-bills/res-records/query

billing:billDetail:view

查看消费明细、资源消费、账单分析、付款历史记录。

  

查询汇总账单

GET /v2/bills/customer-bills/monthly-sum

billing:bill:view

查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。

  

查询资源消费记录

GET /v2/bills/customer-bills/res-fee-records

  • billing:billDetail:view
  • billing:bill:view(待下线)

查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。

  

查询流水账单

GET /v2/bills/customer-bills/fee-records

  • billing:billDetail:view
  • billing:bill:view(待下线)

查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。

  

查询95计费资源用量

查询95计费资源用量明细

GET /v2/bills/customer-bills/resources/usage/details

billing:billDetail:view

查看消费明细、资源消费、账单分析、付款历史记录。

  

查询95计费资源用量汇总

GET /v2/bills/customer-bills/resources/usage/summary

billing:resourcePackages:view

查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。

  

管理成本

管理成本

查询月度成本

GET /v2/costs/cost-analysed-bills/monthly-breakdown

  • costCenter:costDetail:listCostDetails
  • costCenter:costAnalysis:listCosts(待下线)

查看成本分析。

  

查询成本数据

POST /v4/costs/cost-analysed-bills/query

costCenter:costAnalysis:listCosts

查看成本分析。

  

管理企业

管理企业项目

开通客户企业项目权限

POST /v2/enterprises/enterprise-projects/authority

Billing::activeEPFinance

开通企业项目功能。

  

管理企业多账号

查询企业子账号列表

GET /v2/enterprises/multi-accounts/sub-customers

businessUnitCenter:businessUnit:view

企业中心组织与账号查看权限。

  

查询企业组织结构

GET /v2/enterprises/multi-accounts/enterprise-organizations

businessUnitCenter:businessUnit:view

企业中心组织与账号查看权限。

  

查询企业主的可拨款余额

GET /v2/enterprises/multi-accounts/transfer-amount

businessUnitCenter:businessUnitFinance:view

查看企业组织财务信息。

  

查询企业子账号可回收余额

GET /v2/enterprises/multi-accounts/retrieve-amount

businessUnitCenter:businessUnitFinance:view

查看企业组织财务信息。

  

创建企业子账号

POST /v2/enterprises/multi-accounts/sub-customers

businessUnitCenter:businessUnit:view

修改企业组织与子账号

  

企业主账号向企业子账号拨款

POST /v2/enterprises/multi-accounts/transfer-amount

businessUnitCenter:businessUnitFinance:update

修改企业组织财务信息。

  

企业主账号从企业子账号回收余额

POST /v2/enterprises/multi-accounts/retrieve-amount

businessUnitCenter:businessUnitFinance:update

修改企业组织财务信息。

  

查询企业主账号可拨款优惠券列表

GET /v2/enterprises/multi-accounts/transfer-coupons

businessUnitCenter:businessUnitFinance:view

查看企业组织财务信息

  

查询企业子账号可回收优惠券列表

GET /v2/enterprises/multi-accounts/retrieve-coupons

businessUnitCenter:businessUnitFinance:view

查看企业组织财务信息

  

企业主账号向企业子账号拨款优惠券

POST v2/enterprises/multi-accounts/transfer-coupon

businessUnitCenter:businessUnitFinance:update

修改企业组织财务信息

  

企业主账号从企业子账号回收优惠券

POST /v2/enterprises/multi-accounts/retrieve-coupon

businessUnitCenter:businessUnitFinance:update

修改企业组织财务信息

  

资源类型(Resource)

BSS 服务不支持在身份策略中的资源中指定资源进行权限控制。如需允许访问BSS服务,请在策略的Resource元素中使用通配符号*,表示策略将应用到所有资源

条件(Condition)

条件(Condition)是身份策略生效的特定条件,包括条件键运算符

  • 条件键表示身份策略语句的Condition元素中的键值。根据适用范围,分为全局级条件键和服务级条件键。
    • 全局级条件键(前缀为g:)适用于所有操作,在鉴权过程中,云服务不需要提供用户身份信息,系统将自动获取并鉴权。详情请参见:全局条件键
    • 服务级条件键(前缀通常为服务缩写,如BSS:)仅适用于对应服务的操作,详情请参见表3
    • 单值/多值表示API调用时请求中与条件关联的值数。单值条件键在API调用时的请求中最多包含一个值,多值条件键在API调用时请求可以包含多个值。例如:g:SourceVpce是单值条件键,表示仅允许通过某个VPC终端节点发起请求访问某资源,一个请求最多包含一个VPC终端节点ID值。g:TagKeys是多值条件键,表示请求中携带的所有标签的key组成的列表,当用户在调用API请求时传入标签可以传入多个值。
  • 运算符与条件键、条件值一起构成完整的条件判断语句,当请求信息满足该条件时,身份策略才能生效。支持的运算符请参见:运算符

BSS定义了以下可以在身份策略的Condition元素中使用的条件键,您可以使用这些条件键进一步细化身份策略语句应用的条件。

表2 BSS支持的服务级条件键

服务级条件键

类型

单值/多值

说明

billing:cloudServiceType

string

多值

根据请求参数中云服务的类型,过滤访问。常见问题

条件键示例

  • billing:cloudServiceType

    示例:表示仅支持退订hws.service.type.ebs云服务资源订单

    {
    	"Version": "5.0",
    	"Statement": [{
    		"Effect": "Allow",
    		"Action": [
    			"billing:subscription:unsubscribe"
    		],
    		"Condition": {
    			"ForAnyValue:StringEquals": {
    				"billing:cloudServiceType": [
                                     "hws.service.type.ebs"
                                 ]
    			}
    		}
    	}]
    }

相关文档