github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/ram/resourceShareAccepter.go

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

package ram

import (
	"context"
	"reflect"

	"errors"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
	"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`.
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ram"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			senderShare, err := ram.NewResourceShare(ctx, "sender_share", &ram.ResourceShareArgs{
//				Name:                    pulumi.String("tf-test-resource-share"),
//				AllowExternalPrincipals: pulumi.Bool(true),
//				Tags: pulumi.StringMap{
//					"Name": pulumi.String("tf-test-resource-share"),
//				},
//			})
//			if err != nil {
//				return err
//			}
//			receiver, err := aws.GetCallerIdentity(ctx, nil, nil)
//			if err != nil {
//				return err
//			}
//			senderInvite, err := ram.NewPrincipalAssociation(ctx, "sender_invite", &ram.PrincipalAssociationArgs{
//				Principal:        pulumi.String(receiver.AccountId),
//				ResourceShareArn: senderShare.Arn,
//			})
//			if err != nil {
//				return err
//			}
//			_, err = ram.NewResourceShareAccepter(ctx, "receiver_accept", &ram.ResourceShareAccepterArgs{
//				ShareArn: senderInvite.ResourceShareArn,
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
//
// ## Import
//
// Using `pulumi import`, import resource share accepters using the resource share ARN. For example:
//
// ```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'")
	}
	opts = internal.PkgResourceDefaultOpts(opts)
	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)).Elem()
}

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

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

// 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)).Elem()
}

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

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

// The ARN of the resource share invitation.
func (o ResourceShareAccepterOutput) InvitationArn() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.InvitationArn }).(pulumi.StringOutput)
}

// The account ID of the receiver account which accepts the invitation.
func (o ResourceShareAccepterOutput) ReceiverAccountId() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.ReceiverAccountId }).(pulumi.StringOutput)
}

// A list of the resource ARNs shared via the resource share.
func (o ResourceShareAccepterOutput) Resources() pulumi.StringArrayOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringArrayOutput { return v.Resources }).(pulumi.StringArrayOutput)
}

// The account ID of the sender account which submits the invitation.
func (o ResourceShareAccepterOutput) SenderAccountId() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.SenderAccountId }).(pulumi.StringOutput)
}

// The ARN of the resource share.
func (o ResourceShareAccepterOutput) ShareArn() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.ShareArn }).(pulumi.StringOutput)
}

// The ID of the resource share as displayed in the console.
func (o ResourceShareAccepterOutput) ShareId() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.ShareId }).(pulumi.StringOutput)
}

// The name of the resource share.
func (o ResourceShareAccepterOutput) ShareName() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.ShareName }).(pulumi.StringOutput)
}

// The status of the resource share (ACTIVE, PENDING, FAILED, DELETING, DELETED).
func (o ResourceShareAccepterOutput) Status() pulumi.StringOutput {
	return o.ApplyT(func(v *ResourceShareAccepter) pulumi.StringOutput { return v.Status }).(pulumi.StringOutput)
}

type ResourceShareAccepterArrayOutput struct{ *pulumi.OutputState }

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

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)).Elem()
}

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((*ResourceShareAccepterArrayInput)(nil)).Elem(), ResourceShareAccepterArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*ResourceShareAccepterMapInput)(nil)).Elem(), ResourceShareAccepterMap{})
	pulumi.RegisterOutputType(ResourceShareAccepterOutput{})
	pulumi.RegisterOutputType(ResourceShareAccepterArrayOutput{})
	pulumi.RegisterOutputType(ResourceShareAccepterMapOutput{})
}