1. Packages
  2. Packages
  3. Scaleway
  4. API Docs
  5. network
  6. getAcl
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse
scaleway logo
Viewing docs for Scaleway v1.48.0
published on Wednesday, Apr 29, 2026 by pulumiverse

    Gets information about a VPC ACL (Access Control List).

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Get the IPv4 ACL for a VPC
    const myAcl = scaleway.network.getAcl({
        vpcId: myVpc.id,
        isIpv6: false,
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Get the IPv4 ACL for a VPC
    my_acl = scaleway.network.get_acl(vpc_id=my_vpc["id"],
        is_ipv6=False)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Get the IPv4 ACL for a VPC
    		_, err := network.LookupAcl(ctx, &network.LookupAclArgs{
    			VpcId:  myVpc.Id,
    			IsIpv6: pulumi.BoolRef(false),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scaleway = Pulumiverse.Scaleway;
    
    return await Deployment.RunAsync(() => 
    {
        // Get the IPv4 ACL for a VPC
        var myAcl = Scaleway.Network.GetAcl.Invoke(new()
        {
            VpcId = myVpc.Id,
            IsIpv6 = false,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scaleway.network.NetworkFunctions;
    import com.pulumi.scaleway.network.inputs.GetAclArgs;
    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) {
            // Get the IPv4 ACL for a VPC
            final var myAcl = NetworkFunctions.getAcl(GetAclArgs.builder()
                .vpcId(myVpc.id())
                .isIpv6(false)
                .build());
    
        }
    }
    
    variables:
      # Get the IPv4 ACL for a VPC
      myAcl:
        fn::invoke:
          function: scaleway:network:getAcl
          arguments:
            vpcId: ${myVpc.id}
            isIpv6: false
    
    import * as pulumi from "@pulumi/pulumi";
    import * as scaleway from "@pulumiverse/scaleway";
    
    // Get the IPv6 ACL for a VPC
    const myAclV6 = scaleway.network.getAcl({
        vpcId: myVpc.id,
        isIpv6: true,
    });
    
    import pulumi
    import pulumi_scaleway as scaleway
    
    # Get the IPv6 ACL for a VPC
    my_acl_v6 = scaleway.network.get_acl(vpc_id=my_vpc["id"],
        is_ipv6=True)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/network"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Get the IPv6 ACL for a VPC
    		_, err := network.LookupAcl(ctx, &network.LookupAclArgs{
    			VpcId:  myVpc.Id,
    			IsIpv6: pulumi.BoolRef(true),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Scaleway = Pulumiverse.Scaleway;
    
    return await Deployment.RunAsync(() => 
    {
        // Get the IPv6 ACL for a VPC
        var myAclV6 = Scaleway.Network.GetAcl.Invoke(new()
        {
            VpcId = myVpc.Id,
            IsIpv6 = true,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.scaleway.network.NetworkFunctions;
    import com.pulumi.scaleway.network.inputs.GetAclArgs;
    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) {
            // Get the IPv6 ACL for a VPC
            final var myAclV6 = NetworkFunctions.getAcl(GetAclArgs.builder()
                .vpcId(myVpc.id())
                .isIpv6(true)
                .build());
    
        }
    }
    
    variables:
      # Get the IPv6 ACL for a VPC
      myAclV6:
        fn::invoke:
          function: scaleway:network:getAcl
          arguments:
            vpcId: ${myVpc.id}
            isIpv6: true
    

    Using getAcl

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getAcl(args: GetAclArgs, opts?: InvokeOptions): Promise<GetAclResult>
    function getAclOutput(args: GetAclOutputArgs, opts?: InvokeOptions): Output<GetAclResult>
    def get_acl(is_ipv6: Optional[bool] = None,
                region: Optional[str] = None,
                vpc_id: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetAclResult
    def get_acl_output(is_ipv6: pulumi.Input[Optional[bool]] = None,
                region: pulumi.Input[Optional[str]] = None,
                vpc_id: pulumi.Input[Optional[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetAclResult]
    func LookupAcl(ctx *Context, args *LookupAclArgs, opts ...InvokeOption) (*LookupAclResult, error)
    func LookupAclOutput(ctx *Context, args *LookupAclOutputArgs, opts ...InvokeOption) LookupAclResultOutput

    > Note: This function is named LookupAcl in the Go SDK.

    public static class GetAcl 
    {
        public static Task<GetAclResult> InvokeAsync(GetAclArgs args, InvokeOptions? opts = null)
        public static Output<GetAclResult> Invoke(GetAclInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetAclResult> getAcl(GetAclArgs args, InvokeOptions options)
    public static Output<GetAclResult> getAcl(GetAclArgs args, InvokeOptions options)
    
    fn::invoke:
      function: scaleway:network/getAcl:getAcl
      arguments:
        # arguments dictionary

    The following arguments are supported:

    VpcId string
    The VPC ID to look up the ACL for.
    IsIpv6 bool
    Whether to get the IPv6 ACL.
    Region string
    region). The region in which the ACL exists.
    VpcId string
    The VPC ID to look up the ACL for.
    IsIpv6 bool
    Whether to get the IPv6 ACL.
    Region string
    region). The region in which the ACL exists.
    vpcId String
    The VPC ID to look up the ACL for.
    isIpv6 Boolean
    Whether to get the IPv6 ACL.
    region String
    region). The region in which the ACL exists.
    vpcId string
    The VPC ID to look up the ACL for.
    isIpv6 boolean
    Whether to get the IPv6 ACL.
    region string
    region). The region in which the ACL exists.
    vpc_id str
    The VPC ID to look up the ACL for.
    is_ipv6 bool
    Whether to get the IPv6 ACL.
    region str
    region). The region in which the ACL exists.
    vpcId String
    The VPC ID to look up the ACL for.
    isIpv6 Boolean
    Whether to get the IPv6 ACL.
    region String
    region). The region in which the ACL exists.

    getAcl Result

    The following output properties are available:

    DefaultPolicy string
    Id string
    The provider-assigned unique ID for this managed resource.
    Rules List<Pulumiverse.Scaleway.Network.Outputs.GetAclRule>
    VpcId string
    IsIpv6 bool
    Region string
    DefaultPolicy string
    Id string
    The provider-assigned unique ID for this managed resource.
    Rules []GetAclRule
    VpcId string
    IsIpv6 bool
    Region string
    defaultPolicy String
    id String
    The provider-assigned unique ID for this managed resource.
    rules List<GetAclRule>
    vpcId String
    isIpv6 Boolean
    region String
    defaultPolicy string
    id string
    The provider-assigned unique ID for this managed resource.
    rules GetAclRule[]
    vpcId string
    isIpv6 boolean
    region string
    default_policy str
    id str
    The provider-assigned unique ID for this managed resource.
    rules Sequence[GetAclRule]
    vpc_id str
    is_ipv6 bool
    region str
    defaultPolicy String
    id String
    The provider-assigned unique ID for this managed resource.
    rules List<Property Map>
    vpcId String
    isIpv6 Boolean
    region String

    Supporting Types

    GetAclRule

    Action string
    The policy to apply to the packet
    Description string
    The rule description
    Destination string
    Destination IP range to which this rule applies (CIDR notation with subnet mask)
    DstPortHigh int
    Ending port of the destination port range to which this rule applies (inclusive)
    DstPortLow int
    Starting port of the destination port range to which this rule applies (inclusive)
    Protocol string
    The protocol to which this rule applies. Default value: ANY
    Source string
    Source IP range to which this rule applies (CIDR notation with subnet mask)
    SrcPortHigh int
    Ending port of the source port range to which this rule applies (inclusive)
    SrcPortLow int
    Starting port of the source port range to which this rule applies (inclusive)
    Action string
    The policy to apply to the packet
    Description string
    The rule description
    Destination string
    Destination IP range to which this rule applies (CIDR notation with subnet mask)
    DstPortHigh int
    Ending port of the destination port range to which this rule applies (inclusive)
    DstPortLow int
    Starting port of the destination port range to which this rule applies (inclusive)
    Protocol string
    The protocol to which this rule applies. Default value: ANY
    Source string
    Source IP range to which this rule applies (CIDR notation with subnet mask)
    SrcPortHigh int
    Ending port of the source port range to which this rule applies (inclusive)
    SrcPortLow int
    Starting port of the source port range to which this rule applies (inclusive)
    action String
    The policy to apply to the packet
    description String
    The rule description
    destination String
    Destination IP range to which this rule applies (CIDR notation with subnet mask)
    dstPortHigh Integer
    Ending port of the destination port range to which this rule applies (inclusive)
    dstPortLow Integer
    Starting port of the destination port range to which this rule applies (inclusive)
    protocol String
    The protocol to which this rule applies. Default value: ANY
    source String
    Source IP range to which this rule applies (CIDR notation with subnet mask)
    srcPortHigh Integer
    Ending port of the source port range to which this rule applies (inclusive)
    srcPortLow Integer
    Starting port of the source port range to which this rule applies (inclusive)
    action string
    The policy to apply to the packet
    description string
    The rule description
    destination string
    Destination IP range to which this rule applies (CIDR notation with subnet mask)
    dstPortHigh number
    Ending port of the destination port range to which this rule applies (inclusive)
    dstPortLow number
    Starting port of the destination port range to which this rule applies (inclusive)
    protocol string
    The protocol to which this rule applies. Default value: ANY
    source string
    Source IP range to which this rule applies (CIDR notation with subnet mask)
    srcPortHigh number
    Ending port of the source port range to which this rule applies (inclusive)
    srcPortLow number
    Starting port of the source port range to which this rule applies (inclusive)
    action str
    The policy to apply to the packet
    description str
    The rule description
    destination str
    Destination IP range to which this rule applies (CIDR notation with subnet mask)
    dst_port_high int
    Ending port of the destination port range to which this rule applies (inclusive)
    dst_port_low int
    Starting port of the destination port range to which this rule applies (inclusive)
    protocol str
    The protocol to which this rule applies. Default value: ANY
    source str
    Source IP range to which this rule applies (CIDR notation with subnet mask)
    src_port_high int
    Ending port of the source port range to which this rule applies (inclusive)
    src_port_low int
    Starting port of the source port range to which this rule applies (inclusive)
    action String
    The policy to apply to the packet
    description String
    The rule description
    destination String
    Destination IP range to which this rule applies (CIDR notation with subnet mask)
    dstPortHigh Number
    Ending port of the destination port range to which this rule applies (inclusive)
    dstPortLow Number
    Starting port of the destination port range to which this rule applies (inclusive)
    protocol String
    The protocol to which this rule applies. Default value: ANY
    source String
    Source IP range to which this rule applies (CIDR notation with subnet mask)
    srcPortHigh Number
    Ending port of the source port range to which this rule applies (inclusive)
    srcPortLow Number
    Starting port of the source port range to which this rule applies (inclusive)

    Package Details

    Repository
    scaleway pulumiverse/pulumi-scaleway
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the scaleway Terraform Provider.
    scaleway logo
    Viewing docs for Scaleway v1.48.0
    published on Wednesday, Apr 29, 2026 by pulumiverse
      Try Pulumi Cloud free. Your team will thank you.