All Products
Search

This Product

    Cloud Firewall:DescribePolicyPriorUsed

    Document Center

    Cloud Firewall:DescribePolicyPriorUsed

    Last Updated:Dec 09, 2025

    Queries the priority range of access control policies.

    Operation description

    You can call this operation to query the priority range of access control policies for inbound or outbound traffic.

    Rate limit

    This operation is limited to 10 queries per second (QPS) per user. If you exceed this limit, API calls are throttled. Throttling may impact your business. Plan your calls accordingly.

    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
    SourceIp deprecated

    string

    No

    The source IP address of the visitor.

    192.0.XX.XX
    Lang

    string

    No

    The language of the request and response.

    Valid values:

    • zh (default): Chinese

    • en: English

    zh
    Direction

    string

    Yes

    The traffic direction of the access control policy.

    Valid values:

    • in: inbound traffic

    • out: outbound traffic

    in
    IpVersion

    string

    No

    The IP version of the assets that are protected by Cloud Firewall.

    Valid values:

    • 4 (default): IPv4

    • 6: IPv6

    6

    Response elements

    Element

    Type

    Description

    Example

    object

    End

    integer

    The lowest priority of the created access control policies.

    Note

    A value of -1 indicates the lowest priority.

    150
    Start

    integer

    The highest priority of the created access control policies.

    Note

    A value of 0 indicates the highest priority.

    -1
    RequestId

    string

    The ID of the request.

    CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

    Examples

    Success response

    JSON format

    {
  "End": 150,
  "Start": -1,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 ErrorParameterIpVersion The IP version is invalid. The IP version is invalid.
    400 ErrorParametersDirection The direction is invalid. The direction is invalid.
    400 ErrorParametersUid The aliUid parameter is invalid. The aliUid parameter is invalid.
    400 ErrorDBSelect An error occurred while querying database. An error occurred while querying database.
    400 ErrorUUIDNew The UUID is invalid. The UUID is invalid.
    400 ErrorParametersAppId The AppId parameter is incorrect. The AppId parameter is invalid.
    400 ErrorParametersSource The source is invalid. The source is invalid.
    400 ErrorDomainResolve A domain resolution error occurred. An error occurred while resolving the domain.
    400 ErrorParametersDestination The destination is invalid. The destination is invalid.
    400 ErrorParametersProto The protocol is invalid. The protocol is invalid.
    400 ErrorParametersDestPort The dst_port is invalid. The dst_port is invalid.
    400 ErrorParametersAction The action is invalid. The action is invalid.
    400 ErrorParameters Parameters error. Parameter error.
    400 ErrorMarshalJSON An error occurred while encoding JSON. An error occurred while encoding JSON.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.