tencent cloud

Tencent Cloud EdgeOne

Release Notes and Announcements
Release Notes
Security Announcement
Announcements
Product Introduction
Overview
Strengths
Use Cases
Comparison Between EdgeOne and CDN Products
Use Limits
Purchase Guide
Description of Trial Plan Experience Benefits
Free Plan Guide
Billing Overview
Billing Items
Subscriptions
Renewals
Instructions for overdue and refunds
Comparison of EdgeOne Plans
About "clean traffic" billing instructions
DDoS Protection Capacity Description
Getting Started
Choose business scenario
Quick access to website security acceleration
Quick deploying a website with Pages
Domain Service&Origin Configuration
Domain Service
HTTPS Certificate
Origin Configuration
Site Acceleration
Overview
Access Control
Smart Acceleration
Cache Configuration
File Optimization
Network Optimization
URL Rewrite
Modifying Header
Modify the response content
Rule Engine
Image&Video Processing
Speed limit for single connection download
DDoS & Web Protection
Overview
DDoS Protection
Web Protection
Bot Management
API Discovery(Beta)
Edge Functions
Overview
Getting Started
Operation Guide
Runtime APIs
Sample Functions
Best Practices
Pages
L4 Proxy
Overview
Creating an L4 Proxy Instance
Modifying an L4 Proxy Instance
Disabling or Deleting an L4 Proxy Instance
Batch Configuring Forwarding Rules
Obtaining Real Client IPs
Data Analysis&Log Service
Log Service
Data Analysis
Alarm Service
Site and Billing Management
Billing Management
Site Management
Version Management
General Policy
General Reference
Configuration Syntax
Request and Response Actions
Country/region and Corresponding Codes
Terraform
Overview
Installing and Configuring Terraform
Practical Tutorial
EdgeOne Skill User Guide
Automatic Warm-up/Cache Purge
Resource Abuse/hotlinking Protection Practical
HTTPS Related Practices
Acceleration Optimization
Scheduling Traffic
Data Analysis and Alerting
Log Platform Integration Practices
Configuring Origin Servers for Cloud Object Storage (Such As COS)
CORS Response Configuration
API Documentation
History
Introduction
API Category
Making API Requests
Site APIs
Acceleration Domain Management APIs
Site Acceleration Configuration APIs
Edge Function APIs
Alias Domain APIs
Security Configuration APIs
Layer 4 Application Proxy APIs
Content Management APIs
Data Analysis APIs
Log Service APIs
Billing APIs
Certificate APIs
Origin Protection APIs
Load Balancing APIs
Diagnostic Tool APIs
Custom Response Page APIs
API Security APIs
DNS Record APIs
Content Identifier APIs
Legacy APIs
Ownership APIs
Image and Video Processing APIs
Multi-Channel Security Gateway APIs
Version Management APIs
Data Types
Error Codes
FAQs
Product Features FAQs
DNS Record FAQs
Domain Configuration FAQs
Site Acceleration FAQs
Data and Log FAQs
Security Protection-related Queries
Origin Configuration FAQs
Troubleshooting
Reference for Abnormal Status Codes
Troubleshooting Guide for EdgeOne 4XX/5XX Status Codes
520/524 Status Code Troubleshooting Guide
521/522 Status Code Troubleshooting Guide
Tool Guide
Agreements
Service Level Agreement
Origin Protection Enablement Conditions of Use
TEO Policy
Privacy Policy
Data Processing And Security Agreement
Contact Us
Glossary

DescribePlans

PDF
Focus Mode
Font Size
Last updated: 2025-10-30 22:03:01

1. API Description

Domain name for API request: teo.intl.tencentcloudapi.com.

This API is used to query package information list with pagination support.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: DescribePlans.
Version Yes String Common Params. The value used for this API: 2022-09-01.
Region No String Common Params. This parameter is not required.
Filters.N No Array of Filter Filter criteria: the maximum number of Filters.Values is 20. detailed filter criteria are as follows:
  • plan-type
      filter by package type.
      available types:
      plan-trial: trial package;
      plan-personal: personal plan;
      plan-basic: basic plan;
      plan-standard: standard edition plan;
      plan-enterprise: enterprise plan.
  • plan-id
      filter by package id. the package id format is: edgeone-268z103ob0sx.
  • area
      filter by acceleration region.
  • service area. available types:
      mainland: chinese mainland;
      overseas: worldwide (excluding chinese mainland);
      global: global (including chinese mainland).
  • status
      filter by status.
      available states:
      normal: normal status;
      expiring-soon: expiring soon;
      expired: expired;
      isolated: isolated.
  • .
    Order No String Specifies the sorting field. valid values:.
  • enable-time: effective time;
  • .
  • expire-time: expiration time.
  • use default value enable-time if not specified.
    Direction No String Sorting order. valid values:.
  • Asc: sort in ascending order
  • .
  • Desc: from the largest to smallest.
  • default value: desc.
    Limit No Integer Number limit of paginated query. Default value: 20. Maximum value: 200.
    Offset No Integer The offset of paginated query. Default value: 0.

    3. Output Parameters

    Parameter Name Type Description
    TotalCount Integer Number of eligible packages.
    Plans Array of Plan Package information list.
    RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

    4. Example

    Example1 Query Package Information List

    This example shows you how to query the package information list sorted by package activation time in descending order, starting from the 0th package and fetching 4 package details.

    Input Example

    POST / HTTP/1.1
    Host: teo.intl.tencentcloudapi.com
    Content-Type: application/json
    X-TC-Action: DescribePlans
    <Common request parameters>
    
    {
        "Offset": 0,
        "Limit": 4,
        "Order": "enable-time",
        "Direction": "desc"
    }

    Output Example

    {
        "Response": {
            "RequestId": "55496a31-e798-4aef-b40c-5cdbaef7fe6f",
            "Plans": [
                {
                    "Area": "overseas",
                    "AutoRenewal": false,
                    "PayMode": 0,
                    "PlanId": "edgeone-2ycvr8ml4zpq",
                    "PlanType": "plan-enterprise-v2",
                    "Status": "normal",
                    "DDoSTrafficCapacity": 10000,
                    "AccTrafficCapacity": 10000,
                    "CrossMLCTrafficCapacity": 10000,
                    "ExpiredTime": "2020-09-22T00:00:00Z",
                    "EnabledTime": "2020-10-22T00:00:00Z",
                    "SecRequestCapacity": 10000,
                    "SecTrafficCapacity": 10000,
                    "SmartTrafficCapacity": 10000,
                    "L4TrafficCapacity": 10000,
                    "SmartRequestCapacity": 10000,
                    "VAUCapacity": 50,
                    "ZonesInfo": [
                        {
                            "Paused": false,
                            "ZoneId": "zone-2ycvr8p31c5q",
                            "ZoneName": "edgeone.icu"
                        }
                    ],
                    "Bindable": "true"
                },
                {
                    "Area": "global",
                    "AutoRenewal": false,
                    "PayMode": 0,
                    "PlanId": "edgeone-2ycvr8p345am",
                    "PlanType": "plan-enterprise-v2",
                    "Status": "normal",
                    "DDoSTrafficCapacity": 10000,
                    "AccTrafficCapacity": 10000,
                    "CrossMLCTrafficCapacity": 10000,
                    "ExpiredTime": "2020-09-22T00:00:00Z",
                    "EnabledTime": "2020-10-22T00:00:00Z",
                    "SecRequestCapacity": 10000,
                    "SecTrafficCapacity": 10000,
                    "SmartTrafficCapacity": 10000,
                    "L4TrafficCapacity": 10000,
                    "SmartRequestCapacity": 10000,
                    "VAUCapacity": 50,
                    "ZonesInfo": [
                        {
                            "Paused": false,
                            "ZoneId": "zone-2ycvr8p35jv2",
                            "ZoneName": "edgeone.xyz"
                        }
                    ],
                    "Bindable": "true"
                },
                {
                    "Area": "overseas",
                    "AutoRenewal": false,
                    "PayMode": 0,
                    "PlanId": "edgeone-2ycvr8p36yfi",
                    "PlanType": "plan-enterprise",
                    "Status": "normal",
                    "DDoSTrafficCapacity": 10000,
                    "AccTrafficCapacity": 10000,
                    "CrossMLCTrafficCapacity": 10000,
                    "ExpiredTime": "2020-09-22T00:00:00Z",
                    "EnabledTime": "2020-10-22T00:00:00Z",
                    "SecRequestCapacity": 10000,
                    "SecTrafficCapacity": 10000,
                    "SmartTrafficCapacity": 10000,
                    "L4TrafficCapacity": 10000,
                    "SmartRequestCapacity": 10000,
                    "VAUCapacity": 50,
                    "ZonesInfo": [
                        {
                            "Paused": false,
                            "ZoneId": "zone-2ycvr8p38czy",
                            "ZoneName": "edgeone.com"
                        }
                    ],
                    "Bindable": "true"
                },
                {
                    "Area": "overseas",
                    "AutoRenewal": false,
                    "PayMode": 0,
                    "PlanId": "edgeone-2ycvr8p39rke",
                    "PlanType": "plan-standard",
                    "Status": "normal",
                    "DDoSTrafficCapacity": 10000,
                    "AccTrafficCapacity": 10000,
                    "CrossMLCTrafficCapacity": 10000,
                    "ExpiredTime": "2020-09-22T00:00:00Z",
                    "EnabledTime": "2020-10-22T00:00:00Z",
                    "SecRequestCapacity": 10000,
                    "SecTrafficCapacity": 10000,
                    "SmartTrafficCapacity": 10000,
                    "L4TrafficCapacity": 10000,
                    "SmartRequestCapacity": 10000,
                    "VAUCapacity": 50,
                    "ZonesInfo": [
                        {
                            "Paused": true,
                            "ZoneId": "zone-2vv6990bixl1",
                            "ZoneName": "edgeone.xyz"
                        }
                    ],
                    "Bindable": "false"
                }
            ],
            "TotalCount": 28
        }
    }

    5. Developer Resources

    SDK

    TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

    Command Line Interface

    6. Error Code

    The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

    Error Code Description
    UnauthorizedOperation.CamUnauthorized CAM is not authorized.
    UnauthorizedOperation.NoPermission The sub-account is not authorized for the operation. Please get permissions first.

    Help and Support

    Was this page helpful?

    Help us improve! Rate your documentation experience in 5 mins.

    Feedback