管理订阅

一旦您的客户配置了区域 (zone)，您就可以添加区域和账户级别的订阅。

要创建区域订阅（通常用于将区域的计划从 PARTNERS_FREE 升级到付费的区域计划），请向 /zones/{zone_id}/subscription 端点发送 POST 请求，并包含以下值：

• rate_plan 对象

  • 包含对应于客户在控制面板中订购的区域计划。有关可用值的列表，请参阅区域计划。

• component_values 数组

  • 视您的经销商协议而定的额外服务，例如额外的 page_rules。

• frequency 字符串

  • 订阅自动续订的频率（默认为 "monthly"）。

curl 'https://api.cloudflare.com/client/v4/zones/{zone_id}/subscription' \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "rate_plan": {
    "id": "<RATE_PLAN>"
  },
  "frequency": "annual"
}'

curl 'https://api.cloudflare.com/client/v4/zones/{zone_id}/subscription' \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "rate_plan": {
    "id": "PARTNERS_BIZ"
  },
  "component_values": [
    {
      "name": "page_rules",
      "value": 50
    }
  ]
}'

要获取区域订阅的详细信息，请向 /zones/<ZONE_ID>/subscription 端点发送一个 GET 请求。

要更新区域的订阅（通常用于更新现有订阅的 'component_values' 或降低区域的订阅级别），请向 /zones/<ZONE_ID>/subscription 端点发送一个 PUT 请求。

根据您的协议，您可能被允许转售其他附加服务。这些服务以账户级订阅的形式进行配置。

要创建账户订阅，请向 /accounts/{account_id}/subscriptions 端点发送 POST 请求，并包含以下值：

• rate_plan 对象

  • 包含对应于特定附加服务（add-on service）的账户订阅。有关可用值的列表，请参阅可用订阅。

• component_values 数组

  • 视您的经销商协议而定的额外服务，例如用于负载均衡 (load balancing) 的额外端点或 Cloudflare Zero Trust 的额外席位 (seats)。如果未包含，订阅将包含与每次购买相关联的默认值。

• frequency 字符串

  • 订阅自动续订的频率（默认为 "monthly"）。

curl 'https://api.cloudflare.com/client/v4/accounts/{account_id}/subscriptions' \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "rate_plan": {
    "id": "<RATE_PLAN_NAME>"
  }
}'

要获取账户的所有订阅，请向 /accounts/<ACCOUNT_ID>/subscriptions 端点发送一个 GET 请求。

要更新账户的订阅，请向 /accounts/<ACCOUNT_ID>/subscriptions/<SUBSCRIPTION_ID> 端点发送一个 PUT 请求。

要删除账户的订阅，请向 /accounts/<ACCOUNT_ID>/subscriptions/<SUBSCRIPTION_ID> 端点发送一个 DELETE 请求。