Consulta de recursos do gateway
Função
Esta API é usada para consultar os recursos de um gateway. Se um gateway não oferecer suporte aos recursos listados na tabela a seguir, entre em contato com o suporte técnico para atualizar o gateway.
A tabela a seguir lista os recursos de gateway suportados.
Nome de recursos | Descrição | Configurável |
---|---|---|
lts | Relatórios de logs de acesso Shubao | Sim |
gateway_responses | Respostas de gateway personalizadas | Não |
ratelimit | Configuração do limite de solicitação | Sim |
request_body_size | Configuração do tamanho máximo do corpo da solicitação | Sim |
backend_timeout | Configuração máxima de tempo limite de back-end | Sim |
app_token | Autenticação app_token | Sim |
app_api_key | Autenticação app_api_key | Sim |
app_basic | Autenticação app_basic | Sim |
app_secret | Autenticação app_secret | Sim |
app_jwt | Autenticação app_jwt | Sim |
public_key | Assinaturas de back-end public_key | Sim |
backend_token_allow | Permitir que os locatários transmitam tokens de forma transparente para o back-end | Sim |
sign_basic | Chaves básicas de assinatura | Não |
multi_auth | Autenticação de dois fatores | Não |
backend_client_certificate | Autenticação bidirecional de back-end | Sim |
ssl_ciphers | Conjuntos de cifras HTTPS | Sim |
route | Rotas personalizadas | Não |
cors | Plug-ins | Não |
real_ip_from_xff | Usar o cabeçalho X-Forwarded-For para especificar endereços IP de origem para controle de acesso e limitação de solicitações | Sim |
app_route | Acesso ao endereço IP | Sim |
vpc_name_modifiable | Modificação do nome do canal do balanceamento de carga | Sim |
default_group_host_trustlist | Acesso ao grupo DEFAULT a partir de endereços IP que não são endereços de acesso de entrada do gateway atual | Sim |
throttle_strategy | Políticas de algoritmo de limitação de solicitações | Sim |
custom_log | Impressão de cabeçalhos de solicitação personalizados, cadeia de consulta e cookies em logs | Sim |
real_ip_header_getter | Usar um cabeçalho personalizado para obter endereços IP de origem | Sim |
policy_cookie_param | Usar cookies em condições de política de back-end | Sim |
app_quota | Cotas de clientes | Não |
app_acl | Políticas de limitação de solicitações | Não |
set_resp_headers | Plug-ins de gerenciamento de cabeçalho de resposta | Não |
vpc_backup | Canais da VPC principais/em espera | Não |
sign_aes | Chaves de assinatura AES | Não |
kafka_log | Adicionar, excluir, modificar e consultar plug-ins de envio de log do Kafka | Não |
backend_retry_count | Configuração de repetição de back-end | Não |
policy_sys_param | Usar parâmetros do sistema em condições de política de back-end | Não |
breaker | Disjuntores | Não |
content_type_configurable | Retornar o tipo de parâmetro de solicitação (Content-Type) ao consultar APIs | Não |
rate_limit_plugin | Plug-ins de limitação de solicitação | Não |
breakerv2 | Disjuntores para serviços degradantes em caso de sobrecarga | Não |
sm_cipher_type | Criptografar dados sensíveis locais com algoritmos criptográficos comerciais | Não |
rate_limit_algorithm | Troca do algoritmo de limitação de solicitação | Não |
URI
GET /v2/{project_id}/apigw/instances/{instance_id}/features
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
project_id |
Sim |
String |
ID do projeto. Para obter detalhes sobre como obter um ID de projeto, consulte "Apêndice" > "Obtenção de um ID de projeto" neste documento. |
instance_id |
Sim |
String |
ID do gateway, que pode ser obtido a partir das informações de gateway no console do APIG. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
offset |
Não |
Long |
Deslocamento a partir do qual a consulta é iniciada. Se o valor estiver menor que 0, ele é automaticamente convertido para 0. Padrão: 0 |
limit |
Não |
Integer |
Número de itens exibidos em cada página. Um valor menor ou igual a 0 será automaticamente convertido em 20, e um valor maior que 500 será automaticamente convertido em 500. Mínimo: 1 Máximo: 500 Padrão: 20 |
Parâmetros de solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
X-Auth-Token |
Sim |
String |
Token do usuário. Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é um token. |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
size |
Integer |
Comprimento da lista de recursos retornados. |
total |
Long |
Número de recursos que atendem às condições de consulta. |
features |
Array of FeatureInfo objects |
Lista de recursos. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
ID dos recursos. |
name |
String |
Nome de recursos. Mínimo: 1 Máximo: 64 |
enable |
Boolean |
Indica se o recurso deve ser ativado. |
config |
String |
Configuração de parâmetros. |
instance_id |
String |
ID do gateway. |
update_time |
String |
Tempo de atualização do recurso. |
Código de status: 400
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 401
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 403
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 404
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Código de status: 500
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro. |
error_msg |
String |
Mensagem de erro. |
Exemplo de solicitações
Nenhum
Exemplo de respostas
Código de status: 200
OK
{ "total" : 1, "size" : 1, "features" : [ { "config" : "on", "enable" : true, "id" : "db9a9260cd3e4a16a9b5747a65d3ffaa", "instance_id" : "eddc4d25480b4cd6b512f270a1b8b341", "name" : "app_api_key", "update_time" : "2020-08-24T01:17:31.041984Z" } ] }
Código de status: 400
Solicitação inválida
{ "error_code" : "APIG.2012", "error_msg" : "Invalid parameter value,parameterName:instance_id. Please refer to the support documentation" }
Código de status: 401
Não autorizado
{ "error_code" : "APIG.1002", "error_msg" : "Incorrect token or token resolution failed" }
Código de status: 403
Proibido
{ "error_code" : "APIG.1005", "error_msg" : "No permissions to request this method" }
Código de status: 404
Não encontrado
{ "error_code" : "APIG.3030", "error_msg" : "The instance does not exist;id:eddc4d25480b4cd6b512f270a1b8b341" }
Código de status: 500
Erro do servidor interno
{ "error_code" : "APIG.9999", "error_msg" : "System error" }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK |
400 |
Solicitação inválida |
401 |
Não autorizado |
403 |
Proibido |
404 |
Não encontrado |
500 |
Erro do servidor interno |
Códigos de erro
Consulte Códigos de erro.