1. Packages
  2. Google Cloud (GCP) Classic
  3. API Docs
  4. compute
  5. getInstanceIamPolicy
Google Cloud Classic v7.26.0 published on Friday, Jun 7, 2024 by Pulumi

gcp.compute.getInstanceIamPolicy

Explore with Pulumi AI

gcp logo
Google Cloud Classic v7.26.0 published on Friday, Jun 7, 2024 by Pulumi

    Retrieves the current IAM policy data for instance

    example

    import * as pulumi from "@pulumi/pulumi";
    import * as gcp from "@pulumi/gcp";
    
    const policy = gcp.compute.getInstanceIamPolicy({
        project: _default.project,
        zone: _default.zone,
        instanceName: _default.name,
    });
    
    import pulumi
    import pulumi_gcp as gcp
    
    policy = gcp.compute.get_instance_iam_policy(project=default["project"],
        zone=default["zone"],
        instance_name=default["name"])
    
    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.GetInstanceIamPolicy(ctx, &compute.GetInstanceIamPolicyArgs{
    			Project:      pulumi.StringRef(_default.Project),
    			Zone:         pulumi.StringRef(_default.Zone),
    			InstanceName: _default.Name,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcp = Pulumi.Gcp;
    
    return await Deployment.RunAsync(() => 
    {
        var policy = Gcp.Compute.GetInstanceIamPolicy.Invoke(new()
        {
            Project = @default.Project,
            Zone = @default.Zone,
            InstanceName = @default.Name,
        });
    
    });
    
    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.GetInstanceIamPolicyArgs;
    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 policy = ComputeFunctions.getInstanceIamPolicy(GetInstanceIamPolicyArgs.builder()
                .project(default_.project())
                .zone(default_.zone())
                .instanceName(default_.name())
                .build());
    
        }
    }
    
    variables:
      policy:
        fn::invoke:
          Function: gcp:compute:getInstanceIamPolicy
          Arguments:
            project: ${default.project}
            zone: ${default.zone}
            instanceName: ${default.name}
    

    Using getInstanceIamPolicy

    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 getInstanceIamPolicy(args: GetInstanceIamPolicyArgs, opts?: InvokeOptions): Promise<GetInstanceIamPolicyResult>
    function getInstanceIamPolicyOutput(args: GetInstanceIamPolicyOutputArgs, opts?: InvokeOptions): Output<GetInstanceIamPolicyResult>
    def get_instance_iam_policy(instance_name: Optional[str] = None,
                                project: Optional[str] = None,
                                zone: Optional[str] = None,
                                opts: Optional[InvokeOptions] = None) -> GetInstanceIamPolicyResult
    def get_instance_iam_policy_output(instance_name: Optional[pulumi.Input[str]] = None,
                                project: Optional[pulumi.Input[str]] = None,
                                zone: Optional[pulumi.Input[str]] = None,
                                opts: Optional[InvokeOptions] = None) -> Output[GetInstanceIamPolicyResult]
    func GetInstanceIamPolicy(ctx *Context, args *GetInstanceIamPolicyArgs, opts ...InvokeOption) (*GetInstanceIamPolicyResult, error)
    func GetInstanceIamPolicyOutput(ctx *Context, args *GetInstanceIamPolicyOutputArgs, opts ...InvokeOption) GetInstanceIamPolicyResultOutput

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

    public static class GetInstanceIamPolicy 
    {
        public static Task<GetInstanceIamPolicyResult> InvokeAsync(GetInstanceIamPolicyArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceIamPolicyResult> Invoke(GetInstanceIamPolicyInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetInstanceIamPolicyResult> getInstanceIamPolicy(GetInstanceIamPolicyArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: gcp:compute/getInstanceIamPolicy:getInstanceIamPolicy
      arguments:
        # arguments dictionary

    The following arguments are supported:

    InstanceName string
    Used to find the parent resource to bind the IAM policy to
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
    Zone string
    A reference to the zone where the machine resides. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no zone is provided in the parent identifier and no zone is specified, it is taken from the provider configuration.
    InstanceName string
    Used to find the parent resource to bind the IAM policy to
    Project string
    The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
    Zone string
    A reference to the zone where the machine resides. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no zone is provided in the parent identifier and no zone is specified, it is taken from the provider configuration.
    instanceName String
    Used to find the parent resource to bind the IAM policy to
    project String
    The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
    zone String
    A reference to the zone where the machine resides. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no zone is provided in the parent identifier and no zone is specified, it is taken from the provider configuration.
    instanceName string
    Used to find the parent resource to bind the IAM policy to
    project string
    The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
    zone string
    A reference to the zone where the machine resides. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no zone is provided in the parent identifier and no zone is specified, it is taken from the provider configuration.
    instance_name str
    Used to find the parent resource to bind the IAM policy to
    project str
    The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
    zone str
    A reference to the zone where the machine resides. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no zone is provided in the parent identifier and no zone is specified, it is taken from the provider configuration.
    instanceName String
    Used to find the parent resource to bind the IAM policy to
    project String
    The ID of the project in which the resource belongs. If it is not provided, the project will be parsed from the identifier of the parent resource. If no project is provided in the parent identifier and no project is specified, the provider project is used.
    zone String
    A reference to the zone where the machine resides. Used to find the parent resource to bind the IAM policy to. If not specified, the value will be parsed from the identifier of the parent resource. If no zone is provided in the parent identifier and no zone is specified, it is taken from the provider configuration.

    getInstanceIamPolicy Result

    The following output properties are available:

    Etag string
    (Computed) The etag of the IAM policy.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceName string
    PolicyData string
    (Required only by gcp.compute.InstanceIAMPolicy) The policy data generated by a gcp.organizations.getIAMPolicy data source.
    Project string
    Zone string
    Etag string
    (Computed) The etag of the IAM policy.
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceName string
    PolicyData string
    (Required only by gcp.compute.InstanceIAMPolicy) The policy data generated by a gcp.organizations.getIAMPolicy data source.
    Project string
    Zone string
    etag String
    (Computed) The etag of the IAM policy.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceName String
    policyData String
    (Required only by gcp.compute.InstanceIAMPolicy) The policy data generated by a gcp.organizations.getIAMPolicy data source.
    project String
    zone String
    etag string
    (Computed) The etag of the IAM policy.
    id string
    The provider-assigned unique ID for this managed resource.
    instanceName string
    policyData string
    (Required only by gcp.compute.InstanceIAMPolicy) The policy data generated by a gcp.organizations.getIAMPolicy data source.
    project string
    zone string
    etag str
    (Computed) The etag of the IAM policy.
    id str
    The provider-assigned unique ID for this managed resource.
    instance_name str
    policy_data str
    (Required only by gcp.compute.InstanceIAMPolicy) The policy data generated by a gcp.organizations.getIAMPolicy data source.
    project str
    zone str
    etag String
    (Computed) The etag of the IAM policy.
    id String
    The provider-assigned unique ID for this managed resource.
    instanceName String
    policyData String
    (Required only by gcp.compute.InstanceIAMPolicy) The policy data generated by a gcp.organizations.getIAMPolicy data source.
    project String
    zone String

    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.
    gcp logo
    Google Cloud Classic v7.26.0 published on Friday, Jun 7, 2024 by Pulumi