DescribeDomainList - Web Application Firewall: Central de Documentação do Alibaba Cloud

Consulta os nomes de domínio adicionados ao Web Application Firewall (WAF) com suporte a paginação.

Para consultar nomes de domínio sem paginação, chame a operação DescribeDomainNames . Essa operação retorna todos os nomes de domínio em uma única resposta. Para grandes quantidades de nomes de domínio, use o DescribeDomainList, que permite filtragem baseada em condições e retorna resultados paginados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeDomainList	A operação a ser executada. Defina o valor como DescribeDomainList.
InstanceId	String	Sim	waf-cn-7pp26f1****	O ID da instância do WAF. Para obter o ID da instância, chame a operação DescribeInstanceInfo.
ResourceGroupId	String	Não	rg-acfm2pz25js****	O ID do grupo de recursos ao qual a instância do WAF pertence no Resource Management. Se deixado em branco, a instância do WAF pertencerá ao grupo de recursos padrão. Para mais informações, consulte Crie um grupo de recursos.
DomainName	String	Não	example.com	O nome de domínio a ser consultado. Há suporte para correspondência aproximada. Use este parâmetro para verificar se um nome de domínio específico foi adicionado ao WAF.
DomainNames.N	RepeatList	Não	example.com	O nome de domínio N a ser consultado. Há suporte para correspondência aproximada. Use este parâmetro para verificar se vários nomes de domínio foram adicionados ao WAF.
PageNumber	Integer	Não	1	O número da página. As páginas começam na página 1. Valor padrão: 1.
PageSize	Integer	Não	10	O número de entradas por página. Valor padrão: 10.
IsSub	Integer	Não	0	O tipo de nomes de domínio a serem consultados. Valores válidos: 0 (todos os nomes de domínio, incluindo correspondência exata e domínios curinga; padrão), 1 (apenas nomes de domínio com correspondência exata).

Todas as operações da API do Alibaba Cloud devem incluir parâmetros de solicitação comuns. Para mais informações, consulte Parâmetros comuns.

Para exemplos de solicitações, consulte a seção Examples deste tópico.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
DomainNames	List	["www.example.com","test.example.com"]	Os nomes de domínio retornados.
RequestId	String	592E866F-6C05-4E7C-81DE-B4D8E86B91EF	O ID da solicitação.
TotalCount	Integer	2	O número total de nomes de domínio retornados.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeDomainList
&InstanceId=waf-cn-7pp26f1****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeDomainListResponse>
      <TotalCount>2</TotalCount>
      <RequestId>592E866F-6C05-4E7C-81DE-B4D8E86B91EF</RequestId>
      <DomainNames>www.example.com</DomainNames>
      <DomainNames>test.example.com</DomainNames>
</DescribeDomainListResponse>

Formato JSON

{
  "TotalCount": 2,
  "RequestId": "592E866F-6C05-4E7C-81DE-B4D8E86B91EF",
  "DomainNames": [
    "www.example.com",
    "test.example.com"
  ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.