All Products
Search

This Product

    Cloud Firewall:DescribeAclApps

    Document Center

    Cloud Firewall:DescribeAclApps

    Last Updated:Oct 15, 2025

    Queries multiple access control applications.

    Operation description

    QPS limit

    Each user can make up to 10 queries per second (QPS) to this API. If you exceed this limit, your API calls are throttled, which may impact your business. We recommend that you call this API at a reasonable rate.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    Lang

    string

    No

    The language of the response message. Valid values:

    • zh (default): Chinese.

    • en: English.

    zh
    PageNo

    integer

    Yes

    The page number.

    1
    PageSize

    integer

    Yes

    The number of entries per page.

    10
    AclType

    string

    Yes

    The type of the access control list (ACL). Valid values:

    • Internet

    • NAT

    • VPC

    • All

    VPC
    Popular

    integer

    No

    Specifies whether the application is common. Valid values:

    • 1: common

    • 0: not common

    • If you do not specify this parameter, all applications are queried.

    Valid values:

    • 1 :

      1

    1
    Protocols

    array

    No

    The list of protocol types.

    string

    No

    The protocol type.

    • TCP: TCP

    • UDP: UDP

    [ "TCP", "UDP" ]

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    9063AB86-6FFA-5B2D-A16D-697C966D****
    AclApps

    array<object>

    The list of access control applications.

    object

    AppId

    integer

    The application ID.

    1.0
    AppName

    string

    The application name.

    test
    RiskLevel

    integer

    The risk assessment level. Valid values:

    • 1: low

    • 2: medium

    • 3: high

    1
    Popular

    integer

    Indicates whether the application is common. Valid values:

    • 1: The application is common.

    • 0: The application is not common.

    • Leave blank (default value): Queries all.

    1
    Protocols

    array

    The list of protocol types.

    string

    The protocol type.

    • TCP: TCP

    • UDP: UDP

    [ "TCP", "UDP" ]
    SupportFqdn

    integer

    Indicates whether the application supports fully qualified domain names (FQDNs).

    • 0: No

    • 1: Yes

    1
    TotalCount

    integer

    The total number of entries.

    20

    Examples

    Success response

    JSON format

    {
  "RequestId": "9063AB86-6FFA-5B2D-A16D-697C966D****",
  "AclApps": [
    {
      "AppId": 1,
      "AppName": "test",
      "RiskLevel": 1,
      "Popular": 1,
      "Protocols": [
        "[\n  \"TCP\",\n  \"UDP\"\n]"
      ],
      "SupportFqdn": 1
    }
  ],
  "TotalCount": 20
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.