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-09-25 GMT+08:00

Consulta de informações de versões da API

Função

Esta API é usada para consultar informações de versões da API.

URI

  • Formato de URI

    GET /

Solicitação

  • Exemplo de solicitação
    GET https://{endpoint}/

Resposta

  • Descrição do parâmetro

    Parâmetro

    Tipo

    Descrição

    versions

    Array of objects

    As versões da API. Para obter detalhes, consulte Parâmetros no campo versions.

  • Parâmetros no campo versions

    Parâmetro

    Tipo

    Descrição

    min_version

    String

    A microversão mínima suportada. Se esta versão não suportar microversões, o valor é uma cadeia vazia.

    media-types

    Array of objects

    O tipo de mensagem de solicitação da versão da API. Para obter detalhes, consulte Parâmetros no campo media-types.

    links

    Array of objects

    O URI da versão da API. Para obter detalhes, consulte Parâmetros no campo links.

    id

    String

    O ID da versão da API.

    updated

    String

    A última vez em que a versão da API foi atualizada.

    Formato da hora: UTC YYYY-MM-DDTHH:MM:SS.XXXXXX

    version

    String

    A microversão máxima suportada. Se esta versão não suportar microversões, o valor é uma cadeia vazia.

    status

    String

    O status da versão da API. O valor pode ser o seguinte:
    • CURRENT: as APIs personalizadas do EVS fornecem várias versões. Para as APIs que oferecem as mesmas funções, é recomendável usar as APIs v2.
    • SUPPORTED: indica uma versão anterior que ainda é suportada.
    • DEPRECATED: indica uma versão preterida que pode ser excluída posteriormente.
  • Parâmetros no campo media-types

    Parâmetro

    Tipo

    Descrição

    type

    String

    O tipo de resposta.

    base

    String

    O tipo de texto.

  • Parâmetros no campo links

    Parâmetro

    Tipo

    Descrição

    rel

    String

    A descrição do nome de domínio.

    href

    String

    O nome do domínio.

    type

    String

    O tipo de resposta.

  • Exemplo de resposta
    {
        "versions": [
            {
                "min_version": "", 
                "media-types": [
                    {
                        "type": "application/vnd.openstack.volume+json;version=1", 
                        "base": "application/json"
                    }, 
                    {
                        "type": "application/vnd.openstack.volume+xml;version=1", 
                        "base": "application/xml"
                    }
                ], 
                "links": [
                    {
                        "rel": "describedby", 
                        "href": "http://docs.openstack.org/", 
                        "type": "text/html"
                    }, 
                    {
                        "rel": "self", 
                        "href": "https://evs.localdomain.com/v1"
                    }
                ], 
                "id": "v1.0", 
                "updated": "2014-06-28T12:20:21Z", 
                "version": "", 
                "status": "SUPPORTED"
            }, 
            {
                "min_version": "", 
                "media-types": [
                    {
                        "type": "application/vnd.openstack.volume+json;version=1", 
                        "base": "application/json"
                    }, 
                    {
                        "type": "application/vnd.openstack.volume+xml;version=1", 
                        "base": "application/xml"
                    }
                ], 
                "links": [
                    {
                        "rel": "describedby", 
                        "href": "http://docs.openstack.org/", 
                        "type": "text/html"
                    }, 
                    {
                        "rel": "self", 
                        "href": "https://evs.localdomain.com/v2"
                    }
                ], 
                "id": "v2.0", 
                "updated": "2014-06-28T12:20:21Z", 
                "version": "", 
                "status": "SUPPORTED"
            }, 
            {
                "min_version": "3.0", 
                "media-types": [
                    {
                        "type": "application/vnd.openstack.volume+json;version=1", 
                        "base": "application/json"
                    }, 
                    {
                        "type": "application/vnd.openstack.volume+xml;version=1", 
                        "base": "application/xml"
                    }
                ], 
                "links": [
                    {
                        "rel": "describedby", 
                        "href": "http://docs.openstack.org/", 
                        "type": "text/html"
                    }, 
                    {
                        "rel": "self", 
                        "href": "https://evs.localdomain.com/v3"
                    }
                ], 
                "id": "v3.0", 
                "updated": "2016-02-08T12:20:21Z", 
                "version": "3.0", 
                "status": "CURRENT"
            }
        ]
    }

Códigos de status

  • Normal

    300

Códigos de erro

Consulte Códigos de erro.