Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ API Gateway/ Referência de API/ APIs compartilhadas de gateway (para usuários existentes)/ Gerenciamento de política de controle de acesso/ Consulta da lista de políticas de controle de acesso
Atualizado em 2023-05-29 GMT+08:00
Ver PDF
Compartilhar

Consulta da lista de políticas de controle de acesso

Função

Esta API é usada para consultar a lista de todas as políticas de controle de acesso.

URI

A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.

Tabela 1 Método de solicitação HTTP/HTTPS e URI

Método de solicitação

URI

GET

/v1.0/apigw/acls[?page_size, page_no, id, name, acl_type, entity_type]
  • Uma combinação de diferentes condições de consulta pode ser adicionada no final do URI usando pontos de interrogação (?) e E comercial (&).
  • As condições de consulta incluem: id, name, acl_type, entity_type, page_size e page_no.

A tabela a seguir lista os parâmetros no URI.

Tabela 2 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

id

Não

String

ID da política de controle de acesso

name

Não

String

Nome da política de controle de acesso

acl_type

Não

String

Tipo de controle de acesso, que pode ser PERMIT ou DENY

entity_type

Não

String

Tipo de objeto, que pode ser IP ou DOMAIN

page_size

Não

Integer

Número de registros exibidos em cada página. O valor padrão é 20.

page_no

Não

Integer

Número da página. O valor padrão é 1.

precise_search

Não

String

Nome do parâmetro (name) para correspondência exata

Solicitação

N/D

Resposta

Tabela 3 Descrição do parâmetro

Parâmetro

Tipo

Descrição

size

Integer

Número de políticas de controle de acesso exibidas na página atual

total

Integer

Número total de políticas de controle de acesso

acls

Dicionário

Lista de políticas de controle de acesso
Tabela 4 Descrição do parâmetro de acls

Parâmetro

Tipo

Descrição

id

String

ID da política de controle de acesso

acl_name

String

Nome da política de controle de acesso

acl_type

String

Tipo de controle de acesso, que pode ser:

  • PERMIT (lista branca)
  • DENY (lista negra)

acl_value

String

Objetos de controle de acesso

entity_type

String

Tipo de objeto, que pode ser:

  • IP
  • DOMAIN

update_time

Timestamp

Hora em que a política de controle de acesso foi atualizada pela última vez

bind_num

Integer

Número de APIs às quais a política de controle de acesso foi vinculada

Exemplo de resposta:

{
	"total": 1,
	"size": 1,
	"acls": [{
		"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
		"acl_name": "goodone",
		"entity_type": "DOMAIN",
		"acl_type": "PERMIT",
		"acl_value": "19asdfaf-adfadf",
		"update_time": "2017-11-18T14:27:36.918578+08:00",
                "bind_num":1
	}]
}

Códigos de status

Tabela 5 Códigos de status

Código de status

Descrição

200

OK

400

Solicitação inválida

500

Erro do servidor interno