A AuthMS API Wiki API Reference iam.tianv.com →

PUT /admin/billing/subscription/{tenant_id}

修改指定租户的订阅配置,支持变更套餐(plan)和自动续费(auto_renew)设置。套餐变更时按比例计算费用。

计费服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
tenant_id path string Yes 租户ID

Request Body

Schema: dto.UpdateSubscriptionRequestDTO

FieldTypeRequiredExampleConstraintsDescription
auto_renew boolean No False
billing_cycle string No yearly
plan string No enterprise

Responses

StatusDescriptionSchema
200订阅更新成功dto.SubscriptionDetailResponse
400请求参数错误object
401未授权object
403无权限object
500服务器内部错误object

Referenced Schemas

dto.SubscriptionDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.SubscriptionResponse No
message string No
timestamp string No

dto.SubscriptionResponse

FieldTypeRequiredExampleConstraintsDescription
admin_user_id string No usr_abc123
amount number No 499
auto_renew boolean No True
billing_cycle string No monthly
cancel_at_period_end boolean No False
currency string No CNY
current_period_end string No 2026-02-01T00:00:00Z
current_period_start string No 2026-01-01T00:00:00Z
grace_period_days integer No 7
plan_id string No pro
status string No active
tenant_id string No tnt_xyz789
trial_end_date string No 2026-01-15T00:00:00Z