1. Packages
  2. OVH
  3. API Docs
  4. CloudProject
  5. getInstance
Viewing docs for OVHCloud v2.12.0
published on Thursday, Mar 12, 2026 by OVHcloud
Schema (JSON)
ovh/pulumi-ovh

ovh.CloudProject.getInstance

ovh logo
Viewing docs for OVHCloud v2.12.0
published on Thursday, Mar 12, 2026 by OVHcloud
Schema (JSON)
ovh/pulumi-ovh

    This datasource uses a Beta API Use this data source to get the instance of a public cloud project.

    Example Usage

    To get information of an instance:

    import * as pulumi from "@pulumi/pulumi";
import * as ovh from "@ovhcloud/pulumi-ovh";

const instance = ovh.CloudProject.getInstance({
    serviceName: "YYYY",
    region: "XXXX",
    instanceId: "ZZZZZ",
});

    import pulumi
import pulumi_ovh as ovh

instance = ovh.CloudProject.get_instance(service_name="YYYY",
    region="XXXX",
    instance_id="ZZZZZ")

    package main

import (
	"github.com/ovh/pulumi-ovh/sdk/v2/go/ovh/cloudproject"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudproject.GetInstance(ctx, &cloudproject.GetInstanceArgs{
			ServiceName: "YYYY",
			Region:      "XXXX",
			InstanceId:  "ZZZZZ",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var instance = Ovh.CloudProject.GetInstance.Invoke(new()
    {
        ServiceName = "YYYY",
        Region = "XXXX",
        InstanceId = "ZZZZZ",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ovh.CloudProject.CloudProjectFunctions;
import com.pulumi.ovh.CloudProject.inputs.GetInstanceArgs;
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 instance = CloudProjectFunctions.getInstance(GetInstanceArgs.builder()
            .serviceName("YYYY")
            .region("XXXX")
            .instanceId("ZZZZZ")
            .build());

    }
}

    variables:
  instance:
    fn::invoke:
      function: ovh:CloudProject:getInstance
      arguments:
        serviceName: YYYY
        region: XXXX
        instanceId: ZZZZZ

    Using getInstance

    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 getInstance(args: GetInstanceArgs, opts?: InvokeOptions): Promise<GetInstanceResult>
function getInstanceOutput(args: GetInstanceOutputArgs, opts?: InvokeOptions): Output<GetInstanceResult>
    def get_instance(instance_id: Optional[str] = None,
                 region: Optional[str] = None,
                 service_name: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetInstanceResult
def get_instance_output(instance_id: Optional[pulumi.Input[str]] = None,
                 region: Optional[pulumi.Input[str]] = None,
                 service_name: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetInstanceResult]
    func LookupInstance(ctx *Context, args *LookupInstanceArgs, opts ...InvokeOption) (*LookupInstanceResult, error)
func LookupInstanceOutput(ctx *Context, args *LookupInstanceOutputArgs, opts ...InvokeOption) LookupInstanceResultOutput

    > Note: This function is named LookupInstance in the Go SDK.

    public static class GetInstance 
{
    public static Task<GetInstanceResult> InvokeAsync(GetInstanceArgs args, InvokeOptions? opts = null)
    public static Output<GetInstanceResult> Invoke(GetInstanceInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetInstanceResult> getInstance(GetInstanceArgs args, InvokeOptions options)
public static Output<GetInstanceResult> getInstance(GetInstanceArgs args, InvokeOptions options)

    fn::invoke:
  function: ovh:CloudProject/getInstance:getInstance
  arguments:
    # arguments dictionary

    The following arguments are supported:

    InstanceId string
    Instance id
    Region string
    Instance region
    ServiceName string
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used
    InstanceId string
    Instance id
    Region string
    Instance region
    ServiceName string
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used
    instanceId String
    Instance id
    region String
    Instance region
    serviceName String
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used
    instanceId string
    Instance id
    region string
    Instance region
    serviceName string
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used
    instance_id str
    Instance id
    region str
    Instance region
    service_name str
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used
    instanceId String
    Instance id
    region String
    Instance region
    serviceName String
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used

    getInstance Result

    The following output properties are available:

    Addresses List<GetInstanceAddress>
    Instance IP addresses
    AttachedVolumes List<GetInstanceAttachedVolume>
    Volumes attached to the instance
    AvailabilityZone string
    Availability zone of the instance
    FlavorId string
    Flavor id
    FlavorName string
    Flavor name
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageId string
    Image id
    InstanceId string
    Name string
    Instance name
    Region string
    ServiceName string
    SshKey string
    SSH Keypair
    Status string
    Instance status
    TaskState string
    Instance task state
    Addresses []GetInstanceAddress
    Instance IP addresses
    AttachedVolumes []GetInstanceAttachedVolume
    Volumes attached to the instance
    AvailabilityZone string
    Availability zone of the instance
    FlavorId string
    Flavor id
    FlavorName string
    Flavor name
    Id string
    The provider-assigned unique ID for this managed resource.
    ImageId string
    Image id
    InstanceId string
    Name string
    Instance name
    Region string
    ServiceName string
    SshKey string
    SSH Keypair
    Status string
    Instance status
    TaskState string
    Instance task state
    addresses List<GetInstanceAddress>
    Instance IP addresses
    attachedVolumes List<GetInstanceAttachedVolume>
    Volumes attached to the instance
    availabilityZone String
    Availability zone of the instance
    flavorId String
    Flavor id
    flavorName String
    Flavor name
    id String
    The provider-assigned unique ID for this managed resource.
    imageId String
    Image id
    instanceId String
    name String
    Instance name
    region String
    serviceName String
    sshKey String
    SSH Keypair
    status String
    Instance status
    taskState String
    Instance task state
    addresses GetInstanceAddress[]
    Instance IP addresses
    attachedVolumes GetInstanceAttachedVolume[]
    Volumes attached to the instance
    availabilityZone string
    Availability zone of the instance
    flavorId string
    Flavor id
    flavorName string
    Flavor name
    id string
    The provider-assigned unique ID for this managed resource.
    imageId string
    Image id
    instanceId string
    name string
    Instance name
    region string
    serviceName string
    sshKey string
    SSH Keypair
    status string
    Instance status
    taskState string
    Instance task state
    addresses Sequence[GetInstanceAddress]
    Instance IP addresses
    attached_volumes Sequence[GetInstanceAttachedVolume]
    Volumes attached to the instance
    availability_zone str
    Availability zone of the instance
    flavor_id str
    Flavor id
    flavor_name str
    Flavor name
    id str
    The provider-assigned unique ID for this managed resource.
    image_id str
    Image id
    instance_id str
    name str
    Instance name
    region str
    service_name str
    ssh_key str
    SSH Keypair
    status str
    Instance status
    task_state str
    Instance task state
    addresses List<Property Map>
    Instance IP addresses
    attachedVolumes List<Property Map>
    Volumes attached to the instance
    availabilityZone String
    Availability zone of the instance
    flavorId String
    Flavor id
    flavorName String
    Flavor name
    id String
    The provider-assigned unique ID for this managed resource.
    imageId String
    Image id
    instanceId String
    name String
    Instance name
    region String
    serviceName String
    sshKey String
    SSH Keypair
    status String
    Instance status
    taskState String
    Instance task state

    Supporting Types

    GetInstanceAddress

    Ip string
    IP address
    Version int
    IP version
    Ip string
    IP address
    Version int
    IP version
    ip String
    IP address
    version Integer
    IP version
    ip string
    IP address
    version number
    IP version
    ip str
    IP address
    version int
    IP version
    ip String
    IP address
    version Number
    IP version

    GetInstanceAttachedVolume

    Id string
    Instance id
    Id string
    Instance id
    id String
    Instance id
    id string
    Instance id
    id str
    Instance id
    id String
    Instance id

    Package Details

    Repository
    ovh ovh/pulumi-ovh
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ovh Terraform Provider.
    ovh logo
    Viewing docs for OVHCloud v2.12.0
    published on Thursday, Mar 12, 2026 by OVHcloud
    Schema (JSON)
    ovh/pulumi-ovh
      Try Pulumi Cloud free. Your team will thank you.