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.
Central de ajuda> Bare Metal Server> Referência de API> APIs do BMS> Gerenciamento de flavors do BMS> Consulta de detalhes sobre flavors e informações estendidas sobre flavors
Atualizado em 2023-09-20 GMT+08:00

Consulta de detalhes sobre flavors e informações estendidas sobre flavors

Função

Essa API é usada para consultar detalhes sobre flavors do BMS e informações estendidas sobre os flavors. Você pode chamar essa API para consultar o valor do parâmetro baremetal:extBootType para verificar se um flavor oferece suporte ao provisionamento rápido de BMS.

URI

GET /v1/{project_id}/baremetalservers/flavors?availability_zone={availability_zone}

A Tabela 1 lista os parâmetros.
Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Descrição

project_id

Sim

Especifica o ID do projeto.

Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

Tabela 2 Parâmetros para consulta de flavors do BMS

Parâmetro

Obrigatório

Tipo

Descrição

availability_zone

Não

String

Especifica o nome da AZ.

Solicitação

  • Parâmetros de solicitação

    Nenhum

  • Exemplo de solicitação
    1
    GET https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/flavors?availability_zone=cn-north-1a
    

Resposta

  • Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    flavors

    Array of objects

    Especifica os flavors de BMS. Para mais detalhes, consulte Tabela 3.

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

    Parâmetro

    Tipo

    Descrição

    id

    String

    Especifica o ID do flavor de BMS.

    name

    String

    Especifica o nome do flavor de BMS.

    vcpus

    String

    Especifica o número de núcleos de CPU no flavor do BMS.

    ram

    Integer

    Especifica o tamanho da memória (MB) no flavor do BMS.

    disk

    String

    Especifica o tamanho do disco do sistema no flavor do BMS. O valor 0 indica que o tamanho do disco não é limitado.

    swap

    String

    Este é um atributo reservado.

    OS-FLV-EXT-DATA:ephemeral

    Integer

    Este é um atributo reservado.

    OS-FLV-DISABLED:disabled

    Boolean

    Este é um atributo reservado.

    rxtx_factor

    Float

    Este é um atributo reservado.

    rxtx_quota

    String

    Este é um atributo reservado.

    rxtx_cap

    String

    Este é um atributo reservado.

    os-flavor-access:is_public

    Boolean

    Especifica se o flavor é público.

    false indica um flavor privado e true indica um flavor público.

    links

    Array of objects

    Especifica links de atalho do flavor. Para mais detalhes, consulte Tabela 4.

    os_extra_specs

    Object

    Especifica campos estendidos do flavor do BMS. Para mais detalhes, consulte Tabela 5.

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

    Parâmetro

    Tipo

    Descrição

    rel

    String

    Especifica o nome do marcador do link de atalho. 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.

    href

    String

    Especifica o link de atalho correspondente.

    type

    String

    Especifica o tipo de link de atalho.

    Tabela 5 Descrição da estrutura de dados do campo os_extra_specs

    Parâmetro

    Tipo

    Descrição

    resource_type

    String

    Especifica o tipo de recurso correspondente ao flavor. O valor é ironic.

    capabilities:cpu_arch

    String

    Especifica a arquitetura da CPU do BMS. O valor pode ser:

    • x86_64 (aplicável a servidores x86)
    • aarch64 (aplicável a servidores ARM)

    baremetal:disk_detail

    String

    Especifica as especificações do disco físico.

    capabilities:hypervisor_type

    String

    Especifica um flavor do tipo Irônico.

    baremetal:__support_evs

    String

    Especifica se o flavor do BMS suporta discos do EVS.

    • verdadeiro
    • falso

    Se o flavor não contiver este parâmetro, os discos do EVS também não são suportados.

    baremetal:extBootType

    String

    Especifica a origem de inicialização do BMS.

    • LocalDisk: disco local
    • Volume: disco do EVS (provisionamento rápido)

    capabilities:board_type

    String

    Especifica o tipo de flavor do BMS no formato de abreviação de flavor. Por exemplo, se o nome do sabor for physical.o2.medium, o tipo de flavor é o2m.

    baremetal:net_num

    String

    Especifica o número máximo de NICs no BMS.

    baremetal:netcard_detail

    String

    Especifica as especificações físicas da NIC.

    baremetal:cpu_detail

    String

    Especifica as especificações físicas da CPU.

    baremetal:memory_detail

    String

    Especifica especificações de memória física.

    cond:operation:status

    String

    Especifica o status do flavor do BMS. Se este parâmetro não for definido, seu valor padrão é normal.

    • normal: indica o uso comercial normal do flavor.
    • abandon: indica que o flavor foi desabilitado (não exibido).
    • sellout: indica que o flavor foi vendido.
    • obt: indica que o flavor está sob OBT.
    • promotion: indica o flavor recomendado (uso comercial, que é semelhante ao normal).

    cond:operation:az

    String

    Especifica o status de flavor do BMS em uma AZ.

    Este parâmetro tem efeito em toda a AZ. Se uma AZ não estiver configurada neste parâmetro, o valor do parâmetro cond:operation:status será usado por padrão.

    Seu formato é az (xx). O xx indica o status do flavor BMS em uma AZ, e é obrigatório. Se xx não for especificado, a configuração é inválida.

    Por exemplo, um flavor é para uso comercial em AZ0 e AZ3, esgotado em AZ1, para OBT em AZ2 e cancelado em outros AZs. Em seguida, defina os parâmetros da seguinte forma:

    • cond:operation:status: abandon
    • cond:operation:az: az0(normal), az1(sellout), az2(obt), az3(promotion)
    NOTA:

    Configure esse parâmetro se o status do flavor em uma AZ for diferente do valor cond:operation:status.

  • Exemplo de resposta
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    {
        "flavors": [
             {
                "id": "physical.kl1.3xlarge",
                "name": "physical.kl1.3xlarge",
                "vcpus": "24",
                "ram": 321729,
                "disk": "6707",
                "swap": "",
                "links": [
                    {
                        "rel": "self",
                        "href": "https://compute.Region.dc1.domainname.com/v2/bbf1946d374b44a0a2a95533562ba954/flavors/physical.kl1.3xlarge",
                        "type": null
                    },
                    {
                        "rel": "bookmark",
                        "href": "https://compute.Region.dc1.domainname.com/bbf1946d374b44a0a2a95533562ba954/flavors/physical.kl1.3xlarge",
                        "type": null
                    }
                ],
                "OS-FLV-EXT-DATA:ephemeral": 0,
                "rxtx_factor": 1,
                "OS-FLV-DISABLED:disabled": false,
                "rxtx_quota": null,
                "rxtx_cap": null,
                "os-flavor-access:is_public": false,
                "os_extra_specs": {
                    "capabilities:cpu_arch": "x86_64",
                    "baremetal:disk_detail": "SAS SSD:2*800G Raid 1 + NVMe SSD Card1.6T",
                    "capabilities:hypervisor_type": "ironic",
                    "baremetal:__support_evs": "true",
                    "baremetal:extBootType": "LocalDisk",
                    "capabilities:board_type": "o2m",
                    "baremetal:net_num": "2",
                    "baremetal:netcard_detail": "2 x 2*10GE",
                    "baremetal:cpu_detail": "Intel Xeon E5-2667 V4 (2*8core* 3.2 GHz)",
                    "resource_type": "ironic",
                    "baremetal:memory_detail": "256GB DDR4 RAM(GB)"
                }
            }
        ]
    }
    

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.