pulumi-aws-kotlin/com.pulumi.aws.ec2.kotlin/Ec2Functions/getNetworkAcls

getNetworkAcls

suspend fun getNetworkAcls(argument: GetNetworkAclsPlainArgs): GetNetworkAclsResult

Example Usage

The following shows outputting all network ACL ids in a vpc.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
export = async () => {
    const example = await aws.ec2.getNetworkAcls({
        vpcId: vpcId,
    });
    return {
        example: example.ids,
    };
}
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.ec2.get_network_acls(vpc_id=vpc_id)
pulumi.export("example", example.ids)
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = Aws.Ec2.GetNetworkAcls.Invoke(new()
    {
        VpcId = vpcId,
    });
    return new Dictionary<string, object?>
    {
        ["example"] = example.Apply(getNetworkAclsResult => getNetworkAclsResult.Ids),
    };
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := ec2.GetNetworkAcls(ctx, &ec2.GetNetworkAclsArgs{
			VpcId: pulumi.StringRef(vpcId),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("example", example.Ids)
		return nil
	})
}
Content copied to clipboard
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.GetNetworkAclsArgs;
import java.util.List;
import java.util.ArrayList;
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.getNetworkAcls(GetNetworkAclsArgs.builder()
            .vpcId(vpcId)
            .build());
        ctx.export("example", example.ids());
    }
}
Content copied to clipboard
variables:
  example:
    fn::invoke:
      function: aws:ec2:getNetworkAcls
      arguments:
        vpcId: ${vpcId}
outputs:
  example: ${example.ids}
Content copied to clipboard

The following example retrieves a list of all network ACL ids in a VPC with a custom tag of Tier set to a value of "Private".

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = aws.ec2.getNetworkAcls({
    vpcId: vpcId,
    tags: {
        Tier: "Private",
    },
});
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.ec2.get_network_acls(vpc_id=vpc_id,
    tags={
        "Tier": "Private",
    })
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = Aws.Ec2.GetNetworkAcls.Invoke(new()
    {
        VpcId = vpcId,
        Tags =
        {
            { "Tier", "Private" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.GetNetworkAcls(ctx, &ec2.GetNetworkAclsArgs{
			VpcId: pulumi.StringRef(vpcId),
			Tags: map[string]interface{}{
				"Tier": "Private",
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
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.GetNetworkAclsArgs;
import java.util.List;
import java.util.ArrayList;
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.getNetworkAcls(GetNetworkAclsArgs.builder()
            .vpcId(vpcId)
            .tags(Map.of("Tier", "Private"))
            .build());
    }
}
Content copied to clipboard
variables:
  example:
    fn::invoke:
      function: aws:ec2:getNetworkAcls
      arguments:
        vpcId: ${vpcId}
        tags:
          Tier: Private
Content copied to clipboard

The following example retrieves a network ACL id in a VPC which associated with specific subnet.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = aws.ec2.getNetworkAcls({
    vpcId: vpcId,
    filters: [{
        name: "association.subnet-id",
        values: [test&#46;id],
    }],
});
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.ec2.get_network_acls(vpc_id=vpc_id,
    filters=[{
        "name": "association.subnet-id",
        "values": [test["id"]],
    }])
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = Aws.Ec2.GetNetworkAcls.Invoke(new()
    {
        VpcId = vpcId,
        Filters = new[]
        {
            new Aws.Ec2.Inputs.GetNetworkAclsFilterInputArgs
            {
                Name = "association.subnet-id",
                Values = new[]
                {
                    test.Id,
                },
            },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := ec2.GetNetworkAcls(ctx, &ec2.GetNetworkAclsArgs{
VpcId: pulumi.StringRef(vpcId),
Filters: []ec2.GetNetworkAclsFilter{
{
Name: "association.subnet-id",
Values: interface{}{
test.Id,
},
},
},
}, nil);
if err != nil {
return err
}
return nil
})
}
Content copied to clipboard
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.GetNetworkAclsArgs;
import java.util.List;
import java.util.ArrayList;
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.getNetworkAcls(GetNetworkAclsArgs.builder()
            .vpcId(vpcId)
            .filters(GetNetworkAclsFilterArgs.builder()
                .name("association.subnet-id")
                .values(test.id())
                .build())
            .build());
    }
}
Content copied to clipboard
variables:
  example:
    fn::invoke:
      function: aws:ec2:getNetworkAcls
      arguments:
        vpcId: ${vpcId}
        filters:
          - name: association.subnet-id
            values:
              - ${test.id}
Content copied to clipboard

Return

A collection of values returned by getNetworkAcls.

Parameters

argument

A collection of arguments for invoking getNetworkAcls.

suspend fun getNetworkAcls(filters: List<GetNetworkAclsFilter>? = null, tags: Map<String, String>? = null, vpcId: String? = null): GetNetworkAclsResult

Return

A collection of values returned by getNetworkAcls.

Parameters

filters

Custom filter block as described below.

tags

Map of tags, each pair of which must exactly match a pair on the desired network ACLs.

vpcId

VPC ID that you want to filter from.

See also

.

suspend fun getNetworkAcls(argument: suspend GetNetworkAclsPlainArgsBuilder.() -> Unit): GetNetworkAclsResult

Return

A collection of values returned by getNetworkAcls.

Parameters

argument

Builder for com.pulumi.aws.ec2.kotlin.inputs.GetNetworkAclsPlainArgs.

See also

.