github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/connect/getUserHierarchyGroup.go (about)

     1  // Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
     2  // *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***
     3  
     4  package connect
     5  
     6  import (
     7  	"context"
     8  	"reflect"
     9  
    10  	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
    11  	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    12  )
    13  
    14  // Provides details about a specific Amazon Connect User Hierarchy Group.
    15  //
    16  // ## Example Usage
    17  //
    18  // By `name`
    19  //
    20  // <!--Start PulumiCodeChooser -->
    21  // ```go
    22  // package main
    23  //
    24  // import (
    25  //
    26  //	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/connect"
    27  //	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    28  //
    29  // )
    30  //
    31  //	func main() {
    32  //		pulumi.Run(func(ctx *pulumi.Context) error {
    33  //			_, err := connect.LookupUserHierarchyGroup(ctx, &connect.LookupUserHierarchyGroupArgs{
    34  //				InstanceId: "aaaaaaaa-bbbb-cccc-dddd-111111111111",
    35  //				Name:       pulumi.StringRef("Example"),
    36  //			}, nil)
    37  //			if err != nil {
    38  //				return err
    39  //			}
    40  //			return nil
    41  //		})
    42  //	}
    43  //
    44  // ```
    45  // <!--End PulumiCodeChooser -->
    46  //
    47  // By `hierarchyGroupId`
    48  //
    49  // <!--Start PulumiCodeChooser -->
    50  // ```go
    51  // package main
    52  //
    53  // import (
    54  //
    55  //	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/connect"
    56  //	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    57  //
    58  // )
    59  //
    60  //	func main() {
    61  //		pulumi.Run(func(ctx *pulumi.Context) error {
    62  //			_, err := connect.LookupUserHierarchyGroup(ctx, &connect.LookupUserHierarchyGroupArgs{
    63  //				InstanceId:       "aaaaaaaa-bbbb-cccc-dddd-111111111111",
    64  //				HierarchyGroupId: pulumi.StringRef("cccccccc-bbbb-cccc-dddd-111111111111"),
    65  //			}, nil)
    66  //			if err != nil {
    67  //				return err
    68  //			}
    69  //			return nil
    70  //		})
    71  //	}
    72  //
    73  // ```
    74  // <!--End PulumiCodeChooser -->
    75  func LookupUserHierarchyGroup(ctx *pulumi.Context, args *LookupUserHierarchyGroupArgs, opts ...pulumi.InvokeOption) (*LookupUserHierarchyGroupResult, error) {
    76  	opts = internal.PkgInvokeDefaultOpts(opts)
    77  	var rv LookupUserHierarchyGroupResult
    78  	err := ctx.Invoke("aws:connect/getUserHierarchyGroup:getUserHierarchyGroup", args, &rv, opts...)
    79  	if err != nil {
    80  		return nil, err
    81  	}
    82  	return &rv, nil
    83  }
    84  
    85  // A collection of arguments for invoking getUserHierarchyGroup.
    86  type LookupUserHierarchyGroupArgs struct {
    87  	// Returns information on a specific hierarchy group by hierarchy group id
    88  	HierarchyGroupId *string `pulumi:"hierarchyGroupId"`
    89  	// Reference to the hosting Amazon Connect Instance
    90  	InstanceId string `pulumi:"instanceId"`
    91  	// Returns information on a specific hierarchy group by name
    92  	Name *string `pulumi:"name"`
    93  	// Map of tags to assign to the hierarchy group.
    94  	Tags map[string]string `pulumi:"tags"`
    95  }
    96  
    97  // A collection of values returned by getUserHierarchyGroup.
    98  type LookupUserHierarchyGroupResult struct {
    99  	// ARN of the hierarchy group.
   100  	Arn              string `pulumi:"arn"`
   101  	HierarchyGroupId string `pulumi:"hierarchyGroupId"`
   102  	// Block that contains information about the levels in the hierarchy group. The `hierarchyPath` block is documented below.
   103  	HierarchyPaths []GetUserHierarchyGroupHierarchyPath `pulumi:"hierarchyPaths"`
   104  	// The provider-assigned unique ID for this managed resource.
   105  	Id         string `pulumi:"id"`
   106  	InstanceId string `pulumi:"instanceId"`
   107  	// Identifier of the level in the hierarchy group.
   108  	LevelId string `pulumi:"levelId"`
   109  	// Name of the hierarchy group.
   110  	Name string `pulumi:"name"`
   111  	// Map of tags to assign to the hierarchy group.
   112  	Tags map[string]string `pulumi:"tags"`
   113  }
   114  
   115  func LookupUserHierarchyGroupOutput(ctx *pulumi.Context, args LookupUserHierarchyGroupOutputArgs, opts ...pulumi.InvokeOption) LookupUserHierarchyGroupResultOutput {
   116  	return pulumi.ToOutputWithContext(context.Background(), args).
   117  		ApplyT(func(v interface{}) (LookupUserHierarchyGroupResult, error) {
   118  			args := v.(LookupUserHierarchyGroupArgs)
   119  			r, err := LookupUserHierarchyGroup(ctx, &args, opts...)
   120  			var s LookupUserHierarchyGroupResult
   121  			if r != nil {
   122  				s = *r
   123  			}
   124  			return s, err
   125  		}).(LookupUserHierarchyGroupResultOutput)
   126  }
   127  
   128  // A collection of arguments for invoking getUserHierarchyGroup.
   129  type LookupUserHierarchyGroupOutputArgs struct {
   130  	// Returns information on a specific hierarchy group by hierarchy group id
   131  	HierarchyGroupId pulumi.StringPtrInput `pulumi:"hierarchyGroupId"`
   132  	// Reference to the hosting Amazon Connect Instance
   133  	InstanceId pulumi.StringInput `pulumi:"instanceId"`
   134  	// Returns information on a specific hierarchy group by name
   135  	Name pulumi.StringPtrInput `pulumi:"name"`
   136  	// Map of tags to assign to the hierarchy group.
   137  	Tags pulumi.StringMapInput `pulumi:"tags"`
   138  }
   139  
   140  func (LookupUserHierarchyGroupOutputArgs) ElementType() reflect.Type {
   141  	return reflect.TypeOf((*LookupUserHierarchyGroupArgs)(nil)).Elem()
   142  }
   143  
   144  // A collection of values returned by getUserHierarchyGroup.
   145  type LookupUserHierarchyGroupResultOutput struct{ *pulumi.OutputState }
   146  
   147  func (LookupUserHierarchyGroupResultOutput) ElementType() reflect.Type {
   148  	return reflect.TypeOf((*LookupUserHierarchyGroupResult)(nil)).Elem()
   149  }
   150  
   151  func (o LookupUserHierarchyGroupResultOutput) ToLookupUserHierarchyGroupResultOutput() LookupUserHierarchyGroupResultOutput {
   152  	return o
   153  }
   154  
   155  func (o LookupUserHierarchyGroupResultOutput) ToLookupUserHierarchyGroupResultOutputWithContext(ctx context.Context) LookupUserHierarchyGroupResultOutput {
   156  	return o
   157  }
   158  
   159  // ARN of the hierarchy group.
   160  func (o LookupUserHierarchyGroupResultOutput) Arn() pulumi.StringOutput {
   161  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) string { return v.Arn }).(pulumi.StringOutput)
   162  }
   163  
   164  func (o LookupUserHierarchyGroupResultOutput) HierarchyGroupId() pulumi.StringOutput {
   165  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) string { return v.HierarchyGroupId }).(pulumi.StringOutput)
   166  }
   167  
   168  // Block that contains information about the levels in the hierarchy group. The `hierarchyPath` block is documented below.
   169  func (o LookupUserHierarchyGroupResultOutput) HierarchyPaths() GetUserHierarchyGroupHierarchyPathArrayOutput {
   170  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) []GetUserHierarchyGroupHierarchyPath { return v.HierarchyPaths }).(GetUserHierarchyGroupHierarchyPathArrayOutput)
   171  }
   172  
   173  // The provider-assigned unique ID for this managed resource.
   174  func (o LookupUserHierarchyGroupResultOutput) Id() pulumi.StringOutput {
   175  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) string { return v.Id }).(pulumi.StringOutput)
   176  }
   177  
   178  func (o LookupUserHierarchyGroupResultOutput) InstanceId() pulumi.StringOutput {
   179  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) string { return v.InstanceId }).(pulumi.StringOutput)
   180  }
   181  
   182  // Identifier of the level in the hierarchy group.
   183  func (o LookupUserHierarchyGroupResultOutput) LevelId() pulumi.StringOutput {
   184  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) string { return v.LevelId }).(pulumi.StringOutput)
   185  }
   186  
   187  // Name of the hierarchy group.
   188  func (o LookupUserHierarchyGroupResultOutput) Name() pulumi.StringOutput {
   189  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) string { return v.Name }).(pulumi.StringOutput)
   190  }
   191  
   192  // Map of tags to assign to the hierarchy group.
   193  func (o LookupUserHierarchyGroupResultOutput) Tags() pulumi.StringMapOutput {
   194  	return o.ApplyT(func(v LookupUserHierarchyGroupResult) map[string]string { return v.Tags }).(pulumi.StringMapOutput)
   195  }
   196  
   197  func init() {
   198  	pulumi.RegisterOutputType(LookupUserHierarchyGroupResultOutput{})
   199  }