Updated on 2024-07-31 GMT+08:00

API Access Permission (Customer)

A customer needs to obtain permissions before accessing APIs. Customers' API access permissions can be granted in IAM. Supported actions of APIs are listed in the following table. The API cannot be accessed if one of its actions is not supported.

  • For APIs not listed in the table, fine-grained permission verification is not required and all customer accounts can access them.
  • Authentication of system-defined roles is not supported, but policy authentication is. For details about the configuration guide, see Creating a User Group and Assigning Permissions.

Scenario

Sub-Scenario

API Description

URL

Permission Code

Supported Action

Managing products

Querying product price

Querying pay-per-use product price

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

bss:discount:view

View discount and price information.

Querying the price of a yearly/monthly product

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

bss:discount:view

View discount and price information.

Querying the renewal price of a yearly/monthly resource

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

bss:discount:view

View discount and price information.

Managing accounts

Managing accounts

Querying account balance

GET/v2/accounts/customer-accounts/balances

bss:balance:view

View account information.

Managing transactions

Managing coupons

Querying coupons

GET /v2/promotions/benefits/coupons

bss:coupon:view

View discount, cash, and flexi-purchase coupons.

Managing yearly/monthly orders

Querying order lists

GET /v2/orders/customer-orders

bss:order:view

View order information.

Querying order details

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

bss:order:view

View order information.

Canceling orders in the pending payment status

PUT /v2/orders/customer-orders/cancel

bss:order:update

Place orders, cancel orders, and modify recipient information.

Paying a yearly/monthly order

POST/v2/orders/customer-orders/pay

bss:order:pay

Pay orders.

Querying supported discounts of an order

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

bss:discount:view

View discount and price information.

Paying a yearly/monthly order

POST /v3/orders/customer-orders/pay

bss:order:pay

Pay orders.

Querying financial information of an order unsubscribed from

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

bss:order:view

View order information.

Managing yearly/monthly resources

Querying yearly/monthly resource list

POST /v2/orders/suscriptions/resources/query

bss:order:view

View order information.

Renewing subscription to yearly/monthly resources

POST /v2/orders/subscriptions/resources/renew

bss:renewal:update

Place orders, cancel orders, and modify recipient information.

Unsubscribing from yearly/monthly resources

POST /v2/orders/subscriptions/resources/unsubscribe

bss:order:update

Place orders, cancel orders, and modify recipient information.

Enabling automatic renewal for yearly/monthly resources

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

bss:renewal:update

Place orders, cancel orders, and modify recipient information.

Disabling automatic renewal for yearly/monthly resources

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

bss:renewal:update

Place orders, cancel orders, and modify recipient information.

Enabling/Canceling the change from yearly/monthly to pay-per-use upon expiration

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

bss:renewal:update

Place orders, cancel orders, and modify recipient information.

Managing resource packages

Querying the resource packages (V3)

POST/v3/payments/free-resources/query

bss:bill:view

View bills, monthly costs, usage details, cost management, expenditures and revenues, and cost trends.

Querying resource package usage details

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

bss:billDetail:view

View expenditure details, resource expenditures, bill analysis, and historical payments.

Querying the usage of a resource package

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

bss:bill:view

View bills, monthly costs, usage details, cost management, expenditures and revenues, and cost trends.

Managing bills

Managing bills

Viewing bill details

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

bss:billDetail:view

View expenditure details, resource expenditures, bill analysis, and historical payments.

Querying bill summary

GET /v1.0/{domain_id}/customer/account-mgr/bill/monthly-sum

bss:bill:view

View bills, monthly costs, usage details, cost management, expenditures and revenues, and cost trends.

Querying expenditure records

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

bss:bill:view

View bills, monthly costs, usage details, cost management, expenditures and revenues, and cost trends.

Managing costs

Managing costs

Querying cost data

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

bss:costanalysis:view

View cost analysis.

Managing the enterprise

Managing enterprise projects

Enabling the enterprise project management service

POST /v2/enterprises/enterprise-projects/authority

bss:enterpriseProjectFunction:update

Enable the enterprise project management service

Managing invoices

Managing invoices

Querying invoice lists

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

bss:invoice:update

Request invoices and view invoice information.