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

ibm.getIamAccessTag

Explore with Pulumi AI

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

    Retrieve an existing IBM Cloud access management tag as a read-only data source. For more information, about access tags, see IBM Cloud access management tags.

    Example Usage

    Sample to retrieve an access tag

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const exampleAccessTag = ibm.getIamAccessTag({
        name: _var.access_tag_name,
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    example_access_tag = ibm.get_iam_access_tag(name=var["access_tag_name"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.LookupIamAccessTag(ctx, &ibm.LookupIamAccessTagArgs{
    			Name: _var.Access_tag_name,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var exampleAccessTag = Ibm.GetIamAccessTag.Invoke(new()
        {
            Name = @var.Access_tag_name,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IbmFunctions;
    import com.pulumi.ibm.inputs.GetIamAccessTagArgs;
    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 exampleAccessTag = IbmFunctions.getIamAccessTag(GetIamAccessTagArgs.builder()
                .name(var_.access_tag_name())
                .build());
    
        }
    }
    
    variables:
      exampleAccessTag:
        fn::invoke:
          function: ibm:getIamAccessTag
          arguments:
            name: ${var.access_tag_name}
    

    Attributes reference

    In addition to all argument reference list, you can access the following attribute references after your data source is created.

    • id - (String) The unique identifier of the access tag. Same as name.
    • tag_type - (String) Type of the tag(access)

    Using getIamAccessTag

    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 getIamAccessTag(args: GetIamAccessTagArgs, opts?: InvokeOptions): Promise<GetIamAccessTagResult>
    function getIamAccessTagOutput(args: GetIamAccessTagOutputArgs, opts?: InvokeOptions): Output<GetIamAccessTagResult>
    def get_iam_access_tag(id: Optional[str] = None,
                           name: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetIamAccessTagResult
    def get_iam_access_tag_output(id: Optional[pulumi.Input[str]] = None,
                           name: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetIamAccessTagResult]
    func LookupIamAccessTag(ctx *Context, args *LookupIamAccessTagArgs, opts ...InvokeOption) (*LookupIamAccessTagResult, error)
    func LookupIamAccessTagOutput(ctx *Context, args *LookupIamAccessTagOutputArgs, opts ...InvokeOption) LookupIamAccessTagResultOutput

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

    public static class GetIamAccessTag 
    {
        public static Task<GetIamAccessTagResult> InvokeAsync(GetIamAccessTagArgs args, InvokeOptions? opts = null)
        public static Output<GetIamAccessTagResult> Invoke(GetIamAccessTagInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetIamAccessTagResult> getIamAccessTag(GetIamAccessTagArgs args, InvokeOptions options)
    public static Output<GetIamAccessTagResult> getIamAccessTag(GetIamAccessTagArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getIamAccessTag:getIamAccessTag
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Name string
    The name of the access management tag.
    Id string
    Name string
    The name of the access management tag.
    Id string
    name String
    The name of the access management tag.
    id String
    name string
    The name of the access management tag.
    id string
    name str
    The name of the access management tag.
    id str
    name String
    The name of the access management tag.
    id String

    getIamAccessTag Result

    The following output properties are available:

    Id string
    Name string
    TagType string
    Id string
    Name string
    TagType string
    id String
    name String
    tagType String
    id string
    name string
    tagType string
    id str
    name str
    tag_type str
    id String
    name String
    tagType String

    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