gcp.compute.getInstanceGroupManager
Explore with Pulumi AI
Get a Compute Instance Group Manager within GCE. For more information, see the official documentation and API
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var igm1 = Gcp.Compute.GetInstanceGroupManager.Invoke(new()
{
Name = "my-igm",
Zone = "us-central1-a",
});
var igm2 = Gcp.Compute.GetInstanceGroupManager.Invoke(new()
{
SelfLink = "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm",
});
});
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v7/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := compute.LookupInstanceGroupManager(ctx, &compute.LookupInstanceGroupManagerArgs{
Name: pulumi.StringRef("my-igm"),
Zone: pulumi.StringRef("us-central1-a"),
}, nil)
if err != nil {
return err
}
_, err = compute.LookupInstanceGroupManager(ctx, &compute.LookupInstanceGroupManagerArgs{
SelfLink: pulumi.StringRef("https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm"),
}, nil)
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetInstanceGroupManagerArgs;
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 igm1 = ComputeFunctions.getInstanceGroupManager(GetInstanceGroupManagerArgs.builder()
.name("my-igm")
.zone("us-central1-a")
.build());
final var igm2 = ComputeFunctions.getInstanceGroupManager(GetInstanceGroupManagerArgs.builder()
.selfLink("https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm")
.build());
}
}
import pulumi
import pulumi_gcp as gcp
igm1 = gcp.compute.get_instance_group_manager(name="my-igm",
zone="us-central1-a")
igm2 = gcp.compute.get_instance_group_manager(self_link="https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm")
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const igm1 = gcp.compute.getInstanceGroupManager({
name: "my-igm",
zone: "us-central1-a",
});
const igm2 = gcp.compute.getInstanceGroupManager({
selfLink: "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm",
});
variables:
igm1:
fn::invoke:
Function: gcp:compute:getInstanceGroupManager
Arguments:
name: my-igm
zone: us-central1-a
igm2:
fn::invoke:
Function: gcp:compute:getInstanceGroupManager
Arguments:
selfLink: https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroupManagers/my-igm
Using getInstanceGroupManager
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 getInstanceGroupManager(args: GetInstanceGroupManagerArgs, opts?: InvokeOptions): Promise<GetInstanceGroupManagerResult>
function getInstanceGroupManagerOutput(args: GetInstanceGroupManagerOutputArgs, opts?: InvokeOptions): Output<GetInstanceGroupManagerResult>
def get_instance_group_manager(name: Optional[str] = None,
project: Optional[str] = None,
self_link: Optional[str] = None,
zone: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetInstanceGroupManagerResult
def get_instance_group_manager_output(name: Optional[pulumi.Input[str]] = None,
project: Optional[pulumi.Input[str]] = None,
self_link: Optional[pulumi.Input[str]] = None,
zone: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetInstanceGroupManagerResult]
func LookupInstanceGroupManager(ctx *Context, args *LookupInstanceGroupManagerArgs, opts ...InvokeOption) (*LookupInstanceGroupManagerResult, error)
func LookupInstanceGroupManagerOutput(ctx *Context, args *LookupInstanceGroupManagerOutputArgs, opts ...InvokeOption) LookupInstanceGroupManagerResultOutput
> Note: This function is named LookupInstanceGroupManager
in the Go SDK.
public static class GetInstanceGroupManager
{
public static Task<GetInstanceGroupManagerResult> InvokeAsync(GetInstanceGroupManagerArgs args, InvokeOptions? opts = null)
public static Output<GetInstanceGroupManagerResult> Invoke(GetInstanceGroupManagerInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetInstanceGroupManagerResult> getInstanceGroupManager(GetInstanceGroupManagerArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: gcp:compute/getInstanceGroupManager:getInstanceGroupManager
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
The name of the instance group. Either
name
orself_link
must be provided.- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Self
Link string The self link of the instance group. Either
name
orself_link
must be provided.- Zone string
The zone of the instance group. If referencing the instance group by name and
zone
is not provided, the provider zone is used.
- Name string
The name of the instance group. Either
name
orself_link
must be provided.- Project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Self
Link string The self link of the instance group. Either
name
orself_link
must be provided.- Zone string
The zone of the instance group. If referencing the instance group by name and
zone
is not provided, the provider zone is used.
- name String
The name of the instance group. Either
name
orself_link
must be provided.- project String
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- self
Link String The self link of the instance group. Either
name
orself_link
must be provided.- zone String
The zone of the instance group. If referencing the instance group by name and
zone
is not provided, the provider zone is used.
- name string
The name of the instance group. Either
name
orself_link
must be provided.- project string
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- self
Link string The self link of the instance group. Either
name
orself_link
must be provided.- zone string
The zone of the instance group. If referencing the instance group by name and
zone
is not provided, the provider zone is used.
- name str
The name of the instance group. Either
name
orself_link
must be provided.- project str
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- self_
link str The self link of the instance group. Either
name
orself_link
must be provided.- zone str
The zone of the instance group. If referencing the instance group by name and
zone
is not provided, the provider zone is used.
- name String
The name of the instance group. Either
name
orself_link
must be provided.- project String
The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- self
Link String The self link of the instance group. Either
name
orself_link
must be provided.- zone String
The zone of the instance group. If referencing the instance group by name and
zone
is not provided, the provider zone is used.
getInstanceGroupManager Result
The following output properties are available:
- All
Instances List<GetConfigs Instance Group Manager All Instances Config> - Auto
Healing List<GetPolicies Instance Group Manager Auto Healing Policy> - Base
Instance stringName - Description string
- Fingerprint string
- Id string
The provider-assigned unique ID for this managed resource.
- Instance
Group string - Instance
Lifecycle List<GetPolicies Instance Group Manager Instance Lifecycle Policy> - List
Managed stringInstances Results - Named
Ports List<GetInstance Group Manager Named Port> - Operation string
- Stateful
Disks List<GetInstance Group Manager Stateful Disk> - Stateful
External List<GetIps Instance Group Manager Stateful External Ip> - Stateful
Internal List<GetIps Instance Group Manager Stateful Internal Ip> - Statuses
List<Get
Instance Group Manager Status> - Target
Pools List<string> - Target
Size int - Update
Policies List<GetInstance Group Manager Update Policy> - Versions
List<Get
Instance Group Manager Version> - Wait
For boolInstances - Wait
For stringInstances Status - Name string
- Project string
- Self
Link string - Zone string
- All
Instances []GetConfigs Instance Group Manager All Instances Config - Auto
Healing []GetPolicies Instance Group Manager Auto Healing Policy - Base
Instance stringName - Description string
- Fingerprint string
- Id string
The provider-assigned unique ID for this managed resource.
- Instance
Group string - Instance
Lifecycle []GetPolicies Instance Group Manager Instance Lifecycle Policy - List
Managed stringInstances Results - Named
Ports []GetInstance Group Manager Named Port - Operation string
- Stateful
Disks []GetInstance Group Manager Stateful Disk - Stateful
External []GetIps Instance Group Manager Stateful External Ip - Stateful
Internal []GetIps Instance Group Manager Stateful Internal Ip - Statuses
[]Get
Instance Group Manager Status - Target
Pools []string - Target
Size int - Update
Policies []GetInstance Group Manager Update Policy - Versions
[]Get
Instance Group Manager Version - Wait
For boolInstances - Wait
For stringInstances Status - Name string
- Project string
- Self
Link string - Zone string
- all
Instances List<GetConfigs Instance Group Manager All Instances Config> - auto
Healing List<GetPolicies Instance Group Manager Auto Healing Policy> - base
Instance StringName - description String
- fingerprint String
- id String
The provider-assigned unique ID for this managed resource.
- instance
Group String - instance
Lifecycle List<GetPolicies Instance Group Manager Instance Lifecycle Policy> - list
Managed StringInstances Results - named
Ports List<GetInstance Group Manager Named Port> - operation String
- stateful
Disks List<GetInstance Group Manager Stateful Disk> - stateful
External List<GetIps Instance Group Manager Stateful External Ip> - stateful
Internal List<GetIps Instance Group Manager Stateful Internal Ip> - statuses
List<Get
Instance Group Manager Status> - target
Pools List<String> - target
Size Integer - update
Policies List<GetInstance Group Manager Update Policy> - versions
List<Get
Instance Group Manager Version> - wait
For BooleanInstances - wait
For StringInstances Status - name String
- project String
- self
Link String - zone String
- all
Instances GetConfigs Instance Group Manager All Instances Config[] - auto
Healing GetPolicies Instance Group Manager Auto Healing Policy[] - base
Instance stringName - description string
- fingerprint string
- id string
The provider-assigned unique ID for this managed resource.
- instance
Group string - instance
Lifecycle GetPolicies Instance Group Manager Instance Lifecycle Policy[] - list
Managed stringInstances Results - named
Ports GetInstance Group Manager Named Port[] - operation string
- stateful
Disks GetInstance Group Manager Stateful Disk[] - stateful
External GetIps Instance Group Manager Stateful External Ip[] - stateful
Internal GetIps Instance Group Manager Stateful Internal Ip[] - statuses
Get
Instance Group Manager Status[] - target
Pools string[] - target
Size number - update
Policies GetInstance Group Manager Update Policy[] - versions
Get
Instance Group Manager Version[] - wait
For booleanInstances - wait
For stringInstances Status - name string
- project string
- self
Link string - zone string
- all_
instances_ Sequence[Getconfigs Instance Group Manager All Instances Config] - auto_
healing_ Sequence[Getpolicies Instance Group Manager Auto Healing Policy] - base_
instance_ strname - description str
- fingerprint str
- id str
The provider-assigned unique ID for this managed resource.
- instance_
group str - instance_
lifecycle_ Sequence[Getpolicies Instance Group Manager Instance Lifecycle Policy] - list_
managed_ strinstances_ results - named_
ports Sequence[GetInstance Group Manager Named Port] - operation str
- stateful_
disks Sequence[GetInstance Group Manager Stateful Disk] - stateful_
external_ Sequence[Getips Instance Group Manager Stateful External Ip] - stateful_
internal_ Sequence[Getips Instance Group Manager Stateful Internal Ip] - statuses
Sequence[Get
Instance Group Manager Status] - target_
pools Sequence[str] - target_
size int - update_
policies Sequence[GetInstance Group Manager Update Policy] - versions
Sequence[Get
Instance Group Manager Version] - wait_
for_ boolinstances - wait_
for_ strinstances_ status - name str
- project str
- self_
link str - zone str
- all
Instances List<Property Map>Configs - auto
Healing List<Property Map>Policies - base
Instance StringName - description String
- fingerprint String
- id String
The provider-assigned unique ID for this managed resource.
- instance
Group String - instance
Lifecycle List<Property Map>Policies - list
Managed StringInstances Results - named
Ports List<Property Map> - operation String
- stateful
Disks List<Property Map> - stateful
External List<Property Map>Ips - stateful
Internal List<Property Map>Ips - statuses List<Property Map>
- target
Pools List<String> - target
Size Number - update
Policies List<Property Map> - versions List<Property Map>
- wait
For BooleanInstances - wait
For StringInstances Status - name String
- project String
- self
Link String - zone String
Supporting Types
GetInstanceGroupManagerAllInstancesConfig
GetInstanceGroupManagerAutoHealingPolicy
- Health
Check string - Initial
Delay intSec
- Health
Check string - Initial
Delay intSec
- health
Check String - initial
Delay IntegerSec
- health
Check string - initial
Delay numberSec
- health_
check str - initial_
delay_ intsec
- health
Check String - initial
Delay NumberSec
GetInstanceGroupManagerInstanceLifecyclePolicy
- Force
Update stringOn Repair
- Force
Update stringOn Repair
- force
Update StringOn Repair
- force
Update stringOn Repair
- force
Update StringOn Repair
GetInstanceGroupManagerNamedPort
GetInstanceGroupManagerStatefulDisk
- Delete
Rule string - Device
Name string
- Delete
Rule string - Device
Name string
- delete
Rule String - device
Name String
- delete
Rule string - device
Name string
- delete_
rule str - device_
name str
- delete
Rule String - device
Name String
GetInstanceGroupManagerStatefulExternalIp
- Delete
Rule string - Interface
Name string
- Delete
Rule string - Interface
Name string
- delete
Rule String - interface
Name String
- delete
Rule string - interface
Name string
- delete_
rule str - interface_
name str
- delete
Rule String - interface
Name String
GetInstanceGroupManagerStatefulInternalIp
- Delete
Rule string - Interface
Name string
- Delete
Rule string - Interface
Name string
- delete
Rule String - interface
Name String
- delete
Rule string - interface
Name string
- delete_
rule str - interface_
name str
- delete
Rule String - interface
Name String
GetInstanceGroupManagerStatus
GetInstanceGroupManagerStatusAllInstancesConfig
- Effective bool
- Effective bool
- effective Boolean
- effective boolean
- effective bool
- effective Boolean
GetInstanceGroupManagerStatusStateful
GetInstanceGroupManagerStatusStatefulPerInstanceConfig
- All
Effective bool
- All
Effective bool
- all
Effective Boolean
- all
Effective boolean
- all_
effective bool
- all
Effective Boolean
GetInstanceGroupManagerStatusVersionTarget
- Is
Reached bool
- Is
Reached bool
- is
Reached Boolean
- is
Reached boolean
- is_
reached bool
- is
Reached Boolean
GetInstanceGroupManagerUpdatePolicy
- Max
Surge intFixed - Max
Surge intPercent - int
- int
- Min
Ready intSec - Minimal
Action string - Most
Disruptive stringAllowed Action - Replacement
Method string - Type string
- Max
Surge intFixed - Max
Surge intPercent - int
- int
- Min
Ready intSec - Minimal
Action string - Most
Disruptive stringAllowed Action - Replacement
Method string - Type string
- max
Surge IntegerFixed - max
Surge IntegerPercent - Integer
- Integer
- min
Ready IntegerSec - minimal
Action String - most
Disruptive StringAllowed Action - replacement
Method String - type String
- max
Surge numberFixed - max
Surge numberPercent - number
- number
- min
Ready numberSec - minimal
Action string - most
Disruptive stringAllowed Action - replacement
Method string - type string
- max_
surge_ intfixed - max_
surge_ intpercent - int
- int
- min_
ready_ intsec - minimal_
action str - most_
disruptive_ strallowed_ action - replacement_
method str - type str
- max
Surge NumberFixed - max
Surge NumberPercent - Number
- Number
- min
Ready NumberSec - minimal
Action String - most
Disruptive StringAllowed Action - replacement
Method String - type String
GetInstanceGroupManagerVersion
- Instance
Template string - Name string
The name of the instance group. Either
name
orself_link
must be provided.- Target
Sizes List<GetInstance Group Manager Version Target Size>
- Instance
Template string - Name string
The name of the instance group. Either
name
orself_link
must be provided.- Target
Sizes []GetInstance Group Manager Version Target Size
- instance
Template String - name String
The name of the instance group. Either
name
orself_link
must be provided.- target
Sizes List<GetInstance Group Manager Version Target Size>
- instance
Template string - name string
The name of the instance group. Either
name
orself_link
must be provided.- target
Sizes GetInstance Group Manager Version Target Size[]
- instance_
template str - name str
The name of the instance group. Either
name
orself_link
must be provided.- target_
sizes Sequence[GetInstance Group Manager Version Target Size]
- instance
Template String - name String
The name of the instance group. Either
name
orself_link
must be provided.- target
Sizes List<Property Map>
GetInstanceGroupManagerVersionTargetSize
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
google-beta
Terraform Provider.