1. Packages
  2. Volcengine
  3. API Docs
  4. clb
  5. getAcls
Viewing docs for Volcengine v0.0.46
published on Friday, Feb 27, 2026 by Volcengine
Schema (JSON)
volcengine/pulumi-volcengine

volcengine.clb.getAcls

volcengine logo
Viewing docs for Volcengine v0.0.46
published on Friday, Feb 27, 2026 by Volcengine
Schema (JSON)
volcengine/pulumi-volcengine

    Use this data source to query detailed information of acls

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as volcengine from "@pulumi/volcengine";

const default = volcengine.clb.getAcls({
    ids: ["acl-3ti8n0rurx4bwbh9jzdy"],
    tags: [{
        key: "k1",
        value: "v1",
    }],
});

    import pulumi
import pulumi_volcengine as volcengine

default = volcengine.clb.get_acls(ids=["acl-3ti8n0rurx4bwbh9jzdy"],
    tags=[volcengine.clb.GetAclsTagArgs(
        key="k1",
        value="v1",
    )])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/clb"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := clb.GetAcls(ctx, &clb.GetAclsArgs{
			Ids: []string{
				"acl-3ti8n0rurx4bwbh9jzdy",
			},
			Tags: []clb.GetAclsTag{
				{
					Key:   "k1",
					Value: "v1",
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Volcengine = Pulumi.Volcengine;

return await Deployment.RunAsync(() => 
{
    var @default = Volcengine.Clb.GetAcls.Invoke(new()
    {
        Ids = new[]
        {
            "acl-3ti8n0rurx4bwbh9jzdy",
        },
        Tags = new[]
        {
            new Volcengine.Clb.Inputs.GetAclsTagInputArgs
            {
                Key = "k1",
                Value = "v1",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.volcengine.clb.ClbFunctions;
import com.pulumi.volcengine.clb.inputs.GetAclsArgs;
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 default = ClbFunctions.getAcls(GetAclsArgs.builder()
            .ids("acl-3ti8n0rurx4bwbh9jzdy")
            .tags(GetAclsTagArgs.builder()
                .key("k1")
                .value("v1")
                .build())
            .build());

    }
}

    variables:
  default:
    fn::invoke:
      Function: volcengine:clb:getAcls
      Arguments:
        ids:
          - acl-3ti8n0rurx4bwbh9jzdy
        tags:
          - key: k1
            value: v1

    Using getAcls

    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 getAcls(args: GetAclsArgs, opts?: InvokeOptions): Promise<GetAclsResult>
function getAclsOutput(args: GetAclsOutputArgs, opts?: InvokeOptions): Output<GetAclsResult>
    def get_acls(acl_name: Optional[str] = None,
             ids: Optional[Sequence[str]] = None,
             name_regex: Optional[str] = None,
             output_file: Optional[str] = None,
             project_name: Optional[str] = None,
             tags: Optional[Sequence[GetAclsTag]] = None,
             opts: Optional[InvokeOptions] = None) -> GetAclsResult
def get_acls_output(acl_name: Optional[pulumi.Input[str]] = None,
             ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             name_regex: Optional[pulumi.Input[str]] = None,
             output_file: Optional[pulumi.Input[str]] = None,
             project_name: Optional[pulumi.Input[str]] = None,
             tags: Optional[pulumi.Input[Sequence[pulumi.Input[GetAclsTagArgs]]]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetAclsResult]
    func GetAcls(ctx *Context, args *GetAclsArgs, opts ...InvokeOption) (*GetAclsResult, error)
func GetAclsOutput(ctx *Context, args *GetAclsOutputArgs, opts ...InvokeOption) GetAclsResultOutput

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

    public static class GetAcls 
{
    public static Task<GetAclsResult> InvokeAsync(GetAclsArgs args, InvokeOptions? opts = null)
    public static Output<GetAclsResult> Invoke(GetAclsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetAclsResult> getAcls(GetAclsArgs args, InvokeOptions options)
public static Output<GetAclsResult> getAcls(GetAclsArgs args, InvokeOptions options)

    fn::invoke:
  function: volcengine:clb/getAcls:getAcls
  arguments:
    # arguments dictionary

    The following arguments are supported:

    AclName string
    The name of acl.
    Ids List<string>
    A list of Acl IDs.
    NameRegex string
    A Name Regex of Acl.
    OutputFile string
    File name where to save data source results.
    ProjectName string
    The ProjectName of Acl.
    Tags List<GetAclsTag>
    Tags.
    AclName string
    The name of acl.
    Ids []string
    A list of Acl IDs.
    NameRegex string
    A Name Regex of Acl.
    OutputFile string
    File name where to save data source results.
    ProjectName string
    The ProjectName of Acl.
    Tags []GetAclsTag
    Tags.
    aclName String
    The name of acl.
    ids List<String>
    A list of Acl IDs.
    nameRegex String
    A Name Regex of Acl.
    outputFile String
    File name where to save data source results.
    projectName String
    The ProjectName of Acl.
    tags List<GetAclsTag>
    Tags.
    aclName string
    The name of acl.
    ids string[]
    A list of Acl IDs.
    nameRegex string
    A Name Regex of Acl.
    outputFile string
    File name where to save data source results.
    projectName string
    The ProjectName of Acl.
    tags GetAclsTag[]
    Tags.
    acl_name str
    The name of acl.
    ids Sequence[str]
    A list of Acl IDs.
    name_regex str
    A Name Regex of Acl.
    output_file str
    File name where to save data source results.
    project_name str
    The ProjectName of Acl.
    tags Sequence[GetAclsTag]
    Tags.
    aclName String
    The name of acl.
    ids List<String>
    A list of Acl IDs.
    nameRegex String
    A Name Regex of Acl.
    outputFile String
    File name where to save data source results.
    projectName String
    The ProjectName of Acl.
    tags List<Property Map>
    Tags.

    getAcls Result

    The following output properties are available:

    Acls List<GetAclsAcl>
    The collection of Acl query.
    Id string
    The provider-assigned unique ID for this managed resource.
    TotalCount int
    The total count of Acl query.
    AclName string
    The Name of Acl.
    Ids List<string>
    NameRegex string
    OutputFile string
    ProjectName string
    The ProjectName of Acl.
    Tags List<GetAclsTag>
    Tags.
    Acls []GetAclsAcl
    The collection of Acl query.
    Id string
    The provider-assigned unique ID for this managed resource.
    TotalCount int
    The total count of Acl query.
    AclName string
    The Name of Acl.
    Ids []string
    NameRegex string
    OutputFile string
    ProjectName string
    The ProjectName of Acl.
    Tags []GetAclsTag
    Tags.
    acls List<GetAclsAcl>
    The collection of Acl query.
    id String
    The provider-assigned unique ID for this managed resource.
    totalCount Integer
    The total count of Acl query.
    aclName String
    The Name of Acl.
    ids List<String>
    nameRegex String
    outputFile String
    projectName String
    The ProjectName of Acl.
    tags List<GetAclsTag>
    Tags.
    acls GetAclsAcl[]
    The collection of Acl query.
    id string
    The provider-assigned unique ID for this managed resource.
    totalCount number
    The total count of Acl query.
    aclName string
    The Name of Acl.
    ids string[]
    nameRegex string
    outputFile string
    projectName string
    The ProjectName of Acl.
    tags GetAclsTag[]
    Tags.
    acls Sequence[GetAclsAcl]
    The collection of Acl query.
    id str
    The provider-assigned unique ID for this managed resource.
    total_count int
    The total count of Acl query.
    acl_name str
    The Name of Acl.
    ids Sequence[str]
    name_regex str
    output_file str
    project_name str
    The ProjectName of Acl.
    tags Sequence[GetAclsTag]
    Tags.
    acls List<Property Map>
    The collection of Acl query.
    id String
    The provider-assigned unique ID for this managed resource.
    totalCount Number
    The total count of Acl query.
    aclName String
    The Name of Acl.
    ids List<String>
    nameRegex String
    outputFile String
    projectName String
    The ProjectName of Acl.
    tags List<Property Map>
    Tags.

    Supporting Types

    GetAclsAcl

    AclEntries List<GetAclsAclAclEntry>
    The acl entry list of the Acl.
    AclEntryCount int
    The count of acl entry.
    AclId string
    The ID of Acl.
    AclName string
    The name of acl.
    CreateTime string
    Creation time of Acl.
    Description string
    The description of Acl.
    Id string
    The ID of Acl.
    ListenerDetails List<GetAclsAclListenerDetail>
    The listener details of the Acl.
    Listeners List<string>
    The listeners of Acl.
    ProjectName string
    The ProjectName of Acl.
    ServiceManaged bool
    Whether the Acl is managed by service.
    Status string
    The status of the Acl.
    Tags List<GetAclsAclTag>
    Tags.
    UpdateTime string
    Update time of Acl.
    AclEntries []GetAclsAclAclEntry
    The acl entry list of the Acl.
    AclEntryCount int
    The count of acl entry.
    AclId string
    The ID of Acl.
    AclName string
    The name of acl.
    CreateTime string
    Creation time of Acl.
    Description string
    The description of Acl.
    Id string
    The ID of Acl.
    ListenerDetails []GetAclsAclListenerDetail
    The listener details of the Acl.
    Listeners []string
    The listeners of Acl.
    ProjectName string
    The ProjectName of Acl.
    ServiceManaged bool
    Whether the Acl is managed by service.
    Status string
    The status of the Acl.
    Tags []GetAclsAclTag
    Tags.
    UpdateTime string
    Update time of Acl.
    aclEntries List<GetAclsAclAclEntry>
    The acl entry list of the Acl.
    aclEntryCount Integer
    The count of acl entry.
    aclId String
    The ID of Acl.
    aclName String
    The name of acl.
    createTime String
    Creation time of Acl.
    description String
    The description of Acl.
    id String
    The ID of Acl.
    listenerDetails List<GetAclsAclListenerDetail>
    The listener details of the Acl.
    listeners List<String>
    The listeners of Acl.
    projectName String
    The ProjectName of Acl.
    serviceManaged Boolean
    Whether the Acl is managed by service.
    status String
    The status of the Acl.
    tags List<GetAclsAclTag>
    Tags.
    updateTime String
    Update time of Acl.
    aclEntries GetAclsAclAclEntry[]
    The acl entry list of the Acl.
    aclEntryCount number
    The count of acl entry.
    aclId string
    The ID of Acl.
    aclName string
    The name of acl.
    createTime string
    Creation time of Acl.
    description string
    The description of Acl.
    id string
    The ID of Acl.
    listenerDetails GetAclsAclListenerDetail[]
    The listener details of the Acl.
    listeners string[]
    The listeners of Acl.
    projectName string
    The ProjectName of Acl.
    serviceManaged boolean
    Whether the Acl is managed by service.
    status string
    The status of the Acl.
    tags GetAclsAclTag[]
    Tags.
    updateTime string
    Update time of Acl.
    acl_entries Sequence[GetAclsAclAclEntry]
    The acl entry list of the Acl.
    acl_entry_count int
    The count of acl entry.
    acl_id str
    The ID of Acl.
    acl_name str
    The name of acl.
    create_time str
    Creation time of Acl.
    description str
    The description of Acl.
    id str
    The ID of Acl.
    listener_details Sequence[GetAclsAclListenerDetail]
    The listener details of the Acl.
    listeners Sequence[str]
    The listeners of Acl.
    project_name str
    The ProjectName of Acl.
    service_managed bool
    Whether the Acl is managed by service.
    status str
    The status of the Acl.
    tags Sequence[GetAclsAclTag]
    Tags.
    update_time str
    Update time of Acl.
    aclEntries List<Property Map>
    The acl entry list of the Acl.
    aclEntryCount Number
    The count of acl entry.
    aclId String
    The ID of Acl.
    aclName String
    The name of acl.
    createTime String
    Creation time of Acl.
    description String
    The description of Acl.
    id String
    The ID of Acl.
    listenerDetails List<Property Map>
    The listener details of the Acl.
    listeners List<String>
    The listeners of Acl.
    projectName String
    The ProjectName of Acl.
    serviceManaged Boolean
    Whether the Acl is managed by service.
    status String
    The status of the Acl.
    tags List<Property Map>
    Tags.
    updateTime String
    Update time of Acl.

    GetAclsAclAclEntry

    Description string
    The description of Acl.
    Entry string
    The address range of the IP entry.
    Description string
    The description of Acl.
    Entry string
    The address range of the IP entry.
    description String
    The description of Acl.
    entry String
    The address range of the IP entry.
    description string
    The description of Acl.
    entry string
    The address range of the IP entry.
    description str
    The description of Acl.
    entry str
    The address range of the IP entry.
    description String
    The description of Acl.
    entry String
    The address range of the IP entry.

    GetAclsAclListenerDetail

    AclType string
    The control method of the listener for this Acl. Valid values: black, white.
    ListenerId string
    The ID of the listener.
    ListenerName string
    The name of the listener.
    Port int
    The port receiving request of the listener.
    Protocol string
    The protocol of the listener.
    AclType string
    The control method of the listener for this Acl. Valid values: black, white.
    ListenerId string
    The ID of the listener.
    ListenerName string
    The name of the listener.
    Port int
    The port receiving request of the listener.
    Protocol string
    The protocol of the listener.
    aclType String
    The control method of the listener for this Acl. Valid values: black, white.
    listenerId String
    The ID of the listener.
    listenerName String
    The name of the listener.
    port Integer
    The port receiving request of the listener.
    protocol String
    The protocol of the listener.
    aclType string
    The control method of the listener for this Acl. Valid values: black, white.
    listenerId string
    The ID of the listener.
    listenerName string
    The name of the listener.
    port number
    The port receiving request of the listener.
    protocol string
    The protocol of the listener.
    acl_type str
    The control method of the listener for this Acl. Valid values: black, white.
    listener_id str
    The ID of the listener.
    listener_name str
    The name of the listener.
    port int
    The port receiving request of the listener.
    protocol str
    The protocol of the listener.
    aclType String
    The control method of the listener for this Acl. Valid values: black, white.
    listenerId String
    The ID of the listener.
    listenerName String
    The name of the listener.
    port Number
    The port receiving request of the listener.
    protocol String
    The protocol of the listener.

    GetAclsAclTag

    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.
    key string
    The Key of Tags.
    value string
    The Value of Tags.
    key str
    The Key of Tags.
    value str
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.

    GetAclsTag

    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.
    key string
    The Key of Tags.
    value string
    The Value of Tags.
    key str
    The Key of Tags.
    value str
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.

    Package Details

    Repository
    volcengine volcengine/pulumi-volcengine
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the volcengine Terraform Provider.
    volcengine logo
    Viewing docs for Volcengine v0.0.46
    published on Friday, Feb 27, 2026 by Volcengine
    Schema (JSON)
    volcengine/pulumi-volcengine
      Try Pulumi Cloud free. Your team will thank you.