更新时间:2024-07-08 GMT+08:00

客户运营能力

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

SCP不直接进行授权,只划定权限边界。将SCP绑定到组织单元或者成员账号时,并没有直接对组织单元或成员账号授予操作权限,而是规定了成员账号或组织单元包含的成员账号的授权范围。

本章节介绍组织服务中SCP使用的元素,这些元素包含了操作(Action)、资源(Resource)和条件(Condition)。

如何使用这些元素编辑SCP自定义策略,请参考创建SCP

操作(Action)

操作(Action)即为SCP中支持的授权项。

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

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

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

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

您可以在SCP语句的Action元素中指定以下BSS的相关操作。

表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:invoice:update

授予发票管理,提供索取发票、管理发票抬头和收件地址的权限。

write

-

-

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

表2 API与授权项的关系(当前API均无需要依赖的授权项)

场景

子场景

接口名称

接口URL

授权项

授权项描述

管理产品

查询商品价格

查询按需产品价格

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/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-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: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 /v3/payments/free-resources/query

billing:resourcePackages:view

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

查询资源包使用明细

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

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:bill:view

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

管理成本

管理成本

查询成本数据

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

costCenter:costAnalysis:listCosts

查看成本分析。

管理发票

管理发票

查询发票列表

GET /v1.0/{domain_id}/payments/intl-invoices

billing:invoice:manage

申请发票、查看信息。

资源类型(Resource)

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

条件(Condition)

BSS服务不支持在SCP中的条件键中配置服务级的条件键。BSS可以使用适用于所有服务的全局条件键,请参考全局条件键