Consulta de versiones de API

Función

Esta interfaz se utiliza para consultar todas las versiones de API del servicio AS.

URI

GET /

Mensaje de solicitud

• Parámetros de solicitud

  No hay

• Ejemplo de la solicitud
  Este ejemplo muestra cómo consultar todas las versiones de una API.

  GET https://{Endpoint}/

Mensaje de la respuesta

• Parámetros de respuesta

  Tabla 1 Parámetros de respuesta

  Parámetro	Tipo	Descripción
  versions	Array of versions objects	Especifica las versiones de la API.

  Tabla 2 Descripción del campo versions

  Parámetro	Tipo	Descripción
  id	String	Especifica el ID de versión de la API.
  links	Array of links objects	Especifica la URL de la API. Para más detalles, consulte Tabla 3.
  min_version	String	Especifica el número de versión de la API admitida más antiguo.
  status	String	Especifica el estado de la versión de la API. CURRENT: indica una versión principal. SUPPORTED: indica una versión anterior que todavía es compatible. DEPRECATED: indica una versión obsoleta que puede eliminarse más tarde.
  updated	String	Especifica la fecha de lanzamiento de una versión de API.
  version	String	Especifica el número de versión de la API admitida más reciente.

  Tabla 3 Descripción del campo links

  Parámetro	Tipo	Descripción
  href	String	Especifica el localizador uniforme de recursos (URL) de la API.
  rel	String	Especifica la dependencia URL de la API.

• Ejemplo de la respuesta

  {
    "versions": [
      {
        "id": "v1",
        "links": [
          {
            "href": "https://as.XXX.mycloud.com/autoscaling-api/v1/",
            "rel": "self"
          }
        ],
        "min_version": "",
        "status": "CURRENT",
        "updated": "2016-06-30T00:00:00Z",
        "version": ""
      },
      {
        "id": "v2",
        "links": [
          {
            "href": "https://as.XXX.mycloud.com/autoscaling-api/v2/",
            "rel": "self"
          }
        ],
        "min_version": "",
        "status": "SUPPORTED",
        "updated": "2018-03-30T00:00:00Z",
        "version": ""
      }
    ]
  }
  

Valores devueltos

• Normal

  200

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Se produjo un error en el servidor al procesar la solicitud.
  401 Unauthorized	Debe introducir el nombre de usuario y la contraseña para acceder a la página solicitada.
  403 Forbidden	Está prohibido el acceso a la página solicitada.
  404 Not Found	No se pudo encontrar la página solicitada.
  405 Method Not Allowed	No se le permite utilizar el método especificado en la solicitud.
  406 Not Acceptable	El cliente no pudo aceptar la respuesta generada por el servidor.
  407 Proxy Authentication Required	Debe utilizar el servidor proxy para la autenticación para que la solicitud pueda procesarse.
  408 Request Timeout	Se agotó el tiempo de espera de la solicitud.
  409 Conflict	La solicitud no se pudo procesar debido a un conflicto.
  500 Internal Server Error	Se produjo un error al completar la solicitud debido a un problema de servicio interno.
  501 Not Implemented	Error al completar la solicitud porque el servidor no admite la función solicitada.
  502 Bad Gateway	Error al completar la solicitud porque la solicitud no es válida.
  503 Service Unavailable	Error al completar la solicitud porque el sistema no está disponible.
  504 Gateway Timeout	Se ha producido un error de tiempo de espera de la puerta de enlace.

Códigos de error

Consulte Códigos de error