getVpcIpamPool function
aws.ec2.VpcIpamPool provides details about an IPAM pool.
This resource can prove useful when an ipam pool was created in another root module and you need the pool's id as an input variable. For example, pools can be shared via RAM and used to create vpcs with CIDRs from that pool.
Example Usage
The following example shows an account that has only 1 pool, perhaps shared via RAM, and using that pool id to create a VPC with a CIDR derived from AWS IPAM.
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = aws.ec2.getVpcIpamPool({
filters: [
{
name: "description",
values: ["*test*"],
},
{
name: "address-family",
values: ["ipv4"],
},
],
});
const testVpc = new aws.ec2.Vpc("test", {
ipv4IpamPoolId: test.then(test => test.id),
ipv4NetmaskLength: 28,
});
import pulumi
import pulumi_aws as aws
test = aws.ec2.get_vpc_ipam_pool(filters=[
{
"name": "description",
"values": ["*test*"],
},
{
"name": "address-family",
"values": ["ipv4"],
},
])
test_vpc = aws.ec2.Vpc("test",
ipv4_ipam_pool_id=test.id,
ipv4_netmask_length=28)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var test = Aws.Ec2.GetVpcIpamPool.Invoke(new()
{
Filters = new[]
{
new Aws.Ec2.Inputs.GetVpcIpamPoolFilterInputArgs
{
Name = "description",
Values = new[]
{
"*test*",
},
},
new Aws.Ec2.Inputs.GetVpcIpamPoolFilterInputArgs
{
Name = "address-family",
Values = new[]
{
"ipv4",
},
},
},
});
var testVpc = new Aws.Ec2.Vpc("test", new()
{
Ipv4IpamPoolId = test.Apply(getVpcIpamPoolResult => getVpcIpamPoolResult.Id),
Ipv4NetmaskLength = 28,
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
test, err := ec2.LookupVpcIpamPool(ctx, &ec2.LookupVpcIpamPoolArgs{
Filters: []ec2.GetVpcIpamPoolFilter{
{
Name: "description",
Values: []string{
"*test*",
},
},
{
Name: "address-family",
Values: []string{
"ipv4",
},
},
},
}, nil)
if err != nil {
return err
}
_, err = ec2.NewVpc(ctx, "test", &ec2.VpcArgs{
Ipv4IpamPoolId: pulumi.String(test.Id),
Ipv4NetmaskLength: pulumi.Int(28),
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
data "aws_ec2_getvpcipampool" "test" {
filters {
name = "description"
values = ["*test*"]
}
filters {
name = "address-family"
values = ["ipv4"]
}
}
resource "aws_ec2_vpc" "test" {
ipv4_ipam_pool_id = data.aws_ec2_getvpcipampool.test.id
ipv4_netmask_length = 28
}
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.GetVpcIpamPoolArgs;
import com.pulumi.aws.ec2.inputs.GetVpcIpamPoolFilterArgs;
import com.pulumi.aws.ec2.Vpc;
import com.pulumi.aws.ec2.VpcArgs;
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 test = Ec2Functions.getVpcIpamPool(GetVpcIpamPoolArgs.builder()
.filters(
GetVpcIpamPoolFilterArgs.builder()
.name("description")
.values("*test*")
.build(),
GetVpcIpamPoolFilterArgs.builder()
.name("address-family")
.values("ipv4")
.build())
.build());
var testVpc = new Vpc("testVpc", VpcArgs.builder()
.ipv4IpamPoolId(test.id())
.ipv4NetmaskLength(28)
.build());
}
}
resources:
testVpc:
type: aws:ec2:Vpc
name: test
properties:
ipv4IpamPoolId: ${test.id}
ipv4NetmaskLength: 28
variables:
test:
fn::invoke:
function: aws:ec2:getVpcIpamPool
arguments:
filters:
- name: description
values:
- '*test*'
- name: address-family
values:
- ipv4
args Arguments passed to this invoke. Arguments for getVpcIpamPool.
options Invoke options controlling this call.
Implementation
Future<GetVpcIpamPoolResult> getVpcIpamPool(
GetVpcIpamPoolArgs args, {
pulumi.InvokeOptions? options,
}) async {
final deployment = pulumi.Deployment.instance;
final result = await deployment.invoke<Map<String, dynamic>>(
'aws:ec2/getVpcIpamPool:getVpcIpamPool',
args.toMap(),
options: pulumi.toDeploymentInvokeOptions(options),
);
return GetVpcIpamPoolResult.fromMap(result);
}