pulumi-aws-kotlin/com.pulumi.aws.ec2.kotlin/VpcIpamResourceDiscoveryAssociation

VpcIpamResourceDiscoveryAssociation

class VpcIpamResourceDiscoveryAssociation : KotlinCustomResource

Provides an association between an Amazon IP Address Manager (IPAM) and a IPAM Resource Discovery. IPAM Resource Discoveries are resources meant for multi-organization customers. If you wish to use a single IPAM across multiple orgs, a resource discovery can be created and shared from a subordinate organization to the management organizations IPAM delegated admin account. Once an association is created between two organizations via IPAM & a IPAM Resource Discovery, IPAM Pools can be shared via Resource Access Manager (RAM) to accounts in the subordinate organization; these RAM shares must be accepted by the end user account. Pools can then also discover and monitor IPAM resources in the subordinate organization.

Example Usage

Basic usage:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.ec2.VpcIpamResourceDiscoveryAssociation("test", {
    ipamId: testAwsVpcIpam.id,
    ipamResourceDiscoveryId: testAwsVpcIpamResourceDiscovery.id,
    tags: {
        Name: "test",
    },
});

import pulumi
import pulumi_aws as aws
test = aws.ec2.VpcIpamResourceDiscoveryAssociation("test",
    ipam_id=test_aws_vpc_ipam["id"],
    ipam_resource_discovery_id=test_aws_vpc_ipam_resource_discovery["id"],
    tags={
        "Name": "test",
    })

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var test = new Aws.Ec2.VpcIpamResourceDiscoveryAssociation("test", new()
    {
        IpamId = testAwsVpcIpam.Id,
        IpamResourceDiscoveryId = testAwsVpcIpamResourceDiscovery.Id,
        Tags =
        {
            { "Name", "test" },
        },
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.NewVpcIpamResourceDiscoveryAssociation(ctx, "test", &ec2.VpcIpamResourceDiscoveryAssociationArgs{
			IpamId:                  pulumi.Any(testAwsVpcIpam.Id),
			IpamResourceDiscoveryId: pulumi.Any(testAwsVpcIpamResourceDiscovery.Id),
			Tags: pulumi.StringMap{
				"Name": pulumi.String("test"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.VpcIpamResourceDiscoveryAssociation;
import com.pulumi.aws.ec2.VpcIpamResourceDiscoveryAssociationArgs;
import java.util.List;
import java.util.ArrayList;
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 test = new VpcIpamResourceDiscoveryAssociation("test", VpcIpamResourceDiscoveryAssociationArgs.builder()
            .ipamId(testAwsVpcIpam.id())
            .ipamResourceDiscoveryId(testAwsVpcIpamResourceDiscovery.id())
            .tags(Map.of("Name", "test"))
            .build());
    }
}

resources:
  test:
    type: aws:ec2:VpcIpamResourceDiscoveryAssociation
    properties:
      ipamId: ${testAwsVpcIpam.id}
      ipamResourceDiscoveryId: ${testAwsVpcIpamResourceDiscovery.id}
      tags:
        Name: test

Import

Using pulumi import, import IPAMs using the IPAM resource discovery association id. For example:

$ pulumi import aws:ec2/vpcIpamResourceDiscoveryAssociation:VpcIpamResourceDiscoveryAssociation example ipam-res-disco-assoc-0178368ad2146a492

Properties

arn

val arn: Output<String>

The Amazon Resource Name (ARN) of IPAM Resource Discovery Association.

val id: Output<String>

ipamArn

val ipamArn: Output<String>

The Amazon Resource Name (ARN) of the IPAM.

ipamId

val ipamId: Output<String>

The ID of the IPAM to associate.

ipamRegion

val ipamRegion: Output<String>

The home region of the IPAM.

ipamResourceDiscoveryId

val ipamResourceDiscoveryId: Output<String>

The ID of the Resource Discovery to associate.

isDefault

val isDefault: Output<Boolean>

A boolean to identify if the Resource Discovery is the accounts default resource discovery.

ownerId

val ownerId: Output<String>

The account ID for the account that manages the Resource Discovery

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

state

val state: Output<String>

The lifecycle state of the association when you associate or disassociate a resource discovery.