1. Packages
  2. Ibm Provider
  3. API Docs
  4. IsInstanceGroup
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.IsInstanceGroup

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

    Create, update or delete a instance group on VPC. For more information, about instance group, see managing an instance group.

    Note: VPC infrastructure services are a regional specific based endpoint, by default targets to us-south. Please make sure to target right region in the provider block as shown in the provider.tf file, if VPC service is created in region other than us-south.

    provider.tf

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    
    return await Deployment.RunAsync(() => 
    {
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    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) {
        }
    }
    
    {}
    

    Example Usage

    In the following example, you can create a instance group on VPC Generation-2 infrastructure.

    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    Coming soon!
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsVpc;
    import com.pulumi.ibm.IsSubnet;
    import com.pulumi.ibm.IsSubnetArgs;
    import com.pulumi.ibm.IsSshKey;
    import com.pulumi.ibm.IsSshKeyArgs;
    import com.pulumi.ibm.IsInstanceTemplate;
    import com.pulumi.ibm.IsInstanceTemplateArgs;
    import com.pulumi.ibm.inputs.IsInstanceTemplatePrimaryNetworkInterfaceArgs;
    import com.pulumi.ibm.IsInstanceGroup;
    import com.pulumi.ibm.IsInstanceGroupArgs;
    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 exampleIsVpc = new IsVpc("exampleIsVpc");
    
            var exampleIsSubnet = new IsSubnet("exampleIsSubnet", IsSubnetArgs.builder()
                .vpc(exampleIsVpc.isVpcId())
                .zone("us-south-2")
                .ipv4CidrBlock("10.240.64.0/28")
                .build());
    
            var exampleIsSshKey = new IsSshKey("exampleIsSshKey", IsSshKeyArgs.builder()
                .publicKey("SSH KEY")
                .build());
    
            var exampleIsInstanceTemplate = new IsInstanceTemplate("exampleIsInstanceTemplate", IsInstanceTemplateArgs.builder()
                .image(ibm_is_image.example().id())
                .profile("bx2-8x32")
                .primaryNetworkInterface(IsInstanceTemplatePrimaryNetworkInterfaceArgs.builder()
                    .subnet(exampleIsSubnet.isSubnetId())
                    .build())
                .vpc(exampleIsVpc.isVpcId())
                .zone("us-south-2")
                .keys(exampleIsSshKey.isSshKeyId())
                .build());
    
            var exampleIsInstanceGroup = new IsInstanceGroup("exampleIsInstanceGroup", IsInstanceGroupArgs.builder()
                .instanceTemplate(exampleIsInstanceTemplate.isInstanceTemplateId())
                .instanceCount(2)
                .subnets(exampleIsSubnet.isSubnetId())
                .timeouts(IsInstanceGroupTimeoutsArgs.builder()
                    .create("15m")
                    .delete("15m")
                    .update("10m")
                    .build())
                .build());
    
        }
    }
    
    resources:
      exampleIsVpc:
        type: ibm:IsVpc
      exampleIsSubnet:
        type: ibm:IsSubnet
        properties:
          vpc: ${exampleIsVpc.isVpcId}
          zone: us-south-2
          ipv4CidrBlock: 10.240.64.0/28
      exampleIsSshKey:
        type: ibm:IsSshKey
        properties:
          publicKey: SSH KEY
      exampleIsInstanceTemplate:
        type: ibm:IsInstanceTemplate
        properties:
          image: ${ibm_is_image.example.id}
          profile: bx2-8x32
          primaryNetworkInterface:
            subnet: ${exampleIsSubnet.isSubnetId}
          vpc: ${exampleIsVpc.isVpcId}
          zone: us-south-2
          keys:
            - ${exampleIsSshKey.isSshKeyId}
      exampleIsInstanceGroup:
        type: ibm:IsInstanceGroup
        properties:
          instanceTemplate: ${exampleIsInstanceTemplate.isInstanceTemplateId}
          instanceCount: 2
          subnets:
            - ${exampleIsSubnet.isSubnetId}
          # User can configure timeouts
          timeouts:
            - create: 15m
              delete: 15m
              update: 10m
    

    Create IsInstanceGroup Resource

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

    Constructor syntax

    new IsInstanceGroup(name: string, args: IsInstanceGroupArgs, opts?: CustomResourceOptions);
    @overload
    def IsInstanceGroup(resource_name: str,
                        args: IsInstanceGroupArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def IsInstanceGroup(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        instance_template: Optional[str] = None,
                        subnets: Optional[Sequence[str]] = None,
                        access_tags: Optional[Sequence[str]] = None,
                        application_port: Optional[float] = None,
                        instance_count: Optional[float] = None,
                        is_instance_group_id: Optional[str] = None,
                        load_balancer: Optional[str] = None,
                        load_balancer_pool: Optional[str] = None,
                        name: Optional[str] = None,
                        resource_group: Optional[str] = None,
                        tags: Optional[Sequence[str]] = None,
                        timeouts: Optional[IsInstanceGroupTimeoutsArgs] = None)
    func NewIsInstanceGroup(ctx *Context, name string, args IsInstanceGroupArgs, opts ...ResourceOption) (*IsInstanceGroup, error)
    public IsInstanceGroup(string name, IsInstanceGroupArgs args, CustomResourceOptions? opts = null)
    public IsInstanceGroup(String name, IsInstanceGroupArgs args)
    public IsInstanceGroup(String name, IsInstanceGroupArgs args, CustomResourceOptions options)
    
    type: ibm:IsInstanceGroup
    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 IsInstanceGroupArgs
    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 IsInstanceGroupArgs
    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 IsInstanceGroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IsInstanceGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IsInstanceGroupArgs
    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 isInstanceGroupResource = new Ibm.IsInstanceGroup("isInstanceGroupResource", new()
    {
        InstanceTemplate = "string",
        Subnets = new[]
        {
            "string",
        },
        AccessTags = new[]
        {
            "string",
        },
        ApplicationPort = 0,
        InstanceCount = 0,
        IsInstanceGroupId = "string",
        LoadBalancer = "string",
        LoadBalancerPool = "string",
        Name = "string",
        ResourceGroup = "string",
        Tags = new[]
        {
            "string",
        },
        Timeouts = new Ibm.Inputs.IsInstanceGroupTimeoutsArgs
        {
            Create = "string",
            Delete = "string",
            Update = "string",
        },
    });
    
    example, err := ibm.NewIsInstanceGroup(ctx, "isInstanceGroupResource", &ibm.IsInstanceGroupArgs{
    	InstanceTemplate: pulumi.String("string"),
    	Subnets: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	AccessTags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	ApplicationPort:   pulumi.Float64(0),
    	InstanceCount:     pulumi.Float64(0),
    	IsInstanceGroupId: pulumi.String("string"),
    	LoadBalancer:      pulumi.String("string"),
    	LoadBalancerPool:  pulumi.String("string"),
    	Name:              pulumi.String("string"),
    	ResourceGroup:     pulumi.String("string"),
    	Tags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Timeouts: &ibm.IsInstanceGroupTimeoutsArgs{
    		Create: pulumi.String("string"),
    		Delete: pulumi.String("string"),
    		Update: pulumi.String("string"),
    	},
    })
    
    var isInstanceGroupResource = new IsInstanceGroup("isInstanceGroupResource", IsInstanceGroupArgs.builder()
        .instanceTemplate("string")
        .subnets("string")
        .accessTags("string")
        .applicationPort(0)
        .instanceCount(0)
        .isInstanceGroupId("string")
        .loadBalancer("string")
        .loadBalancerPool("string")
        .name("string")
        .resourceGroup("string")
        .tags("string")
        .timeouts(IsInstanceGroupTimeoutsArgs.builder()
            .create("string")
            .delete("string")
            .update("string")
            .build())
        .build());
    
    is_instance_group_resource = ibm.IsInstanceGroup("isInstanceGroupResource",
        instance_template="string",
        subnets=["string"],
        access_tags=["string"],
        application_port=0,
        instance_count=0,
        is_instance_group_id="string",
        load_balancer="string",
        load_balancer_pool="string",
        name="string",
        resource_group="string",
        tags=["string"],
        timeouts={
            "create": "string",
            "delete": "string",
            "update": "string",
        })
    
    const isInstanceGroupResource = new ibm.IsInstanceGroup("isInstanceGroupResource", {
        instanceTemplate: "string",
        subnets: ["string"],
        accessTags: ["string"],
        applicationPort: 0,
        instanceCount: 0,
        isInstanceGroupId: "string",
        loadBalancer: "string",
        loadBalancerPool: "string",
        name: "string",
        resourceGroup: "string",
        tags: ["string"],
        timeouts: {
            create: "string",
            "delete": "string",
            update: "string",
        },
    });
    
    type: ibm:IsInstanceGroup
    properties:
        accessTags:
            - string
        applicationPort: 0
        instanceCount: 0
        instanceTemplate: string
        isInstanceGroupId: string
        loadBalancer: string
        loadBalancerPool: string
        name: string
        resourceGroup: string
        subnets:
            - string
        tags:
            - string
        timeouts:
            create: string
            delete: string
            update: string
    

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

    InstanceTemplate string
    The ID of the instance template to create the instance group.
    Subnets List<string>
    The list of subnet IDs used by the instances.
    AccessTags List<string>

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    ApplicationPort double
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    InstanceCount double

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    IsInstanceGroupId string
    (String) The ID of an instance group.
    LoadBalancer string
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    LoadBalancerPool string
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    Name string
    The instance group name.
    ResourceGroup string
    The resource group ID.
    Tags List<string>
    List of tags for instance group
    Timeouts IsInstanceGroupTimeouts
    InstanceTemplate string
    The ID of the instance template to create the instance group.
    Subnets []string
    The list of subnet IDs used by the instances.
    AccessTags []string

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    ApplicationPort float64
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    InstanceCount float64

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    IsInstanceGroupId string
    (String) The ID of an instance group.
    LoadBalancer string
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    LoadBalancerPool string
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    Name string
    The instance group name.
    ResourceGroup string
    The resource group ID.
    Tags []string
    List of tags for instance group
    Timeouts IsInstanceGroupTimeoutsArgs
    instanceTemplate String
    The ID of the instance template to create the instance group.
    subnets List<String>
    The list of subnet IDs used by the instances.
    accessTags List<String>

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    applicationPort Double
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    instanceCount Double

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    isInstanceGroupId String
    (String) The ID of an instance group.
    loadBalancer String
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    loadBalancerPool String
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    name String
    The instance group name.
    resourceGroup String
    The resource group ID.
    tags List<String>
    List of tags for instance group
    timeouts IsInstanceGroupTimeouts
    instanceTemplate string
    The ID of the instance template to create the instance group.
    subnets string[]
    The list of subnet IDs used by the instances.
    accessTags string[]

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    applicationPort number
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    instanceCount number

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    isInstanceGroupId string
    (String) The ID of an instance group.
    loadBalancer string
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    loadBalancerPool string
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    name string
    The instance group name.
    resourceGroup string
    The resource group ID.
    tags string[]
    List of tags for instance group
    timeouts IsInstanceGroupTimeouts
    instance_template str
    The ID of the instance template to create the instance group.
    subnets Sequence[str]
    The list of subnet IDs used by the instances.
    access_tags Sequence[str]

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    application_port float
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    instance_count float

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    is_instance_group_id str
    (String) The ID of an instance group.
    load_balancer str
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    load_balancer_pool str
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    name str
    The instance group name.
    resource_group str
    The resource group ID.
    tags Sequence[str]
    List of tags for instance group
    timeouts IsInstanceGroupTimeoutsArgs
    instanceTemplate String
    The ID of the instance template to create the instance group.
    subnets List<String>
    The list of subnet IDs used by the instances.
    accessTags List<String>

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    applicationPort Number
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    instanceCount Number

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    isInstanceGroupId String
    (String) The ID of an instance group.
    loadBalancer String
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    loadBalancerPool String
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    name String
    The instance group name.
    resourceGroup String
    The resource group ID.
    tags List<String>
    List of tags for instance group
    timeouts Property Map

    Outputs

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

    Crn string
    (String) The CRN for this instance group.
    Id string
    The provider-assigned unique ID for this managed resource.
    Instances double
    (String) The number of instances in the instances group.
    Managers List<string>
    (String) List of managers associated with the instance group.
    Status string
    (String) Status of an instance group.
    Vpc string
    (String) The VPC ID.
    Crn string
    (String) The CRN for this instance group.
    Id string
    The provider-assigned unique ID for this managed resource.
    Instances float64
    (String) The number of instances in the instances group.
    Managers []string
    (String) List of managers associated with the instance group.
    Status string
    (String) Status of an instance group.
    Vpc string
    (String) The VPC ID.
    crn String
    (String) The CRN for this instance group.
    id String
    The provider-assigned unique ID for this managed resource.
    instances Double
    (String) The number of instances in the instances group.
    managers List<String>
    (String) List of managers associated with the instance group.
    status String
    (String) Status of an instance group.
    vpc String
    (String) The VPC ID.
    crn string
    (String) The CRN for this instance group.
    id string
    The provider-assigned unique ID for this managed resource.
    instances number
    (String) The number of instances in the instances group.
    managers string[]
    (String) List of managers associated with the instance group.
    status string
    (String) Status of an instance group.
    vpc string
    (String) The VPC ID.
    crn str
    (String) The CRN for this instance group.
    id str
    The provider-assigned unique ID for this managed resource.
    instances float
    (String) The number of instances in the instances group.
    managers Sequence[str]
    (String) List of managers associated with the instance group.
    status str
    (String) Status of an instance group.
    vpc str
    (String) The VPC ID.
    crn String
    (String) The CRN for this instance group.
    id String
    The provider-assigned unique ID for this managed resource.
    instances Number
    (String) The number of instances in the instances group.
    managers List<String>
    (String) List of managers associated with the instance group.
    status String
    (String) Status of an instance group.
    vpc String
    (String) The VPC ID.

    Look up Existing IsInstanceGroup Resource

    Get an existing IsInstanceGroup 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?: IsInstanceGroupState, opts?: CustomResourceOptions): IsInstanceGroup
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            access_tags: Optional[Sequence[str]] = None,
            application_port: Optional[float] = None,
            crn: Optional[str] = None,
            instance_count: Optional[float] = None,
            instance_template: Optional[str] = None,
            instances: Optional[float] = None,
            is_instance_group_id: Optional[str] = None,
            load_balancer: Optional[str] = None,
            load_balancer_pool: Optional[str] = None,
            managers: Optional[Sequence[str]] = None,
            name: Optional[str] = None,
            resource_group: Optional[str] = None,
            status: Optional[str] = None,
            subnets: Optional[Sequence[str]] = None,
            tags: Optional[Sequence[str]] = None,
            timeouts: Optional[IsInstanceGroupTimeoutsArgs] = None,
            vpc: Optional[str] = None) -> IsInstanceGroup
    func GetIsInstanceGroup(ctx *Context, name string, id IDInput, state *IsInstanceGroupState, opts ...ResourceOption) (*IsInstanceGroup, error)
    public static IsInstanceGroup Get(string name, Input<string> id, IsInstanceGroupState? state, CustomResourceOptions? opts = null)
    public static IsInstanceGroup get(String name, Output<String> id, IsInstanceGroupState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IsInstanceGroup    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:
    AccessTags List<string>

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    ApplicationPort double
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    Crn string
    (String) The CRN for this instance group.
    InstanceCount double

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    InstanceTemplate string
    The ID of the instance template to create the instance group.
    Instances double
    (String) The number of instances in the instances group.
    IsInstanceGroupId string
    (String) The ID of an instance group.
    LoadBalancer string
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    LoadBalancerPool string
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    Managers List<string>
    (String) List of managers associated with the instance group.
    Name string
    The instance group name.
    ResourceGroup string
    The resource group ID.
    Status string
    (String) Status of an instance group.
    Subnets List<string>
    The list of subnet IDs used by the instances.
    Tags List<string>
    List of tags for instance group
    Timeouts IsInstanceGroupTimeouts
    Vpc string
    (String) The VPC ID.
    AccessTags []string

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    ApplicationPort float64
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    Crn string
    (String) The CRN for this instance group.
    InstanceCount float64

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    InstanceTemplate string
    The ID of the instance template to create the instance group.
    Instances float64
    (String) The number of instances in the instances group.
    IsInstanceGroupId string
    (String) The ID of an instance group.
    LoadBalancer string
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    LoadBalancerPool string
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    Managers []string
    (String) List of managers associated with the instance group.
    Name string
    The instance group name.
    ResourceGroup string
    The resource group ID.
    Status string
    (String) Status of an instance group.
    Subnets []string
    The list of subnet IDs used by the instances.
    Tags []string
    List of tags for instance group
    Timeouts IsInstanceGroupTimeoutsArgs
    Vpc string
    (String) The VPC ID.
    accessTags List<String>

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    applicationPort Double
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    crn String
    (String) The CRN for this instance group.
    instanceCount Double

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    instanceTemplate String
    The ID of the instance template to create the instance group.
    instances Double
    (String) The number of instances in the instances group.
    isInstanceGroupId String
    (String) The ID of an instance group.
    loadBalancer String
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    loadBalancerPool String
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    managers List<String>
    (String) List of managers associated with the instance group.
    name String
    The instance group name.
    resourceGroup String
    The resource group ID.
    status String
    (String) Status of an instance group.
    subnets List<String>
    The list of subnet IDs used by the instances.
    tags List<String>
    List of tags for instance group
    timeouts IsInstanceGroupTimeouts
    vpc String
    (String) The VPC ID.
    accessTags string[]

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    applicationPort number
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    crn string
    (String) The CRN for this instance group.
    instanceCount number

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    instanceTemplate string
    The ID of the instance template to create the instance group.
    instances number
    (String) The number of instances in the instances group.
    isInstanceGroupId string
    (String) The ID of an instance group.
    loadBalancer string
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    loadBalancerPool string
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    managers string[]
    (String) List of managers associated with the instance group.
    name string
    The instance group name.
    resourceGroup string
    The resource group ID.
    status string
    (String) Status of an instance group.
    subnets string[]
    The list of subnet IDs used by the instances.
    tags string[]
    List of tags for instance group
    timeouts IsInstanceGroupTimeouts
    vpc string
    (String) The VPC ID.
    access_tags Sequence[str]

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    application_port float
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    crn str
    (String) The CRN for this instance group.
    instance_count float

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    instance_template str
    The ID of the instance template to create the instance group.
    instances float
    (String) The number of instances in the instances group.
    is_instance_group_id str
    (String) The ID of an instance group.
    load_balancer str
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    load_balancer_pool str
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    managers Sequence[str]
    (String) List of managers associated with the instance group.
    name str
    The instance group name.
    resource_group str
    The resource group ID.
    status str
    (String) Status of an instance group.
    subnets Sequence[str]
    The list of subnet IDs used by the instances.
    tags Sequence[str]
    List of tags for instance group
    timeouts IsInstanceGroupTimeoutsArgs
    vpc str
    (String) The VPC ID.
    accessTags List<String>

    A list of access management tags to attach to the instance group.

    Note: You can attach only those access tags that already exists. For more information, about creating access tags, see working with tags. You must have the access listed in the Granting users access to tag resources for access_tags access_tags must be in the format key:value.

    applicationPort Number
    The instance group uses when scaling up instances to supply the port for the Load Balancer pool member. The load_balancer and load_balancer_pool arguments must be specified when configured.
    crn String
    (String) The CRN for this instance group.
    instanceCount Number

    The number of instances to create in the instance group.

    ~>Note: instance group manager must be in diables state to update the instance_count.

    instanceTemplate String
    The ID of the instance template to create the instance group.
    instances Number
    (String) The number of instances in the instances group.
    isInstanceGroupId String
    (String) The ID of an instance group.
    loadBalancer String
    The load Balancer ID, the application_port and load_balancer_pool arguments must be specified when configured.
    loadBalancerPool String
    The load Balancer pool ID, the application_port and load_balancer arguments must be specified when configured.
    managers List<String>
    (String) List of managers associated with the instance group.
    name String
    The instance group name.
    resourceGroup String
    The resource group ID.
    status String
    (String) Status of an instance group.
    subnets List<String>
    The list of subnet IDs used by the instances.
    tags List<String>
    List of tags for instance group
    timeouts Property Map
    vpc String
    (String) The VPC ID.

    Supporting Types

    IsInstanceGroupTimeouts, IsInstanceGroupTimeoutsArgs

    Create string
    Delete string
    Update string
    Create string
    Delete string
    Update string
    create String
    delete String
    update String
    create string
    delete string
    update string
    create str
    delete str
    update str
    create String
    delete String
    update String

    Import

    The ibm_is_instance_group resource can be imported by using the instance group ID.

    $ pulumi import ibm:index/isInstanceGroup:IsInstanceGroup instance_group r006-14140f94-fcc4-11e9-96e7-a7272asd122112315
    

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

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud