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.