getSubnet function
aws.ec2.Subnet provides details about a specific VPC subnet.
This resource can prove useful when a module accepts a subnet ID as an input variable and needs to, for example, determine the ID of the VPC that the subnet belongs to.
Example Usage
The following example shows how one might accept a subnet ID as a variable and use this data source to obtain the data necessary to create a security group that allows connections from hosts in that subnet.
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const config = new pulumi.Config();
const subnetId = config.requireObject<any>("subnetId");
const selected = aws.ec2.getSubnet({
id: subnetId,
});
const subnetSecurityGroup = new aws.ec2.SecurityGroup("subnet_security_group", {
ingress: [{
cidrBlocks: [selected.then(selected => selected.cidrBlock)],
fromPort: 80,
toPort: 80,
protocol: "tcp",
}],
vpcId: selected.then(selected => selected.vpcId),
});
import pulumi
import pulumi_aws as aws
config = pulumi.Config()
subnet_id = config.require_object("subnetId")
selected = aws.ec2.get_subnet(id=subnet_id)
subnet_security_group = aws.ec2.SecurityGroup("subnet_security_group",
ingress=[{
"cidr_blocks": [selected.cidr_block],
"from_port": 80,
"to_port": 80,
"protocol": "tcp",
}],
vpc_id=selected.vpc_id)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var config = new Config();
var subnetId = config.RequireObject<dynamic>("subnetId");
var selected = Aws.Ec2.GetSubnet.Invoke(new()
{
Id = subnetId,
});
var subnetSecurityGroup = new Aws.Ec2.SecurityGroup("subnet_security_group", new()
{
Ingress = new[]
{
new Aws.Ec2.Inputs.SecurityGroupIngressArgs
{
CidrBlocks = new[]
{
selected.Apply(getSubnetResult => getSubnetResult.CidrBlock),
},
FromPort = 80,
ToPort = 80,
Protocol = "tcp",
},
},
VpcId = selected.Apply(getSubnetResult => getSubnetResult.VpcId),
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
var subnetId interface{}
cfg.RequireObject("subnetId", &subnetId)
selected, err := ec2.LookupSubnet(ctx, &ec2.LookupSubnetArgs{
Id: pulumi.StringRef(subnetId),
}, nil)
if err != nil {
return err
}
_, err = ec2.NewSecurityGroup(ctx, "subnet_security_group", &ec2.SecurityGroupArgs{
Ingress: ec2.SecurityGroupIngressArray{
&ec2.SecurityGroupIngressArgs{
CidrBlocks: pulumi.StringArray{
pulumi.String(selected.CidrBlock),
},
FromPort: pulumi.Int(80),
ToPort: pulumi.Int(80),
Protocol: pulumi.String("tcp"),
},
},
VpcId: pulumi.String(selected.VpcId),
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
data "aws_ec2_getsubnet" "selected" {
id = var.subnetId
}
resource "aws_ec2_securitygroup" "subnet_security_group" {
ingress {
cidr_blocks = [data.aws_ec2_getsubnet.selected.cidr_block]
from_port = 80
to_port = 80
protocol = "tcp"
}
vpc_id = data.aws_ec2_getsubnet.selected.vpc_id
}
variable "subnetId" {
}
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.GetSubnetArgs;
import com.pulumi.aws.ec2.SecurityGroup;
import com.pulumi.aws.ec2.SecurityGroupArgs;
import com.pulumi.aws.ec2.inputs.SecurityGroupIngressArgs;
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 config = ctx.config();
final var subnetId = config.require("subnetId");
final var selected = Ec2Functions.getSubnet(GetSubnetArgs.builder()
.id(subnetId)
.build());
var subnetSecurityGroup = new SecurityGroup("subnetSecurityGroup", SecurityGroupArgs.builder()
.ingress(SecurityGroupIngressArgs.builder()
.cidrBlocks(selected.cidrBlock())
.fromPort(80)
.toPort(80)
.protocol("tcp")
.build())
.vpcId(selected.vpcId())
.build());
}
}
configuration:
subnetId:
type: object
resources:
subnetSecurityGroup:
type: aws:ec2:SecurityGroup
name: subnet_security_group
properties:
ingress:
- cidrBlocks:
- ${selected.cidrBlock}
fromPort: 80
toPort: 80
protocol: tcp
vpcId: ${selected.vpcId}
variables:
selected:
fn::invoke:
function: aws:ec2:getSubnet
arguments:
id: ${subnetId}
Filter Example
If you want to match against tag Name, use:
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const selected = aws.ec2.getSubnet({
filters: [{
name: "tag:Name",
values: ["yakdriver"],
}],
});
import pulumi
import pulumi_aws as aws
selected = aws.ec2.get_subnet(filters=[{
"name": "tag:Name",
"values": ["yakdriver"],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var selected = Aws.Ec2.GetSubnet.Invoke(new()
{
Filters = new[]
{
new Aws.Ec2.Inputs.GetSubnetFilterInputArgs
{
Name = "tag:Name",
Values = new[]
{
"yakdriver",
},
},
},
});
});
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 {
_, err := ec2.LookupSubnet(ctx, &ec2.LookupSubnetArgs{
Filters: []ec2.GetSubnetFilter{
{
Name: "tag:Name",
Values: []string{
"yakdriver",
},
},
},
}, nil)
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
data "aws_ec2_getsubnet" "selected" {
filters {
name = "tag:Name"
values = ["yakdriver"]
}
}
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.GetSubnetArgs;
import com.pulumi.aws.ec2.inputs.GetSubnetFilterArgs;
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 selected = Ec2Functions.getSubnet(GetSubnetArgs.builder()
.filters(GetSubnetFilterArgs.builder()
.name("tag:Name")
.values("yakdriver")
.build())
.build());
}
}
variables:
selected:
fn::invoke:
function: aws:ec2:getSubnet
arguments:
filters:
- name: tag:Name
values:
- yakdriver
args Arguments passed to this invoke. Arguments for getSubnet.
options Invoke options controlling this call.
Implementation
Future<GetSubnetResult> getSubnet(
GetSubnetArgs args, {
pulumi.InvokeOptions? options,
}) async {
final deployment = pulumi.Deployment.instance;
final result = await deployment.invoke<Map<String, dynamic>>(
'aws:ec2/getSubnet:getSubnet',
args.toMap(),
options: pulumi.toDeploymentInvokeOptions(options),
);
return GetSubnetResult.fromMap(result);
}