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

ovh.CloudProject.getInstances

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 list of instances in a region of a public cloud project.

    Example Usage

    To list your instances:

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

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

    import pulumi
import pulumi_ovh as ovh

instance = ovh.CloudProject.get_instances(service_name="YYYY",
    region="XXXX")

    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.GetInstances(ctx, &cloudproject.GetInstancesArgs{
			ServiceName: "YYYY",
			Region:      "XXXX",
		}, 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.GetInstances.Invoke(new()
    {
        ServiceName = "YYYY",
        Region = "XXXX",
    });

});

    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.GetInstancesArgs;
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.getInstances(GetInstancesArgs.builder()
            .serviceName("YYYY")
            .region("XXXX")
            .build());

    }
}

    variables:
  instance:
    fn::invoke:
      function: ovh:CloudProject:getInstances
      arguments:
        serviceName: YYYY
        region: XXXX

    Using getInstances

    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 getInstances(args: GetInstancesArgs, opts?: InvokeOptions): Promise<GetInstancesResult>
function getInstancesOutput(args: GetInstancesOutputArgs, opts?: InvokeOptions): Output<GetInstancesResult>
    def get_instances(region: Optional[str] = None,
                  service_name: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetInstancesResult
def get_instances_output(region: Optional[pulumi.Input[str]] = None,
                  service_name: Optional[pulumi.Input[str]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetInstancesResult]
    func GetInstances(ctx *Context, args *GetInstancesArgs, opts ...InvokeOption) (*GetInstancesResult, error)
func GetInstancesOutput(ctx *Context, args *GetInstancesOutputArgs, opts ...InvokeOption) GetInstancesResultOutput

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

    public static class GetInstances 
{
    public static Task<GetInstancesResult> InvokeAsync(GetInstancesArgs args, InvokeOptions? opts = null)
    public static Output<GetInstancesResult> Invoke(GetInstancesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetInstancesResult> getInstances(GetInstancesArgs args, InvokeOptions options)
public static Output<GetInstancesResult> getInstances(GetInstancesArgs args, InvokeOptions options)

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

    The following arguments are supported:

    Region string
    Instance region.
    ServiceName string
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.
    Region string
    Instance region.
    ServiceName string
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.
    region String
    Instance region.
    serviceName String
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.
    region string
    Instance region.
    serviceName string
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.
    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.
    region String
    Instance region.
    serviceName String
    The id of the public cloud project. If omitted, the OVH_CLOUD_PROJECT_SERVICE environment variable is used.

    getInstances Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    Instances List<GetInstancesInstance>
    List of instances
    Region string
    ServiceName string
    Id string
    The provider-assigned unique ID for this managed resource.
    Instances []GetInstancesInstance
    List of instances
    Region string
    ServiceName string
    id String
    The provider-assigned unique ID for this managed resource.
    instances List<GetInstancesInstance>
    List of instances
    region String
    serviceName String
    id string
    The provider-assigned unique ID for this managed resource.
    instances GetInstancesInstance[]
    List of instances
    region string
    serviceName string
    id str
    The provider-assigned unique ID for this managed resource.
    instances Sequence[GetInstancesInstance]
    List of instances
    region str
    service_name str
    id String
    The provider-assigned unique ID for this managed resource.
    instances List<Property Map>
    List of instances
    region String
    serviceName String

    Supporting Types

    GetInstancesInstance

    Addresses List<GetInstancesInstanceAddress>
    Instance IP addresses
    AttachedVolumes List<GetInstancesInstanceAttachedVolume>
    Volumes attached to the instance
    AvailabilityZone string
    Availability zone of the instance
    FlavorId string
    Flavor id
    FlavorName string
    Flavor name
    Id string
    Instance id
    ImageId string
    Image id
    Name string
    Instance name
    SshKey string
    SSH Keypair
    Status string
    Instance status
    TaskState string
    Instance task state
    Addresses []GetInstancesInstanceAddress
    Instance IP addresses
    AttachedVolumes []GetInstancesInstanceAttachedVolume
    Volumes attached to the instance
    AvailabilityZone string
    Availability zone of the instance
    FlavorId string
    Flavor id
    FlavorName string
    Flavor name
    Id string
    Instance id
    ImageId string
    Image id
    Name string
    Instance name
    SshKey string
    SSH Keypair
    Status string
    Instance status
    TaskState string
    Instance task state
    addresses List<GetInstancesInstanceAddress>
    Instance IP addresses
    attachedVolumes List<GetInstancesInstanceAttachedVolume>
    Volumes attached to the instance
    availabilityZone String
    Availability zone of the instance
    flavorId String
    Flavor id
    flavorName String
    Flavor name
    id String
    Instance id
    imageId String
    Image id
    name String
    Instance name
    sshKey String
    SSH Keypair
    status String
    Instance status
    taskState String
    Instance task state
    addresses GetInstancesInstanceAddress[]
    Instance IP addresses
    attachedVolumes GetInstancesInstanceAttachedVolume[]
    Volumes attached to the instance
    availabilityZone string
    Availability zone of the instance
    flavorId string
    Flavor id
    flavorName string
    Flavor name
    id string
    Instance id
    imageId string
    Image id
    name string
    Instance name
    sshKey string
    SSH Keypair
    status string
    Instance status
    taskState string
    Instance task state
    addresses Sequence[GetInstancesInstanceAddress]
    Instance IP addresses
    attached_volumes Sequence[GetInstancesInstanceAttachedVolume]
    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
    Instance id
    image_id str
    Image id
    name str
    Instance name
    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
    Instance id
    imageId String
    Image id
    name String
    Instance name
    sshKey String
    SSH Keypair
    status String
    Instance status
    taskState String
    Instance task state

    GetInstancesInstanceAddress

    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

    GetInstancesInstanceAttachedVolume

    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.