Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ API Gateway/ Referencia de la API/ Las API de gateway compartido (para usuarios existentes)/ Gestión de API/ Consulta de detalles de una versión de API

Actualización más reciente 2023-03-29 GMT+08:00

Ver PDF

Consulta de detalles de una versión de API

Función

Esta API se utiliza para consultar los detalles de una versión de API especificada.

URI

La siguiente tabla muestra el método de solicitud HTTP/HTTPS y el URI de la API.

**Tabla 1** Método de solicitud de HTTP/HTTPS y URI
Método de solicitud	URI
GET	/v1.0/apigw/apis/versions/{version_id}

En la siguiente tabla se muestra el parámetro en el URI.

**Tabla 2** Descripción de parámetro
Parámetro	Obligatorio	Tipo	Descripción
version_id	Sí	String	ID de versión de API

Solicitud

N/A

Respuesta

**Tabla 3** Descripción de parámetro
Parámetro	Tipo	Descripción
id	String	ID de API
name	String	Nombre de la API
group_id	String	ID del grupo de API al que pertenece la API
group_name	String	Nombre del grupo de API al que pertenece la API
status	Integer	Estado de la API
type	Integer	Tipo de API
version	String	Versión de la API
req_protocol	String	Solicitud de protocolo
req_method	String	Método de solicitud
req_uri	String	Dirección de acceso
auth_type	String	Modo de autenticación de seguridad
auth_opt	Object	Parámetro del modo de autenticación de seguridad
authorizer_id	String	ID del autorizador personalizado de frontend
match_mode	String	Modo de coincidencia
register_time	Timestamp	Hora en que se creó la API
update_time	Timestamp	Hora de la última modificación de la API
remark	String	Descripción de la API
bakend_type	String	Tipo de backend
run_env_name	String	Nombre del entorno en el que se ha publicado la API
run_env_id	String	ID del entorno en el que se ha publicado la API
publish_id	String	ID del registro de publicación
arrange_necessary	Integer	Indica si se requiere orquestación.
tag	String	Etiqueta de nombre de servicio, que debe descartarse
tags	[]String	Etiquetas de API
cors	Bool	Indica si se admite CORS.
body_remark	String	Descripción del cuerpo de solicitud de API, que puede ser un cuerpo de solicitud de ejemplo, tipo de medio o información de parámetro
result_normal_sample	String	Ejemplo de respuesta para una solicitud correcta
result_failure_sample	String	Ejemplo de respuesta para una solicitud fallida
response_id	String	ID de la respuesta del gateway
sl_domain	String	Nombre del subdominio del grupo API
sl_domains	Array of strings	Lista de nombres de subdominio enlazados al grupo de API
version_id	String	Versión de la API
publish_time	Timestamp	Hora en que se publica la versión de la API
backend_api	Dictionary	Detalles de backend de Web.
mock_info	Dictionary	Detalles de backend de Mock
func_info	Dictionary	Detalles del backend de FunctionGraph
req_params	Dictionary	Lista de parámetros de solicitud
backend_params	Dictionary	Lista de parámetros de backend

**Tabla 4** Descripción del parámetro de backend_api
Parámetro	Tipo	Descripción
id	String	ID de backend de Web
status	Integer	Estado de backend de web
url_domain	String	Punto de conexión de backend
version	String	Versión de backend
req_protocol	String	Solicitud de protocolo
req_method	String	Método de solicitud
req_uri	String	Dirección de acceso
timeout	Integer	Tiempo de espera en milisegundos
register_time	Timestamp	Tiempo de creación
update_time	Timestamp	Hora en la que se modificó por última vez el backend de web
remark	String	Descripción del backend
vpc_status	String	Indica si se debe utilizar un canal de VPC.
vpc_info	String	Información del canal de VPC
authorizer_id	String	ID del autorizador personalizado de backend

**Tabla 5** Descripción del parámetro de mock_info
Parámetro	Tipo	Descripción
id	String	ID de backend de simulacro
status	Integer	Estado de backend de simulacro
version	String	Versión de backend
result_content	String	Respuesta de simulacro
register_time	Timestamp	Tiempo de creación
update_time	Timestamp	Hora en la que el backend de simulacro fue modificado por última vez
remark	String	Descripción del backend

**Tabla 6** Descripción del parámetro de func_info
Parámetro	Tipo	Descripción
id	String	ID de la función
status	Integer	Estado de la función
version	String	Versión de la función
function_urn	String	Función URN
invocation_type	String	Modo de invocación, que puede ser async o sync
register_time	Timestamp	Tiempo de creación
update_time	Timestamp	Hora de la última actualización de la función
timeout	Integer	Tiempo de espera en milisegundos
remark	String	Descripción de la función

**Tabla 7** Descripción del parámetro de req_params
Parámetro	Tipo	Descripción
id	String	ID del parámetro
name	String	Nombre del parámetro
type	String	Tipo de parámetro
location	String	Ubicación del parámetro
default_value	String	Valor predeterminado
sample_value	String	Valor de ejemplo
required	Integer	Indica si el parámetro es obligatorio.
valid_enable	Integer	Indica si la comprobación de validez está activada.
remark	String	Descripción del parámetro
enumerations	String	Valor enumerado
min_num	Integer	Valor mínimo, que es válido cuando el tipo de parámetro es NUMBER
max_num	Integer	Valor máximo, que es válido cuando el tipo de parámetro es NUMBER
min_size	Integer	Longitud mínima
max_size	Integer	Longitud máxima
regular	String	Regla de validación de expresiones regulares
json_schema	String	Regla de validación de JSON

**Tabla 8** Descripción del parámetro de backend_params
Parámetro	Tipo	Descripción
id	String	ID del parámetro
req_param_id	String	ID del parámetro de solicitud al que se asigna el parámetro de backend
name	String	Nombre del parámetro
location	String	Ubicación del parámetro
origin	Integer	Tipo de parámetro
value	Integer	Valor del parámetro
remark	String	Descripción del parámetro

**Tabla 9** Descripción del parámetro de auth_opt
Parámetro	Tipo	Descripción
app_code_auth_type	String	Indica si la autenticación AppCode está habilitada.

Ejemplo de respuesta:

{
  "name": "test",
  "type": 1,
  "version": "V0.0.1",
  "req_protocol": "HTTPS",
  "req_method": "GET",
  "req_uri": "/test/{project_id}",
  "auth_type": "APP",
  "auth_opt": {
    "app_code_auth_type": "HEADER"
  },
  "tags": ["APIG-SN-test", "test"],
  "cors": false,
  "match_mode": "NORMAL",
  "backend_type": "HTTP",
  "group_id": "f71f69876f90456ca6fd18ed012fdc11",
  "result_normal_sample": "hello world!",
  "id": "81efcfd94b8747a0b21e8c04144a4e8c",
  "status": 1,
  "arrange_necessary": 2,
  "register_time": "2018-08-15T03:41:11.0239936Z",
  "update_time": "2018-08-15T03:41:11.0239936Z",
  "group_name": "group0002",
  "sl_domain": "a8be0e466f0e4d8bb18ebd15402cdd66.apigw.example.com",
  "sl_domains": ["a8be0e466f0e4d8bb18ebd15402cdd66.apigw.example.com", "a8be0e466f0e4d8bb18ebd15402cdd66.apigw.example.cn"],
  "version_id": "69b7492e2855487398d45733b9d6147a",
  "publish_time": "2018-08-24T03:10:14Z",
  "backend_api": {
    "url_domain": "xxxxxxxxx",
    "req_protocol": "HTTP",
    "req_method": "GET",
    "req_uri": "/test",
    "timeout": 1000,
    "vpc_status": 2,
    "id": "3442ffd031814e3a8f133a9f1ea08453",
    "status": 1,
    "register_time": "2018-08-15T03:41:11.1019236Z",
    "update_time": "2018-08-15T03:41:11.1019236Z"
  },
  "req_params": [
    {
      "name": "project_id",
      "type": "STRING",
      "location": "PATH",
      "required": 1,
      "valid_enable": 2,
      "id": "593c5560e0924e00af08fb458f850ecb"
    },
    {
      "name": "city",
      "type": "STRING",
      "location": "QUERY",
      "required": 2,
      "valid_enable": 2,
      "id": "e0b91bc81ae54f8ea850848d782d6e1e"
    }
  ],
  "backend_params": [
    {
      "name": "project_id",
      "location": "QUERY",
      "origin": "REQUEST",
      "value": "project_id",
      "id": "44e03de2351e43a8b18ba9ec1e71d2e9",
      "req_param_id": "593c5560e0924e00af08fb458f850ecb"
    },
    {
      "name": "city",
      "location": "QUERY",
      "origin": "REQUEST",
      "value": "city",
      "id": "b60fbcb5b86f4f5c8705c445b9bd6325",
      "req_param_id": "e0b91bc81ae54f8ea850848d782d6e1e"
    }
  ]
}