tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Cloud EdgeOne
    Documentation
    Download PDF

    CreateApplicationProxy

    Last updated: 2024-12-03 16:17:39
    Download PDF

      1. API Description

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

      This API is on an earlier version. If you want to call it, please switch to the latest version [CreateL4Proxy] (https://www.tencentcloud.com/document/product/1552/103417?from_cn_redirect=1).

      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: CreateApplicationProxy.
      Version Yes String Common Params. The value used for this API: 2022-09-01.
      Region No String Common Params. This parameter is not required.
      ZoneId Yes String Site ID.
      ProxyName Yes String Domain name or subdomain name when ProxyType=hostname;
      Instance name when ProxyType=instance.
      PlatType Yes String The scheduling mode. Values:
    • ip: Schedule via Anycast IP.
    • domain: Schedule via CNAME.
      		•
      SecurityType Yes Integer Whether to enable security protection. Values:
    • 0: Disable security protection.
    • 1: Enable security protection.
      		•
      AccelerateType Yes Integer Whether to enable acceleration. Values:
    • 0: Disable acceleration.
    • 1: Enable acceleration.
      		•
      ProxyType No String Layer 4 proxy mode, with value:
    • instance: instance mode.
      • If not specified, the default value instance will be used.
      SessionPersistTime No Integer The session persistence duration. Value range: 30-3600 (in seconds).
      If not specified, this field uses the default value 600.
      Ipv6 No Ipv6 Ipv6 access configuration.
      IPv6 access is disabled if it is not specified.
      ApplicationProxyRules.N No Array of ApplicationProxyRule The rule details.
      If this field is not specified, an application proxy rule will not be created.
      AccelerateMainland No AccelerateMainland Cross-MLC-border acceleration. It is disabled if this parameter is not specified.

      3. Output Parameters

      Parameter Name Type Description
      ProxyId String The L4 application proxy ID.
      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 Creating an application proxy

      This example shows you how to create an application proxy.

      Input Example

      POST / HTTP/1.1 
Host: teo.intl.tencentcloudapi.com 
Content-Type: application/json 
X-TC-Action: CreateApplicationProxy 
<Common request parameters>

{
    "ZoneId": "zone-21xfqlh4qjee",
    "ProxyName": "instancd-name",
    "ProxyType": "instance",
    "PlatType": "ip",
    "SecurityType": 1,
    "AccelerateType": 1,
    "SessionPersistTime": 3600,
    "Ipv6": {
        "Switch": "on"
    },
    "ApplicationProxyRules": [
        {
            "Proto": "TCP",
            "Port": [
                "80",
                "90",
                "99-110"
            ],
            "OriginType": "custom",
            "OriginValue": [
                "1.1.1.1:80"
            ]
        },
        {
            "Proto": "UDP",
            "Port": [
                "999",
                "888",
                "99-110"
            ],
            "OriginType": "custom",
            "OriginValue": [
                "1.1.1.1:80",
                "2.2.2.2:80"
            ]
        }
    ]
}

      Output Example

      {
    "Response": {
        "RequestId": "5e0a2b4e-df6d-4d2a-ac39-1706cbf8a707",
        "ProxyId": "proxy-537f5b41-162a-11ed-abaa-525400c5da15"
    }
}

      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
      FailedOperation Operation failed.
      InvalidParameter.InvalidOriginIp The origin cannot be a private IP or loopback address.
      InvalidParameter.ParameterError Parameter error: Invalid “End time”. The interval between the start and end time cannot exceed 7 days.
      InvalidParameter.ProxyNameDuplicating The instance name already exists.
      InvalidParameter.ProxyNameNotMatched Instance name can contain 1 to 50 characters. The allowed characters are a to z, 0 to 9, and -. - cannot be registered alone or used continuously and cannot be placed at the beginning or the end.
      LimitExceeded The quota limit has been reached.
      LimitExceeded.UserQuotaLimited User instance quantity limitation.
      OperationDenied Operation denied.
      OperationDenied.ErrZoneIsAlreadyPaused The EdgeOne service of the site is disabled. Please enable it and try again.
      OperationDenied.PlatTypeIPAccelerateMainlandNotSupport This site is using Anycast IP scheduling mode and does not support Cross-MLC-border acceleration.
      OperationDenied.ZoneNotActive The zone is disabled.
      ResourceInsufficient Insufficient resource.
      ResourceNotFound The resource doesn’t exist.
      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