Consulta de versões de API

Função

Esta API é usada para consultar as versões de API compatíveis com o RDS.

A documentação da API v1 foi colocada off-line, assim como o software correspondente. Para evitar que seus serviços sejam afetados, é aconselhável mudar os serviços para as APIs v3.

• Antes de chamar uma API, você precisa entender a API em Autenticação.

URI

• Formato de URI

  GET /

• Descrição do parâmetro

  Nenhuma

Solicitação

• Parâmetros de solicitação

  Nenhum

• Exemplo de URI

  GET https://rds.ap-southeast-1.myhuaweicloud.com/

Resposta

• Resposta normal

  Tabela 1 Descrição do parâmetro

  Nome	Tipo	Descrição
  versions	Array of objects	Lista de informações detalhadas da versão de API Para mais detalhes, consulte Tabela 2.

  Tabela 2 Descrição da estrutura de dados do campo versions

  Nome	Tipo	Descrição
  id	String	Versão da API Seu valor pode ser: v1: versão da API v1 AVISO: A documentação da API v1 foi colocada off-line, assim como o software correspondente. Para evitar que seus serviços sejam afetados, é aconselhável alternar os serviços para a API v3. v3: versão da API v3
  links	Array of objects	Links da API. O valor fica vazio quando a versão é v1 ou v3. Para mais detalhes, consulte Tabela 3.
  status	String	Status da versão CURRENT: versão recomendada DEPRECATED: versão obsoleta que pode ser excluída posteriormente
  updated	String	Tempo de atualização da versão O formato é yyyy-mm-dd Thh:mm:ssZ. T é o separador entre o calendário e a notação horária do tempo. Z indica o Tempo Universal Coordenado (UTC).

  Tabela 3 Descrição da estrutura de dados do campo links

  Nome	Tipo	Descrição
  href	String	URL da API. O valor é "".
  rel	String	O valor é self, indicando que href é um link local.

• Exemplo de resposta normal

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

• Resposta anormal

  Para mais detalhes, consulte Resultados anormais da solicitação.

Código de status

• Normal

  200

• Anormal

  Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.