tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Enterprise Content Delivery Network
    Documentation
    Download PDF

    Data Types

    Last updated: 2022-02-23 10:16:39
    Download PDF

    AdvanceHttps

    Custom HTTPS configuration for origin-pull

    Used by actions: AddEcdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    CustomTlsStatus String No Custom TLS data switch
    Note: This field may return null, indicating that no valid values can be obtained.
    TlsVersion Array of String No TLS version settings. Valid values: TLSv1, TLSV1.1, TLSV1.2, and TLSv1.3. Only consecutive versions can be enabled at the same time.
    Note: This field may return null, indicating that no valid values can be obtained.
    Cipher String No Custom encryption suite
    Note: This field may return null, indicating that no valid values can be obtained.
    VerifyOriginType String No Origin-pull verification status
    off: Disables origin-pull verification
    oneWay: Only verify the origin
    twoWay: Enables two-way origin-pull verification
    Note: This field may return null, indicating that no valid values can be obtained.
    CertInfo ServerCert No Configuration information of the origin-pull certificate
    Note: This field may return null, indicating that no valid values can be obtained.
    OriginCertInfo ClientCert No Configuration information of the origin server certificate
    Note: This field may return null, indicating that no valid values can be obtained.

    Cache

    Simple edition of cache configuration, which does not support setting a caching rule for scenarios where the max-age is not returned from the origin server.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    CacheRules Array of CacheRule Yes Caching configuration rule array.
    FollowOrigin String No Whether to follow the Cache-Control: max-age configuration on the origin server (this feature is only available to users on the allowlist).
    on: enable
    off: disable
    If it is enabled, resources that do not match CacheRules will be cached on node according to the max-age value returned by the origin server, while resources that match CacheRules will be cached on node according to the cache expiration time set in CacheRules.
    Note: this field may return null, indicating that no valid values can be obtained.

    CacheKey

    Caching configuration.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    FullUrlCache String No Whether to enable full path cache. Valid values: on, off.

    CacheRule

    Caching configuration rule.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    CacheType String Yes Cache type. Valid values: all (all files), file (extension type), directory (directory), path (full path), index (homepage).
    CacheContents Array of String Yes Cached content list.
    CacheTime Integer Yes Cache time in seconds.

    ClientCert

    HTTPS client certificate configuration.

    Used by actions: AddEcdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Certificate String Yes Client certificate in PEM format.
    Note: this field may return null, indicating that no valid values can be obtained.
    CertName String No Client certificate name.
    Note: this field may return null, indicating that no valid values can be obtained.
    ExpireTime Timestamp No Certificate expiration time.
    Note: this field may return null, indicating that no valid values can be obtained.
    DeployTime Timestamp No Certificate issuance time.
    Note: this field may return null, indicating that no valid values can be obtained.

    DetailData

    Data structure of sorted data

    Used by actions: DescribeEcdnDomainStatistics.

    Name Type Description
    Name String Data type name
    Value Float Data value

    DomainBriefInfo

    Basic information of a CDN domain name.

    Used by actions: DescribeDomains.

    Name Type Description
    ResourceId String Domain name ID.
    AppId Integer Tencent Cloud account ID.
    Domain String CDN acceleration domain name.
    Cname String Domain name CNAME.
    Status String Domain name status. Valid values: pending (reviewing), rejected (rejected), processing (deploying after approval), online (enabled), offline (disabled), deleted (deleted).
    ProjectId Integer Project ID.
    CreateTime Timestamp Domain name creation time.
    UpdateTime Timestamp Domain name update time.
    Origin Origin Origin server configuration details.
    Disable String Domain name blockage status. Valid values: normal (normal), overdue (service is suspended due to arrears), quota (trial traffic package is used up), malicious (malicious user), ddos (DDoS attack), idle (no traffic), unlicensed (no ICP filing), capping (bandwidth cap reached), readonly (read-only)
    Area String Acceleration region. Valid values: mainland, oversea, global.
    Readonly String Domain name lock status. normal: not locked; global: globally locked
    Tag Array of Tag Domain name tag
    Note: This field may return null, indicating that no valid value can be found.

    DomainData

    Data structure of sorted data

    Used by actions: DescribeEcdnDomainStatistics.

    Name Type Description
    Resource String Domain name
    DetailData Array of DetailData Result details.

    DomainDetailInfo

    Detailed configuration information of ECDN domain name.

    Used by actions: DescribeDomainsConfig.

    Name Type Description
    ResourceId String Domain name ID.
    AppId Integer Tencent Cloud account ID.
    Domain String Acceleration domain name.
    Cname String Domain name CNAME.
    Note: this field may return null, indicating that no valid values can be obtained.
    Status String Domain name status. Valid values: pending (reviewing), rejected (rejected), processing (deploying after approval), online (enabled), offline (disabled), deleted (deleted).
    ProjectId Integer Project ID.
    CreateTime Timestamp Domain name creation time.
    UpdateTime Timestamp Domain name update time.
    Origin Origin Origin server configuration.
    IpFilter IpFilter IP blocklist/allowlist configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    IpFreqLimit IpFreqLimit IP access limit configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    ResponseHeader ResponseHeader Origin server response header configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    CacheKey CacheKey Node caching configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    Cache Cache Caching rule configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    Https Https HTTPS configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    Disable String Domain name blockage status. Valid values: normal (normal), overdue (service is suspended due to arrears), quota (trial traffic package is used up), malicious (malicious user), ddos (DDoS attack), idle (no traffic), unlicensed (no ICP filing), capping (bandwidth cap reached), readonly (read-only).
    Note: this field may return null, indicating that no valid values can be obtained.
    ForceRedirect ForceRedirect Forced access protocol redirection configuration.
    Note: this field may return null, indicating that no valid values can be obtained.
    Area String Acceleration region. Valid values: mainland, overseas, global.
    Note: this field may return null, indicating that no valid values can be obtained.
    Readonly String Domain name lock status. normal: not locked; global: globally locked.
    Note: this field may return null, indicating that no valid values can be obtained.
    Tag Array of Tag Domain name tag
    Note: This field may return null, indicating that no valid value can be obtained.
    WebSocket WebSocket WebSocket configuration.
    Note: This field may return null, indicating that no valid values can be obtained.

    DomainFilter

    Filter for domain name query.

    Used by actions: DescribeDomains, DescribeDomainsConfig.

    Name Type Required Description
    Name String Yes Filters by the field name, which includes:
    - origin: Primary origin server.
    - domain: Domain name.
    - resourceId: Domain name ID.
    - status: Domain name status. Valid values: online, offline, and processing.
    - disable: Whether the domain name is blocked. Valid values: normal, unlicensed.
    - projectId: Project ID.
    - fullUrlCache: Whether to enable full-path cache, which can be on or off.
    - https: Whether to configure HTTPS, which can be on, off or processing.
    - originPullProtocol: Origin-pull protocol type, which can be http, follow, or https.
    - area: Acceleration region, which can be mainland，overseas or global.
    - tagKey: Tag key.
    Value Array of String Yes Filter field value.
    Fuzzy Boolean No Whether to enable fuzzy query, which is supported only for filter fields origin and domain.

    DomainLogs

    Domain name log information.

    Used by actions: DescribeEcdnDomainLogs.

    Name Type Description
    StartTime Timestamp Log start time.
    EndTime Timestamp Log end time.
    LogPath String Log download path.

    EcdnData

    Detailed access data type

    Used by actions: DescribeEcdnStatistics.

    Name Type Description
    Metrics Array of String Queries the specified metric. Valid values: Bandwidth, Flux, Request, Delay, status code, LogBandwidth, LogFlux, LogRequest
    DetailData Array of TimestampData Detailed data collection

    ForceRedirect

    Forced access protocol redirection configuration.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes Forced access protocol redirection configuration switch. Valid values: on, off.
    Note: this field may return null, indicating that no valid values can be obtained.
    RedirectType String No Access protocol type for forced redirection. Valid values: http (forced redirection to HTTP protocol), https (forced redirection to HTTPS protocol).
    Note: this field may return null, indicating that no valid values can be obtained.
    RedirectStatusCode Integer No HTTP status code returned when forced redirection is enabled. Valid values: 301, 302.
    Note: this field may return null, indicating that no valid values can be obtained.

    Hsts

    HSTS configuration.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes Whether to enable. Valid values: on, off.
    MaxAge Integer No MaxAge value.
    Note: this field may return null, indicating that no valid values can be obtained.
    IncludeSubDomains String No Whether to include subdomain names. Valid values: on, off.
    Note: this field may return null, indicating that no valid values can be obtained.

    HttpHeaderPathRule

    Path-specific HTTP header setting rule.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    HeaderMode String Yes HTTP header setting method. Valid values: add (add header), set (set header), del (delete header).
    Request header currently does not support set.
    Note: this field may return null, indicating that no valid values can be obtained.
    HeaderName String Yes HTTP header name.
    Note: this field may return null, indicating that no valid values can be obtained.
    HeaderValue String Yes HTTP header value, which is optional when it is del.
    Note: this field may return null, indicating that no valid values can be obtained.
    RuleType String Yes Type of effective URL path rule. Valid values: all (all paths), file (file extension), directory (directory), path (absolute path).
    Note: this field may return null, indicating that no valid values can be obtained.
    RulePaths Array of String Yes URL path or file type list
    Note: this field may return null, indicating that no valid values can be obtained.

    Https

    HTTPS configuration of domain name.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes HTTPS configuration switch. Valid values: on, off. If the domain name with HTTPS configuration enabled is being deployed, this switch will be off.
    Note: this field may return null, indicating that no valid values can be obtained.
    Http2 String No Whether to enable HTTP2. Valid values: on, off.
    Note: this field may return null, indicating that no valid values can be obtained.
    OcspStapling String No Whether to enable the OCSP feature. Valid values: on, off.
    Note: this field may return null, indicating that no valid values can be obtained.
    VerifyClient String No Whether to enable the client certificate verification feature. Valid values: on, off. The client certificate information must be uploaded if this feature is enabled.
    Note: this field may return null, indicating that no valid values can be obtained.
    CertInfo ServerCert No Server certificate configuration information.
    Note: this field may return null, indicating that no valid values can be obtained.
    ClientCertInfo ClientCert No Client certificate configuration information.
    Note: this field may return null, indicating that no valid values can be obtained.
    Spdy String No Whether to enable SPDY. Valid values: on, off.
    Note: this field may return null, indicating that no valid values can be obtained.
    SslStatus String No HTTPS certificate deployment status. Valid values: closed (disabled), deploying (deploying), deployed (deployment succeeded), failed (deployment failed). This parameter cannot be used as an input parameter.
    Note: this field may return null, indicating that no valid values can be obtained.
    Hsts Hsts No HSTS configuration
    Note: this field may return null, indicating that no valid values can be obtained.

    IpFilter

    IP blocklist/allowlist.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes IP blocklist/allowlist switch. Valid values: on, off.
    FilterType String No IP blocklist/allowlist type. Valid values: whitelist, blacklist.
    Note: this field may return null, indicating that no valid values can be obtained.
    Filters Array of String No IP blocklist/allowlist list.
    Note: this field may return null, indicating that no valid values can be obtained.

    IpFreqLimit

    IP access limit configuration.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes IP access limit switch. Valid values: on, off.
    Qps Integer No Number of requests per second.
    Note: this field may return null, indicating that no valid values can be obtained.

    IpStatus

    Node IP information

    Used by actions: DescribeIpStatus.

    Name Type Description
    Ip String Node IP
    District String Node region
    Isp String Node ISP
    City String Node city
    Status String Node status
    online: the node is online and scheduling normally
    offline: the node is offline
    CreateTime Timestamp Node IP creation time

    Origin

    Origin server configuration.

    Used by actions: AddEcdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Origins Array of String No Primary origin server list. IP and the domain name of the origin server cannot be entered at the same time. Configure origin server port in the format of ["origin1:port1", "origin2:port2"]. Configure origin-pull weight in the format of ["origin1::weight1", "origin2::weight2"]. Configure both port and weight in the format of ["origin1:port1:weight1", "origin2:port2:weight2"]. Valid range of weight value: 0 - 100.
    OriginType String No Primary origin server type. Valid values: domain (domain name origin server), ip (IP origin server).
    This is required when setting Origins.
    Note: this field may return null, indicating that no valid values can be obtained.
    ServerName String No Host header value during origin-pull.
    Note: this field may return null, indicating that no valid values can be obtained.
    OriginPullProtocol String No Origin-pull protocol type. Valid values: http (forced HTTP origin-pull), follow (protocol follow), https (HTTPS origin-pull).
    If this parameter is left empty, HTTP origin-pull will be used by default.
    Note: this field may return null, indicating that no valid value is obtained.
    BackupOrigins Array of String No Secondary origin server list.
    BackupOriginType String No Secondary origin server type, which is the same as OriginType.
    This is required when setting BackupOrigins.
    Note: this field may return null, indicating that no valid values can be obtained.
    AdvanceHttps AdvanceHttps No HTTPS advanced origin-pull configuration
    Note: This field may return null, indicating that no valid values can be obtained.

    PurgeTask

    Purge task log details.

    Used by actions: DescribePurgeTasks.

    Name Type Description
    TaskId String Purge task ID.
    Url String Purged URL.
    Status String Purge task status. fail: failed, done: succeeded, process: purging.
    PurgeType String Purge type. url: URL purge; path: directory purge.
    FlushType String Resource purge method. flush: purges updated resources, delete: purges all resources.
    CreateTime Timestamp Purge task submission time

    Quota

    Purge usage and quota

    Used by actions: DescribePurgeQuota.

    Name Type Description
    Batch Integer Quota limit for one batch submission request.
    Total Integer Daily submission quota limit.
    Available Integer Remaining daily submission quota.

    ResourceData

    Query object and its access details

    Used by actions: DescribeEcdnStatistics.

    Name Type Description
    Resource String Resource name, which is categorized as follows based on different query conditions:
    Specific domain name: indicates the details of the specific domain name
    multiDomains: indicates aggregated details of multiple domain names
    Project ID: displays the ID of the specified project to be queried
    all: details at the account level
    EcdnData EcdnData Data details of resource

    ResponseHeader

    Custom response header configuration.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes Custom response header switch. Valid values: on, off.
    HeaderRules Array of HttpHeaderPathRule No Custom response header rule array.
    Note: this field may return null, indicating that no valid values can be obtained.

    ServerCert

    HTTPS server certificate configuration.

    Used by actions: AddEcdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    CertId String No Server certificate ID, which is required if the certificate is a Tencent Cloud-hosted certificate.
    Note: this field may return null, indicating that no valid values can be obtained.
    CertName String No Server certificate name, which is required if the certificate is a Tencent Cloud-hosted certificate.
    Note: this field may return null, indicating that no valid values can be obtained.
    Certificate String No Server certificate information, which is required when uploading your own certificate and must contain complete certificate chain information.
    Note: this field may return null, indicating that no valid values can be obtained.
    PrivateKey String No Server key information, which is required when uploading your own certificate.
    Note: this field may return null, indicating that no valid values can be obtained.
    ExpireTime Timestamp No Certificate expiration time.
    Note: this field may return null, indicating that no valid values can be obtained.
    DeployTime Timestamp No Certificate issuance time.
    Note: this field may return null, indicating that no valid values can be obtained.
    Message String No Certificate remarks.
    Note: this field may return null, indicating that no valid values can be obtained.

    Sort

    Sorting criteria for query results.

    Used by actions: DescribeDomainsConfig.

    Name Type Required Description
    Key String Yes Sort by field. Valid values:
    createTime: domain name creation time
    certExpireTime: certificate expiration time
    Sequence String No asc/desc. Default value: desc.

    Tag

    Tag key and tag value.

    Used by actions: AddEcdnDomain, DescribeDomains, DescribeDomainsConfig.

    Name Type Required Description
    TagKey String Yes Tag key.
    Note: this field may return null, indicating that no valid value is obtained.
    TagValue String Yes Tag value.
    Note: this field may return null, indicating that no valid value is obtained.

    TimestampData

    Timestamp and its corresponding value

    Used by actions: DescribeEcdnStatistics.

    Name Type Description
    Time Timestamp Statistical time point in forward rounding mode
    Taking the 5-minute granularity as an example, 13:35:00 indicates that the statistical interval is between 13:35:00 and 13:39:59
    Value Array of Float Data value

    WebSocket

    WebSocket configuration.

    Used by actions: AddEcdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

    Name Type Required Description
    Switch String Yes Whether to enable custom WebSocket timeout setting. When it’s off: WebSocket connection is supported, and the default timeout period is 15 seconds. To change the timeout period, please set it to on.

    * WebSocket is now only available for beta users. To use it, please submit a ticket.
    Timeout Integer No Sets timeout period in seconds. Maximum value: 65
    Note: This field may return null, indicating that no valid values can be obtained.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Contact Us
    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    Submit a Ticket
    7x24 Phone Support
    Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
    Privacy PolicyLegalCookie Policy