Consulta da definição de tempo de execução de uma API
Função
Esta API é usada para consultar a definição de tempo de execução de uma API em um ambiente especificado. A definição de tempo de execução de uma API no ambiente RELEASE é consultada se nenhum ambiente for especificado.
A definição de uma API é classificada nos seguintes tipos:
-
Definição temporária: definição de uma API usada após a última edição da API.
-
Definição de tempo de execução: instantâneo da definição temporária de uma API capturada quando a API é publicada em um ambiente.
A definição de tempo de execução de uma API é acessada quando a API é chamada em um ambiente.
URI
GET /v2/{project_id}/apigw/instances/{instance_id}/apis/runtime/{api_id}
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. |
api_id |
Sim |
String |
ID da API. |
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
env_id |
Não |
String |
ID do ambiente em que a API é publicada. |
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 |
---|---|---|
name |
String |
Nome da API. Pode conter de 3 a 64 caracteres, começando com uma letra. Apenas letras, dígitos e sublinhados (_) são permitidos. |
type |
Integer |
Tipo de API.
Valores de enumeração:
|
version |
String |
Versão da API. Máximo: 16 |
req_protocol |
String |
Protocolo de solicitação.
Padrão: HTTPS Valores de enumeração:
|
req_method |
String |
Método de solicitação. Valores de enumeração:
|
req_uri |
String |
Solicitar endereço. Ele pode conter parâmetros de solicitação entre colchetes ({}). Por exemplo, /getUserInfo/{userId}. Caracteres especiais, como asteriscos (*), sinais de porcentagem (%), hifens (-) e sublinhados (_), são permitidos. Pode conter um máximo de 512 caracteres e deve estar em conformidade com as especificações de URI.> O valor deve estar em conformidade com as especificações de URI. |
auth_type |
String |
Modo de autenticação da API.
Valores de enumeração:
|
auth_opt |
AuthOpt object |
Parâmetro de autenticação de segurança. |
cors |
Boolean |
Indica se o CORS é suportado.
Padrão: false Valores de enumeração:
|
match_mode |
String |
Modo de correspondência de rota.
O valor padrão é NORMAL. Valores de enumeração:
|
backend_type |
String |
Tipo de back-end.
Valores de enumeração:
|
remark |
String |
Descrição da API. Não pode exceder 255 caracteres. |
group_id |
String |
ID do grupo de APIs ao qual a API pertence. |
body_remark |
String |
Corpo de solicitação da API, que pode ser um exemplo de corpo de solicitação, tipo de mídia ou parâmetros. Certifique-se de que o corpo da solicitação não exceda os caracteres 20.480. |
result_normal_sample |
String |
Exemplo de resposta para uma solicitação bem-sucedida. O valor não pode exceder 20.480 caracteres. |
result_failure_sample |
String |
Exemplo de resposta para uma solicitação com falha O valor não pode exceder 20.480 caracteres. |
authorizer_id |
String |
ID do autorizador personalizado do front-end. |
tags |
Array of strings |
Tags. O valor pode conter apenas letras, dígitos e sublinhados (_), e deve começar com uma letra. Você pode inserir várias tags e separá-las com vírgulas (,). Mínimo: 1 Máximo: 128 |
response_id |
String |
ID de resposta do grupo. |
roma_app_id |
String |
ID da aplicação de integração. Atualmente, este parâmetro não é suportado. |
domain_name |
String |
Nome de domínio personalizado vinculado à API. Atualmente, este parâmetro não é suportado. |
tag |
String |
Tag. Este campo será depreciado. Você pode usar o campo de tags em vez disso. |
content_type |
String |
Tipo de conteúdo de solicitação:
Atualmente, este parâmetro não é suportado. Valores de enumeração:
|
id |
String |
ID da API. |
group_name |
String |
Nome do grupo de APIs ao qual a API pertence. |
run_env_name |
String |
Nome do ambiente no qual a API foi publicada. |
run_env_id |
String |
ID do ambiente no qual a API foi publicada. |
publish_id |
String |
ID do registro da publicação. |
sl_domain |
String |
Nome do subdomínio do grupo de APIs. |
sl_domains |
Array of strings |
Nomes do subdomínio que o APIG aloca automaticamente ao grupo da API. |
req_params |
Array of ReqParam objects |
Parâmetros de solicitação. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
app_code_auth_type |
String |
Indica se a autenticação de AppCode está habilitada. Este parâmetro é válido somente se auth_type for definido como App. O valor padrão é DISABLE.
Padrão: DISABLE Valores de enumeração:
|
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
String |
Nome do parâmetro. O nome do parâmetro pode conter de 1 a 32 caracteres e deve começar com uma letra. Apenas letras, dígitos, hifens (-), sublinhados (_) e pontos (.) são permitidos. |
type |
String |
Tipo de parâmetro. Valores de enumeração:
|
location |
String |
Localização do parâmetro. Valores de enumeração:
|
default_value |
String |
Valor padrão. |
sample_value |
String |
Exemplo de valor. |
required |
Integer |
Indica se o parâmetro é obrigatório. 1: sim 2: não O valor desse parâmetro é 1 se Localização for definido como PATH e 2 se Localização for definido como outro valor. Valores de enumeração:
|
valid_enable |
Integer |
Indica se a verificação de validade está habilitada.
Padrão: 2 Valores de enumeração:
|
remark |
String |
Descrição. Não pode exceder 255 caracteres. |
enumerations |
String |
Valor enumerado. |
min_num |
Integer |
Valor mínimo. Este parâmetro é válido quando tipo é definido como NUMBER. |
max_num |
Integer |
Valor máximo. Este parâmetro é válido quando tipo é definido como NUMBER. |
min_size |
Integer |
Comprimento mínimo. Este parâmetro é válido quando tipo é definido como STRING. |
max_size |
Integer |
Comprimento máximo. Este parâmetro é válido quando tipo é definido como STRING. |
regular |
String |
Regra de validação de expressão regular. Atualmente, este parâmetro não é suportado. |
json_schema |
String |
Regra de validação JSON. Atualmente, este parâmetro não é suportado. |
pass_through |
Integer |
Indica se o parâmetro deve ser transferido de forma transparente. 1: sim 2: não Valores de enumeração:
|
id |
String |
ID do parâmetro. |
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
{ "name" : "Api_http", "type" : 1, "version" : "V0.0.1", "req_protocol" : "HTTPS", "req_method" : "GET", "req_uri" : "/test/http", "auth_type" : "AUTHORIZER", "authorizer_id" : "8d0443832a194eaa84244e0c1c1912ac", "auth_opt" : { "app_code_auth_type" : "DISABLE" }, "cors" : false, "match_mode" : "NORMAL", "backend_type" : "HTTP", "remark" : "Web backend API", "group_id" : "c77f5e81d9cb4424bf704ef2b0ac7600", "result_normal_sample" : "Example success response", "result_failure_sample" : "Example failure response", "id" : "5f918d104dc84480a75166ba99efff21", "group_name" : "api_group_001", "run_env_id" : "DEFAULT_ENVIRONMENT_RELEASE_ID", "run_env_name" : "RELEASE", "publish_id" : "9191cdb430724d4b8586ed7f1b962ca2", "sl_domain" : "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.com", "sl_domains" : [ "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.com", "c77f5e81d9cb4424bf704ef2b0ac7600.apic.****.cn" ] }
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.3002", "error_msg" : "API 5f918d104dc84480a75166ba99efff21 does not exist" }
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 |
401 |
Não autorizado |
403 |
Proibido |
404 |
Não encontrado |
500 |
Erro do servidor interno |
Códigos de erro
Consulte Códigos de erro.