Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Atualizado em 2024-01-26 GMT+08:00

Consulta de uma versão de API

Função

Esta API é usada para consultar uma versão específica da API.

URI

GET /{api_version}

Tabela 1 descreve os parâmetros.

Tabela 1 Descrição dos parâmetros

Parâmetro

Obrigatório

Descrição

api_version

Sim

Especifica a versão da API, por exemplo, v1.0.

Solicitação

Nenhuma

Resposta

Tabela 2 Parâmetros de resposta

Parâmetro

Tipo

Descrição

version

Object

Especifica informações sobre uma versão de API especificada.

Tabela 3 Descrição do campo version

Parâmetro

Tipo

Descrição

id

String

Especifica o ID da versão da API.

links

Array of objects

Especifica o URL da versão da API.

min_version

String

Especifica a microversão. Se as APIs desta versão suportarem microversões, defina este parâmetro como a microversão mínima suportada. Se a microversão não for suportada, deixe este parâmetro em branco.

status

String

Especifica o status da versão da API.

  • CURRENT: indica uma versão primária.
  • SUPPORTED: indica uma versão anterior que ainda é suportada.
  • DEPRECATED: indica uma versão obsoleta que pode ser excluída posteriormente.

updated

String

Especifica a hora de atualização da versão da API.

version

String

Se as APIs desta versão suportarem microversões, defina este parâmetro para a microversão máxima suportada. Se não, deixe este parâmetro em branco.

Tabela 4 Descrição do campo links

Parâmetro

Tipo

Descrição

href

String

Especifica o URL da versão da API.

rel

String

Especifica a dependência de URL da API.

Exemplo de solicitação

GET /v1.0

Exemplo de resposta

{
    "version": {
        "id": "v1.0",
        "links": [
            {
                "href": "https//deh.xxx.com/v1.0/",
                "rel": "self"
            }
        ],
        "min_version": "",
        "status": "SUPPORTED",
        "updated": "2016-12-01T11:33:21Z",
        "version": ""
    }
}

Código de status

Consulte Códigos de status.