Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. OVH
  4. API Docs
  5. CloudInstanceGroup
Viewing docs for OVHCloud v2.19.1
published on Tuesday, Aug 18, 2026 by OVHcloud
Schema (JSON)
ovh/pulumi-ovh

ovh.CloudInstanceGroup

ovh logo
Viewing docs for OVHCloud v2.19.1
published on Tuesday, Aug 18, 2026 by OVHcloud
Schema (JSON)
ovh/pulumi-ovh

    Creates an instance group (placement group) in a public cloud project.

    WARNING An instance group is immutable: it has no update route. Changing any attribute (name, region, policy) forces the group to be destroyed and re-created.

    NOTE Membership is set only at instance-creation time through the instance’s group_id; this resource never manages members.

    Example Usage

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

const group = new ovh.CloudInstanceGroup("group", {
    serviceName: "<Public cloud project id>",
    region: "GRA11",
    name: "my-instance-group",
    policy: "ANTI_AFFINITY",
});

    import pulumi
import pulumi_ovh as ovh

group = ovh.CloudInstanceGroup("group",
    service_name="<Public cloud project id>",
    region="GRA11",
    name="my-instance-group",
    policy="ANTI_AFFINITY")

    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 {
		_, err := ovh.NewCloudInstanceGroup(ctx, "group", &ovh.CloudInstanceGroupArgs{
			ServiceName: pulumi.String("<Public cloud project id>"),
			Region:      pulumi.String("GRA11"),
			Name:        pulumi.String("my-instance-group"),
			Policy:      pulumi.String("ANTI_AFFINITY"),
		})
		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 @group = new Ovh.CloudInstanceGroup("group", new()
    {
        ServiceName = "<Public cloud project id>",
        Region = "GRA11",
        Name = "my-instance-group",
        Policy = "ANTI_AFFINITY",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.ovhcloud.pulumi.ovh.CloudInstanceGroup;
import com.ovhcloud.pulumi.ovh.CloudInstanceGroupArgs;
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 group = new CloudInstanceGroup("group", CloudInstanceGroupArgs.builder()
            .serviceName("<Public cloud project id>")
            .region("GRA11")
            .name("my-instance-group")
            .policy("ANTI_AFFINITY")
            .build());

    }
}

    resources:
  group:
    type: ovh:CloudInstanceGroup
    properties:
      serviceName: <Public cloud project id>
      region: GRA11
      name: my-instance-group
      policy: ANTI_AFFINITY

    Example coming soon!

    AFFINITY vs ANTI_AFFINITY

    ANTI_AFFINITY spreads the members across distinct hypervisors: use it for the replicas of a highly-available service, so a single host failure cannot take them all down. AFFINITY does the opposite and packs the members onto the same hypervisor, for tightly coupled instances that benefit from staying on one host.

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

const spread = new ovh.CloudInstanceGroup("spread", {
    serviceName: "<Public cloud project id>",
    region: "GRA11",
    name: "my-anti-affinity-group",
    policy: "ANTI_AFFINITY",
});
const packed = new ovh.CloudInstanceGroup("packed", {
    serviceName: "<Public cloud project id>",
    region: "GRA11",
    name: "my-affinity-group",
    policy: "AFFINITY",
});

    import pulumi
import pulumi_ovh as ovh

spread = ovh.CloudInstanceGroup("spread",
    service_name="<Public cloud project id>",
    region="GRA11",
    name="my-anti-affinity-group",
    policy="ANTI_AFFINITY")
packed = ovh.CloudInstanceGroup("packed",
    service_name="<Public cloud project id>",
    region="GRA11",
    name="my-affinity-group",
    policy="AFFINITY")

    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 {
		_, err := ovh.NewCloudInstanceGroup(ctx, "spread", &ovh.CloudInstanceGroupArgs{
			ServiceName: pulumi.String("<Public cloud project id>"),
			Region:      pulumi.String("GRA11"),
			Name:        pulumi.String("my-anti-affinity-group"),
			Policy:      pulumi.String("ANTI_AFFINITY"),
		})
		if err != nil {
			return err
		}
		_, err = ovh.NewCloudInstanceGroup(ctx, "packed", &ovh.CloudInstanceGroupArgs{
			ServiceName: pulumi.String("<Public cloud project id>"),
			Region:      pulumi.String("GRA11"),
			Name:        pulumi.String("my-affinity-group"),
			Policy:      pulumi.String("AFFINITY"),
		})
		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 spread = new Ovh.CloudInstanceGroup("spread", new()
    {
        ServiceName = "<Public cloud project id>",
        Region = "GRA11",
        Name = "my-anti-affinity-group",
        Policy = "ANTI_AFFINITY",
    });

    var packed = new Ovh.CloudInstanceGroup("packed", new()
    {
        ServiceName = "<Public cloud project id>",
        Region = "GRA11",
        Name = "my-affinity-group",
        Policy = "AFFINITY",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.ovhcloud.pulumi.ovh.CloudInstanceGroup;
import com.ovhcloud.pulumi.ovh.CloudInstanceGroupArgs;
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 spread = new CloudInstanceGroup("spread", CloudInstanceGroupArgs.builder()
            .serviceName("<Public cloud project id>")
            .region("GRA11")
            .name("my-anti-affinity-group")
            .policy("ANTI_AFFINITY")
            .build());

        var packed = new CloudInstanceGroup("packed", CloudInstanceGroupArgs.builder()
            .serviceName("<Public cloud project id>")
            .region("GRA11")
            .name("my-affinity-group")
            .policy("AFFINITY")
            .build());

    }
}

    resources:
  spread:
    type: ovh:CloudInstanceGroup
    properties:
      serviceName: <Public cloud project id>
      region: GRA11
      name: my-anti-affinity-group
      policy: ANTI_AFFINITY
  packed:
    type: ovh:CloudInstanceGroup
    properties:
      serviceName: <Public cloud project id>
      region: GRA11
      name: my-affinity-group
      policy: AFFINITY

    Example coming soon!

    Adding member instances

    Members join through the instance’s group_id, never through this resource. group_id is itself immutable, so moving an instance to another group — or out of its group — recreates the instance. Read the resulting membership back from current_state.members.

    Example coming soon!

    Example coming soon!

    Example coming soon!

    Example coming soon!

    Example coming soon!

    resources:
  ha:
    type: ovh:CloudInstanceGroup
    properties:
      serviceName: <Public cloud project id>
      region: GRA11
      name: my-ha-group
      policy: ANTI_AFFINITY
  replica:
    type: ovh:CloudInstance
    properties:
      serviceName: <Public cloud project id>
      region: ${ha.region}
      name: my-replica-${range.value}
      flavorId: <flavor id>
      imageId: <image id>
      groupId: ${ha.id}
      networks:
        - auto_assign_public_ip: true
    options: {}

    Example coming soon!

    Operational notes

    • Create and delete poll the API until the group settles, for up to 20 minutes each. The resource offers no timeouts {} block, so that budget cannot be shortened or extended from the configuration.
    • resource_status = "ERROR" is terminal: polling stops at once and the provider surfaces the summary of the failed task(s) instead of a generic unexpected-state error.
    • resource_status = "OUT_OF_SYNC" is remediated by replacement, not by an update. A group that drifts is planned for destroy-and-recreate on the next pulumi up; it never sits drifted. Replacement is the only reconciliation path available, because the group has no update route.
    • Because the replacement assigns a new group ID, every ovh.CloudInstance whose immutable group_id points at this group is replaced along with it. Plan a drift remediation as an outage of the whole group, not of the placement group alone.

    Create CloudInstanceGroup Resource

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

    Constructor syntax

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

@overload
def CloudInstanceGroup(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       policy: Optional[str] = None,
                       region: Optional[str] = None,
                       service_name: Optional[str] = None,
                       name: Optional[str] = None)
    func NewCloudInstanceGroup(ctx *Context, name string, args CloudInstanceGroupArgs, opts ...ResourceOption) (*CloudInstanceGroup, error)
    public CloudInstanceGroup(string name, CloudInstanceGroupArgs args, CustomResourceOptions? opts = null)
    public CloudInstanceGroup(String name, CloudInstanceGroupArgs args)
public CloudInstanceGroup(String name, CloudInstanceGroupArgs args, CustomResourceOptions options)

    type: ovh:CloudInstanceGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "ovh_cloud_instance_group" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args CloudInstanceGroupArgs
    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 CloudInstanceGroupArgs
    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 CloudInstanceGroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CloudInstanceGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CloudInstanceGroupArgs
    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 cloudInstanceGroupResource = new Ovh.CloudInstanceGroup("cloudInstanceGroupResource", new()
{
    Policy = "string",
    Region = "string",
    ServiceName = "string",
    Name = "string",
});

    example, err := ovh.NewCloudInstanceGroup(ctx, "cloudInstanceGroupResource", &ovh.CloudInstanceGroupArgs{
	Policy:      pulumi.String("string"),
	Region:      pulumi.String("string"),
	ServiceName: pulumi.String("string"),
	Name:        pulumi.String("string"),
})

    resource "ovh_cloud_instance_group" "cloudInstanceGroupResource" {
  lifecycle {
    create_before_destroy = true
  }
  policy       = "string"
  region       = "string"
  service_name = "string"
  name         = "string"
}

    var cloudInstanceGroupResource = new CloudInstanceGroup("cloudInstanceGroupResource", CloudInstanceGroupArgs.builder()
    .policy("string")
    .region("string")
    .serviceName("string")
    .name("string")
    .build());

    cloud_instance_group_resource = ovh.CloudInstanceGroup("cloudInstanceGroupResource",
    policy="string",
    region="string",
    service_name="string",
    name="string")

    const cloudInstanceGroupResource = new ovh.CloudInstanceGroup("cloudInstanceGroupResource", {
    policy: "string",
    region: "string",
    serviceName: "string",
    name: "string",
});

    type: ovh:CloudInstanceGroup
properties:
    name: string
    policy: string
    region: string
    serviceName: string

    CloudInstanceGroup 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 CloudInstanceGroup resource accepts the following input properties:

    Policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    Region string
    Region where the instance group will be created. Changing this value recreates the resource.
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    Name string
    Instance group name. Changing this value recreates the resource.
    Policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    Region string
    Region where the instance group will be created. Changing this value recreates the resource.
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    Name string
    Instance group name. Changing this value recreates the resource.
    policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region string
    Region where the instance group will be created. Changing this value recreates the resource.
    service_name string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    name string
    Instance group name. Changing this value recreates the resource.
    policy String
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region String
    Region where the instance group will be created. Changing this value recreates the resource.
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    name String
    Instance group name. Changing this value recreates the resource.
    policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region string
    Region where the instance group will be created. Changing this value recreates the resource.
    serviceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    name string
    Instance group name. Changing this value recreates the resource.
    policy str
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region str
    Region where the instance group will be created. Changing this value recreates the resource.
    service_name str
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    name str
    Instance group name. Changing this value recreates the resource.
    policy String
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region String
    Region where the instance group will be created. Changing this value recreates the resource.
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    name String
    Instance group name. Changing this value recreates the resource.

    Outputs

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

    Checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    CreatedAt string
    Creation date of the instance group.
    CurrentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceStatus string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    Checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    CreatedAt string
    Creation date of the instance group.
    CurrentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    Id string
    The provider-assigned unique ID for this managed resource.
    ResourceStatus string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    created_at string
    Creation date of the instance group.
    current_state object
    Current state of the instance group:
    id string
    The provider-assigned unique ID for this managed resource.
    resource_status string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    checksum String
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    createdAt String
    Creation date of the instance group.
    currentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    id String
    The provider-assigned unique ID for this managed resource.
    resourceStatus String
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    createdAt string
    Creation date of the instance group.
    currentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    id string
    The provider-assigned unique ID for this managed resource.
    resourceStatus string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    checksum str
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    created_at str
    Creation date of the instance group.
    current_state CloudInstanceGroupCurrentState
    Current state of the instance group:
    id str
    The provider-assigned unique ID for this managed resource.
    resource_status str
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    checksum String
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    createdAt String
    Creation date of the instance group.
    currentState Property Map
    Current state of the instance group:
    id String
    The provider-assigned unique ID for this managed resource.
    resourceStatus String
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)

    Look up Existing CloudInstanceGroup Resource

    Get an existing CloudInstanceGroup 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?: CloudInstanceGroupState, opts?: CustomResourceOptions): CloudInstanceGroup
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        checksum: Optional[str] = None,
        created_at: Optional[str] = None,
        current_state: Optional[CloudInstanceGroupCurrentStateArgs] = None,
        name: Optional[str] = None,
        policy: Optional[str] = None,
        region: Optional[str] = None,
        resource_status: Optional[str] = None,
        service_name: Optional[str] = None) -> CloudInstanceGroup
    func GetCloudInstanceGroup(ctx *Context, name string, id IDInput, state *CloudInstanceGroupState, opts ...ResourceOption) (*CloudInstanceGroup, error)
    public static CloudInstanceGroup Get(string name, Input<string> id, CloudInstanceGroupState? state, CustomResourceOptions? opts = null)
    public static CloudInstanceGroup get(String name, Output<String> id, CloudInstanceGroupState state, CustomResourceOptions options)
    resources:  _:    type: ovh:CloudInstanceGroup    get:      id: ${id}
    import {
  to = ovh_cloud_instance_group.example
  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:
    Checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    CreatedAt string
    Creation date of the instance group.
    CurrentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    Name string
    Instance group name. Changing this value recreates the resource.
    Policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    Region string
    Region where the instance group will be created. Changing this value recreates the resource.
    ResourceStatus string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    Checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    CreatedAt string
    Creation date of the instance group.
    CurrentState CloudInstanceGroupCurrentStateArgs
    Current state of the instance group:
    Name string
    Instance group name. Changing this value recreates the resource.
    Policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    Region string
    Region where the instance group will be created. Changing this value recreates the resource.
    ResourceStatus string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    ServiceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    created_at string
    Creation date of the instance group.
    current_state object
    Current state of the instance group:
    name string
    Instance group name. Changing this value recreates the resource.
    policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region string
    Region where the instance group will be created. Changing this value recreates the resource.
    resource_status string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    service_name string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    checksum String
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    createdAt String
    Creation date of the instance group.
    currentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    name String
    Instance group name. Changing this value recreates the resource.
    policy String
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region String
    Region where the instance group will be created. Changing this value recreates the resource.
    resourceStatus String
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    checksum string
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    createdAt string
    Creation date of the instance group.
    currentState CloudInstanceGroupCurrentState
    Current state of the instance group:
    name string
    Instance group name. Changing this value recreates the resource.
    policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region string
    Region where the instance group will be created. Changing this value recreates the resource.
    resourceStatus string
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    serviceName string
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    checksum str
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    created_at str
    Creation date of the instance group.
    current_state CloudInstanceGroupCurrentStateArgs
    Current state of the instance group:
    name str
    Instance group name. Changing this value recreates the resource.
    policy str
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region str
    Region where the instance group will be created. Changing this value recreates the resource.
    resource_status str
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    service_name str
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.
    checksum String
    Computed hash representing the current target specification value. Because an instance group has no update route, this value never changes after creation.
    createdAt String
    Creation date of the instance group.
    currentState Property Map
    Current state of the instance group:
    name String
    Instance group name. Changing this value recreates the resource.
    policy String
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    region String
    Region where the instance group will be created. Changing this value recreates the resource.
    resourceStatus String
    Instance group readiness in the system (CREATING, DELETING, ERROR, OUT_OF_SYNC, READY)
    serviceName String
    Service name of the resource representing the id of the cloud project. Changing this value recreates the resource.

    Supporting Types

    CloudInstanceGroupCurrentState, CloudInstanceGroupCurrentStateArgs

    Location CloudInstanceGroupCurrentStateLocation
    Location details:
    Members List<CloudInstanceGroupCurrentStateMember>
    Instances currently belonging to the group:
    Name string
    Instance group name. Changing this value recreates the resource.
    Policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    Location CloudInstanceGroupCurrentStateLocation
    Location details:
    Members []CloudInstanceGroupCurrentStateMember
    Instances currently belonging to the group:
    Name string
    Instance group name. Changing this value recreates the resource.
    Policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    location object
    Location details:
    members list(object)
    Instances currently belonging to the group:
    name string
    Instance group name. Changing this value recreates the resource.
    policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    location CloudInstanceGroupCurrentStateLocation
    Location details:
    members List<CloudInstanceGroupCurrentStateMember>
    Instances currently belonging to the group:
    name String
    Instance group name. Changing this value recreates the resource.
    policy String
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    location CloudInstanceGroupCurrentStateLocation
    Location details:
    members CloudInstanceGroupCurrentStateMember[]
    Instances currently belonging to the group:
    name string
    Instance group name. Changing this value recreates the resource.
    policy string
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    location CloudInstanceGroupCurrentStateLocation
    Location details:
    members Sequence[CloudInstanceGroupCurrentStateMember]
    Instances currently belonging to the group:
    name str
    Instance group name. Changing this value recreates the resource.
    policy str
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.
    location Property Map
    Location details:
    members List<Property Map>
    Instances currently belonging to the group:
    name String
    Instance group name. Changing this value recreates the resource.
    policy String
    Placement policy applied to the group's member instances (AFFINITY, ANTI_AFFINITY). Changing this value recreates the resource.

    CloudInstanceGroupCurrentStateLocation, CloudInstanceGroupCurrentStateLocationArgs

    AvailabilityZone string
    Availability zone.
    Region string
    Region where the instance group will be created. Changing this value recreates the resource.
    AvailabilityZone string
    Availability zone.
    Region string
    Region where the instance group will be created. Changing this value recreates the resource.
    availability_zone string
    Availability zone.
    region string
    Region where the instance group will be created. Changing this value recreates the resource.
    availabilityZone String
    Availability zone.
    region String
    Region where the instance group will be created. Changing this value recreates the resource.
    availabilityZone string
    Availability zone.
    region string
    Region where the instance group will be created. Changing this value recreates the resource.
    availability_zone str
    Availability zone.
    region str
    Region where the instance group will be created. Changing this value recreates the resource.
    availabilityZone String
    Availability zone.
    region String
    Region where the instance group will be created. Changing this value recreates the resource.

    CloudInstanceGroupCurrentStateMember, CloudInstanceGroupCurrentStateMemberArgs

    Id string
    Instance ID.
    Id string
    Instance ID.
    id string
    Instance ID.
    id String
    Instance ID.
    id string
    Instance ID.
    id str
    Instance ID.
    id String
    Instance ID.

    Import

    An instance group in a public cloud project can be imported using the

    service_name and instance_group_id, separated by /:

    terraform

    import {

    to = ovh_cloud_instance_group.group

    id = “<service_name>/<instance_group_id>”

    }

    bash

    $ pulumi import ovh:index/cloudInstanceGroup:CloudInstanceGroup group service_name/instance_group_id

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

    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.19.1
    published on Tuesday, Aug 18, 2026 by OVHcloud
    Schema (JSON)
    ovh/pulumi-ovh

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial