All Products
Search
Document Center

Smart Access Gateway:ListDpiSignatures

Last Updated:Aug 08, 2025

Queries information about all applications, specific applications, or specific application groups supported by Smart Access Gateway (SAG) in a specified region.

Operation description

This operation lets you:

  • Query all applications supported by SAG in a specified region.

  • Query a specific application by its ID in a specified region.

  • Query a specific application by its name in a specified region.

  • Query all applications in a specific application group by the group ID in a specified region.

If this is the first time you call this operation, we recommend that you query all applications supported by SAG in a region. This helps you obtain the information required for subsequent queries of specific applications.

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

RegionId

string

Yes

The region ID.

Call the DescribeRegions operation to query the regions and their IDs that are supported by SAG.

cn-shanghai

NextToken

string

No

The token for the next page of results.

caeba0bbb2****

MaxResults

integer

No

The number of applications to return on each page.

Valid values: 1 to 100.

Default value: 20.

20

DpiGroupId

string

No

The ID of the application group.

20

DpiSignatureIds

array

No

The application ID.

235

string

No

The application ID.

235

DpiSignatureNames

array

No

The application name.

EdgeCast

string

No

The application name.

EdgeCast

Response parameters

Parameter

Type

Description

Example

object

The response parameters.

TotalCount

integer

The total number of applications returned.

1

NextToken

string

The token for the next page of results.

FFrMV38kR4****

RequestId

string

The request ID.

63081123-B7C0-4BC9-B9E5-59E77A616EC9

DpiSignature

array<object>

A list of applications.

object

The application information.

DpiSignatureId

string

The application ID.

235

MinSignatureDbVersion

string

The minimum version of the signature library that supports the application.

20201117_1_0-0.0.1

DpiGroupId

string

The ID of the application group to which the application belongs.

20

MinEngineVersion

string

The minimum version of the deep packet inspection (DPI) engine that supports the application.

0-0.0.1

DpiSignatureName

string

The application name.

EdgeCast

Examples

Success response

JSON format

{
  "TotalCount": 1,
  "NextToken": "FFrMV38kR4****",
  "RequestId": "63081123-B7C0-4BC9-B9E5-59E77A616EC9",
  "DpiSignature": [
    {
      "DpiSignatureId": "235",
      "MinSignatureDbVersion": "20201117_1_0-0.0.1",
      "DpiGroupId": "20",
      "MinEngineVersion": "0-0.0.1",
      "DpiSignatureName": "EdgeCast"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.