import * as pulumi from "@pulumi/pulumi"; /** * Allocates (reserves) a CIDR from an IPAM address pool, preventing usage by IPAM. Only works for private IPv4. * * ## Example Usage * * Basic usage: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const current = aws.getRegion({}); * const exampleVpcIpam = new aws.ec2.VpcIpam("example", {operatingRegions: [{ * regionName: current.then(current => current.region), * }]}); * const exampleVpcIpamPool = new aws.ec2.VpcIpamPool("example", { * addressFamily: "ipv4", * ipamScopeId: exampleVpcIpam.privateDefaultScopeId, * locale: current.then(current => current.region), * }); * const exampleVpcIpamPoolCidr = new aws.ec2.VpcIpamPoolCidr("example", { * ipamPoolId: exampleVpcIpamPool.id, * cidr: "172.20.0.0/16", * }); * const example = new aws.ec2.VpcIpamPoolCidrAllocation("example", { * ipamPoolId: exampleVpcIpamPool.id, * cidr: "172.20.0.0/24", * }, { * dependsOn: [exampleVpcIpamPoolCidr], * }); * ``` * * With the `disallowedCidrs` attribute: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const current = aws.getRegion({}); * const exampleVpcIpam = new aws.ec2.VpcIpam("example", {operatingRegions: [{ * regionName: current.then(current => current.region), * }]}); * const exampleVpcIpamPool = new aws.ec2.VpcIpamPool("example", { * addressFamily: "ipv4", * ipamScopeId: exampleVpcIpam.privateDefaultScopeId, * locale: current.then(current => current.region), * }); * const exampleVpcIpamPoolCidr = new aws.ec2.VpcIpamPoolCidr("example", { * ipamPoolId: exampleVpcIpamPool.id, * cidr: "172.20.0.0/16", * }); * const example = new aws.ec2.VpcIpamPoolCidrAllocation("example", { * ipamPoolId: exampleVpcIpamPool.id, * netmaskLength: 28, * disallowedCidrs: ["172.20.0.0/28"], * }, { * dependsOn: [exampleVpcIpamPoolCidr], * }); * ``` * * ## Import * * Using `pulumi import`, import IPAM allocations using the allocation `id` and `pool id`, separated by `_`. For example: * * ```sh * $ pulumi import aws:ec2/vpcIpamPoolCidrAllocation:VpcIpamPoolCidrAllocation example ipam-pool-alloc-0dc6d196509c049ba8b549ff99f639736_ipam-pool-07cfb559e0921fcbe * ``` */ export declare class VpcIpamPoolCidrAllocation extends pulumi.CustomResource { /** * Get an existing VpcIpamPoolCidrAllocation resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: VpcIpamPoolCidrAllocationState, opts?: pulumi.CustomResourceOptions): VpcIpamPoolCidrAllocation; /** * Returns true if the given object is an instance of VpcIpamPoolCidrAllocation. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is VpcIpamPoolCidrAllocation; /** * The CIDR you want to assign to the pool. */ readonly cidr: pulumi.Output; /** * The description for the allocation. */ readonly description: pulumi.Output; /** * Exclude a particular CIDR range from being returned by the pool. */ readonly disallowedCidrs: pulumi.Output; readonly ipamPoolAllocationId: pulumi.Output; /** * The ID of the pool to which you want to assign a CIDR. */ readonly ipamPoolId: pulumi.Output; /** * The netmask length of the CIDR you would like to allocate to the IPAM pool. Valid Values: `0-128`. */ readonly netmaskLength: pulumi.Output; /** * 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. */ readonly region: pulumi.Output; /** * The ID of the resource. */ readonly resourceId: pulumi.Output; /** * The owner of the resource. */ readonly resourceOwner: pulumi.Output; /** * The type of the resource. */ readonly resourceType: pulumi.Output; /** * Map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ readonly tagsAll: pulumi.Output<{ [key: string]: string; }>; /** * Create a VpcIpamPoolCidrAllocation resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: VpcIpamPoolCidrAllocationArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering VpcIpamPoolCidrAllocation resources. */ export interface VpcIpamPoolCidrAllocationState { /** * The CIDR you want to assign to the pool. */ cidr?: pulumi.Input; /** * The description for the allocation. */ description?: pulumi.Input; /** * Exclude a particular CIDR range from being returned by the pool. */ disallowedCidrs?: pulumi.Input[] | undefined>; ipamPoolAllocationId?: pulumi.Input; /** * The ID of the pool to which you want to assign a CIDR. */ ipamPoolId?: pulumi.Input; /** * The netmask length of the CIDR you would like to allocate to the IPAM pool. Valid Values: `0-128`. */ netmaskLength?: pulumi.Input; /** * 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. */ region?: pulumi.Input; /** * The ID of the resource. */ resourceId?: pulumi.Input; /** * The owner of the resource. */ resourceOwner?: pulumi.Input; /** * The type of the resource. */ resourceType?: pulumi.Input; /** * Map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ tagsAll?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; } /** * The set of arguments for constructing a VpcIpamPoolCidrAllocation resource. */ export interface VpcIpamPoolCidrAllocationArgs { /** * The CIDR you want to assign to the pool. */ cidr?: pulumi.Input; /** * The description for the allocation. */ description?: pulumi.Input; /** * Exclude a particular CIDR range from being returned by the pool. */ disallowedCidrs?: pulumi.Input[] | undefined>; /** * The ID of the pool to which you want to assign a CIDR. */ ipamPoolId: pulumi.Input; /** * The netmask length of the CIDR you would like to allocate to the IPAM pool. Valid Values: `0-128`. */ netmaskLength?: pulumi.Input; /** * 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. */ region?: pulumi.Input; /** * Map of tags to assign to the resource. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; } //# sourceMappingURL=vpcIpamPoolCidrAllocation.d.ts.map