Consulta de versiones de API

Función

Esta API se utiliza para consultar las versiones compatibles de la API de RDS.

Esta API no estará disponible el 31 de marzo de 2024. Se recomienda cambiar las cargas de trabajo a la nueva API (Consulta de versiones de API) antes de esa fecha.

• Antes de invocar a una API, debe entender la API de Autenticación.

URI

• Formato de URI

  GET /rds

• Descripción de parámetro

  Ninguna

Solicitud

• Parámetros de solicitud

  Ninguna

• Ejemplo de URI

  GET https://{endpoint}/rds

Respuesta

• Respuesta normal

  Tabla 1 Descripción de parámetro

  Nombre	Tipo	Descripción
  versions	Array of objects	Indica la lista de información detallada de la versión de la API. Para obtener más información, consulte Tabla 2.

  Tabla 2 descripción de la estructura de datos del campo de versiones

  Nombre	Tipo	Descripción
  id	String	Indica la versión de la API. v1: indica la versión de la API v1. v3: indica la versión de la API v3.
  links	Array of objects	Indica la información de enlace de API. El valor está vacío cuando la versión es v1 o v3. Para obtener más información, consulte Tabla 3.
  status	String	Indica el estado de la versión. CURRENT: indica que se recomienda la versión. DEPRECATED: indica una versión obsoleta que puede eliminarse más tarde.
  updated	String	Indica la hora de actualización de la versión. El formato es aaaa-mm-dd Thh:mm:ssZ. T es el separador entre el calendario y la notación horaria del tiempo. Z indica el Tiempo Universal Coordinado (UTC).

  Tabla 3 descripción de la estructura de datos del campo de enlaces

  Nombre	Tipo	Descripción
  href	String	Indica la URL de la API y el valor es de "".
  rel	String	Su valor es self, lo que indica que href es un enlace local.

• Ejemplo de respuesta normal

  {
  	"versions": [{
  			"id": "v3",
  			"links": [],
  			"status": "CURRENT",
  			"updated": "2019-01-15T12:00:00Z"
  		},
  		{
  			"id": "v1",
  			"links": [],
  			"status": "DEPRECATED",
  			"updated": "2017-02-07T17:34:02Z"
  		}
  	]
  }

• Respuesta anormal

  Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• Normal

  200

• Anormal

  Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.