github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/organizations/getOrganizationalUnits.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 organizations
     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  // Get all direct child organizational units under a parent organizational unit. This only provides immediate children, not all children.
    15  //
    16  // ## Example Usage
    17  //
    18  // <!--Start PulumiCodeChooser -->
    19  // ```go
    20  // package main
    21  //
    22  // import (
    23  //
    24  //	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/organizations"
    25  //	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    26  //
    27  // )
    28  //
    29  //	func main() {
    30  //		pulumi.Run(func(ctx *pulumi.Context) error {
    31  //			org, err := organizations.LookupOrganization(ctx, nil, nil)
    32  //			if err != nil {
    33  //				return err
    34  //			}
    35  //			_, err = organizations.GetOrganizationalUnits(ctx, &organizations.GetOrganizationalUnitsArgs{
    36  //				ParentId: org.Roots[0].Id,
    37  //			}, nil)
    38  //			if err != nil {
    39  //				return err
    40  //			}
    41  //			return nil
    42  //		})
    43  //	}
    44  //
    45  // ```
    46  // <!--End PulumiCodeChooser -->
    47  func GetOrganizationalUnits(ctx *pulumi.Context, args *GetOrganizationalUnitsArgs, opts ...pulumi.InvokeOption) (*GetOrganizationalUnitsResult, error) {
    48  	opts = internal.PkgInvokeDefaultOpts(opts)
    49  	var rv GetOrganizationalUnitsResult
    50  	err := ctx.Invoke("aws:organizations/getOrganizationalUnits:getOrganizationalUnits", args, &rv, opts...)
    51  	if err != nil {
    52  		return nil, err
    53  	}
    54  	return &rv, nil
    55  }
    56  
    57  // A collection of arguments for invoking getOrganizationalUnits.
    58  type GetOrganizationalUnitsArgs struct {
    59  	// Parent ID of the organizational unit.
    60  	ParentId string `pulumi:"parentId"`
    61  }
    62  
    63  // A collection of values returned by getOrganizationalUnits.
    64  type GetOrganizationalUnitsResult struct {
    65  	// List of child organizational units, which have the following attributes:
    66  	Children []GetOrganizationalUnitsChild `pulumi:"children"`
    67  	// The provider-assigned unique ID for this managed resource.
    68  	Id       string `pulumi:"id"`
    69  	ParentId string `pulumi:"parentId"`
    70  }
    71  
    72  func GetOrganizationalUnitsOutput(ctx *pulumi.Context, args GetOrganizationalUnitsOutputArgs, opts ...pulumi.InvokeOption) GetOrganizationalUnitsResultOutput {
    73  	return pulumi.ToOutputWithContext(context.Background(), args).
    74  		ApplyT(func(v interface{}) (GetOrganizationalUnitsResult, error) {
    75  			args := v.(GetOrganizationalUnitsArgs)
    76  			r, err := GetOrganizationalUnits(ctx, &args, opts...)
    77  			var s GetOrganizationalUnitsResult
    78  			if r != nil {
    79  				s = *r
    80  			}
    81  			return s, err
    82  		}).(GetOrganizationalUnitsResultOutput)
    83  }
    84  
    85  // A collection of arguments for invoking getOrganizationalUnits.
    86  type GetOrganizationalUnitsOutputArgs struct {
    87  	// Parent ID of the organizational unit.
    88  	ParentId pulumi.StringInput `pulumi:"parentId"`
    89  }
    90  
    91  func (GetOrganizationalUnitsOutputArgs) ElementType() reflect.Type {
    92  	return reflect.TypeOf((*GetOrganizationalUnitsArgs)(nil)).Elem()
    93  }
    94  
    95  // A collection of values returned by getOrganizationalUnits.
    96  type GetOrganizationalUnitsResultOutput struct{ *pulumi.OutputState }
    97  
    98  func (GetOrganizationalUnitsResultOutput) ElementType() reflect.Type {
    99  	return reflect.TypeOf((*GetOrganizationalUnitsResult)(nil)).Elem()
   100  }
   101  
   102  func (o GetOrganizationalUnitsResultOutput) ToGetOrganizationalUnitsResultOutput() GetOrganizationalUnitsResultOutput {
   103  	return o
   104  }
   105  
   106  func (o GetOrganizationalUnitsResultOutput) ToGetOrganizationalUnitsResultOutputWithContext(ctx context.Context) GetOrganizationalUnitsResultOutput {
   107  	return o
   108  }
   109  
   110  // List of child organizational units, which have the following attributes:
   111  func (o GetOrganizationalUnitsResultOutput) Children() GetOrganizationalUnitsChildArrayOutput {
   112  	return o.ApplyT(func(v GetOrganizationalUnitsResult) []GetOrganizationalUnitsChild { return v.Children }).(GetOrganizationalUnitsChildArrayOutput)
   113  }
   114  
   115  // The provider-assigned unique ID for this managed resource.
   116  func (o GetOrganizationalUnitsResultOutput) Id() pulumi.StringOutput {
   117  	return o.ApplyT(func(v GetOrganizationalUnitsResult) string { return v.Id }).(pulumi.StringOutput)
   118  }
   119  
   120  func (o GetOrganizationalUnitsResultOutput) ParentId() pulumi.StringOutput {
   121  	return o.ApplyT(func(v GetOrganizationalUnitsResult) string { return v.ParentId }).(pulumi.StringOutput)
   122  }
   123  
   124  func init() {
   125  	pulumi.RegisterOutputType(GetOrganizationalUnitsResultOutput{})
   126  }