resourceShareAccepter.go

// *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***

package ram

import (
	"context"
	"reflect"

	"github.com/pkg/errors"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// Manage accepting a Resource Access Manager (RAM) Resource Share invitation. From a _receiver_ AWS account, accept an invitation to share resources that were shared by a _sender_ AWS account. To create a resource share in the _sender_, see the `ram.ResourceShare` resource.
//
// > **Note:** If both AWS accounts are in the same Organization and [RAM Sharing with AWS Organizations is enabled](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs), this resource is not necessary as RAM Resource Share invitations are not used.
//
// ## Example Usage
//
// This configuration provides an example of using multiple AWS providers to configure two different AWS accounts. In the _sender_ account, the configuration creates a `ram.ResourceShare` and uses a data source in the _receiver_ account to create a `ram.PrincipalAssociation` resource with the _receiver's_ account ID. In the _receiver_ account, the configuration accepts the invitation to share resources with the `ram.ResourceShareAccepter`.
//
// ```go
// package main
//
// import (
// 	"github.com/pulumi/pulumi-aws/sdk/v4/go/aws"
// 	"github.com/pulumi/pulumi-aws/sdk/v4/go/aws/providers"
// 	"github.com/pulumi/pulumi-aws/sdk/v4/go/aws/ram"
// 	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
// )
//
// func main() {
// 	pulumi.Run(func(ctx *pulumi.Context) error {
// 		_, err := providers.Newaws(ctx, "alternate", &providers.awsArgs{
// 			Profile: "profile1",
// 		})
// 		if err != nil {
// 			return err
// 		}
// 		senderShare, err := ram.NewResourceShare(ctx, "senderShare", &ram.ResourceShareArgs{
// 			AllowExternalPrincipals: pulumi.Bool(true),
// 			Tags: pulumi.StringMap{
// 				"Name": pulumi.String("tf-test-resource-share"),
// 			},
// 		}, pulumi.Provider(aws.Alternate))
// 		if err != nil {
// 			return err
// 		}
// 		receiver, err := aws.GetCallerIdentity(ctx, nil, nil)
// 		if err != nil {
// 			return err
// 		}
// 		senderInvite, err := ram.NewPrincipalAssociation(ctx, "senderInvite", &ram.PrincipalAssociationArgs{
// 			Principal:        pulumi.String(receiver.AccountId),
// 			ResourceShareArn: senderShare.Arn,
// 		}, pulumi.Provider(aws.Alternate))
// 		if err != nil {
// 			return err
// 		}
// 		_, err = ram.NewResourceShareAccepter(ctx, "receiverAccept", &ram.ResourceShareAccepterArgs{
// 			ShareArn: senderInvite.ResourceShareArn,
// 		})
// 		if err != nil {
// 			return err
// 		}
// 		return nil
// 	})
// }
// ```
//
// ## Import
//
// Resource share accepters can be imported using the resource share ARN, e.g.,
//
// ```sh
//  $ pulumi import aws:ram/resourceShareAccepter:ResourceShareAccepter example arn:aws:ram:us-east-1:123456789012:resource-share/c4b56393-e8d9-89d9-6dc9-883752de4767
// ```
type ResourceShareAccepter struct {
	pulumi.CustomResourceState

	// The ARN of the resource share invitation.
	InvitationArn pulumi.StringOutput `pulumi:"invitationArn"`
	// The account ID of the receiver account which accepts the invitation.
	ReceiverAccountId pulumi.StringOutput `pulumi:"receiverAccountId"`
	// A list of the resource ARNs shared via the resource share.
	Resources pulumi.StringArrayOutput `pulumi:"resources"`
	// The account ID of the sender account which submits the invitation.
	SenderAccountId pulumi.StringOutput `pulumi:"senderAccountId"`
	// The ARN of the resource share.
	ShareArn pulumi.StringOutput `pulumi:"shareArn"`
	// The ID of the resource share as displayed in the console.
	ShareId pulumi.StringOutput `pulumi:"shareId"`
	// The name of the resource share.
	ShareName pulumi.StringOutput `pulumi:"shareName"`
	// The status of the resource share (ACTIVE, PENDING, FAILED, DELETING, DELETED).
	Status pulumi.StringOutput `pulumi:"status"`
}

// NewResourceShareAccepter registers a new resource with the given unique name, arguments, and options.
func NewResourceShareAccepter(ctx *pulumi.Context,
	name string, args *ResourceShareAccepterArgs, opts ...pulumi.ResourceOption) (*ResourceShareAccepter, error) {
	if args == nil {
		return nil, errors.New("missing one or more required arguments")
	}

	if args.ShareArn == nil {
		return nil, errors.New("invalid value for required argument 'ShareArn'")
	}
	var resource ResourceShareAccepter
	err := ctx.RegisterResource("aws:ram/resourceShareAccepter:ResourceShareAccepter", name, args, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// GetResourceShareAccepter gets an existing ResourceShareAccepter resource's state with the given name, ID, and optional
// state properties that are used to uniquely qualify the lookup (nil if not required).
func GetResourceShareAccepter(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ResourceShareAccepterState, opts ...pulumi.ResourceOption) (*ResourceShareAccepter, error) {
	var resource ResourceShareAccepter
	err := ctx.ReadResource("aws:ram/resourceShareAccepter:ResourceShareAccepter", name, id, state, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// Input properties used for looking up and filtering ResourceShareAccepter resources.
type resourceShareAccepterState struct {
	// The ARN of the resource share invitation.
	InvitationArn *string `pulumi:"invitationArn"`
	// The account ID of the receiver account which accepts the invitation.
	ReceiverAccountId *string `pulumi:"receiverAccountId"`
	// A list of the resource ARNs shared via the resource share.
	Resources []string `pulumi:"resources"`
	// The account ID of the sender account which submits the invitation.
	SenderAccountId *string `pulumi:"senderAccountId"`
	// The ARN of the resource share.
	ShareArn *string `pulumi:"shareArn"`
	// The ID of the resource share as displayed in the console.
	ShareId *string `pulumi:"shareId"`
	// The name of the resource share.
	ShareName *string `pulumi:"shareName"`
	// The status of the resource share (ACTIVE, PENDING, FAILED, DELETING, DELETED).
	Status *string `pulumi:"status"`
}

type ResourceShareAccepterState struct {
	// The ARN of the resource share invitation.
	InvitationArn pulumi.StringPtrInput
	// The account ID of the receiver account which accepts the invitation.
	ReceiverAccountId pulumi.StringPtrInput
	// A list of the resource ARNs shared via the resource share.
	Resources pulumi.StringArrayInput
	// The account ID of the sender account which submits the invitation.
	SenderAccountId pulumi.StringPtrInput
	// The ARN of the resource share.
	ShareArn pulumi.StringPtrInput
	// The ID of the resource share as displayed in the console.
	ShareId pulumi.StringPtrInput
	// The name of the resource share.
	ShareName pulumi.StringPtrInput
	// The status of the resource share (ACTIVE, PENDING, FAILED, DELETING, DELETED).
	Status pulumi.StringPtrInput
}

func (ResourceShareAccepterState) ElementType() reflect.Type {
	return reflect.TypeOf((*resourceShareAccepterState)(nil)).Elem()
}

type resourceShareAccepterArgs struct {
	// The ARN of the resource share.
	ShareArn string `pulumi:"shareArn"`
}

// The set of arguments for constructing a ResourceShareAccepter resource.
type ResourceShareAccepterArgs struct {
	// The ARN of the resource share.
	ShareArn pulumi.StringInput
}

func (ResourceShareAccepterArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*resourceShareAccepterArgs)(nil)).Elem()
}

type ResourceShareAccepterInput interface {
	pulumi.Input

	ToResourceShareAccepterOutput() ResourceShareAccepterOutput
	ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput
}

func (*ResourceShareAccepter) ElementType() reflect.Type {
	return reflect.TypeOf((*ResourceShareAccepter)(nil))
}

func (i *ResourceShareAccepter) ToResourceShareAccepterOutput() ResourceShareAccepterOutput {
	return i.ToResourceShareAccepterOutputWithContext(context.Background())
}

func (i *ResourceShareAccepter) ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ResourceShareAccepterOutput)
}

func (i *ResourceShareAccepter) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput {
	return i.ToResourceShareAccepterPtrOutputWithContext(context.Background())
}

func (i *ResourceShareAccepter) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ResourceShareAccepterPtrOutput)
}

type ResourceShareAccepterPtrInput interface {
	pulumi.Input

	ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
	ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
}

type resourceShareAccepterPtrType ResourceShareAccepterArgs

func (*resourceShareAccepterPtrType) ElementType() reflect.Type {
	return reflect.TypeOf((**ResourceShareAccepter)(nil))
}

func (i *resourceShareAccepterPtrType) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput {
	return i.ToResourceShareAccepterPtrOutputWithContext(context.Background())
}

func (i *resourceShareAccepterPtrType) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ResourceShareAccepterPtrOutput)
}

// ResourceShareAccepterArrayInput is an input type that accepts ResourceShareAccepterArray and ResourceShareAccepterArrayOutput values.
// You can construct a concrete instance of `ResourceShareAccepterArrayInput` via:
//
//          ResourceShareAccepterArray{ ResourceShareAccepterArgs{...} }
type ResourceShareAccepterArrayInput interface {
	pulumi.Input

	ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput
	ToResourceShareAccepterArrayOutputWithContext(context.Context) ResourceShareAccepterArrayOutput
}

type ResourceShareAccepterArray []ResourceShareAccepterInput

func (ResourceShareAccepterArray) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*ResourceShareAccepter)(nil)).Elem()
}

func (i ResourceShareAccepterArray) ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput {
	return i.ToResourceShareAccepterArrayOutputWithContext(context.Background())
}

func (i ResourceShareAccepterArray) ToResourceShareAccepterArrayOutputWithContext(ctx context.Context) ResourceShareAccepterArrayOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ResourceShareAccepterArrayOutput)
}

// ResourceShareAccepterMapInput is an input type that accepts ResourceShareAccepterMap and ResourceShareAccepterMapOutput values.
// You can construct a concrete instance of `ResourceShareAccepterMapInput` via:
//
//          ResourceShareAccepterMap{ "key": ResourceShareAccepterArgs{...} }
type ResourceShareAccepterMapInput interface {
	pulumi.Input

	ToResourceShareAccepterMapOutput() ResourceShareAccepterMapOutput
	ToResourceShareAccepterMapOutputWithContext(context.Context) ResourceShareAccepterMapOutput
}

type ResourceShareAccepterMap map[string]ResourceShareAccepterInput

func (ResourceShareAccepterMap) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*ResourceShareAccepter)(nil)).Elem()
}

func (i ResourceShareAccepterMap) ToResourceShareAccepterMapOutput() ResourceShareAccepterMapOutput {
	return i.ToResourceShareAccepterMapOutputWithContext(context.Background())
}

func (i ResourceShareAccepterMap) ToResourceShareAccepterMapOutputWithContext(ctx context.Context) ResourceShareAccepterMapOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ResourceShareAccepterMapOutput)
}

type ResourceShareAccepterOutput struct{ *pulumi.OutputState }

func (ResourceShareAccepterOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*ResourceShareAccepter)(nil))
}

func (o ResourceShareAccepterOutput) ToResourceShareAccepterOutput() ResourceShareAccepterOutput {
	return o
}

func (o ResourceShareAccepterOutput) ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput {
	return o
}

func (o ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput {
	return o.ToResourceShareAccepterPtrOutputWithContext(context.Background())
}

func (o ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput {
	return o.ApplyTWithContext(ctx, func(_ context.Context, v ResourceShareAccepter) *ResourceShareAccepter {
		return &v
	}).(ResourceShareAccepterPtrOutput)
}

type ResourceShareAccepterPtrOutput struct{ *pulumi.OutputState }

func (ResourceShareAccepterPtrOutput) ElementType() reflect.Type {
	return reflect.TypeOf((**ResourceShareAccepter)(nil))
}

func (o ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput {
	return o
}

func (o ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput {
	return o
}

func (o ResourceShareAccepterPtrOutput) Elem() ResourceShareAccepterOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) ResourceShareAccepter {
		if v != nil {
			return *v
		}
		var ret ResourceShareAccepter
		return ret
	}).(ResourceShareAccepterOutput)
}

type ResourceShareAccepterArrayOutput struct{ *pulumi.OutputState }

func (ResourceShareAccepterArrayOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*[]ResourceShareAccepter)(nil))
}

func (o ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput {
	return o
}

func (o ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutputWithContext(ctx context.Context) ResourceShareAccepterArrayOutput {
	return o
}

func (o ResourceShareAccepterArrayOutput) Index(i pulumi.IntInput) ResourceShareAccepterOutput {
	return pulumi.All(o, i).ApplyT(func(vs []interface{}) ResourceShareAccepter {
		return vs[0].([]ResourceShareAccepter)[vs[1].(int)]
	}).(ResourceShareAccepterOutput)
}

type ResourceShareAccepterMapOutput struct{ *pulumi.OutputState }

func (ResourceShareAccepterMapOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]ResourceShareAccepter)(nil))
}

func (o ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutput() ResourceShareAccepterMapOutput {
	return o
}

func (o ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutputWithContext(ctx context.Context) ResourceShareAccepterMapOutput {
	return o
}

func (o ResourceShareAccepterMapOutput) MapIndex(k pulumi.StringInput) ResourceShareAccepterOutput {
	return pulumi.All(o, k).ApplyT(func(vs []interface{}) ResourceShareAccepter {
		return vs[0].(map[string]ResourceShareAccepter)[vs[1].(string)]
	}).(ResourceShareAccepterOutput)
}

func init() {
	pulumi.RegisterInputType(reflect.TypeOf((*ResourceShareAccepterInput)(nil)).Elem(), &ResourceShareAccepter{})
	pulumi.RegisterInputType(reflect.TypeOf((*ResourceShareAccepterPtrInput)(nil)).Elem(), &ResourceShareAccepter{})
	pulumi.RegisterInputType(reflect.TypeOf((*ResourceShareAccepterArrayInput)(nil)).Elem(), ResourceShareAccepterArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*ResourceShareAccepterMapInput)(nil)).Elem(), ResourceShareAccepterMap{})
	pulumi.RegisterOutputType(ResourceShareAccepterOutput{})
	pulumi.RegisterOutputType(ResourceShareAccepterPtrOutput{})
	pulumi.RegisterOutputType(ResourceShareAccepterArrayOutput{})
	pulumi.RegisterOutputType(ResourceShareAccepterMapOutput{})
}