Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ionoscloud
  3. API Docs
  4. apigateway
  5. Route
IonosCloud v0.2.2 published on Monday, May 12, 2025 by ionos-cloud
ionos-cloud/pulumi-ionoscloud

ionoscloud.apigateway.Route

Explore with Pulumi AI

ionoscloud logo
IonosCloud v0.2.2 published on Monday, May 12, 2025 by ionos-cloud
ionos-cloud/pulumi-ionoscloud

    Manages an API Gateway Route on IonosCloud.

    Example Usage

    This resource will create an operational API Gateway Route. After this section completes, the provisioner can be called.

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";

const example = new ionoscloud.apigateway.Apigateway("example", {
    name: "example-gateway",
    metrics: true,
    customDomains: [
        {
            name: "example.com",
            certificateId: "00000000-0000-0000-0000-000000000000",
        },
        {
            name: "example.org",
            certificateId: "00000000-0000-0000-0000-000000000000",
        },
    ],
});
const apigatewayRoute = new ionoscloud.apigateway.Route("apigateway_route", {
    name: "apigateway-route",
    type: "http",
    paths: [
        "/foo/*",
        "/bar",
    ],
    methods: [
        "GET",
        "POST",
    ],
    websocket: false,
    upstreams: [{
        scheme: "http",
        loadbalancer: "roundrobin",
        host: "example.com",
        port: 80,
        weight: 100,
    }],
    gatewayId: example.id,
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.apigateway.Apigateway("example",
    name="example-gateway",
    metrics=True,
    custom_domains=[
        {
            "name": "example.com",
            "certificate_id": "00000000-0000-0000-0000-000000000000",
        },
        {
            "name": "example.org",
            "certificate_id": "00000000-0000-0000-0000-000000000000",
        },
    ])
apigateway_route = ionoscloud.apigateway.Route("apigateway_route",
    name="apigateway-route",
    type="http",
    paths=[
        "/foo/*",
        "/bar",
    ],
    methods=[
        "GET",
        "POST",
    ],
    websocket=False,
    upstreams=[{
        "scheme": "http",
        "loadbalancer": "roundrobin",
        "host": "example.com",
        "port": 80,
        "weight": 100,
    }],
    gateway_id=example.id)

    package main

import (
	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud/apigateway"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := apigateway.NewApigateway(ctx, "example", &apigateway.ApigatewayArgs{
			Name:    pulumi.String("example-gateway"),
			Metrics: pulumi.Bool(true),
			CustomDomains: apigateway.ApigatewayCustomDomainArray{
				&apigateway.ApigatewayCustomDomainArgs{
					Name:          pulumi.String("example.com"),
					CertificateId: pulumi.String("00000000-0000-0000-0000-000000000000"),
				},
				&apigateway.ApigatewayCustomDomainArgs{
					Name:          pulumi.String("example.org"),
					CertificateId: pulumi.String("00000000-0000-0000-0000-000000000000"),
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = apigateway.NewRoute(ctx, "apigateway_route", &apigateway.RouteArgs{
			Name: pulumi.String("apigateway-route"),
			Type: pulumi.String("http"),
			Paths: pulumi.StringArray{
				pulumi.String("/foo/*"),
				pulumi.String("/bar"),
			},
			Methods: pulumi.StringArray{
				pulumi.String("GET"),
				pulumi.String("POST"),
			},
			Websocket: pulumi.Bool(false),
			Upstreams: apigateway.RouteUpstreamArray{
				&apigateway.RouteUpstreamArgs{
					Scheme:       pulumi.String("http"),
					Loadbalancer: pulumi.String("roundrobin"),
					Host:         pulumi.String("example.com"),
					Port:         pulumi.Int(80),
					Weight:       pulumi.Int(100),
				},
			},
			GatewayId: example.ID(),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Ionoscloud.Pulumi.Ionoscloud;

return await Deployment.RunAsync(() => 
{
    var example = new Ionoscloud.Apigateway.Apigateway("example", new()
    {
        Name = "example-gateway",
        Metrics = true,
        CustomDomains = new[]
        {
            new Ionoscloud.Apigateway.Inputs.ApigatewayCustomDomainArgs
            {
                Name = "example.com",
                CertificateId = "00000000-0000-0000-0000-000000000000",
            },
            new Ionoscloud.Apigateway.Inputs.ApigatewayCustomDomainArgs
            {
                Name = "example.org",
                CertificateId = "00000000-0000-0000-0000-000000000000",
            },
        },
    });

    var apigatewayRoute = new Ionoscloud.Apigateway.Route("apigateway_route", new()
    {
        Name = "apigateway-route",
        Type = "http",
        Paths = new[]
        {
            "/foo/*",
            "/bar",
        },
        Methods = new[]
        {
            "GET",
            "POST",
        },
        Websocket = false,
        Upstreams = new[]
        {
            new Ionoscloud.Apigateway.Inputs.RouteUpstreamArgs
            {
                Scheme = "http",
                Loadbalancer = "roundrobin",
                Host = "example.com",
                Port = 80,
                Weight = 100,
            },
        },
        GatewayId = example.Id,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.apigateway.Apigateway;
import com.pulumi.ionoscloud.apigateway.ApigatewayArgs;
import com.pulumi.ionoscloud.apigateway.inputs.ApigatewayCustomDomainArgs;
import com.pulumi.ionoscloud.apigateway.Route;
import com.pulumi.ionoscloud.apigateway.RouteArgs;
import com.pulumi.ionoscloud.apigateway.inputs.RouteUpstreamArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new Apigateway("example", ApigatewayArgs.builder()
            .name("example-gateway")
            .metrics(true)
            .customDomains(            
                ApigatewayCustomDomainArgs.builder()
                    .name("example.com")
                    .certificateId("00000000-0000-0000-0000-000000000000")
                    .build(),
                ApigatewayCustomDomainArgs.builder()
                    .name("example.org")
                    .certificateId("00000000-0000-0000-0000-000000000000")
                    .build())
            .build());

        var apigatewayRoute = new Route("apigatewayRoute", RouteArgs.builder()
            .name("apigateway-route")
            .type("http")
            .paths(            
                "/foo/*",
                "/bar")
            .methods(            
                "GET",
                "POST")
            .websocket(false)
            .upstreams(RouteUpstreamArgs.builder()
                .scheme("http")
                .loadbalancer("roundrobin")
                .host("example.com")
                .port(80)
                .weight(100)
                .build())
            .gatewayId(example.id())
            .build());

    }
}

    resources:
  example:
    type: ionoscloud:apigateway:Apigateway
    properties:
      name: example-gateway
      metrics: true
      customDomains:
        - name: example.com
          certificateId: 00000000-0000-0000-0000-000000000000
        - name: example.org
          certificateId: 00000000-0000-0000-0000-000000000000
  apigatewayRoute:
    type: ionoscloud:apigateway:Route
    name: apigateway_route
    properties:
      name: apigateway-route
      type: http
      paths:
        - /foo/*
        - /bar
      methods:
        - GET
        - POST
      websocket: false
      upstreams:
        - scheme: http
          loadbalancer: roundrobin
          host: example.com
          port: 80
          weight: 100
      gatewayId: ${example.id}

    Create Route Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Route(name: string, args: RouteArgs, opts?: CustomResourceOptions);
    @overload
def Route(resource_name: str,
          args: RouteArgs,
          opts: Optional[ResourceOptions] = None)

@overload
def Route(resource_name: str,
          opts: Optional[ResourceOptions] = None,
          gateway_id: Optional[str] = None,
          methods: Optional[Sequence[str]] = None,
          paths: Optional[Sequence[str]] = None,
          upstreams: Optional[Sequence[RouteUpstreamArgs]] = None,
          name: Optional[str] = None,
          type: Optional[str] = None,
          websocket: Optional[bool] = None)
    func NewRoute(ctx *Context, name string, args RouteArgs, opts ...ResourceOption) (*Route, error)
    public Route(string name, RouteArgs args, CustomResourceOptions? opts = null)
    public Route(String name, RouteArgs args)
public Route(String name, RouteArgs args, CustomResourceOptions options)

    type: ionoscloud:apigateway:Route
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args RouteArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args RouteArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args RouteArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RouteArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RouteArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var routeResource = new Ionoscloud.Apigateway.Route("routeResource", new()
{
    GatewayId = "string",
    Methods = new[]
    {
        "string",
    },
    Paths = new[]
    {
        "string",
    },
    Upstreams = new[]
    {
        new Ionoscloud.Apigateway.Inputs.RouteUpstreamArgs
        {
            Host = "string",
            Loadbalancer = "string",
            Port = 0,
            Scheme = "string",
            Weight = 0,
        },
    },
    Name = "string",
    Type = "string",
    Websocket = false,
});

    example, err := apigateway.NewRoute(ctx, "routeResource", &apigateway.RouteArgs{
	GatewayId: pulumi.String("string"),
	Methods: pulumi.StringArray{
		pulumi.String("string"),
	},
	Paths: pulumi.StringArray{
		pulumi.String("string"),
	},
	Upstreams: apigateway.RouteUpstreamArray{
		&apigateway.RouteUpstreamArgs{
			Host:         pulumi.String("string"),
			Loadbalancer: pulumi.String("string"),
			Port:         pulumi.Int(0),
			Scheme:       pulumi.String("string"),
			Weight:       pulumi.Int(0),
		},
	},
	Name:      pulumi.String("string"),
	Type:      pulumi.String("string"),
	Websocket: pulumi.Bool(false),
})

    var routeResource = new Route("routeResource", RouteArgs.builder()
    .gatewayId("string")
    .methods("string")
    .paths("string")
    .upstreams(RouteUpstreamArgs.builder()
        .host("string")
        .loadbalancer("string")
        .port(0)
        .scheme("string")
        .weight(0)
        .build())
    .name("string")
    .type("string")
    .websocket(false)
    .build());

    route_resource = ionoscloud.apigateway.Route("routeResource",
    gateway_id="string",
    methods=["string"],
    paths=["string"],
    upstreams=[{
        "host": "string",
        "loadbalancer": "string",
        "port": 0,
        "scheme": "string",
        "weight": 0,
    }],
    name="string",
    type="string",
    websocket=False)

    const routeResource = new ionoscloud.apigateway.Route("routeResource", {
    gatewayId: "string",
    methods: ["string"],
    paths: ["string"],
    upstreams: [{
        host: "string",
        loadbalancer: "string",
        port: 0,
        scheme: "string",
        weight: 0,
    }],
    name: "string",
    type: "string",
    websocket: false,
});

    type: ionoscloud:apigateway:Route
properties:
    gatewayId: string
    methods:
        - string
    name: string
    paths:
        - string
    type: string
    upstreams:
        - host: string
          loadbalancer: string
          port: 0
          scheme: string
          weight: 0
    websocket: false

    Route Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Route resource accepts the following input properties:

    GatewayId string
    [string] The ID of the API Gateway that the route belongs to.
    Methods List<string>
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    Paths List<string>
    [list] The paths that the route should match. Minimum items: 1.
    Upstreams List<Ionoscloud.RouteUpstream>
    Upstreams information of the API Gateway Route. Minimum items: 1.
    Name string
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    Type string
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    Websocket bool
    [bool] To enable websocket support. Default value: false.
    GatewayId string
    [string] The ID of the API Gateway that the route belongs to.
    Methods []string
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    Paths []string
    [list] The paths that the route should match. Minimum items: 1.
    Upstreams []RouteUpstreamArgs
    Upstreams information of the API Gateway Route. Minimum items: 1.
    Name string
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    Type string
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    Websocket bool
    [bool] To enable websocket support. Default value: false.
    gatewayId String
    [string] The ID of the API Gateway that the route belongs to.
    methods List<String>
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    paths List<String>
    [list] The paths that the route should match. Minimum items: 1.
    upstreams List<RouteUpstream>
    Upstreams information of the API Gateway Route. Minimum items: 1.
    name String
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    type String
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    websocket Boolean
    [bool] To enable websocket support. Default value: false.
    gatewayId string
    [string] The ID of the API Gateway that the route belongs to.
    methods string[]
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    paths string[]
    [list] The paths that the route should match. Minimum items: 1.
    upstreams RouteUpstream[]
    Upstreams information of the API Gateway Route. Minimum items: 1.
    name string
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    type string
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    websocket boolean
    [bool] To enable websocket support. Default value: false.
    gateway_id str
    [string] The ID of the API Gateway that the route belongs to.
    methods Sequence[str]
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    paths Sequence[str]
    [list] The paths that the route should match. Minimum items: 1.
    upstreams Sequence[RouteUpstreamArgs]
    Upstreams information of the API Gateway Route. Minimum items: 1.
    name str
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    type str
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    websocket bool
    [bool] To enable websocket support. Default value: false.
    gatewayId String
    [string] The ID of the API Gateway that the route belongs to.
    methods List<String>
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    paths List<String>
    [list] The paths that the route should match. Minimum items: 1.
    upstreams List<Property Map>
    Upstreams information of the API Gateway Route. Minimum items: 1.
    name String
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    type String
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    websocket Boolean
    [bool] To enable websocket support. Default value: false.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Route resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing Route Resource

    Get an existing Route resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: RouteState, opts?: CustomResourceOptions): Route
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        gateway_id: Optional[str] = None,
        methods: Optional[Sequence[str]] = None,
        name: Optional[str] = None,
        paths: Optional[Sequence[str]] = None,
        type: Optional[str] = None,
        upstreams: Optional[Sequence[RouteUpstreamArgs]] = None,
        websocket: Optional[bool] = None) -> Route
    func GetRoute(ctx *Context, name string, id IDInput, state *RouteState, opts ...ResourceOption) (*Route, error)
    public static Route Get(string name, Input<string> id, RouteState? state, CustomResourceOptions? opts = null)
    public static Route get(String name, Output<String> id, RouteState state, CustomResourceOptions options)
    resources:  _:    type: ionoscloud:apigateway:Route    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    GatewayId string
    [string] The ID of the API Gateway that the route belongs to.
    Methods List<string>
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    Name string
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    Paths List<string>
    [list] The paths that the route should match. Minimum items: 1.
    Type string
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    Upstreams List<Ionoscloud.RouteUpstream>
    Upstreams information of the API Gateway Route. Minimum items: 1.
    Websocket bool
    [bool] To enable websocket support. Default value: false.
    GatewayId string
    [string] The ID of the API Gateway that the route belongs to.
    Methods []string
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    Name string
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    Paths []string
    [list] The paths that the route should match. Minimum items: 1.
    Type string
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    Upstreams []RouteUpstreamArgs
    Upstreams information of the API Gateway Route. Minimum items: 1.
    Websocket bool
    [bool] To enable websocket support. Default value: false.
    gatewayId String
    [string] The ID of the API Gateway that the route belongs to.
    methods List<String>
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    name String
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    paths List<String>
    [list] The paths that the route should match. Minimum items: 1.
    type String
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    upstreams List<RouteUpstream>
    Upstreams information of the API Gateway Route. Minimum items: 1.
    websocket Boolean
    [bool] To enable websocket support. Default value: false.
    gatewayId string
    [string] The ID of the API Gateway that the route belongs to.
    methods string[]
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    name string
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    paths string[]
    [list] The paths that the route should match. Minimum items: 1.
    type string
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    upstreams RouteUpstream[]
    Upstreams information of the API Gateway Route. Minimum items: 1.
    websocket boolean
    [bool] To enable websocket support. Default value: false.
    gateway_id str
    [string] The ID of the API Gateway that the route belongs to.
    methods Sequence[str]
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    name str
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    paths Sequence[str]
    [list] The paths that the route should match. Minimum items: 1.
    type str
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    upstreams Sequence[RouteUpstreamArgs]
    Upstreams information of the API Gateway Route. Minimum items: 1.
    websocket bool
    [bool] To enable websocket support. Default value: false.
    gatewayId String
    [string] The ID of the API Gateway that the route belongs to.
    methods List<String>
    [list] The HTTP methods that the route should match. Minimum items: 1. Possible values: GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD, CONNECT, TRACE.
    name String
    [string] Name of the API Gateway Route. Only alphanumeric characters are allowed.
    paths List<String>
    [list] The paths that the route should match. Minimum items: 1.
    type String
    [string] This field specifies the protocol used by the ingress to route traffic to the backend service. Default value: http.
    upstreams List<Property Map>
    Upstreams information of the API Gateway Route. Minimum items: 1.
    websocket Boolean
    [bool] To enable websocket support. Default value: false.

    Supporting Types

    RouteUpstream, RouteUpstreamArgs

    Host string
    [string] The host of the upstream.
    Loadbalancer string
    [string] The load balancer algorithm. Default value: roundrobin.
    Port int
    [int] The port of the upstream. Default value: 80.
    Scheme string
    [string] The target URL of the upstream. Default value: http.
    Weight int
    [int] Weight with which to split traffic to the upstream. Default value: 100.
    Host string
    [string] The host of the upstream.
    Loadbalancer string
    [string] The load balancer algorithm. Default value: roundrobin.
    Port int
    [int] The port of the upstream. Default value: 80.
    Scheme string
    [string] The target URL of the upstream. Default value: http.
    Weight int
    [int] Weight with which to split traffic to the upstream. Default value: 100.
    host String
    [string] The host of the upstream.
    loadbalancer String
    [string] The load balancer algorithm. Default value: roundrobin.
    port Integer
    [int] The port of the upstream. Default value: 80.
    scheme String
    [string] The target URL of the upstream. Default value: http.
    weight Integer
    [int] Weight with which to split traffic to the upstream. Default value: 100.
    host string
    [string] The host of the upstream.
    loadbalancer string
    [string] The load balancer algorithm. Default value: roundrobin.
    port number
    [int] The port of the upstream. Default value: 80.
    scheme string
    [string] The target URL of the upstream. Default value: http.
    weight number
    [int] Weight with which to split traffic to the upstream. Default value: 100.
    host str
    [string] The host of the upstream.
    loadbalancer str
    [string] The load balancer algorithm. Default value: roundrobin.
    port int
    [int] The port of the upstream. Default value: 80.
    scheme str
    [string] The target URL of the upstream. Default value: http.
    weight int
    [int] Weight with which to split traffic to the upstream. Default value: 100.
    host String
    [string] The host of the upstream.
    loadbalancer String
    [string] The load balancer algorithm. Default value: roundrobin.
    port Number
    [int] The port of the upstream. Default value: 80.
    scheme String
    [string] The target URL of the upstream. Default value: http.
    weight Number
    [int] Weight with which to split traffic to the upstream. Default value: 100.

    Import

    API Gateway route can be imported using the apigateway route id:

    $ pulumi import ionoscloud:apigateway/route:Route myroute apigateway uuid:apigateway route uuid

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    ionoscloud ionos-cloud/pulumi-ionoscloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    IonosCloud v0.2.2 published on Monday, May 12, 2025 by ionos-cloud
    ionos-cloud/pulumi-ionoscloud