全部产品
云市场

详单订阅服务

更新时间:2019-05-08 19:52:35

接口名

SubscribeBillToOSS

描述

阿里云OSS订阅账单详单数据导出。

接口说明

请求参数

名称 类型 是否必填 说明
SubscribeBucket String 指定详单导出的OSS Bucket
BucketOwnerId String 如果是Bid/ReSeller订阅则需要指定Oss Owner对应的UID。
普通用户则无需指定。
SubscribeType.n String 订阅类型。取值类型:
BillingItemDetailForBillingPeriod:计费项结算周期明细
InstanceDetailForBillingPeriod:实例结算周期明细。

备注1:用户一次订阅一个类型的账单文件

备注2:按天生成的账单文件可能存在时延,建议每个月初拉取上个月全量文件

备注3:需要给订阅用户授予对应权限,参见AliyunConsumeDump2OSSRole

文件名:

  • BillingItemDetailForBillingPeriod

    文件名格式:UID_BillingItemDetail_YYYYMMDD,例:169**_BillingItemDetail_20190310

    下月初完整文件名格式:UID_BillingItemDetail_YYYYMM,例:169**_BillingItemDetail_201903

  • InstanceDetailForBillingPeriod

    文件名格式:UID_InstanceDetail_YYYYMMDD,例:169**_InstanceDetail_20190310

    下月初完整文件名格式:UID_InstanceDetail_YYYYMM,例:169**_InstanceDetail_201903

返回参数

名称 类型 描述
Success String 是否成功。
Code String 错误码。
Message String 订阅详情。

错误码

错误码 错误信息 HTTP状态码语义
NotApplicable This API is not applicable for caller. 400 该用户没有访问API的权限。
MissingParameter The specified parameter xx is mandatory for this request. 400 指定的xx参数未设置。
InvalidParameter The specified parameter xx is not valid. 400 指定的xx参数不合法。
RepeatSubscribe You have subscribed with xx. 400 已经订阅过,bucket是xx。
NoValidSubscriptionType There is no valid subscription type. 400 订阅类型不合法。
NoBucketOwnerId Should assign oss bucket. 400 Bid/ReSeller未指定bucket ower的uid。
AuthInvalidBucket The bucket xx does not belong to you xx. 400 Bucket校验不通过。
RAMNotGrant You xx have not grant to service account. 400 Uid未赋权。
RAMNotGrant You xx role not exists. 400 角色未创建。
DuplicateSubscription “XXX” type has already be subscribed successfully, please don’t retry. 400 重复订阅。

请求示例

  1. https://business.aliyuncs.com/?Action= SubscribeBillToOSS
  2. &SubscribeType=BillingItemDetailForBillingPeriod
  3. &SubscribeBucket=xxxxxx
  4. &公共参数

返回示例

  1. {
  2. "Message": "Successful!",
  3. "RequestId": "F61FCE4B-9B56-4FD9-A17E-******",
  4. "Success": true,
  5. "Code": "Success"
  6. }

详单订阅格式

详单订阅格式说明