---
title: "修改配额模式与数量"
method: PATCH
path: "/v1/mate/open/basic/{address}/quota"
tags: ["OPEN API SERVICE"]
---

# 修改配额模式与数量

`PATCH /v1/mate/open/basic/{address}/quota`

## Path parameters

- `address` string, required

## Query parameters

- `mode` 'UNLIMITED' | 'TRANSFER_QUOTA' | 'ENERGY_QUOTA', required
- `reset_used_count` boolean, required
- `count` integer

## Headers

- `CF-ACCESS-KEY` string, required
- `CF-ACCESS-SIGN` string, required
- `CF-ACCESS-TIMESTAMP` string, required

## Response `200`

OK

- XHostBasicEnergyPayload
  - `code` integer — 成功返回0，其他均为错误
  - `msg` string — 发生错误时候返回的消息
  - `sub_code` string
  - `sub_msg` string
  - `data` HostBasicEnergyPayload
    - `id` integer — ID
    - `address` string — 地址
    - `plan_id` integer — 套餐ID
    - `plan_name_en` string — 套餐英文名
    - `plan_name_zh` string — 套餐中文名
    - `plan_subscription_sun` integer — 套餐的订阅费
    - `plan_unit_sun` integer — 补充能量单价
    - `quota_mode` 'UNLIMITED' | 'TRANSFER_QUOTA' | 'ENERGY_QUOTA' — 配额模式: UNLIMITED:不受限制；TRANSFER_QUOTA:依据转账次数进行限制；ENERGY_QUOTA:按照能量次数进行配额限制。详细信息参见波场伴侣文档
    - `slot_next_billing_timestamp` integer — 下次订阅费时间
    - `quantity` integer — 每次补充的能量数量
    - `used_quantity` integer — 累计使用能量
    - `quota_count` integer — 总配额次数
    - `used_count` integer — 已使用次数
    - `quota_start_time` integer — 配额开始时间
    - `total_transfer_count` integer — 累计转账次数
    - `total_energy_count` integer — 累计能量次数
    - `total_slot_fee` integer — 累计订阅费
    - `total_energy_fee` integer — 累计补能费
    - `remark` string — 备注
    - `is_auto_closable` boolean — 是否72小时未使用自动关闭
    - `idle_hours` integer — 闲置自动关闭时间(小时)
    - `bandwidth_guarantee` boolean — 是否开始带宽保护
    - `status` 'ACTIVE' | 'PAUSED' | 'MANUAL_PAUSED' | 'API_PAUSED' | 'UNUSED_PAUSED' | 'QUOTA_PAUSED' | 'EXPIRED_PAUSED' — 状态: 1=正常 2=欠费暂停 3=人工暂停
    - `expired_at` integer — 过期时间
    - `created_at` integer — 创建时间

---

[API](https://skmtc.net/catfee/apis/energy-mate-api.md) · [All operations](https://skmtc.net/catfee/apis/energy-mate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catfee/energy-mate-api/revisions/4d8dfb4920ea/schema)