Documentation ¶
Index ¶
- type GetResourceShareFilter
- type GetResourceShareFilterArgs
- type GetResourceShareFilterArray
- func (GetResourceShareFilterArray) ElementType() reflect.Type
- func (i GetResourceShareFilterArray) ToGetResourceShareFilterArrayOutput() GetResourceShareFilterArrayOutput
- func (i GetResourceShareFilterArray) ToGetResourceShareFilterArrayOutputWithContext(ctx context.Context) GetResourceShareFilterArrayOutput
- type GetResourceShareFilterArrayInput
- type GetResourceShareFilterArrayOutput
- func (GetResourceShareFilterArrayOutput) ElementType() reflect.Type
- func (o GetResourceShareFilterArrayOutput) Index(i pulumi.IntInput) GetResourceShareFilterOutput
- func (o GetResourceShareFilterArrayOutput) ToGetResourceShareFilterArrayOutput() GetResourceShareFilterArrayOutput
- func (o GetResourceShareFilterArrayOutput) ToGetResourceShareFilterArrayOutputWithContext(ctx context.Context) GetResourceShareFilterArrayOutput
- type GetResourceShareFilterInput
- type GetResourceShareFilterOutput
- func (GetResourceShareFilterOutput) ElementType() reflect.Type
- func (o GetResourceShareFilterOutput) Name() pulumi.StringOutput
- func (o GetResourceShareFilterOutput) ToGetResourceShareFilterOutput() GetResourceShareFilterOutput
- func (o GetResourceShareFilterOutput) ToGetResourceShareFilterOutputWithContext(ctx context.Context) GetResourceShareFilterOutput
- func (o GetResourceShareFilterOutput) Values() pulumi.StringArrayOutput
- type LookupResourceShareArgs
- type LookupResourceShareOutputArgs
- type LookupResourceShareResult
- type LookupResourceShareResultOutput
- func (o LookupResourceShareResultOutput) Arn() pulumi.StringOutput
- func (LookupResourceShareResultOutput) ElementType() reflect.Type
- func (o LookupResourceShareResultOutput) Filters() GetResourceShareFilterArrayOutput
- func (o LookupResourceShareResultOutput) Id() pulumi.StringOutput
- func (o LookupResourceShareResultOutput) Name() pulumi.StringOutput
- func (o LookupResourceShareResultOutput) OwningAccountId() pulumi.StringOutput
- func (o LookupResourceShareResultOutput) ResourceOwner() pulumi.StringOutput
- func (o LookupResourceShareResultOutput) Status() pulumi.StringOutput
- func (o LookupResourceShareResultOutput) Tags() pulumi.StringMapOutput
- func (o LookupResourceShareResultOutput) ToLookupResourceShareResultOutput() LookupResourceShareResultOutput
- func (o LookupResourceShareResultOutput) ToLookupResourceShareResultOutputWithContext(ctx context.Context) LookupResourceShareResultOutput
- type PrincipalAssociation
- func (*PrincipalAssociation) ElementType() reflect.Type
- func (i *PrincipalAssociation) ToPrincipalAssociationOutput() PrincipalAssociationOutput
- func (i *PrincipalAssociation) ToPrincipalAssociationOutputWithContext(ctx context.Context) PrincipalAssociationOutput
- func (i *PrincipalAssociation) ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput
- func (i *PrincipalAssociation) ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput
- type PrincipalAssociationArgs
- type PrincipalAssociationArray
- type PrincipalAssociationArrayInput
- type PrincipalAssociationArrayOutput
- func (PrincipalAssociationArrayOutput) ElementType() reflect.Type
- func (o PrincipalAssociationArrayOutput) Index(i pulumi.IntInput) PrincipalAssociationOutput
- func (o PrincipalAssociationArrayOutput) ToPrincipalAssociationArrayOutput() PrincipalAssociationArrayOutput
- func (o PrincipalAssociationArrayOutput) ToPrincipalAssociationArrayOutputWithContext(ctx context.Context) PrincipalAssociationArrayOutput
- type PrincipalAssociationInput
- type PrincipalAssociationMap
- type PrincipalAssociationMapInput
- type PrincipalAssociationMapOutput
- func (PrincipalAssociationMapOutput) ElementType() reflect.Type
- func (o PrincipalAssociationMapOutput) MapIndex(k pulumi.StringInput) PrincipalAssociationOutput
- func (o PrincipalAssociationMapOutput) ToPrincipalAssociationMapOutput() PrincipalAssociationMapOutput
- func (o PrincipalAssociationMapOutput) ToPrincipalAssociationMapOutputWithContext(ctx context.Context) PrincipalAssociationMapOutput
- type PrincipalAssociationOutput
- func (PrincipalAssociationOutput) ElementType() reflect.Type
- func (o PrincipalAssociationOutput) ToPrincipalAssociationOutput() PrincipalAssociationOutput
- func (o PrincipalAssociationOutput) ToPrincipalAssociationOutputWithContext(ctx context.Context) PrincipalAssociationOutput
- func (o PrincipalAssociationOutput) ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput
- func (o PrincipalAssociationOutput) ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput
- type PrincipalAssociationPtrInput
- type PrincipalAssociationPtrOutput
- func (o PrincipalAssociationPtrOutput) Elem() PrincipalAssociationOutput
- func (PrincipalAssociationPtrOutput) ElementType() reflect.Type
- func (o PrincipalAssociationPtrOutput) ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput
- func (o PrincipalAssociationPtrOutput) ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput
- type PrincipalAssociationState
- type ResourceAssociation
- func (*ResourceAssociation) ElementType() reflect.Type
- func (i *ResourceAssociation) ToResourceAssociationOutput() ResourceAssociationOutput
- func (i *ResourceAssociation) ToResourceAssociationOutputWithContext(ctx context.Context) ResourceAssociationOutput
- func (i *ResourceAssociation) ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput
- func (i *ResourceAssociation) ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput
- type ResourceAssociationArgs
- type ResourceAssociationArray
- type ResourceAssociationArrayInput
- type ResourceAssociationArrayOutput
- func (ResourceAssociationArrayOutput) ElementType() reflect.Type
- func (o ResourceAssociationArrayOutput) Index(i pulumi.IntInput) ResourceAssociationOutput
- func (o ResourceAssociationArrayOutput) ToResourceAssociationArrayOutput() ResourceAssociationArrayOutput
- func (o ResourceAssociationArrayOutput) ToResourceAssociationArrayOutputWithContext(ctx context.Context) ResourceAssociationArrayOutput
- type ResourceAssociationInput
- type ResourceAssociationMap
- type ResourceAssociationMapInput
- type ResourceAssociationMapOutput
- func (ResourceAssociationMapOutput) ElementType() reflect.Type
- func (o ResourceAssociationMapOutput) MapIndex(k pulumi.StringInput) ResourceAssociationOutput
- func (o ResourceAssociationMapOutput) ToResourceAssociationMapOutput() ResourceAssociationMapOutput
- func (o ResourceAssociationMapOutput) ToResourceAssociationMapOutputWithContext(ctx context.Context) ResourceAssociationMapOutput
- type ResourceAssociationOutput
- func (ResourceAssociationOutput) ElementType() reflect.Type
- func (o ResourceAssociationOutput) ToResourceAssociationOutput() ResourceAssociationOutput
- func (o ResourceAssociationOutput) ToResourceAssociationOutputWithContext(ctx context.Context) ResourceAssociationOutput
- func (o ResourceAssociationOutput) ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput
- func (o ResourceAssociationOutput) ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput
- type ResourceAssociationPtrInput
- type ResourceAssociationPtrOutput
- func (o ResourceAssociationPtrOutput) Elem() ResourceAssociationOutput
- func (ResourceAssociationPtrOutput) ElementType() reflect.Type
- func (o ResourceAssociationPtrOutput) ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput
- func (o ResourceAssociationPtrOutput) ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput
- type ResourceAssociationState
- type ResourceShare
- func (*ResourceShare) ElementType() reflect.Type
- func (i *ResourceShare) ToResourceShareOutput() ResourceShareOutput
- func (i *ResourceShare) ToResourceShareOutputWithContext(ctx context.Context) ResourceShareOutput
- func (i *ResourceShare) ToResourceSharePtrOutput() ResourceSharePtrOutput
- func (i *ResourceShare) ToResourceSharePtrOutputWithContext(ctx context.Context) ResourceSharePtrOutput
- type ResourceShareAccepter
- func (*ResourceShareAccepter) ElementType() reflect.Type
- func (i *ResourceShareAccepter) ToResourceShareAccepterOutput() ResourceShareAccepterOutput
- func (i *ResourceShareAccepter) ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput
- func (i *ResourceShareAccepter) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
- func (i *ResourceShareAccepter) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
- type ResourceShareAccepterArgs
- type ResourceShareAccepterArray
- func (ResourceShareAccepterArray) ElementType() reflect.Type
- func (i ResourceShareAccepterArray) ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput
- func (i ResourceShareAccepterArray) ToResourceShareAccepterArrayOutputWithContext(ctx context.Context) ResourceShareAccepterArrayOutput
- type ResourceShareAccepterArrayInput
- type ResourceShareAccepterArrayOutput
- func (ResourceShareAccepterArrayOutput) ElementType() reflect.Type
- func (o ResourceShareAccepterArrayOutput) Index(i pulumi.IntInput) ResourceShareAccepterOutput
- func (o ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput
- func (o ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutputWithContext(ctx context.Context) ResourceShareAccepterArrayOutput
- type ResourceShareAccepterInput
- type ResourceShareAccepterMap
- type ResourceShareAccepterMapInput
- type ResourceShareAccepterMapOutput
- func (ResourceShareAccepterMapOutput) ElementType() reflect.Type
- func (o ResourceShareAccepterMapOutput) MapIndex(k pulumi.StringInput) ResourceShareAccepterOutput
- func (o ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutput() ResourceShareAccepterMapOutput
- func (o ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutputWithContext(ctx context.Context) ResourceShareAccepterMapOutput
- type ResourceShareAccepterOutput
- func (ResourceShareAccepterOutput) ElementType() reflect.Type
- func (o ResourceShareAccepterOutput) ToResourceShareAccepterOutput() ResourceShareAccepterOutput
- func (o ResourceShareAccepterOutput) ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput
- func (o ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
- func (o ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
- type ResourceShareAccepterPtrInput
- type ResourceShareAccepterPtrOutput
- func (o ResourceShareAccepterPtrOutput) Elem() ResourceShareAccepterOutput
- func (ResourceShareAccepterPtrOutput) ElementType() reflect.Type
- func (o ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
- func (o ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
- type ResourceShareAccepterState
- type ResourceShareArgs
- type ResourceShareArray
- type ResourceShareArrayInput
- type ResourceShareArrayOutput
- func (ResourceShareArrayOutput) ElementType() reflect.Type
- func (o ResourceShareArrayOutput) Index(i pulumi.IntInput) ResourceShareOutput
- func (o ResourceShareArrayOutput) ToResourceShareArrayOutput() ResourceShareArrayOutput
- func (o ResourceShareArrayOutput) ToResourceShareArrayOutputWithContext(ctx context.Context) ResourceShareArrayOutput
- type ResourceShareInput
- type ResourceShareMap
- type ResourceShareMapInput
- type ResourceShareMapOutput
- func (ResourceShareMapOutput) ElementType() reflect.Type
- func (o ResourceShareMapOutput) MapIndex(k pulumi.StringInput) ResourceShareOutput
- func (o ResourceShareMapOutput) ToResourceShareMapOutput() ResourceShareMapOutput
- func (o ResourceShareMapOutput) ToResourceShareMapOutputWithContext(ctx context.Context) ResourceShareMapOutput
- type ResourceShareOutput
- func (ResourceShareOutput) ElementType() reflect.Type
- func (o ResourceShareOutput) ToResourceShareOutput() ResourceShareOutput
- func (o ResourceShareOutput) ToResourceShareOutputWithContext(ctx context.Context) ResourceShareOutput
- func (o ResourceShareOutput) ToResourceSharePtrOutput() ResourceSharePtrOutput
- func (o ResourceShareOutput) ToResourceSharePtrOutputWithContext(ctx context.Context) ResourceSharePtrOutput
- type ResourceSharePtrInput
- type ResourceSharePtrOutput
- func (o ResourceSharePtrOutput) Elem() ResourceShareOutput
- func (ResourceSharePtrOutput) ElementType() reflect.Type
- func (o ResourceSharePtrOutput) ToResourceSharePtrOutput() ResourceSharePtrOutput
- func (o ResourceSharePtrOutput) ToResourceSharePtrOutputWithContext(ctx context.Context) ResourceSharePtrOutput
- type ResourceShareState
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type GetResourceShareFilter ¶
type GetResourceShareFilterArgs ¶
type GetResourceShareFilterArgs struct { pulumi.StringInput `pulumi:"name"` Values pulumi.StringArrayInput `pulumi:"values"` }Name
func (GetResourceShareFilterArgs) ElementType ¶
func (GetResourceShareFilterArgs) ElementType() reflect.Type
func (GetResourceShareFilterArgs) ToGetResourceShareFilterOutput ¶
func (i GetResourceShareFilterArgs) ToGetResourceShareFilterOutput() GetResourceShareFilterOutput
func (GetResourceShareFilterArgs) ToGetResourceShareFilterOutputWithContext ¶
func (i GetResourceShareFilterArgs) ToGetResourceShareFilterOutputWithContext(ctx context.Context) GetResourceShareFilterOutput
type GetResourceShareFilterArray ¶
type GetResourceShareFilterArray []GetResourceShareFilterInput
func (GetResourceShareFilterArray) ElementType ¶
func (GetResourceShareFilterArray) ElementType() reflect.Type
func (GetResourceShareFilterArray) ToGetResourceShareFilterArrayOutput ¶
func (i GetResourceShareFilterArray) ToGetResourceShareFilterArrayOutput() GetResourceShareFilterArrayOutput
func (GetResourceShareFilterArray) ToGetResourceShareFilterArrayOutputWithContext ¶
func (i GetResourceShareFilterArray) ToGetResourceShareFilterArrayOutputWithContext(ctx context.Context) GetResourceShareFilterArrayOutput
type GetResourceShareFilterArrayInput ¶
GetResourceShareFilterArrayInput is an input type that accepts GetResourceShareFilterArray and GetResourceShareFilterArrayOutput values. You can construct a concrete instance of `GetResourceShareFilterArrayInput` via:
GetResourceShareFilterArray{ GetResourceShareFilterArgs{...} }
type GetResourceShareFilterArrayOutput ¶
func (GetResourceShareFilterArrayOutput) ElementType ¶
func (GetResourceShareFilterArrayOutput) ElementType() reflect.Type
func (GetResourceShareFilterArrayOutput) Index ¶
func (o GetResourceShareFilterArrayOutput) Index(i pulumi.IntInput) GetResourceShareFilterOutput
func (GetResourceShareFilterArrayOutput) ToGetResourceShareFilterArrayOutput ¶
func (o GetResourceShareFilterArrayOutput) ToGetResourceShareFilterArrayOutput() GetResourceShareFilterArrayOutput
func (GetResourceShareFilterArrayOutput) ToGetResourceShareFilterArrayOutputWithContext ¶
func (o GetResourceShareFilterArrayOutput) ToGetResourceShareFilterArrayOutputWithContext(ctx context.Context) GetResourceShareFilterArrayOutput
type GetResourceShareFilterInput ¶
GetResourceShareFilterInput is an input type that accepts GetResourceShareFilterArgs and GetResourceShareFilterOutput values. You can construct a concrete instance of `GetResourceShareFilterInput` via:
GetResourceShareFilterArgs{...}
type GetResourceShareFilterOutput ¶
func (GetResourceShareFilterOutput) ElementType ¶
func (GetResourceShareFilterOutput) ElementType() reflect.Type
func (GetResourceShareFilterOutput) Name ¶
func (o GetResourceShareFilterOutput) Name() pulumi.StringOutput
The name of the tag key to filter on.
func (GetResourceShareFilterOutput) ToGetResourceShareFilterOutput ¶
func (o GetResourceShareFilterOutput) ToGetResourceShareFilterOutput() GetResourceShareFilterOutput
func (GetResourceShareFilterOutput) ToGetResourceShareFilterOutputWithContext ¶
func (o GetResourceShareFilterOutput) ToGetResourceShareFilterOutputWithContext(ctx context.Context) GetResourceShareFilterOutput
func (GetResourceShareFilterOutput) Values ¶
func (o GetResourceShareFilterOutput) Values() pulumi.StringArrayOutput
The value of the tag key.
type LookupResourceShareArgs ¶
type LookupResourceShareArgs struct { GetResourceShareFilter `pulumi:"filters"` Name string `pulumi:"name"` ResourceOwner string `pulumi:"resourceOwner"` Tags map[string]string `pulumi:"tags"` }Filters []
A collection of arguments for invoking getResourceShare.
type LookupResourceShareOutputArgs ¶ added in v4.21.0
type LookupResourceShareOutputArgs struct { GetResourceShareFilterArrayInput `pulumi:"filters"` Name pulumi.StringInput `pulumi:"name"` ResourceOwner pulumi.StringInput `pulumi:"resourceOwner"` Tags pulumi.StringMapInput `pulumi:"tags"` }Filters
A collection of arguments for invoking getResourceShare.
func (LookupResourceShareOutputArgs) ElementType ¶ added in v4.21.0
func (LookupResourceShareOutputArgs) ElementType() reflect.Type
type LookupResourceShareResult ¶
type LookupResourceShareResult struct { // The Amazon Resource Name (ARN) of the resource share. // The provider-assigned unique ID for this managed resource. // The ID of the AWS account that owns the resource share. Status string `pulumi:"status"` Tags map[string]string `pulumi:"tags"` }
A collection of values returned by getResourceShare.
func LookupResourceShare ¶
func LookupResourceShare(ctx *pulumi.Context, args *LookupResourceShareArgs, opts ...pulumi.InvokeOption) (*LookupResourceShareResult, error)
`ram.ResourceShare` Retrieve information about a RAM Resource Share.
## Example Usage
```go package main
import (
"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 := ram.LookupResourceShare(ctx, &ram.LookupResourceShareArgs{ Name: "example", ResourceOwner: "SELF", }, nil) if err != nil { return err } return nil }) }
``` ## Search by filters
```go package main
import (
"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 := ram.LookupResourceShare(ctx, &ram.LookupResourceShareArgs{ Filters: []ram.GetResourceShareFilter{ ram.GetResourceShareFilter{ Name: "NameOfTag", Values: []string{ "exampleNameTagValue", }, }, }, Name: "MyResourceName", ResourceOwner: "SELF", }, nil) if err != nil { return err } return nil }) }
```
type LookupResourceShareResultOutput ¶ added in v4.21.0
A collection of values returned by getResourceShare.
func LookupResourceShareOutput ¶ added in v4.21.0
func LookupResourceShareOutput(ctx *pulumi.Context, args LookupResourceShareOutputArgs, opts ...pulumi.InvokeOption) LookupResourceShareResultOutput
func (LookupResourceShareResultOutput) Arn ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) Arn() pulumi.StringOutput
The Amazon Resource Name (ARN) of the resource share.
func (LookupResourceShareResultOutput) ElementType ¶ added in v4.21.0
func (LookupResourceShareResultOutput) ElementType() reflect.Type
func (LookupResourceShareResultOutput) Filters ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) Filters() GetResourceShareFilterArrayOutput
func (LookupResourceShareResultOutput) Id ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) Id() pulumi.StringOutput
The provider-assigned unique ID for this managed resource.
func (LookupResourceShareResultOutput) Name ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) Name() pulumi.StringOutput
func (LookupResourceShareResultOutput) OwningAccountId ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) OwningAccountId() pulumi.StringOutput
The ID of the AWS account that owns the resource share.
func (LookupResourceShareResultOutput) ResourceOwner ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) ResourceOwner() pulumi.StringOutput
func (LookupResourceShareResultOutput) Status ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) Status() pulumi.StringOutput
The Status of the RAM share.
func (LookupResourceShareResultOutput) Tags ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) Tags() pulumi.StringMapOutput
The Tags attached to the RAM share
func (LookupResourceShareResultOutput) ToLookupResourceShareResultOutput ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) ToLookupResourceShareResultOutput() LookupResourceShareResultOutput
func (LookupResourceShareResultOutput) ToLookupResourceShareResultOutputWithContext ¶ added in v4.21.0
func (o LookupResourceShareResultOutput) ToLookupResourceShareResultOutputWithContext(ctx context.Context) LookupResourceShareResultOutput
type PrincipalAssociation ¶
type PrincipalAssociation struct { pulumi.CustomResourceState // The principal to associate with the resource share. Possible values are an AWS account ID, an AWS Organizations Organization ARN, or an AWS Organizations Organization Unit ARN. Principal pulumi.StringOutput `pulumi:"principal"` ResourceShareArn pulumi.StringOutput `pulumi:"resourceShareArn"` }
Provides a Resource Access Manager (RAM) principal association. Depending if [RAM Sharing with AWS Organizations is enabled](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs), the RAM behavior with different principal types changes.
When RAM Sharing with AWS Organizations is enabled:
- For AWS Account ID, Organization, and Organizational Unit principals within the same AWS Organization, no resource share invitation is sent and resources become available automatically after creating the association. - For AWS Account ID principals outside the AWS Organization, a resource share invitation is sent and must be accepted before resources become available. See the `ram.ResourceShareAccepter` resource to accept these invitations.
When RAM Sharing with AWS Organizations is not enabled:
- Organization and Organizational Unit principals cannot be used. - For AWS Account ID principals, a resource share invitation is sent and must be accepted before resources become available. See the `ram.ResourceShareAccepter` resource to accept these invitations.
## Example Usage ### AWS Account ID
```go package main
import (
"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 { exampleResourceShare, err := ram.NewResourceShare(ctx, "exampleResourceShare", &ram.ResourceShareArgs{ AllowExternalPrincipals: pulumi.Bool(true), }) if err != nil { return err } _, err = ram.NewPrincipalAssociation(ctx, "examplePrincipalAssociation", &ram.PrincipalAssociationArgs{ Principal: pulumi.String("111111111111"), ResourceShareArn: exampleResourceShare.Arn, }) if err != nil { return err } return nil }) }
``` ### AWS Organization
```go package main
import (
"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 := ram.NewPrincipalAssociation(ctx, "example", &ram.PrincipalAssociationArgs{ Principal: pulumi.Any(aws_organizations_organization.Example.Arn), ResourceShareArn: pulumi.Any(aws_ram_resource_share.Example.Arn), }) if err != nil { return err } return nil }) }
```
## Import
RAM Principal Associations can be imported using their Resource Share ARN and the `principal` separated by a comma, e.g.
```sh
$ pulumi import aws:ram/principalAssociation:PrincipalAssociation example arn:aws:ram:eu-west-1:123456789012:resource-share/73da1ab9-b94a-4ba3-8eb4-45917f7f4b12,123456789012
```
func GetPrincipalAssociation ¶
func GetPrincipalAssociation(ctx *pulumi.Context, name string, id pulumi.IDInput, state *PrincipalAssociationState, opts ...pulumi.ResourceOption) (*PrincipalAssociation, error)
GetPrincipalAssociation gets an existing PrincipalAssociation 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 NewPrincipalAssociation ¶
func NewPrincipalAssociation(ctx *pulumi.Context, name string, args *PrincipalAssociationArgs, opts ...pulumi.ResourceOption) (*PrincipalAssociation, error)
NewPrincipalAssociation registers a new resource with the given unique name, arguments, and options.
func (*PrincipalAssociation) ElementType ¶
func (*PrincipalAssociation) ElementType() reflect.Type
func (*PrincipalAssociation) ToPrincipalAssociationOutput ¶
func (i *PrincipalAssociation) ToPrincipalAssociationOutput() PrincipalAssociationOutput
func (*PrincipalAssociation) ToPrincipalAssociationOutputWithContext ¶
func (i *PrincipalAssociation) ToPrincipalAssociationOutputWithContext(ctx context.Context) PrincipalAssociationOutput
func (*PrincipalAssociation) ToPrincipalAssociationPtrOutput ¶
func (i *PrincipalAssociation) ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput
func (*PrincipalAssociation) ToPrincipalAssociationPtrOutputWithContext ¶
func (i *PrincipalAssociation) ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput
type PrincipalAssociationArgs ¶
type PrincipalAssociationArgs struct { // The principal to associate with the resource share. Possible values are an AWS account ID, an AWS Organizations Organization ARN, or an AWS Organizations Organization Unit ARN. Principal pulumi.StringInput ResourceShareArn pulumi.StringInput }
The set of arguments for constructing a PrincipalAssociation resource.
func (PrincipalAssociationArgs) ElementType ¶
func (PrincipalAssociationArgs) ElementType() reflect.Type
type PrincipalAssociationArray ¶
type PrincipalAssociationArray []PrincipalAssociationInput
func (PrincipalAssociationArray) ElementType ¶
func (PrincipalAssociationArray) ElementType() reflect.Type
func (PrincipalAssociationArray) ToPrincipalAssociationArrayOutput ¶
func (i PrincipalAssociationArray) ToPrincipalAssociationArrayOutput() PrincipalAssociationArrayOutput
func (PrincipalAssociationArray) ToPrincipalAssociationArrayOutputWithContext ¶
func (i PrincipalAssociationArray) ToPrincipalAssociationArrayOutputWithContext(ctx context.Context) PrincipalAssociationArrayOutput
type PrincipalAssociationArrayInput ¶
type PrincipalAssociationArrayInput interface { pulumi.Input ToPrincipalAssociationArrayOutput() PrincipalAssociationArrayOutput ToPrincipalAssociationArrayOutputWithContext(context.Context) PrincipalAssociationArrayOutput }
PrincipalAssociationArrayInput is an input type that accepts PrincipalAssociationArray and PrincipalAssociationArrayOutput values. You can construct a concrete instance of `PrincipalAssociationArrayInput` via:
PrincipalAssociationArray{ PrincipalAssociationArgs{...} }
type PrincipalAssociationArrayOutput ¶
type PrincipalAssociationArrayOutput struct{ *pulumi.OutputState }
func (PrincipalAssociationArrayOutput) ElementType ¶
func (PrincipalAssociationArrayOutput) ElementType() reflect.Type
func (PrincipalAssociationArrayOutput) Index ¶
func (o PrincipalAssociationArrayOutput) Index(i pulumi.IntInput) PrincipalAssociationOutput
func (PrincipalAssociationArrayOutput) ToPrincipalAssociationArrayOutput ¶
func (o PrincipalAssociationArrayOutput) ToPrincipalAssociationArrayOutput() PrincipalAssociationArrayOutput
func (PrincipalAssociationArrayOutput) ToPrincipalAssociationArrayOutputWithContext ¶
func (o PrincipalAssociationArrayOutput) ToPrincipalAssociationArrayOutputWithContext(ctx context.Context) PrincipalAssociationArrayOutput
type PrincipalAssociationInput ¶
type PrincipalAssociationInput interface { pulumi.Input ToPrincipalAssociationOutput() PrincipalAssociationOutput ToPrincipalAssociationOutputWithContext(ctx context.Context) PrincipalAssociationOutput }
type PrincipalAssociationMap ¶
type PrincipalAssociationMap map[string]PrincipalAssociationInput
func (PrincipalAssociationMap) ElementType ¶
func (PrincipalAssociationMap) ElementType() reflect.Type
func (PrincipalAssociationMap) ToPrincipalAssociationMapOutput ¶
func (i PrincipalAssociationMap) ToPrincipalAssociationMapOutput() PrincipalAssociationMapOutput
func (PrincipalAssociationMap) ToPrincipalAssociationMapOutputWithContext ¶
func (i PrincipalAssociationMap) ToPrincipalAssociationMapOutputWithContext(ctx context.Context) PrincipalAssociationMapOutput
type PrincipalAssociationMapInput ¶
type PrincipalAssociationMapInput interface { pulumi.Input ToPrincipalAssociationMapOutput() PrincipalAssociationMapOutput ToPrincipalAssociationMapOutputWithContext(context.Context) PrincipalAssociationMapOutput }
PrincipalAssociationMapInput is an input type that accepts PrincipalAssociationMap and PrincipalAssociationMapOutput values. You can construct a concrete instance of `PrincipalAssociationMapInput` via:
PrincipalAssociationMap{ "key": PrincipalAssociationArgs{...} }
type PrincipalAssociationMapOutput ¶
type PrincipalAssociationMapOutput struct{ *pulumi.OutputState }
func (PrincipalAssociationMapOutput) ElementType ¶
func (PrincipalAssociationMapOutput) ElementType() reflect.Type
func (PrincipalAssociationMapOutput) MapIndex ¶
func (o PrincipalAssociationMapOutput) MapIndex(k pulumi.StringInput) PrincipalAssociationOutput
func (PrincipalAssociationMapOutput) ToPrincipalAssociationMapOutput ¶
func (o PrincipalAssociationMapOutput) ToPrincipalAssociationMapOutput() PrincipalAssociationMapOutput
func (PrincipalAssociationMapOutput) ToPrincipalAssociationMapOutputWithContext ¶
func (o PrincipalAssociationMapOutput) ToPrincipalAssociationMapOutputWithContext(ctx context.Context) PrincipalAssociationMapOutput
type PrincipalAssociationOutput ¶
type PrincipalAssociationOutput struct{ *pulumi.OutputState }
func (PrincipalAssociationOutput) ElementType ¶
func (PrincipalAssociationOutput) ElementType() reflect.Type
func (PrincipalAssociationOutput) ToPrincipalAssociationOutput ¶
func (o PrincipalAssociationOutput) ToPrincipalAssociationOutput() PrincipalAssociationOutput
func (PrincipalAssociationOutput) ToPrincipalAssociationOutputWithContext ¶
func (o PrincipalAssociationOutput) ToPrincipalAssociationOutputWithContext(ctx context.Context) PrincipalAssociationOutput
func (PrincipalAssociationOutput) ToPrincipalAssociationPtrOutput ¶
func (o PrincipalAssociationOutput) ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput
func (PrincipalAssociationOutput) ToPrincipalAssociationPtrOutputWithContext ¶
func (o PrincipalAssociationOutput) ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput
type PrincipalAssociationPtrInput ¶
type PrincipalAssociationPtrInput interface { pulumi.Input ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput }
type PrincipalAssociationPtrOutput ¶
type PrincipalAssociationPtrOutput struct{ *pulumi.OutputState }
func (PrincipalAssociationPtrOutput) Elem ¶ added in v4.15.0
func (o PrincipalAssociationPtrOutput) Elem() PrincipalAssociationOutput
func (PrincipalAssociationPtrOutput) ElementType ¶
func (PrincipalAssociationPtrOutput) ElementType() reflect.Type
func (PrincipalAssociationPtrOutput) ToPrincipalAssociationPtrOutput ¶
func (o PrincipalAssociationPtrOutput) ToPrincipalAssociationPtrOutput() PrincipalAssociationPtrOutput
func (PrincipalAssociationPtrOutput) ToPrincipalAssociationPtrOutputWithContext ¶
func (o PrincipalAssociationPtrOutput) ToPrincipalAssociationPtrOutputWithContext(ctx context.Context) PrincipalAssociationPtrOutput
type PrincipalAssociationState ¶
type PrincipalAssociationState struct { // The principal to associate with the resource share. Possible values are an AWS account ID, an AWS Organizations Organization ARN, or an AWS Organizations Organization Unit ARN. Principal pulumi.StringPtrInput ResourceShareArn pulumi.StringPtrInput }
func (PrincipalAssociationState) ElementType ¶
func (PrincipalAssociationState) ElementType() reflect.Type
type ResourceAssociation ¶
type ResourceAssociation struct { pulumi.CustomResourceState // Amazon Resource Name (ARN) of the resource to associate with the RAM Resource Share. ResourceArn pulumi.StringOutput `pulumi:"resourceArn"` ResourceShareArn pulumi.StringOutput `pulumi:"resourceShareArn"` }
Manages a Resource Access Manager (RAM) Resource Association.
> *NOTE:* Certain AWS resources (e.g. EC2 Subnets) can only be shared in an AWS account that is a member of an AWS Organizations organization with organization-wide Resource Access Manager functionality enabled. See the [Resource Access Manager User Guide](https://docs.aws.amazon.com/ram/latest/userguide/what-is.html) and AWS service specific documentation for additional information.
## Example Usage
```go package main
import (
"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 := ram.NewResourceAssociation(ctx, "example", &ram.ResourceAssociationArgs{ ResourceArn: pulumi.Any(aws_subnet.Example.Arn), ResourceShareArn: pulumi.Any(aws_ram_resource_share.Example.Arn), }) if err != nil { return err } return nil }) }
```
## Import
RAM Resource Associations can be imported using their Resource Share ARN and Resource ARN separated by a comma, e.g.
```sh
$ pulumi import aws:ram/resourceAssociation:ResourceAssociation example arn:aws:ram:eu-west-1:123456789012:resource-share/73da1ab9-b94a-4ba3-8eb4-45917f7f4b12,arn:aws:ec2:eu-west-1:123456789012:subnet/subnet-12345678
```
func GetResourceAssociation ¶
func GetResourceAssociation(ctx *pulumi.Context, name string, id pulumi.IDInput, state *ResourceAssociationState, opts ...pulumi.ResourceOption) (*ResourceAssociation, error)
GetResourceAssociation gets an existing ResourceAssociation 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 NewResourceAssociation ¶
func NewResourceAssociation(ctx *pulumi.Context, name string, args *ResourceAssociationArgs, opts ...pulumi.ResourceOption) (*ResourceAssociation, error)
NewResourceAssociation registers a new resource with the given unique name, arguments, and options.
func (*ResourceAssociation) ElementType ¶
func (*ResourceAssociation) ElementType() reflect.Type
func (*ResourceAssociation) ToResourceAssociationOutput ¶
func (i *ResourceAssociation) ToResourceAssociationOutput() ResourceAssociationOutput
func (*ResourceAssociation) ToResourceAssociationOutputWithContext ¶
func (i *ResourceAssociation) ToResourceAssociationOutputWithContext(ctx context.Context) ResourceAssociationOutput
func (*ResourceAssociation) ToResourceAssociationPtrOutput ¶
func (i *ResourceAssociation) ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput
func (*ResourceAssociation) ToResourceAssociationPtrOutputWithContext ¶
func (i *ResourceAssociation) ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput
type ResourceAssociationArgs ¶
type ResourceAssociationArgs struct { // Amazon Resource Name (ARN) of the resource to associate with the RAM Resource Share. ResourceArn pulumi.StringInput ResourceShareArn pulumi.StringInput }
The set of arguments for constructing a ResourceAssociation resource.
func (ResourceAssociationArgs) ElementType ¶
func (ResourceAssociationArgs) ElementType() reflect.Type
type ResourceAssociationArray ¶
type ResourceAssociationArray []ResourceAssociationInput
func (ResourceAssociationArray) ElementType ¶
func (ResourceAssociationArray) ElementType() reflect.Type
func (ResourceAssociationArray) ToResourceAssociationArrayOutput ¶
func (i ResourceAssociationArray) ToResourceAssociationArrayOutput() ResourceAssociationArrayOutput
func (ResourceAssociationArray) ToResourceAssociationArrayOutputWithContext ¶
func (i ResourceAssociationArray) ToResourceAssociationArrayOutputWithContext(ctx context.Context) ResourceAssociationArrayOutput
type ResourceAssociationArrayInput ¶
type ResourceAssociationArrayInput interface { pulumi.Input ToResourceAssociationArrayOutput() ResourceAssociationArrayOutput ToResourceAssociationArrayOutputWithContext(context.Context) ResourceAssociationArrayOutput }
ResourceAssociationArrayInput is an input type that accepts ResourceAssociationArray and ResourceAssociationArrayOutput values. You can construct a concrete instance of `ResourceAssociationArrayInput` via:
ResourceAssociationArray{ ResourceAssociationArgs{...} }
type ResourceAssociationArrayOutput ¶
type ResourceAssociationArrayOutput struct{ *pulumi.OutputState }
func (ResourceAssociationArrayOutput) ElementType ¶
func (ResourceAssociationArrayOutput) ElementType() reflect.Type
func (ResourceAssociationArrayOutput) Index ¶
func (o ResourceAssociationArrayOutput) Index(i pulumi.IntInput) ResourceAssociationOutput
func (ResourceAssociationArrayOutput) ToResourceAssociationArrayOutput ¶
func (o ResourceAssociationArrayOutput) ToResourceAssociationArrayOutput() ResourceAssociationArrayOutput
func (ResourceAssociationArrayOutput) ToResourceAssociationArrayOutputWithContext ¶
func (o ResourceAssociationArrayOutput) ToResourceAssociationArrayOutputWithContext(ctx context.Context) ResourceAssociationArrayOutput
type ResourceAssociationInput ¶
type ResourceAssociationInput interface { pulumi.Input ToResourceAssociationOutput() ResourceAssociationOutput ToResourceAssociationOutputWithContext(ctx context.Context) ResourceAssociationOutput }
type ResourceAssociationMap ¶
type ResourceAssociationMap map[string]ResourceAssociationInput
func (ResourceAssociationMap) ElementType ¶
func (ResourceAssociationMap) ElementType() reflect.Type
func (ResourceAssociationMap) ToResourceAssociationMapOutput ¶
func (i ResourceAssociationMap) ToResourceAssociationMapOutput() ResourceAssociationMapOutput
func (ResourceAssociationMap) ToResourceAssociationMapOutputWithContext ¶
func (i ResourceAssociationMap) ToResourceAssociationMapOutputWithContext(ctx context.Context) ResourceAssociationMapOutput
type ResourceAssociationMapInput ¶
type ResourceAssociationMapInput interface { pulumi.Input ToResourceAssociationMapOutput() ResourceAssociationMapOutput ToResourceAssociationMapOutputWithContext(context.Context) ResourceAssociationMapOutput }
ResourceAssociationMapInput is an input type that accepts ResourceAssociationMap and ResourceAssociationMapOutput values. You can construct a concrete instance of `ResourceAssociationMapInput` via:
ResourceAssociationMap{ "key": ResourceAssociationArgs{...} }
type ResourceAssociationMapOutput ¶
type ResourceAssociationMapOutput struct{ *pulumi.OutputState }
func (ResourceAssociationMapOutput) ElementType ¶
func (ResourceAssociationMapOutput) ElementType() reflect.Type
func (ResourceAssociationMapOutput) MapIndex ¶
func (o ResourceAssociationMapOutput) MapIndex(k pulumi.StringInput) ResourceAssociationOutput
func (ResourceAssociationMapOutput) ToResourceAssociationMapOutput ¶
func (o ResourceAssociationMapOutput) ToResourceAssociationMapOutput() ResourceAssociationMapOutput
func (ResourceAssociationMapOutput) ToResourceAssociationMapOutputWithContext ¶
func (o ResourceAssociationMapOutput) ToResourceAssociationMapOutputWithContext(ctx context.Context) ResourceAssociationMapOutput
type ResourceAssociationOutput ¶
type ResourceAssociationOutput struct{ *pulumi.OutputState }
func (ResourceAssociationOutput) ElementType ¶
func (ResourceAssociationOutput) ElementType() reflect.Type
func (ResourceAssociationOutput) ToResourceAssociationOutput ¶
func (o ResourceAssociationOutput) ToResourceAssociationOutput() ResourceAssociationOutput
func (ResourceAssociationOutput) ToResourceAssociationOutputWithContext ¶
func (o ResourceAssociationOutput) ToResourceAssociationOutputWithContext(ctx context.Context) ResourceAssociationOutput
func (ResourceAssociationOutput) ToResourceAssociationPtrOutput ¶
func (o ResourceAssociationOutput) ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput
func (ResourceAssociationOutput) ToResourceAssociationPtrOutputWithContext ¶
func (o ResourceAssociationOutput) ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput
type ResourceAssociationPtrInput ¶
type ResourceAssociationPtrInput interface { pulumi.Input ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput }
type ResourceAssociationPtrOutput ¶
type ResourceAssociationPtrOutput struct{ *pulumi.OutputState }
func (ResourceAssociationPtrOutput) Elem ¶ added in v4.15.0
func (o ResourceAssociationPtrOutput) Elem() ResourceAssociationOutput
func (ResourceAssociationPtrOutput) ElementType ¶
func (ResourceAssociationPtrOutput) ElementType() reflect.Type
func (ResourceAssociationPtrOutput) ToResourceAssociationPtrOutput ¶
func (o ResourceAssociationPtrOutput) ToResourceAssociationPtrOutput() ResourceAssociationPtrOutput
func (ResourceAssociationPtrOutput) ToResourceAssociationPtrOutputWithContext ¶
func (o ResourceAssociationPtrOutput) ToResourceAssociationPtrOutputWithContext(ctx context.Context) ResourceAssociationPtrOutput
type ResourceAssociationState ¶
type ResourceAssociationState struct { // Amazon Resource Name (ARN) of the resource to associate with the RAM Resource Share. ResourceArn pulumi.StringPtrInput ResourceShareArn pulumi.StringPtrInput }
func (ResourceAssociationState) ElementType ¶
func (ResourceAssociationState) ElementType() reflect.Type
type ResourceShare ¶
type ResourceShare struct { pulumi.BoolPtrOutput `pulumi:"allowExternalPrincipals"` Arn pulumi.StringOutput `pulumi:"arn"` Name pulumi.StringOutput `pulumi:"name"` Tags pulumi.StringMapOutput `pulumi:"tags"` TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"` }AllowExternalPrincipals
Manages a Resource Access Manager (RAM) Resource Share. To associate principals with the share, see the `ram.PrincipalAssociation` resource. To associate resources with the share, see the `ram.ResourceAssociation` resource.
## Example Usage
```go package main
import (
"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 := ram.NewResourceShare(ctx, "example", &ram.ResourceShareArgs{ AllowExternalPrincipals: pulumi.Bool(true), Tags: pulumi.StringMap{ "Environment": pulumi.String("Production"), }, }) if err != nil { return err } return nil }) }
```
## Import
Resource shares can be imported using the `id`, e.g.
```sh
$ pulumi import aws:ram/resourceShare:ResourceShare example arn:aws:ram:eu-west-1:123456789012:resource-share/73da1ab9-b94a-4ba3-8eb4-45917f7f4b12
```
func GetResourceShare ¶
func GetResourceShare(ctx *pulumi.Context, name string, id pulumi.IDInput, state *ResourceShareState, opts ...pulumi.ResourceOption) (*ResourceShare, error)
GetResourceShare gets an existing ResourceShare 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 NewResourceShare ¶
func NewResourceShare(ctx *pulumi.Context, name string, args *ResourceShareArgs, opts ...pulumi.ResourceOption) (*ResourceShare, error)
NewResourceShare registers a new resource with the given unique name, arguments, and options.
func (*ResourceShare) ElementType ¶
func (*ResourceShare) ElementType() reflect.Type
func (*ResourceShare) ToResourceShareOutput ¶
func (i *ResourceShare) ToResourceShareOutput() ResourceShareOutput
func (*ResourceShare) ToResourceShareOutputWithContext ¶
func (i *ResourceShare) ToResourceShareOutputWithContext(ctx context.Context) ResourceShareOutput
func (*ResourceShare) ToResourceSharePtrOutput ¶
func (i *ResourceShare) ToResourceSharePtrOutput() ResourceSharePtrOutput
func (*ResourceShare) ToResourceSharePtrOutputWithContext ¶
func (i *ResourceShare) ToResourceSharePtrOutputWithContext(ctx context.Context) ResourceSharePtrOutput
type ResourceShareAccepter ¶
type ResourceShareAccepter struct { pulumi.StringOutput `pulumi:"invitationArn"` ReceiverAccountId pulumi.StringOutput `pulumi:"receiverAccountId"` Resources pulumi.StringArrayOutput `pulumi:"resources"` SenderAccountId pulumi.StringOutput `pulumi:"senderAccountId"` ShareArn pulumi.StringOutput `pulumi:"shareArn"` ShareId pulumi.StringOutput `pulumi:"shareId"` ShareName pulumi.StringOutput `pulumi:"shareName"` Status pulumi.StringOutput `pulumi:"status"` }InvitationArn
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
```
func GetResourceShareAccepter ¶
func GetResourceShareAccepter(ctx *pulumi.Context, name string, id pulumi.IDInput, state *ResourceShareAccepterState, opts ...pulumi.ResourceOption) (*ResourceShareAccepter, error)
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 NewResourceShareAccepter ¶
func NewResourceShareAccepter(ctx *pulumi.Context, name string, args *ResourceShareAccepterArgs, opts ...pulumi.ResourceOption) (*ResourceShareAccepter, error)
NewResourceShareAccepter registers a new resource with the given unique name, arguments, and options.
func (*ResourceShareAccepter) ElementType ¶
func (*ResourceShareAccepter) ElementType() reflect.Type
func (*ResourceShareAccepter) ToResourceShareAccepterOutput ¶
func (i *ResourceShareAccepter) ToResourceShareAccepterOutput() ResourceShareAccepterOutput
func (*ResourceShareAccepter) ToResourceShareAccepterOutputWithContext ¶
func (i *ResourceShareAccepter) ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput
func (*ResourceShareAccepter) ToResourceShareAccepterPtrOutput ¶
func (i *ResourceShareAccepter) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
func (*ResourceShareAccepter) ToResourceShareAccepterPtrOutputWithContext ¶
func (i *ResourceShareAccepter) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
type ResourceShareAccepterArgs ¶
type ResourceShareAccepterArgs struct { pulumi.StringInput }ShareArn
The set of arguments for constructing a ResourceShareAccepter resource.
func (ResourceShareAccepterArgs) ElementType ¶
func (ResourceShareAccepterArgs) ElementType() reflect.Type
type ResourceShareAccepterArray ¶
type ResourceShareAccepterArray []ResourceShareAccepterInput
func (ResourceShareAccepterArray) ElementType ¶
func (ResourceShareAccepterArray) ElementType() reflect.Type
func (ResourceShareAccepterArray) ToResourceShareAccepterArrayOutput ¶
func (i ResourceShareAccepterArray) ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput
func (ResourceShareAccepterArray) ToResourceShareAccepterArrayOutputWithContext ¶
func (i ResourceShareAccepterArray) ToResourceShareAccepterArrayOutputWithContext(ctx context.Context) ResourceShareAccepterArrayOutput
type ResourceShareAccepterArrayInput ¶
ResourceShareAccepterArrayInput is an input type that accepts ResourceShareAccepterArray and ResourceShareAccepterArrayOutput values. You can construct a concrete instance of `ResourceShareAccepterArrayInput` via:
ResourceShareAccepterArray{ ResourceShareAccepterArgs{...} }
type ResourceShareAccepterArrayOutput ¶
func (ResourceShareAccepterArrayOutput) ElementType ¶
func (ResourceShareAccepterArrayOutput) ElementType() reflect.Type
func (ResourceShareAccepterArrayOutput) Index ¶
func (o ResourceShareAccepterArrayOutput) Index(i pulumi.IntInput) ResourceShareAccepterOutput
func (ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutput ¶
func (o ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutput() ResourceShareAccepterArrayOutput
func (ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutputWithContext ¶
func (o ResourceShareAccepterArrayOutput) ToResourceShareAccepterArrayOutputWithContext(ctx context.Context) ResourceShareAccepterArrayOutput
type ResourceShareAccepterMap ¶
type ResourceShareAccepterMap map[string]ResourceShareAccepterInput
func (ResourceShareAccepterMap) ElementType ¶
func (ResourceShareAccepterMap) ElementType() reflect.Type
func (ResourceShareAccepterMap) ToResourceShareAccepterMapOutput ¶
func (i ResourceShareAccepterMap) ToResourceShareAccepterMapOutput() ResourceShareAccepterMapOutput
func (ResourceShareAccepterMap) ToResourceShareAccepterMapOutputWithContext ¶
func (i ResourceShareAccepterMap) ToResourceShareAccepterMapOutputWithContext(ctx context.Context) ResourceShareAccepterMapOutput
type ResourceShareAccepterMapInput ¶
ResourceShareAccepterMapInput is an input type that accepts ResourceShareAccepterMap and ResourceShareAccepterMapOutput values. You can construct a concrete instance of `ResourceShareAccepterMapInput` via:
ResourceShareAccepterMap{ "key": ResourceShareAccepterArgs{...} }
type ResourceShareAccepterMapOutput ¶
func (ResourceShareAccepterMapOutput) ElementType ¶
func (ResourceShareAccepterMapOutput) ElementType() reflect.Type
func (ResourceShareAccepterMapOutput) MapIndex ¶
func (o ResourceShareAccepterMapOutput) MapIndex(k pulumi.StringInput) ResourceShareAccepterOutput
func (ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutput ¶
func (o ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutput() ResourceShareAccepterMapOutput
func (ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutputWithContext ¶
func (o ResourceShareAccepterMapOutput) ToResourceShareAccepterMapOutputWithContext(ctx context.Context) ResourceShareAccepterMapOutput
type ResourceShareAccepterOutput ¶
func (ResourceShareAccepterOutput) ElementType ¶
func (ResourceShareAccepterOutput) ElementType() reflect.Type
func (ResourceShareAccepterOutput) ToResourceShareAccepterOutput ¶
func (o ResourceShareAccepterOutput) ToResourceShareAccepterOutput() ResourceShareAccepterOutput
func (ResourceShareAccepterOutput) ToResourceShareAccepterOutputWithContext ¶
func (o ResourceShareAccepterOutput) ToResourceShareAccepterOutputWithContext(ctx context.Context) ResourceShareAccepterOutput
func (ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutput ¶
func (o ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
func (ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutputWithContext ¶
func (o ResourceShareAccepterOutput) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
type ResourceShareAccepterPtrOutput ¶
func (ResourceShareAccepterPtrOutput) Elem ¶ added in v4.15.0
func (o ResourceShareAccepterPtrOutput) Elem() ResourceShareAccepterOutput
func (ResourceShareAccepterPtrOutput) ElementType ¶
func (ResourceShareAccepterPtrOutput) ElementType() reflect.Type
func (ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutput ¶
func (o ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutput() ResourceShareAccepterPtrOutput
func (ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutputWithContext ¶
func (o ResourceShareAccepterPtrOutput) ToResourceShareAccepterPtrOutputWithContext(ctx context.Context) ResourceShareAccepterPtrOutput
type ResourceShareAccepterState ¶
type ResourceShareAccepterState struct { pulumi.StringPtrInput ReceiverAccountId pulumi.StringPtrInput Resources pulumi.StringArrayInput SenderAccountId pulumi.StringPtrInput ShareArn pulumi.StringPtrInput ShareId pulumi.StringPtrInput ShareName pulumi.StringPtrInput Status pulumi.StringPtrInput }InvitationArn
func (ResourceShareAccepterState) ElementType ¶
func (ResourceShareAccepterState) ElementType() reflect.Type
type ResourceShareArgs ¶
type ResourceShareArgs struct { pulumi.BoolPtrInput Name pulumi.StringPtrInput Tags pulumi.StringMapInput }AllowExternalPrincipals
The set of arguments for constructing a ResourceShare resource.
func (ResourceShareArgs) ElementType ¶
func (ResourceShareArgs) ElementType() reflect.Type
type ResourceShareArray ¶
type ResourceShareArray []ResourceShareInput
func (ResourceShareArray) ElementType ¶
func (ResourceShareArray) ElementType() reflect.Type
func (ResourceShareArray) ToResourceShareArrayOutput ¶
func (i ResourceShareArray) ToResourceShareArrayOutput() ResourceShareArrayOutput
func (ResourceShareArray) ToResourceShareArrayOutputWithContext ¶
func (i ResourceShareArray) ToResourceShareArrayOutputWithContext(ctx context.Context) ResourceShareArrayOutput
type ResourceShareArrayInput ¶
ResourceShareArrayInput is an input type that accepts ResourceShareArray and ResourceShareArrayOutput values. You can construct a concrete instance of `ResourceShareArrayInput` via:
ResourceShareArray{ ResourceShareArgs{...} }
type ResourceShareArrayOutput ¶
func (ResourceShareArrayOutput) ElementType ¶
func (ResourceShareArrayOutput) ElementType() reflect.Type
func (ResourceShareArrayOutput) Index ¶
func (o ResourceShareArrayOutput) Index(i pulumi.IntInput) ResourceShareOutput
func (ResourceShareArrayOutput) ToResourceShareArrayOutput ¶
func (o ResourceShareArrayOutput) ToResourceShareArrayOutput() ResourceShareArrayOutput
func (ResourceShareArrayOutput) ToResourceShareArrayOutputWithContext ¶
func (o ResourceShareArrayOutput) ToResourceShareArrayOutputWithContext(ctx context.Context) ResourceShareArrayOutput
type ResourceShareInput ¶
type ResourceShareMap ¶
type ResourceShareMap map[string]ResourceShareInput
func (ResourceShareMap) ElementType ¶
func (ResourceShareMap) ElementType() reflect.Type
func (ResourceShareMap) ToResourceShareMapOutput ¶
func (i ResourceShareMap) ToResourceShareMapOutput() ResourceShareMapOutput
func (ResourceShareMap) ToResourceShareMapOutputWithContext ¶
func (i ResourceShareMap) ToResourceShareMapOutputWithContext(ctx context.Context) ResourceShareMapOutput
type ResourceShareMapInput ¶
ResourceShareMapInput is an input type that accepts ResourceShareMap and ResourceShareMapOutput values. You can construct a concrete instance of `ResourceShareMapInput` via:
ResourceShareMap{ "key": ResourceShareArgs{...} }
type ResourceShareMapOutput ¶
func (ResourceShareMapOutput) ElementType ¶
func (ResourceShareMapOutput) ElementType() reflect.Type
func (ResourceShareMapOutput) MapIndex ¶
func (o ResourceShareMapOutput) MapIndex(k pulumi.StringInput) ResourceShareOutput
func (ResourceShareMapOutput) ToResourceShareMapOutput ¶
func (o ResourceShareMapOutput) ToResourceShareMapOutput() ResourceShareMapOutput
func (ResourceShareMapOutput) ToResourceShareMapOutputWithContext ¶
func (o ResourceShareMapOutput) ToResourceShareMapOutputWithContext(ctx context.Context) ResourceShareMapOutput
type ResourceShareOutput ¶
func (ResourceShareOutput) ElementType ¶
func (ResourceShareOutput) ElementType() reflect.Type
func (ResourceShareOutput) ToResourceShareOutput ¶
func (o ResourceShareOutput) ToResourceShareOutput() ResourceShareOutput
func (ResourceShareOutput) ToResourceShareOutputWithContext ¶
func (o ResourceShareOutput) ToResourceShareOutputWithContext(ctx context.Context) ResourceShareOutput
func (ResourceShareOutput) ToResourceSharePtrOutput ¶
func (o ResourceShareOutput) ToResourceSharePtrOutput() ResourceSharePtrOutput
func (ResourceShareOutput) ToResourceSharePtrOutputWithContext ¶
func (o ResourceShareOutput) ToResourceSharePtrOutputWithContext(ctx context.Context) ResourceSharePtrOutput
type ResourceSharePtrInput ¶
type ResourceSharePtrOutput ¶
func (ResourceSharePtrOutput) Elem ¶ added in v4.15.0
func (o ResourceSharePtrOutput) Elem() ResourceShareOutput
func (ResourceSharePtrOutput) ElementType ¶
func (ResourceSharePtrOutput) ElementType() reflect.Type
func (ResourceSharePtrOutput) ToResourceSharePtrOutput ¶
func (o ResourceSharePtrOutput) ToResourceSharePtrOutput() ResourceSharePtrOutput
func (ResourceSharePtrOutput) ToResourceSharePtrOutputWithContext ¶
func (o ResourceSharePtrOutput) ToResourceSharePtrOutputWithContext(ctx context.Context) ResourceSharePtrOutput
type ResourceShareState ¶
type ResourceShareState struct { pulumi.BoolPtrInput Arn pulumi.StringPtrInput Name pulumi.StringPtrInput Tags pulumi.StringMapInput TagsAll pulumi.StringMapInput }AllowExternalPrincipals
func (ResourceShareState) ElementType ¶
func (ResourceShareState) ElementType() reflect.Type