Todos os produtos
Search
Central de documentação

:ListDpiGroups

Última atualização: Jul 03, 2026

Consulta informações sobre grupos de aplicativos compatíveis com instâncias do Smart Access Gateway (SAG) em uma região específica.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Não ListDpiGroups

A operação a ser executada.

Defina o valor como ListDpiGroups.

RegionId String Sim cn-shanghai

O ID da região à qual os grupos de aplicativos pertencem.

Chame a API DescribeRegions para consultar a lista mais recente de regiões.

NextToken String Não FFPSpX59Eb****

O token usado para consultar a próxima página.

MaxResults Integer Não 3

O número de entradas a retornar por página.

Valores válidos: 1 a 100.

Valor padrão: 20.

DpiGroupIds.N RepeatList Não 1

O ID do grupo de aplicativos.

Consulte informações de um ou mais grupos de aplicativos pelo ID do grupo. Especifique no máximo 10 IDs de grupo em cada chamada.

DpiGroupNames.N RepeatList Não P2P

O nome do grupo de aplicativos.

Consulte informações de um ou mais grupos de aplicativos pelo nome do grupo. Especifique no máximo 10 nomes de grupo em cada chamada.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

DpiGroup

Array of DpiGroup

As informações sobre o grupo de aplicativos.

DpiGroupId

String

1

O ID do grupo de aplicativos.

DpiGroupName

String

P2P

O nome do grupo de aplicativos.

MinEngineVersion

String

0-0.0.1

A versão mínima do mecanismo compatível com o grupo de aplicativos.

MinSignatureDbVersion

String

20201117_1_0-0.0.1

A versão mínima do banco de dados de assinaturas compatível com o grupo de aplicativos.

NextToken

String

FFPSpX59Ebw****

O token retornado para a próxima consulta.

RequestId

String

EC184A86-3C93-49D6-BB34-6C193E14D37F

O ID da solicitação.

TotalCount

Integer

22

O número total de entradas retornadas.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/? Action=ListDpiGroups
&RegionId=cn-shanghai
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ListDpiGroupsResponse>
  <TotalCount>22</TotalCount>
  <RequestId>9E753114-BAF3-4676-9572-377FED18446D</RequestId>
  <NextToken>FFPSpX59Ebw****</NextToken>
  <DpiGroup>
        <MinEngineVersion>0-0.0.1</MinEngineVersion>
        <DpiGroupName>P2P</DpiGroupName>
        <MinSignatureDbVersion>20201117_1_0-0.0.1</MinSignatureDbVersion>
        <DpiGroupId>1</DpiGroupId>
  </DpiGroup>
  <DpiGroup>
        <MinEngineVersion>0-0.0.1</MinEngineVersion>
        <DpiGroupName>VoIP</DpiGroupName>
        <MinSignatureDbVersion>20201117_1_0-0.0.1</MinSignatureDbVersion>
        <DpiGroupId>2</DpiGroupId>
  </DpiGroup>
</ListDpiGroupsResponse>

Formato JSON

{
	"TotalCount": 22,
	"RequestId": "9E753114-BAF3-4676-9572-377FED18446D",
	"NextToken": "FFPSpX59Ebw****",
	"DpiGroup": [
		{
			"MinEngineVersion": "0-0.0.1",
			"DpiGroupName": "P2P",
			"MinSignatureDbVersion": "20201117_1_0-0.0.1",
			"DpiGroupId": "1"
		},
		{
			"MinEngineVersion": "0-0.0.1",
			"DpiGroupName": "VoIP",
			"MinSignatureDbVersion": "20201117_1_0-0.0.1",
			"DpiGroupId": "2"
		}
	]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.