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

ResourceShareAssociationsExclusive(String name, {ResourceShareAssociationsExclusiveArgs? args, CustomResourceOptions? options})
Creates a new ResourceShareAssociationsExclusive. name The Pulumi resource name. args Arguments used to configure this ResourceShareAssociationsExclusive. The set of arguments for ResourceShareAssociationsExclusive. options Resource options controlling this resource's behavior.
ResourceShareAssociationsExclusive.reference(String urn)
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
resourceShareArn ↔ Output<String>
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 principals contains 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 name and id.