Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud
published on Friday, Jul 17, 2026 by OVHcloud
Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud
published on Friday, Jul 17, 2026 by OVHcloud
Use this data source to retrieve information about a gateway in a public cloud project.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ovh from "@ovhcloud/pulumi-ovh";
const gateway = ovh.getCloudGateway({
serviceName: "<public cloud project ID>",
id: "<gateway ID>",
});
export const gatewayName = gateway.then(gateway => gateway.name);
import pulumi
import pulumi_ovh as ovh
gateway = ovh.get_cloud_gateway(service_name="<public cloud project ID>",
id="<gateway ID>")
pulumi.export("gatewayName", gateway.name)
package main
import (
"github.com/ovh/pulumi-ovh/sdk/v2/go/ovh"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
gateway, err := ovh.LookupCloudGateway(ctx, &ovh.LookupCloudGatewayArgs{
ServiceName: "<public cloud project ID>",
Id: "<gateway ID>",
}, nil)
if err != nil {
return err
}
ctx.Export("gatewayName", gateway.Name)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ovh = Pulumi.Ovh;
return await Deployment.RunAsync(() =>
{
var gateway = Ovh.GetCloudGateway.Invoke(new()
{
ServiceName = "<public cloud project ID>",
Id = "<gateway ID>",
});
return new Dictionary<string, object?>
{
["gatewayName"] = gateway.Apply(getCloudGatewayResult => getCloudGatewayResult.Name),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ovh.OvhFunctions;
import com.pulumi.ovh.inputs.GetCloudGatewayArgs;
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) {
final var gateway = OvhFunctions.getCloudGateway(GetCloudGatewayArgs.builder()
.serviceName("<public cloud project ID>")
.id("<gateway ID>")
.build());
ctx.export("gatewayName", gateway.name());
}
}
variables:
gateway:
fn::invoke:
function: ovh:getCloudGateway
arguments:
serviceName: <public cloud project ID>
id: <gateway ID>
outputs:
gatewayName: ${gateway.name}
Example coming soon!
Using getCloudGateway
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getCloudGateway(args: GetCloudGatewayArgs, opts?: InvokeOptions): Promise<GetCloudGatewayResult>
function getCloudGatewayOutput(args: GetCloudGatewayOutputArgs, opts?: InvokeOptions): Output<GetCloudGatewayResult>def get_cloud_gateway(id: Optional[str] = None,
service_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetCloudGatewayResult
def get_cloud_gateway_output(id: pulumi.Input[Optional[str]] = None,
service_name: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetCloudGatewayResult]func LookupCloudGateway(ctx *Context, args *LookupCloudGatewayArgs, opts ...InvokeOption) (*LookupCloudGatewayResult, error)
func LookupCloudGatewayOutput(ctx *Context, args *LookupCloudGatewayOutputArgs, opts ...InvokeOption) LookupCloudGatewayResultOutput> Note: This function is named LookupCloudGateway in the Go SDK.
public static class GetCloudGateway
{
public static Task<GetCloudGatewayResult> InvokeAsync(GetCloudGatewayArgs args, InvokeOptions? opts = null)
public static Output<GetCloudGatewayResult> Invoke(GetCloudGatewayInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetCloudGatewayResult> getCloudGateway(GetCloudGatewayArgs args, InvokeOptions options)
public static Output<GetCloudGatewayResult> getCloudGateway(GetCloudGatewayArgs args, InvokeOptions options)
fn::invoke:
function: ovh:index/getCloudGateway:getCloudGateway
arguments:
# arguments dictionarydata "ovh_get_cloud_gateway" "name" {
# arguments
}The following arguments are supported:
- Id string
- Gateway ID.
- Service
Name string - Service name of the resource representing the id of the cloud project.
- Id string
- Gateway ID.
- Service
Name string - Service name of the resource representing the id of the cloud project.
- id string
- Gateway ID.
- service_
name string - Service name of the resource representing the id of the cloud project.
- id String
- Gateway ID.
- service
Name String - Service name of the resource representing the id of the cloud project.
- id string
- Gateway ID.
- service
Name string - Service name of the resource representing the id of the cloud project.
- id str
- Gateway ID.
- service_
name str - Service name of the resource representing the id of the cloud project.
- id String
- Gateway ID.
- service
Name String - Service name of the resource representing the id of the cloud project.
getCloudGateway Result
The following output properties are available:
- Checksum string
- Computed hash representing the current target specification value.
- Created
At string - Creation date of the gateway.
- Current
State GetCloud Gateway Current State - Current state of the gateway:
- Description string
- Gateway description.
- External
Gateway GetCloud Gateway External Gateway - External gateway configuration:
- Id string
- Subnet ID.
- Location
Get
Cloud Gateway Location - Location details:
- Name string
- Gateway name.
- Resource
Status string - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - Service
Name string - Subnet
Ids List<string> - List of subnet IDs attached as router interfaces.
- Updated
At string - Last update date of the gateway.
- Checksum string
- Computed hash representing the current target specification value.
- Created
At string - Creation date of the gateway.
- Current
State GetCloud Gateway Current State - Current state of the gateway:
- Description string
- Gateway description.
- External
Gateway GetCloud Gateway External Gateway - External gateway configuration:
- Id string
- Subnet ID.
- Location
Get
Cloud Gateway Location - Location details:
- Name string
- Gateway name.
- Resource
Status string - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - Service
Name string - Subnet
Ids []string - List of subnet IDs attached as router interfaces.
- Updated
At string - Last update date of the gateway.
- checksum string
- Computed hash representing the current target specification value.
- created_
at string - Creation date of the gateway.
- current_
state object - Current state of the gateway:
- description string
- Gateway description.
- external_
gateway object - External gateway configuration:
- id string
- Subnet ID.
- location object
- Location details:
- name string
- Gateway name.
- resource_
status string - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - service_
name string - subnet_
ids list(string) - List of subnet IDs attached as router interfaces.
- updated_
at string - Last update date of the gateway.
- checksum String
- Computed hash representing the current target specification value.
- created
At String - Creation date of the gateway.
- current
State GetCloud Gateway Current State - Current state of the gateway:
- description String
- Gateway description.
- external
Gateway GetCloud Gateway External Gateway - External gateway configuration:
- id String
- Subnet ID.
- location
Get
Cloud Gateway Location - Location details:
- name String
- Gateway name.
- resource
Status String - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - service
Name String - subnet
Ids List<String> - List of subnet IDs attached as router interfaces.
- updated
At String - Last update date of the gateway.
- checksum string
- Computed hash representing the current target specification value.
- created
At string - Creation date of the gateway.
- current
State GetCloud Gateway Current State - Current state of the gateway:
- description string
- Gateway description.
- external
Gateway GetCloud Gateway External Gateway - External gateway configuration:
- id string
- Subnet ID.
- location
Get
Cloud Gateway Location - Location details:
- name string
- Gateway name.
- resource
Status string - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - service
Name string - subnet
Ids string[] - List of subnet IDs attached as router interfaces.
- updated
At string - Last update date of the gateway.
- checksum str
- Computed hash representing the current target specification value.
- created_
at str - Creation date of the gateway.
- current_
state GetCloud Gateway Current State - Current state of the gateway:
- description str
- Gateway description.
- external_
gateway GetCloud Gateway External Gateway - External gateway configuration:
- id str
- Subnet ID.
- location
Get
Cloud Gateway Location - Location details:
- name str
- Gateway name.
- resource_
status str - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - service_
name str - subnet_
ids Sequence[str] - List of subnet IDs attached as router interfaces.
- updated_
at str - Last update date of the gateway.
- checksum String
- Computed hash representing the current target specification value.
- created
At String - Creation date of the gateway.
- current
State Property Map - Current state of the gateway:
- description String
- Gateway description.
- external
Gateway Property Map - External gateway configuration:
- id String
- Subnet ID.
- location Property Map
- Location details:
- name String
- Gateway name.
- resource
Status String - Gateway readiness in the system (
CREATING,DELETING,ERROR,OUT_OF_SYNC,READY,UPDATING). - service
Name String - subnet
Ids List<String> - List of subnet IDs attached as router interfaces.
- updated
At String - Last update date of the gateway.
Supporting Types
GetCloudGatewayCurrentState
- Description string
- Gateway description.
- External
Gateway GetCloud Gateway Current State External Gateway - External gateway configuration:
- External
Ip string - External IP address assigned to the gateway.
- Location
Get
Cloud Gateway Current State Location - Location details:
- Name string
- Gateway name.
- Status string
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - Subnets
List<Get
Cloud Gateway Current State Subnet> - Currently attached subnets:
- Description string
- Gateway description.
- External
Gateway GetCloud Gateway Current State External Gateway - External gateway configuration:
- External
Ip string - External IP address assigned to the gateway.
- Location
Get
Cloud Gateway Current State Location - Location details:
- Name string
- Gateway name.
- Status string
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - Subnets
[]Get
Cloud Gateway Current State Subnet - Currently attached subnets:
- description string
- Gateway description.
- external_
gateway object - External gateway configuration:
- external_
ip string - External IP address assigned to the gateway.
- location object
- Location details:
- name string
- Gateway name.
- status string
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - subnets list(object)
- Currently attached subnets:
- description String
- Gateway description.
- external
Gateway GetCloud Gateway Current State External Gateway - External gateway configuration:
- external
Ip String - External IP address assigned to the gateway.
- location
Get
Cloud Gateway Current State Location - Location details:
- name String
- Gateway name.
- status String
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - subnets
List<Get
Cloud Gateway Current State Subnet> - Currently attached subnets:
- description string
- Gateway description.
- external
Gateway GetCloud Gateway Current State External Gateway - External gateway configuration:
- external
Ip string - External IP address assigned to the gateway.
- location
Get
Cloud Gateway Current State Location - Location details:
- name string
- Gateway name.
- status string
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - subnets
Get
Cloud Gateway Current State Subnet[] - Currently attached subnets:
- description str
- Gateway description.
- external_
gateway GetCloud Gateway Current State External Gateway - External gateway configuration:
- external_
ip str - External IP address assigned to the gateway.
- location
Get
Cloud Gateway Current State Location - Location details:
- name str
- Gateway name.
- status str
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - subnets
Sequence[Get
Cloud Gateway Current State Subnet] - Currently attached subnets:
- description String
- Gateway description.
- external
Gateway Property Map - External gateway configuration:
- external
Ip String - External IP address assigned to the gateway.
- location Property Map
- Location details:
- name String
- Gateway name.
- status String
- OpenStack router status (
ACTIVE,BUILD,DOWN,ERROR). - subnets List<Property Map>
- Currently attached subnets:
GetCloudGatewayCurrentStateExternalGateway
GetCloudGatewayCurrentStateLocation
- Availability
Zone string - Availability zone.
- Region string
- Region.
- Availability
Zone string - Availability zone.
- Region string
- Region.
- availability_
zone string - Availability zone.
- region string
- Region.
- availability
Zone String - Availability zone.
- region String
- Region.
- availability
Zone string - Availability zone.
- region string
- Region.
- availability_
zone str - Availability zone.
- region str
- Region.
- availability
Zone String - Availability zone.
- region String
- Region.
GetCloudGatewayCurrentStateSubnet
- Id string
- Gateway ID.
- Id string
- Gateway ID.
- id string
- Gateway ID.
- id String
- Gateway ID.
- id string
- Gateway ID.
- id str
- Gateway ID.
- id String
- Gateway ID.
GetCloudGatewayExternalGateway
GetCloudGatewayLocation
- Availability
Zone string - Availability zone.
- Region string
- Region.
- Availability
Zone string - Availability zone.
- Region string
- Region.
- availability_
zone string - Availability zone.
- region string
- Region.
- availability
Zone String - Availability zone.
- region String
- Region.
- availability
Zone string - Availability zone.
- region string
- Region.
- availability_
zone str - Availability zone.
- region str
- Region.
- availability
Zone String - Availability zone.
- region String
- Region.
Package Details
- Repository
- ovh ovh/pulumi-ovh
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
ovhTerraform Provider.
Viewing docs for OVHCloud v2.17.0
published on Friday, Jul 17, 2026 by OVHcloud
published on Friday, Jul 17, 2026 by OVHcloud