github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/networkmanager/globalNetwork.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 networkmanager
     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 a global network resource.
    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/networkmanager"
    25  //	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    26  //
    27  // )
    28  //
    29  //	func main() {
    30  //		pulumi.Run(func(ctx *pulumi.Context) error {
    31  //			_, err := networkmanager.NewGlobalNetwork(ctx, "example", &networkmanager.GlobalNetworkArgs{
    32  //				Description: pulumi.String("example"),
    33  //			})
    34  //			if err != nil {
    35  //				return err
    36  //			}
    37  //			return nil
    38  //		})
    39  //	}
    40  //
    41  // ```
    42  // <!--End PulumiCodeChooser -->
    43  //
    44  // ## Import
    45  //
    46  // Using `pulumi import`, import `aws_networkmanager_global_network` using the global network ID. For example:
    47  //
    48  // ```sh
    49  // $ pulumi import aws:networkmanager/globalNetwork:GlobalNetwork example global-network-0d47f6t230mz46dy4
    50  // ```
    51  type GlobalNetwork struct {
    52  	pulumi.CustomResourceState
    53  
    54  	// Global Network Amazon Resource Name (ARN)
    55  	Arn pulumi.StringOutput `pulumi:"arn"`
    56  	// Description of the Global Network.
    57  	Description pulumi.StringPtrOutput `pulumi:"description"`
    58  	// Key-value tags for the Global Network. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    59  	Tags pulumi.StringMapOutput `pulumi:"tags"`
    60  	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
    61  	//
    62  	// Deprecated: Please use `tags` instead.
    63  	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
    64  }
    65  
    66  // NewGlobalNetwork registers a new resource with the given unique name, arguments, and options.
    67  func NewGlobalNetwork(ctx *pulumi.Context,
    68  	name string, args *GlobalNetworkArgs, opts ...pulumi.ResourceOption) (*GlobalNetwork, error) {
    69  	if args == nil {
    70  		args = &GlobalNetworkArgs{}
    71  	}
    72  
    73  	opts = internal.PkgResourceDefaultOpts(opts)
    74  	var resource GlobalNetwork
    75  	err := ctx.RegisterResource("aws:networkmanager/globalNetwork:GlobalNetwork", name, args, &resource, opts...)
    76  	if err != nil {
    77  		return nil, err
    78  	}
    79  	return &resource, nil
    80  }
    81  
    82  // GetGlobalNetwork gets an existing GlobalNetwork resource's state with the given name, ID, and optional
    83  // state properties that are used to uniquely qualify the lookup (nil if not required).
    84  func GetGlobalNetwork(ctx *pulumi.Context,
    85  	name string, id pulumi.IDInput, state *GlobalNetworkState, opts ...pulumi.ResourceOption) (*GlobalNetwork, error) {
    86  	var resource GlobalNetwork
    87  	err := ctx.ReadResource("aws:networkmanager/globalNetwork:GlobalNetwork", name, id, state, &resource, opts...)
    88  	if err != nil {
    89  		return nil, err
    90  	}
    91  	return &resource, nil
    92  }
    93  
    94  // Input properties used for looking up and filtering GlobalNetwork resources.
    95  type globalNetworkState struct {
    96  	// Global Network Amazon Resource Name (ARN)
    97  	Arn *string `pulumi:"arn"`
    98  	// Description of the Global Network.
    99  	Description *string `pulumi:"description"`
   100  	// Key-value tags for the Global Network. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
   101  	Tags map[string]string `pulumi:"tags"`
   102  	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
   103  	//
   104  	// Deprecated: Please use `tags` instead.
   105  	TagsAll map[string]string `pulumi:"tagsAll"`
   106  }
   107  
   108  type GlobalNetworkState struct {
   109  	// Global Network Amazon Resource Name (ARN)
   110  	Arn pulumi.StringPtrInput
   111  	// Description of the Global Network.
   112  	Description pulumi.StringPtrInput
   113  	// Key-value tags for the Global Network. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
   114  	Tags pulumi.StringMapInput
   115  	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
   116  	//
   117  	// Deprecated: Please use `tags` instead.
   118  	TagsAll pulumi.StringMapInput
   119  }
   120  
   121  func (GlobalNetworkState) ElementType() reflect.Type {
   122  	return reflect.TypeOf((*globalNetworkState)(nil)).Elem()
   123  }
   124  
   125  type globalNetworkArgs struct {
   126  	// Description of the Global Network.
   127  	Description *string `pulumi:"description"`
   128  	// Key-value tags for the Global Network. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
   129  	Tags map[string]string `pulumi:"tags"`
   130  }
   131  
   132  // The set of arguments for constructing a GlobalNetwork resource.
   133  type GlobalNetworkArgs struct {
   134  	// Description of the Global Network.
   135  	Description pulumi.StringPtrInput
   136  	// Key-value tags for the Global Network. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
   137  	Tags pulumi.StringMapInput
   138  }
   139  
   140  func (GlobalNetworkArgs) ElementType() reflect.Type {
   141  	return reflect.TypeOf((*globalNetworkArgs)(nil)).Elem()
   142  }
   143  
   144  type GlobalNetworkInput interface {
   145  	pulumi.Input
   146  
   147  	ToGlobalNetworkOutput() GlobalNetworkOutput
   148  	ToGlobalNetworkOutputWithContext(ctx context.Context) GlobalNetworkOutput
   149  }
   150  
   151  func (*GlobalNetwork) ElementType() reflect.Type {
   152  	return reflect.TypeOf((**GlobalNetwork)(nil)).Elem()
   153  }
   154  
   155  func (i *GlobalNetwork) ToGlobalNetworkOutput() GlobalNetworkOutput {
   156  	return i.ToGlobalNetworkOutputWithContext(context.Background())
   157  }
   158  
   159  func (i *GlobalNetwork) ToGlobalNetworkOutputWithContext(ctx context.Context) GlobalNetworkOutput {
   160  	return pulumi.ToOutputWithContext(ctx, i).(GlobalNetworkOutput)
   161  }
   162  
   163  // GlobalNetworkArrayInput is an input type that accepts GlobalNetworkArray and GlobalNetworkArrayOutput values.
   164  // You can construct a concrete instance of `GlobalNetworkArrayInput` via:
   165  //
   166  //	GlobalNetworkArray{ GlobalNetworkArgs{...} }
   167  type GlobalNetworkArrayInput interface {
   168  	pulumi.Input
   169  
   170  	ToGlobalNetworkArrayOutput() GlobalNetworkArrayOutput
   171  	ToGlobalNetworkArrayOutputWithContext(context.Context) GlobalNetworkArrayOutput
   172  }
   173  
   174  type GlobalNetworkArray []GlobalNetworkInput
   175  
   176  func (GlobalNetworkArray) ElementType() reflect.Type {
   177  	return reflect.TypeOf((*[]*GlobalNetwork)(nil)).Elem()
   178  }
   179  
   180  func (i GlobalNetworkArray) ToGlobalNetworkArrayOutput() GlobalNetworkArrayOutput {
   181  	return i.ToGlobalNetworkArrayOutputWithContext(context.Background())
   182  }
   183  
   184  func (i GlobalNetworkArray) ToGlobalNetworkArrayOutputWithContext(ctx context.Context) GlobalNetworkArrayOutput {
   185  	return pulumi.ToOutputWithContext(ctx, i).(GlobalNetworkArrayOutput)
   186  }
   187  
   188  // GlobalNetworkMapInput is an input type that accepts GlobalNetworkMap and GlobalNetworkMapOutput values.
   189  // You can construct a concrete instance of `GlobalNetworkMapInput` via:
   190  //
   191  //	GlobalNetworkMap{ "key": GlobalNetworkArgs{...} }
   192  type GlobalNetworkMapInput interface {
   193  	pulumi.Input
   194  
   195  	ToGlobalNetworkMapOutput() GlobalNetworkMapOutput
   196  	ToGlobalNetworkMapOutputWithContext(context.Context) GlobalNetworkMapOutput
   197  }
   198  
   199  type GlobalNetworkMap map[string]GlobalNetworkInput
   200  
   201  func (GlobalNetworkMap) ElementType() reflect.Type {
   202  	return reflect.TypeOf((*map[string]*GlobalNetwork)(nil)).Elem()
   203  }
   204  
   205  func (i GlobalNetworkMap) ToGlobalNetworkMapOutput() GlobalNetworkMapOutput {
   206  	return i.ToGlobalNetworkMapOutputWithContext(context.Background())
   207  }
   208  
   209  func (i GlobalNetworkMap) ToGlobalNetworkMapOutputWithContext(ctx context.Context) GlobalNetworkMapOutput {
   210  	return pulumi.ToOutputWithContext(ctx, i).(GlobalNetworkMapOutput)
   211  }
   212  
   213  type GlobalNetworkOutput struct{ *pulumi.OutputState }
   214  
   215  func (GlobalNetworkOutput) ElementType() reflect.Type {
   216  	return reflect.TypeOf((**GlobalNetwork)(nil)).Elem()
   217  }
   218  
   219  func (o GlobalNetworkOutput) ToGlobalNetworkOutput() GlobalNetworkOutput {
   220  	return o
   221  }
   222  
   223  func (o GlobalNetworkOutput) ToGlobalNetworkOutputWithContext(ctx context.Context) GlobalNetworkOutput {
   224  	return o
   225  }
   226  
   227  // Global Network Amazon Resource Name (ARN)
   228  func (o GlobalNetworkOutput) Arn() pulumi.StringOutput {
   229  	return o.ApplyT(func(v *GlobalNetwork) pulumi.StringOutput { return v.Arn }).(pulumi.StringOutput)
   230  }
   231  
   232  // Description of the Global Network.
   233  func (o GlobalNetworkOutput) Description() pulumi.StringPtrOutput {
   234  	return o.ApplyT(func(v *GlobalNetwork) pulumi.StringPtrOutput { return v.Description }).(pulumi.StringPtrOutput)
   235  }
   236  
   237  // Key-value tags for the Global Network. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
   238  func (o GlobalNetworkOutput) Tags() pulumi.StringMapOutput {
   239  	return o.ApplyT(func(v *GlobalNetwork) pulumi.StringMapOutput { return v.Tags }).(pulumi.StringMapOutput)
   240  }
   241  
   242  // A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
   243  //
   244  // Deprecated: Please use `tags` instead.
   245  func (o GlobalNetworkOutput) TagsAll() pulumi.StringMapOutput {
   246  	return o.ApplyT(func(v *GlobalNetwork) pulumi.StringMapOutput { return v.TagsAll }).(pulumi.StringMapOutput)
   247  }
   248  
   249  type GlobalNetworkArrayOutput struct{ *pulumi.OutputState }
   250  
   251  func (GlobalNetworkArrayOutput) ElementType() reflect.Type {
   252  	return reflect.TypeOf((*[]*GlobalNetwork)(nil)).Elem()
   253  }
   254  
   255  func (o GlobalNetworkArrayOutput) ToGlobalNetworkArrayOutput() GlobalNetworkArrayOutput {
   256  	return o
   257  }
   258  
   259  func (o GlobalNetworkArrayOutput) ToGlobalNetworkArrayOutputWithContext(ctx context.Context) GlobalNetworkArrayOutput {
   260  	return o
   261  }
   262  
   263  func (o GlobalNetworkArrayOutput) Index(i pulumi.IntInput) GlobalNetworkOutput {
   264  	return pulumi.All(o, i).ApplyT(func(vs []interface{}) *GlobalNetwork {
   265  		return vs[0].([]*GlobalNetwork)[vs[1].(int)]
   266  	}).(GlobalNetworkOutput)
   267  }
   268  
   269  type GlobalNetworkMapOutput struct{ *pulumi.OutputState }
   270  
   271  func (GlobalNetworkMapOutput) ElementType() reflect.Type {
   272  	return reflect.TypeOf((*map[string]*GlobalNetwork)(nil)).Elem()
   273  }
   274  
   275  func (o GlobalNetworkMapOutput) ToGlobalNetworkMapOutput() GlobalNetworkMapOutput {
   276  	return o
   277  }
   278  
   279  func (o GlobalNetworkMapOutput) ToGlobalNetworkMapOutputWithContext(ctx context.Context) GlobalNetworkMapOutput {
   280  	return o
   281  }
   282  
   283  func (o GlobalNetworkMapOutput) MapIndex(k pulumi.StringInput) GlobalNetworkOutput {
   284  	return pulumi.All(o, k).ApplyT(func(vs []interface{}) *GlobalNetwork {
   285  		return vs[0].(map[string]*GlobalNetwork)[vs[1].(string)]
   286  	}).(GlobalNetworkOutput)
   287  }
   288  
   289  func init() {
   290  	pulumi.RegisterInputType(reflect.TypeOf((*GlobalNetworkInput)(nil)).Elem(), &GlobalNetwork{})
   291  	pulumi.RegisterInputType(reflect.TypeOf((*GlobalNetworkArrayInput)(nil)).Elem(), GlobalNetworkArray{})
   292  	pulumi.RegisterInputType(reflect.TypeOf((*GlobalNetworkMapInput)(nil)).Elem(), GlobalNetworkMap{})
   293  	pulumi.RegisterOutputType(GlobalNetworkOutput{})
   294  	pulumi.RegisterOutputType(GlobalNetworkArrayOutput{})
   295  	pulumi.RegisterOutputType(GlobalNetworkMapOutput{})
   296  }