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.