用途:查询阿里云当前账号下的实例级账单,适用于“查询实例账单”“查看账单详情”“了解消费情况”等场景,通过 Python SDK alibabacloud_bssopenapi20171214 调用 BSS OpenAPI 的 DescribeInstanceBill 接口。
主要能力:支持按账期(BillingCycle,格式 YYYY-MM,仅最近 18 个月)查询;可选筛选条件包括 ProductCode(如 rds、ecs)、ProductType、SubscriptionType(Subscription 预付费 / PayAsYouGo 后付费)、IsBillingItem、Granularity(MONTHLY/DAILY,DAILY 需指定 BillingDate)、IsHideZeroCharge、BillOwnerId。分页采用 NextToken 方式,MaxResults 最大 300。
使用方式:先确认 AK/SK 已配置,可从当前工作目录 .env 读取 ALIBABA_CLOUD_ACCESS_KEY_ID 与 ALIBABA_CLOUD_ACCESS_KEY_SECRET,或通过环境变量 export 设置;未通过凭证检查不应继续查询。安装依赖:pip install alibabacloud_bssopenapi20171214 alibabacloud_credentials alibabacloud_tea_openapi alibabacloud_tea_util python-dotenv。随后创建 BssOpenApi20171214Client(endpoint 为 business.aliyuncs.com),构建 DescribeInstanceBillRequest 并调用 describe_instance_bill_with_options。必须实现分页循环:首次 next_token=None,后续使用响应中的 next_token,直到其为空或不存在。reference/ 目录为 Agent 参考样例,不是可直接运行脚本,应参考其结构与调用方式生成实现。
适用场景:按月或按天查询全部账单、指定产品账单、后付费产品账单等。
限制:BillingCycle 必填且仅支持最近 18 个月;单次调用最多返回 300 条,必须分页;401/403、InvalidAccessKeyId、SignatureDoesNotMatch 等错误需按提示排查,若异常含 Recommend 字段优先按诊断链接处理。其他细节资料未提供。