ResourceShareAssociationsExclusive class
Resource for maintaining exclusive management of principal and resource associations for an AWS RAM (Resource Access Manager) Resource Share.
> This resource takes exclusive ownership over principal and resource associations for a resource share. This includes removal of principals and resources which are not explicitly configured.
> Destruction of this resource will disassociate all configured principals and resources from the resource share.
> NOTE: This resource cannot be used in conjunction with aws.ram.PrincipalAssociation or aws.ram.ResourceAssociation for the same resource share. Using them together will cause persistent drift and conflicts.
Example Usage
Basic Usage with Principals
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.ram.ResourceShare("example", {
name: "example",
allowExternalPrincipals: true,
});
const exampleVpc = new aws.ec2.Vpc("example", {cidrBlock: "10.0.0.0/16"});
const exampleSubnet = new aws.ec2.Subnet("example", {
vpcId: exampleVpc.id,
cidrBlock: "10.0.1.0/24",
});
const exampleResourceShareAssociationsExclusive = new aws.ram.ResourceShareAssociationsExclusive("example", {
resourceShareArn: example.arn,
principals: [
"111111111111",
"222222222222",
],
resourceArns: [exampleSubnet.arn],
});
import pulumi
import pulumi_aws as aws
example = aws.ram.ResourceShare("example",
name="example",
allow_external_principals=True)
example_vpc = aws.ec2.Vpc("example", cidr_block="10.0.0.0/16")
example_subnet = aws.ec2.Subnet("example",
vpc_id=example_vpc.id,
cidr_block="10.0.1.0/24")
example_resource_share_associations_exclusive = aws.ram.ResourceShareAssociationsExclusive("example",
resource_share_arn=example.arn,
principals=[
"111111111111",
"222222222222",
],
resource_arns=[example_subnet.arn])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Ram.ResourceShare("example", new()
{
Name = "example",
AllowExternalPrincipals = true,
});
var exampleVpc = new Aws.Ec2.Vpc("example", new()
{
CidrBlock = "10.0.0.0/16",
});
var exampleSubnet = new Aws.Ec2.Subnet("example", new()
{
VpcId = exampleVpc.Id,
CidrBlock = "10.0.1.0/24",
});
var exampleResourceShareAssociationsExclusive = new Aws.Ram.ResourceShareAssociationsExclusive("example", new()
{
ResourceShareArn = example.Arn,
Principals = new[]
{
"111111111111",
"222222222222",
},
ResourceArns = new[]
{
exampleSubnet.Arn,
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ram"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := ram.NewResourceShare(ctx, "example", &ram.ResourceShareArgs{
Name: pulumi.String("example"),
AllowExternalPrincipals: pulumi.Bool(true),
})
if err != nil {
return err
}
exampleVpc, err := ec2.NewVpc(ctx, "example", &ec2.VpcArgs{
CidrBlock: pulumi.String("10.0.0.0/16"),
})
if err != nil {
return err
}
exampleSubnet, err := ec2.NewSubnet(ctx, "example", &ec2.SubnetArgs{
VpcId: exampleVpc.ID().ToIDOutput().ToStringOutput(),
CidrBlock: pulumi.String("10.0.1.0/24"),
})
if err != nil {
return err
}
_, err = ram.NewResourceShareAssociationsExclusive(ctx, "example", &ram.ResourceShareAssociationsExclusiveArgs{
ResourceShareArn: example.Arn,
Principals: pulumi.StringArray{
pulumi.String("111111111111"),
pulumi.String("222222222222"),
},
ResourceArns: pulumi.StringArray{
exampleSubnet.Arn,
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_ram_resourceshare" "example" {
name = "example"
allow_external_principals = true
}
resource "aws_ec2_vpc" "example" {
cidr_block = "10.0.0.0/16"
}
resource "aws_ec2_subnet" "example" {
vpc_id = aws_ec2_vpc.example.id
cidr_block = "10.0.1.0/24"
}
resource "aws_ram_resourceshareassociationsexclusive" "example" {
resource_share_arn = aws_ram_resourceshare.example.arn
principals = ["111111111111", "222222222222"]
resource_arns = [aws_ec2_subnet.example.arn]
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ram.ResourceShare;
import com.pulumi.aws.ram.ResourceShareArgs;
import com.pulumi.aws.ec2.Vpc;
import com.pulumi.aws.ec2.VpcArgs;
import com.pulumi.aws.ec2.Subnet;
import com.pulumi.aws.ec2.SubnetArgs;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusive;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusiveArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new ResourceShare("example", ResourceShareArgs.builder()
.name("example")
.allowExternalPrincipals(true)
.build());
var exampleVpc = new Vpc("exampleVpc", VpcArgs.builder()
.cidrBlock("10.0.0.0/16")
.build());
var exampleSubnet = new Subnet("exampleSubnet", SubnetArgs.builder()
.vpcId(exampleVpc.id())
.cidrBlock("10.0.1.0/24")
.build());
var exampleResourceShareAssociationsExclusive = new ResourceShareAssociationsExclusive("exampleResourceShareAssociationsExclusive", ResourceShareAssociationsExclusiveArgs.builder()
.resourceShareArn(example.arn())
.principals(
"111111111111",
"222222222222")
.resourceArns(exampleSubnet.arn())
.build());
}
}
resources:
example:
type: aws:ram:ResourceShare
properties:
name: example
allowExternalPrincipals: true
exampleVpc:
type: aws:ec2:Vpc
name: example
properties:
cidrBlock: 10.0.0.0/16
exampleSubnet:
type: aws:ec2:Subnet
name: example
properties:
vpcId: ${exampleVpc.id}
cidrBlock: 10.0.1.0/24
exampleResourceShareAssociationsExclusive:
type: aws:ram:ResourceShareAssociationsExclusive
name: example
properties:
resourceShareArn: ${example.arn}
principals:
- '111111111111'
- '222222222222'
resourceArns:
- ${exampleSubnet.arn}
With Organization Principal
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
import * as std from "@pulumi/std";
const example = new aws.ram.ResourceShare("example", {name: "example"});
const exampleVpc = new aws.ec2.Vpc("example", {cidrBlock: "10.0.0.0/16"});
const exampleSubnet: aws.ec2.Subnet[] = [];
for (let range = 0; range < 2; range++) {
exampleSubnet.push(new aws.ec2.Subnet(`example-${range}`, {
vpcId: exampleVpc.id,
cidrBlock: std.cidrsubnetOutput({
input: exampleVpc.cidrBlock,
newbits: 8,
netnum: range,
}).result,
}));
}
const exampleResourceShareAssociationsExclusive = new aws.ram.ResourceShareAssociationsExclusive("example", {
resourceShareArn: example.arn,
principals: [exampleAwsOrganizationsOrganization.arn],
resourceArns: exampleSubnet.map(__item => __item.arn),
});
import pulumi
from typing import Any
import pulumi_aws as aws
import pulumi_std as std
example = aws.ram.ResourceShare("example", name="example")
example_vpc = aws.ec2.Vpc("example", cidr_block="10.0.0.0/16")
example_subnet: list[aws.ec2.Subnet] = []
for example_subnet_range in [{"value": i} for i in range(0, 2)]:
example_subnet.append(aws.ec2.Subnet(f"example-{example_subnet_range['value']}",
vpc_id=example_vpc.id,
cidr_block=std.cidrsubnet_output(input=example_vpc.cidr_block,
newbits=8,
netnum=example_subnet_range["value"]).result))
example_resource_share_associations_exclusive = aws.ram.ResourceShareAssociationsExclusive("example",
resource_share_arn=example.arn,
principals=[example_aws_organizations_organization["arn"]],
resource_arns=[__item.arn for __item in example_subnet])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
using Std = Pulumi.Std;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Ram.ResourceShare("example", new()
{
Name = "example",
});
var exampleVpc = new Aws.Ec2.Vpc("example", new()
{
CidrBlock = "10.0.0.0/16",
});
var exampleSubnet = new List<Aws.Ec2.Subnet>();
for (var rangeIndex = 0; rangeIndex < 2; rangeIndex++)
{
var range = new { Value = rangeIndex };
exampleSubnet.Add(new Aws.Ec2.Subnet($"example-{range.Value}", new()
{
VpcId = exampleVpc.Id,
CidrBlock = Std.Cidrsubnet.Invoke(new()
{
Input = exampleVpc.CidrBlock,
Newbits = 8,
Netnum = range.Value,
}).Apply(invoke => invoke.Result),
}));
}
var exampleResourceShareAssociationsExclusive = new Aws.Ram.ResourceShareAssociationsExclusive("example", new()
{
ResourceShareArn = example.Arn,
Principals = new[]
{
exampleAwsOrganizationsOrganization.Arn,
},
ResourceArns = exampleSubnet.Select(__item => __item.Arn).ToList(),
});
});
package main
import (
"fmt"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ram"
"github.com/pulumi/pulumi-std/sdk/go/std"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := ram.NewResourceShare(ctx, "example", &ram.ResourceShareArgs{
Name: pulumi.String("example"),
})
if err != nil {
return err
}
exampleVpc, err := ec2.NewVpc(ctx, "example", &ec2.VpcArgs{
CidrBlock: pulumi.String("10.0.0.0/16"),
})
if err != nil {
return err
}
var exampleSubnet []*ec2.Subnet
for index := 0; index < 2; index++ {
key0 := index
val0 := index
__res, err := ec2.NewSubnet(ctx, fmt.Sprintf("example-%v", key0), &ec2.SubnetArgs{
VpcId: exampleVpc.ID().ToIDOutput().ToStringOutput(),
CidrBlock: std.CidrsubnetOutput(ctx, std.CidrsubnetOutputArgs{
Input: exampleVpc.CidrBlock,
Newbits: pulumi.Int(8),
Netnum: pulumi.Int(val0),
}, nil).Result(),
})
if err != nil {
return err
}
exampleSubnet = append(exampleSubnet, __res)
}
var splat0 pulumi.StringArray
for _, val0 := range exampleSubnet {
splat0 = append(splat0, val0.Arn)
}
_, err = ram.NewResourceShareAssociationsExclusive(ctx, "example", &ram.ResourceShareAssociationsExclusiveArgs{
ResourceShareArn: example.Arn,
Principals: pulumi.StringArray{
exampleAwsOrganizationsOrganization.Arn,
},
ResourceArns: splat0,
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
std = {
source = "pulumi/std"
}
}
}
resource "aws_ram_resourceshare" "example" {
name = "example"
}
resource "aws_ec2_vpc" "example" {
cidr_block = "10.0.0.0/16"
}
resource "aws_ec2_subnet" "example" {
count = 2
vpc_id = aws_ec2_vpc.example.id
cidr_block = cidrsubnet(aws_ec2_vpc.example.cidr_block, 8, count.index)
}
resource "aws_ram_resourceshareassociationsexclusive" "example" {
resource_share_arn = aws_ram_resourceshare.example.arn
principals = [exampleAwsOrganizationsOrganization.arn]
resource_arns = aws_ec2_subnet.example[*].arn
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ram.ResourceShare;
import com.pulumi.aws.ram.ResourceShareArgs;
import com.pulumi.aws.ec2.Vpc;
import com.pulumi.aws.ec2.VpcArgs;
import com.pulumi.aws.ec2.Subnet;
import com.pulumi.aws.ec2.SubnetArgs;
import com.pulumi.std.StdFunctions;
import com.pulumi.std.inputs.CidrsubnetArgs;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusive;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusiveArgs;
import com.pulumi.codegen.internal.KeyedValue;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new ResourceShare("example", ResourceShareArgs.builder()
.name("example")
.build());
var exampleVpc = new Vpc("exampleVpc", VpcArgs.builder()
.cidrBlock("10.0.0.0/16")
.build());
for (var i = 0; i < 2; i++) {
new Subnet("exampleSubnet-" + i, SubnetArgs.builder()
.vpcId(exampleVpc.id())
.cidrBlock(StdFunctions.cidrsubnet(CidrsubnetArgs.builder()
.input(exampleVpc.cidrBlock())
.newbits(8)
.netnum(range.value())
.build()).applyValue(_invoke -> _invoke.result()))
.build());
}
var exampleResourceShareAssociationsExclusive = new ResourceShareAssociationsExclusive("exampleResourceShareAssociationsExclusive", ResourceShareAssociationsExclusiveArgs.builder()
.resourceShareArn(example.arn())
.principals(exampleAwsOrganizationsOrganization.arn())
.resourceArns(exampleSubnet.stream().map(element -> element.arn()).collect(toList()))
.build());
}
}
With Service Principals
When sharing resources with AWS services, use service principals. Service principals follow the pattern service-id.amazonaws.com (e.g., pca-connector-ad.amazonaws.com, elasticmapreduce.amazonaws.com). The sources argument can be used to restrict which AWS accounts the service can access the shared resources from.
> NOTE: Service principals cannot be mixed with other principal types (AWS account IDs, organization ARNs, OU ARNs, IAM role ARNs, or IAM user ARNs) in the same resource.
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.ram.ResourceShare("example", {
name: "example-service-share",
allowExternalPrincipals: true,
});
const exampleCertificateAuthority = new aws.acmpca.CertificateAuthority("example", {
certificateAuthorityConfiguration: {
subject: {
commonName: "example.com",
},
keyAlgorithm: "RSA_4096",
signingAlgorithm: "SHA512WITHRSA",
},
type: "ROOT",
});
const exampleResourceShareAssociationsExclusive = new aws.ram.ResourceShareAssociationsExclusive("example", {
resourceShareArn: example.arn,
principals: ["pca-connector-ad.amazonaws.com"],
resourceArns: [exampleCertificateAuthority.arn],
sources: [
"111111111111",
"222222222222",
],
});
import pulumi
import pulumi_aws as aws
example = aws.ram.ResourceShare("example",
name="example-service-share",
allow_external_principals=True)
example_certificate_authority = aws.acmpca.CertificateAuthority("example",
certificate_authority_configuration={
"subject": {
"common_name": "example.com",
},
"key_algorithm": "RSA_4096",
"signing_algorithm": "SHA512WITHRSA",
},
type="ROOT")
example_resource_share_associations_exclusive = aws.ram.ResourceShareAssociationsExclusive("example",
resource_share_arn=example.arn,
principals=["pca-connector-ad.amazonaws.com"],
resource_arns=[example_certificate_authority.arn],
sources=[
"111111111111",
"222222222222",
])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Ram.ResourceShare("example", new()
{
Name = "example-service-share",
AllowExternalPrincipals = true,
});
var exampleCertificateAuthority = new Aws.Acmpca.CertificateAuthority("example", new()
{
CertificateAuthorityConfiguration = new Aws.Acmpca.Inputs.CertificateAuthorityCertificateAuthorityConfigurationArgs
{
Subject = new Aws.Acmpca.Inputs.CertificateAuthorityCertificateAuthorityConfigurationSubjectArgs
{
CommonName = "example.com",
},
KeyAlgorithm = "RSA_4096",
SigningAlgorithm = "SHA512WITHRSA",
},
Type = "ROOT",
});
var exampleResourceShareAssociationsExclusive = new Aws.Ram.ResourceShareAssociationsExclusive("example", new()
{
ResourceShareArn = example.Arn,
Principals = new[]
{
"pca-connector-ad.amazonaws.com",
},
ResourceArns = new[]
{
exampleCertificateAuthority.Arn,
},
Sources = new[]
{
"111111111111",
"222222222222",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/acmpca"
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ram"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := ram.NewResourceShare(ctx, "example", &ram.ResourceShareArgs{
Name: pulumi.String("example-service-share"),
AllowExternalPrincipals: pulumi.Bool(true),
})
if err != nil {
return err
}
exampleCertificateAuthority, err := acmpca.NewCertificateAuthority(ctx, "example", &acmpca.CertificateAuthorityArgs{
CertificateAuthorityConfiguration: &acmpca.CertificateAuthorityCertificateAuthorityConfigurationArgs{
Subject: &acmpca.CertificateAuthorityCertificateAuthorityConfigurationSubjectArgs{
CommonName: pulumi.String("example.com"),
},
KeyAlgorithm: pulumi.String("RSA_4096"),
SigningAlgorithm: pulumi.String("SHA512WITHRSA"),
},
Type: pulumi.String("ROOT"),
})
if err != nil {
return err
}
_, err = ram.NewResourceShareAssociationsExclusive(ctx, "example", &ram.ResourceShareAssociationsExclusiveArgs{
ResourceShareArn: example.Arn,
Principals: pulumi.StringArray{
pulumi.String("pca-connector-ad.amazonaws.com"),
},
ResourceArns: pulumi.StringArray{
exampleCertificateAuthority.Arn,
},
Sources: pulumi.StringArray{
pulumi.String("111111111111"),
pulumi.String("222222222222"),
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_ram_resourceshare" "example" {
name = "example-service-share"
allow_external_principals = true
}
resource "aws_acmpca_certificateauthority" "example" {
certificate_authority_configuration = {
subject = {
common_name = "example.com"
}
key_algorithm = "RSA_4096"
signing_algorithm = "SHA512WITHRSA"
}
type = "ROOT"
}
resource "aws_ram_resourceshareassociationsexclusive" "example" {
resource_share_arn = aws_ram_resourceshare.example.arn
principals = ["pca-connector-ad.amazonaws.com"]
resource_arns = [aws_acmpca_certificateauthority.example.arn]
sources = ["111111111111", "222222222222"]
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ram.ResourceShare;
import com.pulumi.aws.ram.ResourceShareArgs;
import com.pulumi.aws.acmpca.CertificateAuthority;
import com.pulumi.aws.acmpca.CertificateAuthorityArgs;
import com.pulumi.aws.acmpca.inputs.CertificateAuthorityCertificateAuthorityConfigurationArgs;
import com.pulumi.aws.acmpca.inputs.CertificateAuthorityCertificateAuthorityConfigurationSubjectArgs;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusive;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusiveArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new ResourceShare("example", ResourceShareArgs.builder()
.name("example-service-share")
.allowExternalPrincipals(true)
.build());
var exampleCertificateAuthority = new CertificateAuthority("exampleCertificateAuthority", CertificateAuthorityArgs.builder()
.certificateAuthorityConfiguration(CertificateAuthorityCertificateAuthorityConfigurationArgs.builder()
.subject(CertificateAuthorityCertificateAuthorityConfigurationSubjectArgs.builder()
.commonName("example.com")
.build())
.keyAlgorithm("RSA_4096")
.signingAlgorithm("SHA512WITHRSA")
.build())
.type("ROOT")
.build());
var exampleResourceShareAssociationsExclusive = new ResourceShareAssociationsExclusive("exampleResourceShareAssociationsExclusive", ResourceShareAssociationsExclusiveArgs.builder()
.resourceShareArn(example.arn())
.principals("pca-connector-ad.amazonaws.com")
.resourceArns(exampleCertificateAuthority.arn())
.sources(
"111111111111",
"222222222222")
.build());
}
}
resources:
example:
type: aws:ram:ResourceShare
properties:
name: example-service-share
allowExternalPrincipals: true
exampleCertificateAuthority:
type: aws:acmpca:CertificateAuthority
name: example
properties:
certificateAuthorityConfiguration:
subject:
commonName: example.com
keyAlgorithm: RSA_4096
signingAlgorithm: SHA512WITHRSA
type: ROOT
exampleResourceShareAssociationsExclusive:
type: aws:ram:ResourceShareAssociationsExclusive
name: example
properties:
resourceShareArn: ${example.arn}
principals:
- pca-connector-ad.amazonaws.com
resourceArns:
- ${exampleCertificateAuthority.arn}
sources:
- '111111111111'
- '222222222222'
Disallow All Associations
To automatically remove any configured associations, omit the principals and resourceArns arguments or set them to empty lists.
> This will not prevent associations from being created via Terraform (or any other interface). This resource enables bringing associations into a configured state, however, this reconciliation happens only when apply is proactively run.
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = new aws.ram.ResourceShareAssociationsExclusive("example", {resourceShareArn: exampleAwsRamResourceShare.arn});
import pulumi
import pulumi_aws as aws
example = aws.ram.ResourceShareAssociationsExclusive("example", resource_share_arn=example_aws_ram_resource_share["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = new Aws.Ram.ResourceShareAssociationsExclusive("example", new()
{
ResourceShareArn = exampleAwsRamResourceShare.Arn,
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ram"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := ram.NewResourceShareAssociationsExclusive(ctx, "example", &ram.ResourceShareAssociationsExclusiveArgs{
ResourceShareArn: pulumi.Any(exampleAwsRamResourceShare.Arn),
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_ram_resourceshareassociationsexclusive" "example" {
resource_share_arn = exampleAwsRamResourceShare.arn
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusive;
import com.pulumi.aws.ram.ResourceShareAssociationsExclusiveArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new ResourceShareAssociationsExclusive("example", ResourceShareAssociationsExclusiveArgs.builder()
.resourceShareArn(exampleAwsRamResourceShare.arn())
.build());
}
}
resources:
example:
type: aws:ram:ResourceShareAssociationsExclusive
properties:
resourceShareArn: ${exampleAwsRamResourceShare.arn}
Import
Identity Schema
Required
resourceShareArn(String) ARN of the RAM resource share.
Using pulumi import, import RAM Resource Share Association Exclusive using the resourceShareArn. For example:
$ pulumi import aws:ram/resourceShareAssociationsExclusive:ResourceShareAssociationsExclusive example arn:aws:ram:eu-west-1:123456789012:resource-share/73da1ab9-b94a-4ba3-8eb4-45917f7f4b12
Constructors
-
Creates a new ResourceShareAssociationsExclusive.
nameThe Pulumi resource name.argsArguments used to configure this ResourceShareAssociationsExclusive. The set of arguments for ResourceShareAssociationsExclusive.optionsResource options controlling this resource's behavior. - Creates a typed reference to an existing ResourceShareAssociationsExclusive resource.
Properties
-
childResources
→ Set<
Resource> -
finalinherited
-
completionSources
↔ Map<
String, IOutputCompletionSource> -
latefinalinherited
- hashCode → int
-
The hash code for this object.
no setterinherited
-
id
↔ Output<
String> -
getter/setter pairinherited
- isCustom → bool
-
Returns whether this resource is provider-managed.
no setterinherited
- isProtected → bool
-
Returns whether this resource is protected from deletion.
no setterinherited
- isRemote → bool
-
Whether this resource is registered as remote.
no setterinherited
- isResourceReference → bool
-
Whether this instance represents a resource value returned over RPC.
finalinherited
-
principals
↔ Output<
List< String> ?> -
Set of principals to associate with the resource share. Principals not configured in this argument will be removed. Valid values include: AWS account ID (exactly 12 digits, e.g.,
123456789012), AWS Organizations Organization ARN (e.g.,arn:aws:organizations::123456789012:organization/o-exampleorgid), AWS Organizations Organizational Unit ARN (e.g.,arn:aws:organizations::123456789012:ou/o-exampleorgid/ou-examplerootid-exampleouid), IAM role ARN (e.g.,arn:aws:iam::123456789012:role/example-role), IAM user ARN (e.g.,arn:aws:iam::123456789012:user/example-user), or service principal (e.g.,ec2.amazonaws.com).latefinal -
region
↔ Output<
String> -
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
-
resourceArns
↔ Output<
List< String> ?> -
Set of ARNs of resources to associate with the resource share. Resources not configured in this argument will be removed.
latefinal
-
ARN of the resource share. Changing this value forces creation of a new resource.
latefinal
-
resourceTransforms
→ List<
ResourceTransform> -
Inherited/explicit async transforms.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
-
sources
↔ Output<
List< String> ?> -
Set of AWS account IDs that restrict which accounts a service principal can access resources from. This argument can only be specified when
principalscontains only service principals. When specified, it limits the source accounts from which the service can access the shared resources.latefinal -
transformations
→ List<
ResourceTransformation> -
Inherited/explicit legacy transformations.
no setterinherited
-
urn
↔ Output<
String> -
latefinalinherited
Methods
-
failId(
Object error) → void -
Completes this resource ID with an error when registration fails.
inherited
-
failOutputs(
Object error) → void -
Completes all output properties with
error.inherited -
failUrn(
Object error) → void -
Completes this resource URN with an error when registration fails.
inherited
-
getProvider(
String moduleMember) → ProviderResource? -
Returns provider for
moduleMember's package, if configured.inherited -
getResourceName(
) → String -
Returns this resource's logical name.
inherited
-
getResourceType(
) → String -
Returns this resource's Pulumi type token.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
registerOutput<
T> (String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output< T> -
Registers a dynamic output property for this resource.
inherited
-
resolveId(
String? value, {required bool isKnown}) → void -
Resolves the provider-assigned ID for this resource.
inherited
-
resolveOutputs(
Struct outputs) → void -
Resolves all output properties from a monitor response payload.
inherited
-
resolveUrn(
String value) → void -
Resolves this resource's URN once assigned by the engine.
inherited
-
serializeProperties(
Map< String, dynamic> properties) → Future<Struct> -
Serializes resource properties for RPC transmission.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Static Methods
-
get(
String name, Input< String> id, {ResourceShareAssociationsExclusiveState? state, CustomResourceOptions? options}) → ResourceShareAssociationsExclusive -
Gets an existing ResourceShareAssociationsExclusive resource's state with the given
nameandid.