1. Packages
  2. Packages
  3. Volcenginecc Provider
  4. API Docs
  5. alb
  6. Acl
Viewing docs for volcenginecc v0.0.50
published on Monday, Jul 20, 2026 by Volcengine
volcenginecc logo
Viewing docs for volcenginecc v0.0.50
published on Monday, Jul 20, 2026 by Volcengine

    ALB provides listener-level access control. If you want to allow only certain IPs or deny only certain IPs from accessing the ALB instance through the listener port, you can set an access control policy for this listener. You can configure access control when creating the listener, or modify or reconfigure access control after the listener is created

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcenginecc from "@volcengine/pulumi-volcenginecc";
    
    const albAclDemo = new volcenginecc.alb.Acl("AlbAclDemo", {
        aclName: "AlbAclDemo",
        projectName: "default",
        aclEntries: [{
            description: "AlbAclDemo description",
            entry: "1.1.1.1/32",
        }],
        tags: [{
            key: "env",
            value: "test",
        }],
    });
    
    import pulumi
    import pulumi_volcenginecc as volcenginecc
    
    alb_acl_demo = volcenginecc.alb.Acl("AlbAclDemo",
        acl_name="AlbAclDemo",
        project_name="default",
        acl_entries=[{
            "description": "AlbAclDemo description",
            "entry": "1.1.1.1/32",
        }],
        tags=[{
            "key": "env",
            "value": "test",
        }])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/volcengine/pulumi-volcenginecc/sdk/go/volcenginecc/alb"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := alb.NewAcl(ctx, "AlbAclDemo", &alb.AclArgs{
    			AclName:     pulumi.String("AlbAclDemo"),
    			ProjectName: pulumi.String("default"),
    			AclEntries: alb.AclAclEntryArray{
    				&alb.AclAclEntryArgs{
    					Description: pulumi.String("AlbAclDemo description"),
    					Entry:       pulumi.String("1.1.1.1/32"),
    				},
    			},
    			Tags: alb.AclTagArray{
    				&alb.AclTagArgs{
    					Key:   pulumi.String("env"),
    					Value: pulumi.String("test"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Volcenginecc = Volcengine.Pulumi.Volcenginecc;
    
    return await Deployment.RunAsync(() => 
    {
        var albAclDemo = new Volcenginecc.Alb.Acl("AlbAclDemo", new()
        {
            AclName = "AlbAclDemo",
            ProjectName = "default",
            AclEntries = new[]
            {
                new Volcenginecc.Alb.Inputs.AclAclEntryArgs
                {
                    Description = "AlbAclDemo description",
                    Entry = "1.1.1.1/32",
                },
            },
            Tags = new[]
            {
                new Volcenginecc.Alb.Inputs.AclTagArgs
                {
                    Key = "env",
                    Value = "test",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.volcengine.volcenginecc.alb.Acl;
    import com.volcengine.volcenginecc.alb.AclArgs;
    import com.pulumi.volcenginecc.alb.inputs.AclAclEntryArgs;
    import com.pulumi.volcenginecc.alb.inputs.AclTagArgs;
    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) {
            var albAclDemo = new Acl("albAclDemo", AclArgs.builder()
                .aclName("AlbAclDemo")
                .projectName("default")
                .aclEntries(AclAclEntryArgs.builder()
                    .description("AlbAclDemo description")
                    .entry("1.1.1.1/32")
                    .build())
                .tags(AclTagArgs.builder()
                    .key("env")
                    .value("test")
                    .build())
                .build());
    
        }
    }
    
    resources:
      albAclDemo:
        type: volcenginecc:alb:Acl
        name: AlbAclDemo
        properties:
          aclName: AlbAclDemo
          projectName: default
          aclEntries:
            - description: AlbAclDemo description
              entry: 1.1.1.1/32
          tags:
            - key: env
              value: test
    
    pulumi {
      required_providers {
        volcenginecc = {
          source = "pulumi/volcenginecc"
        }
      }
    }
    
    resource "volcenginecc_alb_acl" "AlbAclDemo" {
      acl_name     = "AlbAclDemo"
      project_name = "default"
      acl_entries {
        description = "AlbAclDemo description"
        entry       = "1.1.1.1/32"
      }
      tags {
        key   = "env"
        value = "test"
      }
    }
    

    Create Acl Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Acl(name: string, args?: AclArgs, opts?: CustomResourceOptions);
    @overload
    def Acl(resource_name: str,
            args: Optional[AclArgs] = None,
            opts: Optional[ResourceOptions] = None)
    
    @overload
    def Acl(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            acl_entries: Optional[Sequence[AclAclEntryArgs]] = None,
            acl_name: Optional[str] = None,
            description: Optional[str] = None,
            project_name: Optional[str] = None,
            tags: Optional[Sequence[AclTagArgs]] = None)
    func NewAcl(ctx *Context, name string, args *AclArgs, opts ...ResourceOption) (*Acl, error)
    public Acl(string name, AclArgs? args = null, CustomResourceOptions? opts = null)
    public Acl(String name, AclArgs args)
    public Acl(String name, AclArgs args, CustomResourceOptions options)
    
    type: volcenginecc:alb:Acl
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "volcenginecc_alb_acl" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args AclArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args AclArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args AclArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AclArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AclArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var aclResource = new Volcenginecc.Alb.Acl("aclResource", new()
    {
        AclEntries = new[]
        {
            new Volcenginecc.Alb.Inputs.AclAclEntryArgs
            {
                Description = "string",
                Entry = "string",
            },
        },
        AclName = "string",
        Description = "string",
        ProjectName = "string",
        Tags = new[]
        {
            new Volcenginecc.Alb.Inputs.AclTagArgs
            {
                Key = "string",
                Value = "string",
            },
        },
    });
    
    example, err := alb.NewAcl(ctx, "aclResource", &alb.AclArgs{
    	AclEntries: alb.AclAclEntryArray{
    		&alb.AclAclEntryArgs{
    			Description: pulumi.String("string"),
    			Entry:       pulumi.String("string"),
    		},
    	},
    	AclName:     pulumi.String("string"),
    	Description: pulumi.String("string"),
    	ProjectName: pulumi.String("string"),
    	Tags: alb.AclTagArray{
    		&alb.AclTagArgs{
    			Key:   pulumi.String("string"),
    			Value: pulumi.String("string"),
    		},
    	},
    })
    
    resource "volcenginecc_alb_acl" "aclResource" {
      lifecycle {
        create_before_destroy = true
      }
      acl_entries {
        description = "string"
        entry       = "string"
      }
      acl_name     = "string"
      description  = "string"
      project_name = "string"
      tags {
        key   = "string"
        value = "string"
      }
    }
    
    var aclResource = new com.volcengine.volcenginecc.alb.Acl("aclResource", com.volcengine.volcenginecc.alb.AclArgs.builder()
        .aclEntries(com.pulumi.volcenginecc.alb.inputs.AclAclEntryArgs.builder()
            .description("string")
            .entry("string")
            .build())
        .aclName("string")
        .description("string")
        .projectName("string")
        .tags(com.pulumi.volcenginecc.alb.inputs.AclTagArgs.builder()
            .key("string")
            .value("string")
            .build())
        .build());
    
    acl_resource = volcenginecc.alb.Acl("aclResource",
        acl_entries=[{
            "description": "string",
            "entry": "string",
        }],
        acl_name="string",
        description="string",
        project_name="string",
        tags=[{
            "key": "string",
            "value": "string",
        }])
    
    const aclResource = new volcenginecc.alb.Acl("aclResource", {
        aclEntries: [{
            description: "string",
            entry: "string",
        }],
        aclName: "string",
        description: "string",
        projectName: "string",
        tags: [{
            key: "string",
            value: "string",
        }],
    });
    
    type: volcenginecc:alb:Acl
    properties:
        aclEntries:
            - description: string
              entry: string
        aclName: string
        description: string
        projectName: string
        tags:
            - key: string
              value: string
    

    Acl Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Acl resource accepts the following input properties:

    AclEntries List<Volcengine.AclAclEntry>
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    AclName string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    Description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    ProjectName string
    Project name to which the access control policy group belongs
    Tags List<Volcengine.AclTag>
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    AclEntries []AclAclEntryArgs
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    AclName string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    Description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    ProjectName string
    Project name to which the access control policy group belongs
    Tags []AclTagArgs
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    acl_entries list(object)
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    acl_name string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    project_name string
    Project name to which the access control policy group belongs
    tags list(object)
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclEntries List<AclAclEntry>
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclName String
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    description String
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    projectName String
    Project name to which the access control policy group belongs
    tags List<AclTag>
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclEntries AclAclEntry[]
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclName string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    projectName string
    Project name to which the access control policy group belongs
    tags AclTag[]
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    acl_entries Sequence[AclAclEntryArgs]
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    acl_name str
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    description str
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    project_name str
    Project name to which the access control policy group belongs
    tags Sequence[AclTagArgs]
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclEntries List<Property Map>
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclName String
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    description String
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    projectName String
    Project name to which the access control policy group belongs
    tags List<Property Map>
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Acl resource produces the following output properties:

    AclEntryCount int
    Number of IP entries in the access control policy group
    AclId string
    Access control policy group ID
    CreatedTime string
    Creation time of the access control policy group
    Id string
    The provider-assigned unique ID for this managed resource.
    Listeners List<Volcengine.AclListener>
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    Status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    UpdatedTime string
    Last operation time of the access control policy group
    AclEntryCount int
    Number of IP entries in the access control policy group
    AclId string
    Access control policy group ID
    CreatedTime string
    Creation time of the access control policy group
    Id string
    The provider-assigned unique ID for this managed resource.
    Listeners []AclListener
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    Status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    UpdatedTime string
    Last operation time of the access control policy group
    acl_entry_count number
    Number of IP entries in the access control policy group
    acl_id string
    Access control policy group ID
    created_time string
    Creation time of the access control policy group
    id string
    The provider-assigned unique ID for this managed resource.
    listeners list(object)
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    updated_time string
    Last operation time of the access control policy group
    aclEntryCount Integer
    Number of IP entries in the access control policy group
    aclId String
    Access control policy group ID
    createdTime String
    Creation time of the access control policy group
    id String
    The provider-assigned unique ID for this managed resource.
    listeners List<AclListener>
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    status String
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    updatedTime String
    Last operation time of the access control policy group
    aclEntryCount number
    Number of IP entries in the access control policy group
    aclId string
    Access control policy group ID
    createdTime string
    Creation time of the access control policy group
    id string
    The provider-assigned unique ID for this managed resource.
    listeners AclListener[]
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    updatedTime string
    Last operation time of the access control policy group
    acl_entry_count int
    Number of IP entries in the access control policy group
    acl_id str
    Access control policy group ID
    created_time str
    Creation time of the access control policy group
    id str
    The provider-assigned unique ID for this managed resource.
    listeners Sequence[AclListener]
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    status str
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    updated_time str
    Last operation time of the access control policy group
    aclEntryCount Number
    Number of IP entries in the access control policy group
    aclId String
    Access control policy group ID
    createdTime String
    Creation time of the access control policy group
    id String
    The provider-assigned unique ID for this managed resource.
    listeners List<Property Map>
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    status String
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    updatedTime String
    Last operation time of the access control policy group

    Look up Existing Acl Resource

    Get an existing Acl resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: AclState, opts?: CustomResourceOptions): Acl
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            acl_entries: Optional[Sequence[AclAclEntryArgs]] = None,
            acl_entry_count: Optional[int] = None,
            acl_id: Optional[str] = None,
            acl_name: Optional[str] = None,
            created_time: Optional[str] = None,
            description: Optional[str] = None,
            listeners: Optional[Sequence[AclListenerArgs]] = None,
            project_name: Optional[str] = None,
            status: Optional[str] = None,
            tags: Optional[Sequence[AclTagArgs]] = None,
            updated_time: Optional[str] = None) -> Acl
    func GetAcl(ctx *Context, name string, id IDInput, state *AclState, opts ...ResourceOption) (*Acl, error)
    public static Acl Get(string name, Input<string> id, AclState? state, CustomResourceOptions? opts = null)
    public static Acl get(String name, Output<String> id, AclState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:alb:Acl    get:      id: ${id}
    import {
      to = volcenginecc_alb_acl.example
      id = "${id}"
    }
    
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AclEntries List<Volcengine.AclAclEntry>
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    AclEntryCount int
    Number of IP entries in the access control policy group
    AclId string
    Access control policy group ID
    AclName string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    CreatedTime string
    Creation time of the access control policy group
    Description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    Listeners List<Volcengine.AclListener>
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    ProjectName string
    Project name to which the access control policy group belongs
    Status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    Tags List<Volcengine.AclTag>
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    UpdatedTime string
    Last operation time of the access control policy group
    AclEntries []AclAclEntryArgs
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    AclEntryCount int
    Number of IP entries in the access control policy group
    AclId string
    Access control policy group ID
    AclName string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    CreatedTime string
    Creation time of the access control policy group
    Description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    Listeners []AclListenerArgs
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    ProjectName string
    Project name to which the access control policy group belongs
    Status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    Tags []AclTagArgs
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    UpdatedTime string
    Last operation time of the access control policy group
    acl_entries list(object)
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    acl_entry_count number
    Number of IP entries in the access control policy group
    acl_id string
    Access control policy group ID
    acl_name string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    created_time string
    Creation time of the access control policy group
    description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    listeners list(object)
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    project_name string
    Project name to which the access control policy group belongs
    status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    tags list(object)
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updated_time string
    Last operation time of the access control policy group
    aclEntries List<AclAclEntry>
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclEntryCount Integer
    Number of IP entries in the access control policy group
    aclId String
    Access control policy group ID
    aclName String
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    createdTime String
    Creation time of the access control policy group
    description String
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    listeners List<AclListener>
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    projectName String
    Project name to which the access control policy group belongs
    status String
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    tags List<AclTag>
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updatedTime String
    Last operation time of the access control policy group
    aclEntries AclAclEntry[]
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclEntryCount number
    Number of IP entries in the access control policy group
    aclId string
    Access control policy group ID
    aclName string
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    createdTime string
    Creation time of the access control policy group
    description string
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    listeners AclListener[]
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    projectName string
    Project name to which the access control policy group belongs
    status string
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    tags AclTag[]
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updatedTime string
    Last operation time of the access control policy group
    acl_entries Sequence[AclAclEntryArgs]
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    acl_entry_count int
    Number of IP entries in the access control policy group
    acl_id str
    Access control policy group ID
    acl_name str
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    created_time str
    Creation time of the access control policy group
    description str
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    listeners Sequence[AclListenerArgs]
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    project_name str
    Project name to which the access control policy group belongs
    status str
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    tags Sequence[AclTagArgs]
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updated_time str
    Last operation time of the access control policy group
    aclEntries List<Property Map>
    Details of IP entries in the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    aclEntryCount Number
    Number of IP entries in the access control policy group
    aclId String
    Access control policy group ID
    aclName String
    Name of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, periods (.), underscores (_), and hyphens (-). Length must be between 1 and 128 characters. If left blank, defaults to the Access Control Policy Group ID.
    createdTime String
    Creation time of the access control policy group
    description String
    Description of the Access Control Policy Group. Cannot start with http:// or https://. Must begin with a letter or Chinese character and may include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length must be between 1 and 255 characters. If left blank, defaults to an empty string.
    listeners List<Property Map>
    Details of listeners associated with the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    projectName String
    Project name to which the access control policy group belongs
    status String
    Status of the access control policy group. Creating: Creating. Active: Available. Configuring: Configuring. Deleting: Deleting
    tags List<Property Map>
    Tags bound to the access control policy group Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updatedTime String
    Last operation time of the access control policy group

    Supporting Types

    AclAclEntry, AclAclEntryArgs

    Description string
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    Entry string
    IP entry address range; only CIDR addresses are supported
    Description string
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    Entry string
    IP entry address range; only CIDR addresses are supported
    description string
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    entry string
    IP entry address range; only CIDR addresses are supported
    description String
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    entry String
    IP entry address range; only CIDR addresses are supported
    description string
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    entry string
    IP entry address range; only CIDR addresses are supported
    description str
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    entry str
    IP entry address range; only CIDR addresses are supported
    description String
    Description of the IP entry. Cannot start with http:// or https://. Must start with a letter or Chinese character. Can include numbers, English commas (,), periods (.), underscores (_), spaces ( ), equals signs (=), hyphens (-), Chinese commas (,), and Chinese periods (。). Length limit: 1–255 characters. If not specified, defaults to an empty string
    entry String
    IP entry address range; only CIDR addresses are supported

    AclListener, AclListenerArgs

    AclType string
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    ListenerId string
    Listener ID
    ListenerName string
    Listener name
    Port int
    Listener port
    Protocol string
    Listener protocol
    AclType string
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    ListenerId string
    Listener ID
    ListenerName string
    Listener name
    Port int
    Listener port
    Protocol string
    Listener protocol
    acl_type string
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    listener_id string
    Listener ID
    listener_name string
    Listener name
    port number
    Listener port
    protocol string
    Listener protocol
    aclType String
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    listenerId String
    Listener ID
    listenerName String
    Listener name
    port Integer
    Listener port
    protocol String
    Listener protocol
    aclType string
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    listenerId string
    Listener ID
    listenerName string
    Listener name
    port number
    Listener port
    protocol string
    Listener protocol
    acl_type str
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    listener_id str
    Listener ID
    listener_name str
    Listener name
    port int
    Listener port
    protocol str
    Listener protocol
    aclType String
    Control mode of the listener for this access control policy group. white: Allowlist mode; black: Denylist mode
    listenerId String
    Listener ID
    listenerName String
    Listener name
    port Number
    Listener port
    protocol String
    Listener protocol

    AclTag, AclTagArgs

    Key string
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    Value string
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @
    Key string
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    Value string
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @
    key string
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    value string
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @
    key String
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    value String
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @
    key string
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    value string
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @
    key str
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    value str
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @
    key String
    User tag key. Length limit: 1–128 characters. Case sensitive. Cannot start with any combination of volc: or sys: (case insensitive). Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @. Tag keys for the same resource must be unique
    value String
    User tag value. Length limit: 0–256 characters. Case sensitive. Cannot start or end with a space. Supports characters from all languages, numbers, spaces (), underscores (_), periods (.), colons (:), slashes (/), equals signs (=), plus signs (+), hyphens (-), and @

    Import

    $ pulumi import volcenginecc:alb/acl:Acl example "acl_id"
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    volcenginecc volcengine/pulumi-volcenginecc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the volcenginecc Terraform Provider.
    volcenginecc logo
    Viewing docs for volcenginecc v0.0.50
    published on Monday, Jul 20, 2026 by Volcengine

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial