授权信息

更新时间:

访问控制(RAM)是阿里云提供的管理用户身份与资源访问权限的服务。使用 RAM 可以让您避免与其他用户共享阿里云账号密钥,并可按需为用户授予最小权限。RAM 中使用权限策略描述授权的具体内容。

本文为您介绍 阿里云交易和账单管理API 为 RAM 权限策略定义的操作(Action)、资源(Resource)和条件(Condition)。 阿里云交易和账单管理API 的 RAM 代码(RamCode)为 bss,bssapi,efc ,支持的授权粒度为 操作级

权限策略通用结构

权限策略支持 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定义的操作,这些操作可以在 RAM 权限策略语句的Action元素中使用,用来授予执行该操作的权限。下面对表中的具体项提供说明:

  • 操作:是指具体的权限点。

  • API:是指操作对应的 API 接口。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。该列不体现适用于任何操作的通用条件关键字

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

API

访问级别

资源类型

条件关键字

关联操作

bss:GetCustomerList GetCustomerList get

*全部资源

*

bss:DescribeInstances QueryResourcePackageInstances get

*全部资源

*

bss:DescribeInstances QueryAvailableInstances get

*全部资源

*

bss:DescribeGaapBill QueryInstanceGaapCost get

*全部资源

*

bss:SavingsPlansAnalysis DescribeSavingsPlansUsageDetail get

*全部资源

*

bss:DescribeProduct QuerySkuPriceList get

*全部资源

*

bss:QueryResellerUserAlarmThreshold QueryResellerUserAlarmThreshold get

*全部资源

*

bss:QueryCustomerInvoiceInfo QueryInvoicingCustomerList get

*全部资源

*

bss:ModifyPrepaidInstanceAutoRenew SetRenewal update

*全部资源

*

bss:QueryCustomerAddress QueryCustomerAddressList get

*全部资源

*

bss:DescribeUserOmsData QueryUserOmsData get

*全部资源

*

bss:CreateResourcePackage RenewResourcePackage update

*全部资源

*

bss:QueryEvaluate QueryEvaluateList get

*全部资源

*

bss:RefundQueryRemainAmount InquiryPriceRefundInstance get

*全部资源

*

bss:DescribeOrderDetail GetOrderDetail get

*全部资源

*

bss:ModifyInstance ModifyInstance update

*全部资源

*

bss:ConvertChargeType ConvertChargeType create

*全部资源

*

bss:DescribeBillList QueryBillOverview get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bss:QueryAccountBill QueryAccountBill get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bss:PayOrder PayOrder create

*全部资源

*

bss:ModifyInstance CreateResourcePackage create

*全部资源

*

bss:DeleteCostUnit DeleteCostUnit delete

*全部资源

*

bss:SavingsPlansAnalysis DescribeSavingsPlansCoverageTotal get

*全部资源

*

bss:ModifyCostUnit ModifyCostUnit update

*全部资源

*

bss:ModifyInstance CreateInstance create

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bss:QueryProductList QueryProductList get

*全部资源

*

bss:CreateCostUnit CreateCostUnit create

*全部资源

*

bss:QueryRiUtilizationDetail QueryRIUtilizationDetail get

*全部资源

*

bss:AllocateCostUnitResource AllocateCostUnitResource

*全部资源

*

bss:GetCustomerAccountInfo GetCustomerAccountInfo get

*全部资源

*

bss:SetSavingPlanUserDeductRule SetSavingPlanUserDeductRule update

*全部资源

*

bss:DescribeAcccount SetCreditLabelAction update

*全部资源

*

bss:DescribePrice GetPayAsYouGoPrice get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bss:SetResellerUserAlarmThreshold SetResellerUserAlarmThreshold update

*全部资源

*

bss:DescribePrice GetSubscriptionPrice get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bss:ModifySubscribeToOSS SubscribeBillToOSS create

*全部资源

*

bss:DescribeBillList QueryBill get

*全部资源

*

bss:ChangeResellerConsumeAmount ChangeResellerConsumeAmount update

*全部资源

*

bss:QueryCostUnitResource QueryCostUnitResource get

*全部资源

*

bss:DescribeBillList QueryInstanceBill get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bss:DescribeAcccount CreateUserQuota create

*全部资源

*

bss:ModifySubscribeToOSS UnsubscribeBillToOSS

*全部资源

*

bss:ModifyInstance RenewInstance create

*全部资源

*

bss:DescribeAcccount ChangeConsumeAmount update

*全部资源

*

bss:DescribeAcccount QueryAvaliableQuota get

*全部资源

*

bss:DescribeSubscribeToOSS QueryBillToOSSSubscription get

*全部资源

*

bss:DescribeAcccount QueryAccountBookList get

*全部资源

*

bss:SetResellerUserQuota SetResellerUserQuota update

*全部资源

*

bss:SavingsPlansAnalysis DescribeSavingsPlansUsageTotal get

*全部资源

*

bss:DescrbePrepaidCards QueryPrepaidCards get

*全部资源

*

bss:DescribeAcccount SetEnduserStatus update

*全部资源

*

bss:DescribeCoupons QueryCashCoupons get

*全部资源

*

bss:DescribeOrderList QueryOrders get

*全部资源

*

bss:QueryResellerAvailableQuota QueryResellerAvailableQuota get

*全部资源

*

bss:RefundBatchRemainRefund RefundInstance update

*全部资源

*

bss:RenewChangeInstance RenewChangeInstance none

*全部资源

*

bss:CancelOrder CancelOrder

*全部资源

*

bss:CreateResourcePackage UpgradeResourcePackage update

*全部资源

*

bss:FrDeductLogQueryRequest QueryDPUtilizationDetail get

*全部资源

*

bss:ModifyPrepaidInstanceAutoRenew SetAllExpirationDay update

*全部资源

*

bss:DescribeProduct QueryCommodityList get

*全部资源

*

bss:ApplyInvoice ApplyInvoice create

*全部资源

*

bss:DescribeAcccount SetUserQuota update

*全部资源

*

bss:DescribeAcccountTran QueryAccountTransactions get

*全部资源

*

bss:DescribeAcccount QueryAccountBalance get

*全部资源

*

bss:DescribeCostBudgetsSummary DescribeCostBudgetsSummary get

*全部资源

*

bss:QueryPriceList QueryPriceList get

*全部资源

*

bss:SetResellerUserStatus SetResellerUserStatus update

*全部资源

*

bss:QueryCostUnit QueryCostUnit get

*全部资源

*

bss:ReleaseInstance ReleaseInstance

*全部资源

*

bss:DescribePrice GetResourcePackagePrice get

*全部资源

*

bss:CreateResellerUserQuota CreateResellerUserQuota create

*全部资源

*

bss:DescribeProduct QueryPriceEntityList get

*全部资源

*

bss:SavingsPlansAnalysis DescribeSavingsPlansCoverageDetail get

*全部资源

*

bss:DescribePricingModule DescribePricingModule get

*全部资源

*

bss:DescribeProduct DescribeResourcePackageProduct get

*全部资源

*

bssapi:QueryRelationList QueryRelationList get

*全部资源

*

bssapi:DescribeCostBill DescribeInstanceAmortizedCostByAmortizationPeriodDate get

*全部资源

*

bssapi:QueryRedeem QueryRedeem get

*全部资源

*

bssapi:DescribeCostBill DescribeProductAmortizedCostByAmortizationPeriod get

*全部资源

*

bssapi:DescribeCostBill DescribeProductAmortizedCostByConsumePeriod get

*全部资源

*

bssapi:TagResources TagResources

*全部资源

*

bssapi:DescribeResourceUsageTotal DescribeResourceUsageTotal get

*全部资源

*

bssapi:DescribeResourceCoverageTotal DescribeResourceCoverageTotal get

*全部资源

*

bssapi:DescribeCostBill DescribeInstanceAmortizedCostByAmortizationPeriod get

*全部资源

*

bssapi:DescribeCostBill DescribeInstanceDeductAmortizedCostByAmortizationPeriod get

*全部资源

*

bssapi:DescribeResourceUsageDetail DescribeResourceUsageDetail get

*全部资源

*

bssapi:DescribeCostBill DescribeInstanceAmortizedCostByConsumePeriod get

*全部资源

*

bssapi:CreateSavingsPlansInstance CreateSavingsPlansInstance create

*全部资源

*

bssapi:QueryPermissionList QueryPermissionList get

*全部资源

*

bssapi:QueryPrice QueryPrice get

*全部资源

*

bssapi:DescribeSplitItemBill DescribeSplitItemBill get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bssapi:QuerySavingsPlansDiscount QuerySavingsPlansDiscount get

*全部资源

*

bssapi:DescribeInstanceBill DescribeInstanceBill get

*全部资源

*

bssapi:ProductCode

bssapi:ProductCode

bssapi:ProductType

bssapi:ProductType

bssapi:QuerySplitItemBill QuerySplitItemBill get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bssapi:QuerySettleBill QuerySettleBill get

*全部资源

*

bssapi:ProductCode

bssapi:ProductType

bssapi:QueryAccountTransactionDetails QueryAccountTransactionDetails get

*全部资源

*

bssapi:QueryInstanceByTag QueryInstanceByTag get

*全部资源

*

bssapi:DescribeResourceCoverageDetail DescribeResourceCoverageDetail get

*全部资源

*

bssapi:UntagResources UntagResources

*全部资源

*

bssapi:QuerySavingsPlansDeductLog QuerySavingsPlansDeductLog get

*全部资源

*

bssapi:QueryFinancialAccountInfo QueryFinancialAccountInfo get

*全部资源

*

bssapi:QuerySavingsPlansInstance QuerySavingsPlansInstance get

*全部资源

*

bssapi:GetRenewPrice GetRenewPrice none

*全部资源

*

资源(Resource)

下表是阿里云交易和账单管理API定义的资源,这些资源可以在 RAM 权限策略语句的Resource元素中使用,用来授予对该资源执行具体操作的权限。 其中,资源 ARN 是资源在阿里云上的唯一标识。具体说明如下:

  • {#}为变量标识,需要您替换为实际值。例如:{#ramcode}需要您替换为实际的云服务RAM代码。

  • *表示全部。例如:

    • {#resourceType}*时:表示全部资源。

    • {#regionId}*时:表示全部地域。

    • {#accountId}*时:表示全部阿里云账号。

资源类型

资源 ARN

条件(Condition)

下表是阿里云交易和账单管理API 定义的产品级条件关键字,这些条件关键字可以在 RAM 权限策略语句的Condition元素中使用,用来描述授予权限的条件。以下仅列举产品级的条件关键字,阿里云定义的通用条件关键字也同样适用阿里云交易和账单管理API

其中,数据类型决定了您可以使用哪些条件运算符将请求中的值与权限策略语句中的值进行比较。您必须使用与数据类型匹配的条件运算符,否则无法匹配策略语句,授权行为无效。数据类型与条件运算符的对应关系,请参见条件操作类型

条件关键字

描述

类型

bssapi:ProductCode 操作资源的产品code,示例:ecs STRING
bssapi:ProductType 操作资源的产品类型,示例:ecs STRING

相关操作

您可以创建自定义权限策略,并将权限策略授予 RAM 用户、RAM 用户组或 RAM 角色。具体操作如下: