tencent cloud


Use of Conditional Routing for TKE Upstream

Last updated: 2022-07-08 16:23:25


    You can forward requests to different TKE backends based on the request/system parameter values, such as the Host or UserName in the request header. This is suitable for various scenarios, including grayscale release, blue-green deployment, and tenant routing. The TKE backend upstream can be combined with the conditional routing plugin to implement data distribution.

    For the usage and features of conditional routing, see Conditional Routing Plugin.


    • You have a dedicated instance.
    • You have created multiple TKE upstreams.


    1. Create an API on the API Gateway service page. Select VPC resources as the backend type of the API and select TKE upstream as the upstream.

    2. After the API is published, create a conditional routing plugin.

      1. Select Plugin > System Plugin on the left sidebar in the console.

      2. Click Create and select Conditional routing as the type.

      3. Create a conditional routing policy: the semantics of the conditional routing in the following example is that when the value of UserName in the request header is admin, the request will be forwarded to the TKE upstream upstream-1ca1d6yi.

        Policy details:

        ServiceType: HTTP
        Method: ANY
        Path: /
        Url: ''
        UniqVpcId: vpc-s0g8gpo5
        UpstreamId: upstream-1ca1d6yi
        Product: upstream
    3. The conditional routing plugin is bound to the API created in step 1.

    4. If the request matches the conditional routing policy (header with UserName as admin), it will be forwarded to upstream-1ca1d6yi; otherwise, the default backend configured for the API will be used.


    Conditional routing can match not only request headers but also clientIp. For more capabilities of conditional routing, see Conditional Routing Plugin.

    Contact Us

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

    Technical Support

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

    7x24 Phone Support