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 2023-03-20 GMT+08:00

Consulta de versões da API

Função

Essa API é usada para consultar todas as versões de API disponíveis do serviço BMS.

URI

GET /

Solicitação

  • Parâmetros de solicitação

    Nenhum

  • Exemplo de solicitação
    1
    GET https://{BMS Endpoint}/
    

Resposta

  • Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    versions

    Array of objects

    Especifica as versões de API do serviço BMS. Para mais detalhes, consulte Tabela 1.

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

    Parâmetro

    Tipo

    Descrição

    id

    String

    Especifica a versão da API.

    links

    Array of objects

    Especifica o URL da API. Para mais detalhes, consulte Tabela 2.

    min_version

    String

    Especifica a versão mais antiga da micro API com suporte.

    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 data de lançamento de uma versão da API.

    O formato do carimbo de data/hora é AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por exemplo, 2018-09-30T00:00:00Z.

    version

    String

    Especifica a versão mais recente da micro API que é suportada.

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

    Parâmetro

    Tipo

    Descrição

    href

    String

    Especifica o URL da API.

    rel

    String

    Especifica a dependência de URL da API. O valor pode ser:

    • self: link de recurso que contém o número da versão. É usado quando o rastreamento imediato é necessário.
    • bookmark: link de recurso que pode ser armazenado por um longo tempo.
  • Exemplo de resposta
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    {
        "versions": [
            {
                "id": "v1",
                "links": [
                    {
                        "href": "http://bms.xxx.com/v1/",
                        "rel": "self"
                    }
                ],
                "min_version": "",
                "status": "CURRENT",
                "updated": "2018-09-30T00:00:00Z",
                "version": ""
            }
        ]
    }
    

Valores retornados

Valores normais

Valores retornados

Descrição

200

A solicitação foi processada com sucesso.

Para obter detalhes sobre outros valores retornados, consulte Códigos de status.

Códigos de erro

Consulte Códigos de erro.