Class VpcIpv6CidrBlockAssociation


  • public class VpcIpv6CidrBlockAssociation
    extends com.pulumi.resources.CustomResource
    Provides a resource to associate additional IPv6 CIDR blocks with a VPC. The `aws.ec2.VpcIpv6CidrBlockAssociation` resource allows IPv6 CIDR blocks to be added to the VPC. ## Example Usage
     
     package generated_program;
     
     import com.pulumi.Context;
     import com.pulumi.Pulumi;
     import com.pulumi.core.Output;
     import com.pulumi.aws.ec2.Vpc;
     import com.pulumi.aws.ec2.VpcArgs;
     import com.pulumi.aws.ec2.VpcIpv6CidrBlockAssociation;
     import com.pulumi.aws.ec2.VpcIpv6CidrBlockAssociationArgs;
     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 test = new Vpc("test", VpcArgs.builder()
                 .cidrBlock("10.0.0.0/16")
                 .build());
     
             var testVpcIpv6CidrBlockAssociation = new VpcIpv6CidrBlockAssociation("testVpcIpv6CidrBlockAssociation", VpcIpv6CidrBlockAssociationArgs.builder()
                 .ipv6IpamPoolId(testAwsVpcIpamPool.id())
                 .vpcId(test.id())
                 .build());
     
         }
     }
     
     
    ## Import or or Using `pulumi import`, import `aws.ec2.VpcIpv6CidrBlockAssociation` using the VPC CIDR association ID and optionally the IPv6 IPAM pool ID and netmask length. For example: ```sh $ pulumi import aws:ec2/vpcIpv6CidrBlockAssociation:VpcIpv6CidrBlockAssociation example vpc-cidr-assoc-0754129087e149dcd ``` or ```sh $ pulumi import aws:ec2/vpcIpv6CidrBlockAssociation:VpcIpv6CidrBlockAssociation example vpc-cidr-assoc-0754129087e149dcd,ipam-pool-0611d1d6bbc05ce60 ``` or ```sh $ pulumi import aws:ec2/vpcIpv6CidrBlockAssociation:VpcIpv6CidrBlockAssociation example vpc-cidr-assoc-0754129087e149dcd,ipam-pool-0611d1d6bbc05ce60,56 ```
    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal
      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal
    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote
    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.pulumi.core.Output<java.lang.Boolean> assignGeneratedIpv6CidrBlock()  
      static VpcIpv6CidrBlockAssociation get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, VpcIpv6CidrBlockAssociationState state, com.pulumi.resources.CustomResourceOptions options)
      Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
      com.pulumi.core.Output<java.lang.String> ipSource()  
      com.pulumi.core.Output<java.lang.String> ipv6AddressAttribute()  
      com.pulumi.core.Output<java.lang.String> ipv6CidrBlock()  
      com.pulumi.core.Output<java.util.Optional<java.lang.String>> ipv6IpamPoolId()  
      com.pulumi.core.Output<java.util.Optional<java.lang.Integer>> ipv6NetmaskLength()  
      com.pulumi.core.Output<java.lang.String> ipv6Pool()  
      com.pulumi.core.Output<java.lang.String> region()  
      com.pulumi.core.Output<java.lang.String> vpcId()  
      • Methods inherited from class com.pulumi.resources.CustomResource

        getId, id, idFuture
      • Methods inherited from class com.pulumi.resources.Resource

        getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • VpcIpv6CidrBlockAssociation

        public VpcIpv6CidrBlockAssociation​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.
      • VpcIpv6CidrBlockAssociation

        public VpcIpv6CidrBlockAssociation​(java.lang.String name,
                                           VpcIpv6CidrBlockAssociationArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
      • VpcIpv6CidrBlockAssociation

        public VpcIpv6CidrBlockAssociation​(java.lang.String name,
                                           VpcIpv6CidrBlockAssociationArgs args,
                                           @Nullable
                                           com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.
    • Method Detail

      • assignGeneratedIpv6CidrBlock

        public com.pulumi.core.Output<java.lang.Boolean> assignGeneratedIpv6CidrBlock()
        Returns:
        Whether to request an Amazon-provided IPv6 CIDR block with a /56 prefix length for the VPC. You cannot specify the range of IPv6 addresses, or the size of the CIDR block. Default is `false`. Conflicts with `ipv6IpamPoolId`, `ipv6Pool`, `ipv6CidrBlock` and `ipv6NetmaskLength`.
      • ipSource

        public com.pulumi.core.Output<java.lang.String> ipSource()
        Returns:
        Source that allocated the IP address space. Values: `amazon`, `byoip`, `none`.
      • ipv6AddressAttribute

        public com.pulumi.core.Output<java.lang.String> ipv6AddressAttribute()
        Returns:
        Public IPv6 addresses are those advertised on the internet from AWS. Private IP addresses are not and cannot be advertised on the internet from AWS. Values: `public`, `private`.
      • ipv6CidrBlock

        public com.pulumi.core.Output<java.lang.String> ipv6CidrBlock()
        Returns:
        IPv6 CIDR block for the VPC. CIDR can be explicitly set or it can be derived from IPAM using `ipv6NetmaskLength`. This parameter is required if `ipv6NetmaskLength` is not set and the IPAM pool does not have `allocationDefaultNetmask` set. Conflicts with `assignGeneratedIpv6CidrBlock`.
      • ipv6IpamPoolId

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> ipv6IpamPoolId()
        Returns:
        ID of an IPv6 IPAM pool you want to use for allocating this VPC's CIDR. IPAM is a VPC feature that you can use to automate your IP address management workflows including assigning, tracking, troubleshooting, and auditing IP addresses across AWS Regions and accounts. Conflict with `assignGeneratedIpv6CidrBlock` and `ipv6Pool`.
      • ipv6NetmaskLength

        public com.pulumi.core.Output<java.util.Optional<java.lang.Integer>> ipv6NetmaskLength()
        Returns:
        Netmask length of the IPv6 CIDR you want to allocate to this VPC. Requires specifying a `ipv6IpamPoolId`. This parameter is optional if the IPAM pool has `allocationDefaultNetmask` set, otherwise it or `ipv6CidrBlock` are required. Conflicts with `ipv6CidrBlock`.
      • ipv6Pool

        public com.pulumi.core.Output<java.lang.String> ipv6Pool()
        Returns:
        ID of an IPv6 address pool from which to allocate the IPv6 CIDR block. Conflicts with `assignGeneratedIpv6CidrBlock` and `ipv6IpamPoolId`.
      • region

        public com.pulumi.core.Output<java.lang.String> region()
        Returns:
        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
      • vpcId

        public com.pulumi.core.Output<java.lang.String> vpcId()
        Returns:
        ID of the VPC to make the association with.
      • get

        public static VpcIpv6CidrBlockAssociation get​(java.lang.String name,
                                                      com.pulumi.core.Output<java.lang.String> id,
                                                      @Nullable
                                                      VpcIpv6CidrBlockAssociationState state,
                                                      @Nullable
                                                      com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.