Association class

Provides a License Manager association.

> Note: License configurations can also be associated with launch templates by specifying the licenseSpecifications block for an aws.ec2.LaunchTemplate.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = aws.ec2.getAmi({
    filters: [{
        name: "name",
        values: ["amzn-ami-vpc-nat*"],
    }],
    mostRecent: true,
    owners: ["amazon"],
});
const exampleInstance = new aws.ec2.Instance("example", {
    ami: example.then(example => example.id),
    instanceType: aws.ec2.InstanceType.T2_Micro,
});
const exampleLicenseConfiguration = new aws.licensemanager.LicenseConfiguration("example", {
    name: "Example",
    licenseCountingType: "Instance",
});
const exampleAssociation = new aws.licensemanager.Association("example", {
    licenseConfigurationArn: exampleLicenseConfiguration.arn,
    resourceArn: exampleInstance.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.ec2.get_ami(filters=[{
        "name": "name",
        "values": ["amzn-ami-vpc-nat*"],
    }],
    most_recent=True,
    owners=["amazon"])
example_instance = aws.ec2.Instance("example",
    ami=example.id,
    instance_type=aws.ec2.InstanceType.T2_MICRO)
example_license_configuration = aws.licensemanager.LicenseConfiguration("example",
    name="Example",
    license_counting_type="Instance")
example_association = aws.licensemanager.Association("example",
    license_configuration_arn=example_license_configuration.arn,
    resource_arn=example_instance.arn)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = Aws.Ec2.GetAmi.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.Ec2.Inputs.GetAmiFilterInputArgs
            {
                Name = "name",
                Values = new[]
                {
                    "amzn-ami-vpc-nat*",
                },
            },
        },
        MostRecent = true,
        Owners = new[]
        {
            "amazon",
        },
    });

    var exampleInstance = new Aws.Ec2.Instance("example", new()
    {
        Ami = example.Apply(getAmiResult => getAmiResult.Id),
        InstanceType = Aws.Ec2.InstanceType.T2_Micro,
    });

    var exampleLicenseConfiguration = new Aws.LicenseManager.LicenseConfiguration("example", new()
    {
        Name = "Example",
        LicenseCountingType = "Instance",
    });

    var exampleAssociation = new Aws.LicenseManager.Association("example", new()
    {
        LicenseConfigurationArn = exampleLicenseConfiguration.Arn,
        ResourceArn = exampleInstance.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := ec2.LookupAmi(ctx, &ec2.LookupAmiArgs{
			Filters: []ec2.GetAmiFilter{
				{
					Name: "name",
					Values: []string{
						"amzn-ami-vpc-nat*",
					},
				},
			},
			MostRecent: pulumi.BoolRef(true),
			Owners: []string{
				"amazon",
			},
		}, nil)
		if err != nil {
			return err
		}
		exampleInstance, err := ec2.NewInstance(ctx, "example", &ec2.InstanceArgs{
			Ami:          pulumi.String(example.Id),
			InstanceType: pulumi.String(ec2.InstanceType_T2_Micro),
		})
		if err != nil {
			return err
		}
		exampleLicenseConfiguration, err := licensemanager.NewLicenseConfiguration(ctx, "example", &licensemanager.LicenseConfigurationArgs{
			Name:                pulumi.String("Example"),
			LicenseCountingType: pulumi.String("Instance"),
		})
		if err != nil {
			return err
		}
		_, err = licensemanager.NewAssociation(ctx, "example", &licensemanager.AssociationArgs{
			LicenseConfigurationArn: exampleLicenseConfiguration.Arn,
			ResourceArn:             exampleInstance.Arn,
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

data "aws_ec2_getami" "example" {
  filters {
    name   = "name"
    values = ["amzn-ami-vpc-nat*"]
  }
  most_recent = true
  owners      = ["amazon"]
}

resource "aws_ec2_instance" "example" {
  ami           = data.aws_ec2_getami.example.id
  instance_type = "t2.micro"
}
resource "aws_licensemanager_licenseconfiguration" "example" {
  name                  = "Example"
  license_counting_type = "Instance"
}
resource "aws_licensemanager_association" "example" {
  license_configuration_arn = aws_licensemanager_licenseconfiguration.example.arn
  resource_arn              = aws_ec2_instance.example.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.Ec2Functions;
import com.pulumi.aws.ec2.inputs.GetAmiArgs;
import com.pulumi.aws.ec2.inputs.GetAmiFilterArgs;
import com.pulumi.aws.ec2.Instance;
import com.pulumi.aws.ec2.InstanceArgs;
import com.pulumi.aws.licensemanager.LicenseConfiguration;
import com.pulumi.aws.licensemanager.LicenseConfigurationArgs;
import com.pulumi.aws.licensemanager.Association;
import com.pulumi.aws.licensemanager.AssociationArgs;
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) {
        final var example = Ec2Functions.getAmi(GetAmiArgs.builder()
            .filters(GetAmiFilterArgs.builder()
                .name("name")
                .values("amzn-ami-vpc-nat*")
                .build())
            .mostRecent(true)
            .owners("amazon")
            .build());

        var exampleInstance = new Instance("exampleInstance", InstanceArgs.builder()
            .ami(example.id())
            .instanceType("t2.micro")
            .build());

        var exampleLicenseConfiguration = new LicenseConfiguration("exampleLicenseConfiguration", LicenseConfigurationArgs.builder()
            .name("Example")
            .licenseCountingType("Instance")
            .build());

        var exampleAssociation = new Association("exampleAssociation", AssociationArgs.builder()
            .licenseConfigurationArn(exampleLicenseConfiguration.arn())
            .resourceArn(exampleInstance.arn())
            .build());

    }
}
resources:
  exampleInstance:
    type: aws:ec2:Instance
    name: example
    properties:
      ami: ${example.id}
      instanceType: t2.micro
  exampleLicenseConfiguration:
    type: aws:licensemanager:LicenseConfiguration
    name: example
    properties:
      name: Example
      licenseCountingType: Instance
  exampleAssociation:
    type: aws:licensemanager:Association
    name: example
    properties:
      licenseConfigurationArn: ${exampleLicenseConfiguration.arn}
      resourceArn: ${exampleInstance.arn}
variables:
  example:
    fn::invoke:
      function: aws:ec2:getAmi
      arguments:
        filters:
          - name: name
            values:
              - amzn-ami-vpc-nat*
        mostRecent: true
        owners:
          - amazon

Import

Using pulumi import, import license configurations using resource_arn,license_configuration_arn. For example:

$ pulumi import aws:licensemanager/association:Association example arn:aws:ec2:eu-west-1:123456789012:image/ami-123456789abcdef01,arn:aws:license-manager:eu-west-1:123456789012:license-configuration:lic-0123456789abcdef0123456789abcdef

Constructors

Association(String name, {AssociationArgs? args, CustomResourceOptions? options})
Creates a new Association. name The Pulumi resource name. args Arguments used to configure this Association. The set of arguments for Association. options Resource options controlling this resource's behavior.
Association.reference(String urn)
Creates a typed reference to an existing Association 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
licenseConfigurationArn ↔ Output<String>
ARN of the license configuration.
latefinal
region ↔ Output<String>
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
resourceArn ↔ Output<String>
ARN of the resource associated with the license configuration.
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
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, {AssociationState? state, CustomResourceOptions? options}) → Association
Gets an existing Association resource's state with the given name and id.