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

Obtém informações sobre grupos de objetos protegidos usando paginação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

yundun-waf:DescribeDefenseResourceGroups

list

*All Resource

*

acs:ResourceGroupId

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância do Web Application Firewall (WAF). Nota Você pode chamar a operação DescribeInstance para visualizar o ID da instância WAF atual.	waf_v2_public_cn-wwo36****0i
ResourceManagerResourceGroupId	string	Não	O ID do grupo de recursos do Alibaba Cloud.	rg-acfmxc7lf****eq
GroupNameLike	string	Não	O nome do grupo de objetos protegidos que você deseja consultar. A consulta difusa é suportada.	demoGroupName
PageNumber	integer	Não	O número da página. Valor padrão: 1, que indica a primeira página.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 20, que indica 20 entradas por página.	20
GroupNames	string	Não	Os nomes dos grupos de objetos protegidos que você deseja consultar. Separe múltiplos nomes com vírgulas (,).	groupName1,groupName2
RegionId	string	Não	A região na qual a instância WAF está implantada. Valores válidos: cn-hangzhou: território continental chinês. ap-southeast-1: fora do território continental chinês.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	BFEC5C77-049B-5E88-A5B6-CB0C****B66E
TotalCount	integer	O número total de entradas retornadas.	10
Groups	array<object>	A lista de grupos de objetos protegidos.
	object	O grupo de objetos protegidos.
Description	string	A descrição do grupo de objetos protegidos.	This is test description
GmtCreate	integer	A hora em que o grupo de objetos protegidos foi criado. Unidade: milissegundos.	1624343180000
GmtModified	integer	A hora mais recente em que o grupo de objetos protegidos foi modificado. Unidade: milissegundos.	1701656305000
GroupName	string	O nome do grupo de objetos protegidos.	apptest
ResourceList	string	Os nomes dos objetos protegidos adicionados ao grupo de objetos protegidos. Separe múltiplos objetos protegidos com vírgulas (,).	example02.aliyun-waf,example01.aliyun-waf

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "BFEC5C77-049B-5E88-A5B6-CB0C****B66E",
  "TotalCount": 10,
  "Groups": [
    {
      "Description": "This is test description",
      "GmtCreate": 1624343180000,
      "GmtModified": 1701656305000,
      "GroupName": "apptest",
      "ResourceList": "example02.aliyun-waf,example01.aliyun-waf"
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.