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 OpenStack nativo Nova V2.1/ Gerenciamento do ciclo de vida do BMS/ Consulta de detalhes sobre um BMS (API OpenStack nativo)

Atualizado em 2023-03-20 GMT+08:00

Ver PDF

Consulta de detalhes sobre um BMS (API OpenStack nativo)

Função

Essa API é usada para consultar detalhes sobre um BMS com base no ID do BMS.

URI

GET /v2.1/{project_id}/servers/{server_id}

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.
server_id	Sim	Especifica o ID de BMS. Você pode obter o ID do BMS no console do BMS ou usando a API do Consulta de BMSs (API OpenStack nativo).

Solicitação

Parâmetros de solicitação
Nenhum

Exemplo de solicitação

      
           GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/9ab74d89-61e7-4259-8546-465fdebe4944

Resposta

Parâmetros de resposta

Parâmetro	Tipo	Descrição
server	Object	Especifica as informações do BMS. Para mais detalhes, consulte Tabela 2.

**Tabela 2** Descrição da estrutura de dados do campo **server**
Parâmetro	Tipo	Descrição
name	String	Especifica o nome de BMS.
id	String	Especifica o ID exclusivo do BMS.
status	String	Especifica o status do BMS. Intervalo de valores: ACTIVE: executando, interrompendo, apagando BUILD: criando ERROR: defeito HARD_REBOOT: reiniciando à força REBOOT: reiniciando SHUTOFF: interrompido, iniciando, excluindo, reconstruindo, reinstalando SO, falha na reinstalação do SO, congelado
created	String	Especifica a hora em que o BMS foi criado. O formato de carimbo de data/hora é AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por exemplo, 2019-05-22T03:30:52Z.
updated	String	Especifica a hora em que o BMS foi atualizado pela última vez. O formato de carimbo de data/hora é AAAA-MM-DDTHH:MM:SSZ (ISO 8601), por exemplo, 2019-05-22T04:30:52Z.
flavor	Object	Especifica o flavor do BMS. Para mais detalhes, consulte Tabela 3.
image	Object	Especifica a imagem do BMS. Para mais detalhes, consulte Tabela 4.
tenant_id	String	Especifica o ID do locatário proprietário do BMS. O valor está no formato UUID. Este parâmetro especifica o mesmo significado que project_id.
key_name	String	Especifica o nome da chave SSH.
user_id	String	Especifica o ID do usuário ao qual o BMS pertence.
metadata	Map<String,String>	Especifica os metadados do BMS. É um par chave-valor de metadados definido pelo usuário. Cada chave ou valor contém no máximo 255 caracteres.
hostId	String	Especifica o ID do host do BMS.
addresses	Map<String,Array of address objects>	Especifica endereços de rede do BMS. Especifica a VPC usada pelo BMS. key: indica o ID da VPC usado pelo BMS. value: indica os detalhes da VPC.
security_groups	Array of objects	Especifica os grupos de segurança aos quais o BMS pertence. Para mais detalhes, consulte Tabela 7.
links	Array of objects	Especifica os links de atalho do BMS. Para mais detalhes, consulte Tabela 5.
OS-DCF:diskConfig	String	Especifica o método de configuração do disco. Este é um atributo estendido. O valor pode ser: MANUAL: a API usa o esquema de particionamento na imagem e no sistema de arquivos para criar um BMS. Se o flavor de destino tiver um disco grande, a API não particionará o espaço em disco restante. AUTO: a API usa uma única partição com o mesmo tamanho do disco do flavor de destino para criar um BMS. A API ajusta automaticamente o sistema de arquivos para se adaptar a toda a partição.
OS-EXT-AZ:availability_zone	String	Especifica a AZ onde o BMS está localizado.
OS-EXT-SRV-ATTR:host	String	Especifica o nome do host do BMS. Este é um atributo estendido.
OS-EXT-SRV-ATTR:hypervisor_hostname	String	Especifica o nome de um host no hipervisor. Este é um atributo estendido fornecido pelo driver Nova virt.
OS-EXT-SRV-ATTR:instance_name	String	Especifica o alias do BMS. Este é um atributo estendido.
OS-EXT-STS:power_state	Integer	Especifica o status de energia do BMS. Este é um atributo estendido. Opções: 0, 1, 2, 3 e 4 0: pendente 1: correndo 2: pausado 3: desligamento 4: caiu
OS-EXT-STS:task_state	String	Especifica o status da tarefa do BMS. Este é um atributo estendido. Intervalo de valores: rebooting: o BMS está sendo reiniciado. reboot_started: o BMS é normalmente reiniciado. reboot_started_hard: o BMS é reiniciado à força. powering-off: o BMS está sendo desligado. powering-on: o BMS está sendo ligado. rebuilding: o BMS está sendo reconstruído. scheduling: o BMS está sendo agendado. deleting: o BMS está sendo excluído.
OS-EXT-STS:vm_state	String	Especifica o status do BMS estável. Este é um atributo estendido. Intervalo de valores: active: o BMS está funcionando. shutoff: o BMS está parado. suspended: o BMS está suspenso. reboot: o BMS é reiniciado.
OS-SRV-USG:launched_at	String	Especifica a hora em que o BMS foi iniciado. Este é um atributo estendido. O formato do carimbo de data/hora é ISO 8601, por exemplo, 2019-05-22T03:23:59.000000.
OS-SRV-USG:terminated_at	String	Especifica a hora em que o BMS foi excluído. Este é um atributo estendido. O formato do carimbo de data/hora é ISO 8601, por exemplo, 2019-05-22T04:23:59.000000.
os-extended-volumes:volumes_attached	Array of objects	Especifica os discos EVS conectados ao BMS. Para mais detalhes, consulte Tabela 8.
accessIPv4	String	Este é um atributo reservado.
accessIPv6	String	Este é um atributo reservado.
fault	Object	Especifica a causa da falha. Se o BMS estiver com defeito, este campo será retornado. Para mais detalhes, consulte Tabela 9.
config_drive	String	Este é um atributo reservado.
progress	Integer	Este é um atributo reservado.
description	String	Fornece informações complementares sobre o pool. Este parâmetro é adicionado na versão micro 2.19.
host_status	String	Especifica o status do host que acomoda o BMS. UP: a nova-computação é normal. UNKNOWN: o status da nova-computação é desconhecido. DOWN: o status da nova-computação é anormal. MAINTENANCE: a nova-computação está no estado de manutenção. Cadeia vazia: o BMS não tem informações de host. Adicionado na micro versão 2.16.
OS-EXT-SRV-ATTR:hostname	String	Especifica o nome do host do BMS. Adicionado na micro versão 2.3.
OS-EXT-SRV-ATTR:reservation_id	String	Especifica os IDs do BMS reservados no cenário de criação do BMS em lote. Adicionado na micro versão 2.3.
OS-EXT-SRV-ATTR:launch_index	Integer	Especifica a sequência de inicialização do BMS no cenário de criação do BMS em lote. Adicionado na micro versão 2.3.
OS-EXT-SRV-ATTR:kernel_id	String	Especifica o UUID da imagem do kernel quando a imagem AMI é usada. Em outros cenários, deixe esse parâmetro em branco. Adicionado na micro versão 2.3.
OS-EXT-SRV-ATTR:ramdisk_id	String	Especifica o UUID da imagem Ramdisk quando a imagem de AMI é usada. Em outros cenários, deixe esse parâmetro em branco. Adicionado na micro versão 2.3.
OS-EXT-SRV-ATTR:root_device_name	String	Especifica o nome do dispositivo do disco do sistema do BMS, por exemplo, /dev/sda. Adicionado na micro versão 2.3.
OS-EXT-SRV-ATTR:user_data	String	Especifica o user_data especificado durante a criação do BMS. O valor é codificado usando Base64 ou uma cadeia vazia.
locked	Boolean	Especifica se o BMS está bloqueado. true: o BMS está bloqueado. false: o BMS não está bloqueado. Adicionado na micro versão 2.9.
tags	Array of strings	Especifica as tags do BMS. Este parâmetro é adicionado na microversão 2.26. Se a microversão não for usada para consulta, a resposta não conterá o campo tags. O valor deste campo atende aos seguintes requisitos: A chave e o valor de uma tag são conectados usando um sinal de igual (=), por exemplo, key=value. Se o valor estiver vazio, somente a chave é retornada.

**Tabela 3** Descrição da estrutura de dados do campo **flavor**
Parâmetro	Tipo	Descrição
id	String	Especifica o ID do tipo do BMS.
links	Array of objects	Especifica links de atalho do tipo do BMS. Para mais detalhes, consulte Tabela 5.

**Tabela 4** Descrição da estrutura de dados do campo **image**
Parâmetro	Tipo	Descrição
id	String	Especifica o ID da imagem do BMS.
links	Array of objects	Especifica os links de atalho da imagem do BMS. Para mais detalhes, consulte Tabela 5.

**Tabela 5** 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.

**Tabela 6** Descrição da estrutura de dados do campo **address**
Parâmetro	Tipo	Descrição
addr	String	Especifica o endereço IP.
version	Integer	Especifica o tipo do endereço IP. O valor pode ser 4 ou 6. 4: o tipo do endereço IP é IPv4. 6: o tipo do endereço IP é IPv6.
OS-EXT-IPS-MAC:mac_addr	String	Especifica o endereço MAC. Este é um atributo estendido.
OS-EXT-IPS:type	String	Especifica o tipo de endereço IP. Este é um atributo estendido. fixed: indica o endereço IP privado. floating: indica o EIP.

**Tabela 7** Descrição da estrutura de dados do campo **security_groups**
Parâmetro	Tipo	Descrição
name	String	Se nenhum grupo de segurança for especificado durante a criação do BMS, o valor default será usado. Se um grupo de segurança for especificado quando você criar o BMS, o valor desse parâmetro será o nome do grupo de segurança.

**Tabela 8** Descrição da estrutura de dados do campo **os-extended-volumes:volumes_attached**
Parâmetro	Tipo	Descrição
id	String	Especifica o ID do disco EVS.
delete_on_termination	Boolean	Especifica se o disco deve ser excluído ao excluir o BMS. true: sim false: não Adicionado na micro versão 2.3.

**Tabela 9** Descrição da estrutura de dados do campo **fault**
Parâmetro	Tipo	Descrição
message	String	Especifica as informações sobre falhas.
code	Integer	Especifica o código de falha.
details	String	Especifica os detalhes da falha.
created	String	Especifica a hora em que a falha ocorreu. A hora está no formato ISO 8601.

Exemplo de resposta

      
       
         
         
           {
    "server": {
        "tenant_id": "c685484a8cc2416b97260938705deb65",
        "addresses": {
            "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
{
                    "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c3:77",
                    "OS-EXT-IPS:type": "fixed",
                    "addr": "192.168.0.107",
                    "version": 4
                }
            ]
        },
        "metadata": {
            "op_svc_userid": "1311c433dd9b408886f57d695c229cbe"
        },
        "OS-EXT-STS:task_state": null,
        "OS-DCF:diskConfig": "MANUAL",
        "OS-EXT-AZ:availability_zone": "az-dc-1",
        "links": [
{
                "rel": "self",
                "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
            },
{
                "rel": "bookmark",
                "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
                }
        ],
        "OS-EXT-STS:power_state": 1,
        "id": "95bf2490-5428-432c-ad9b-5e3406f869dd",
        "os-extended-volumes:volumes_attached": [
{
                "id": "dfa375b5-9856-44ad-a937-a4802b6434c3"
            },
{
                "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417"
            },
{
                "id": "86e801c3-acc6-465d-890c-d43ba493f553"
            },
{
                "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6"
                }
        ],
        "OS-EXT-SRV-ATTR:host": "bms.az1",
        "image": {
            "links": [
{
                    "rel": "bookmark",
                    "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319"
                }
            ],
            "id": "1a6635d8-afea-4f2b-abb6-27a202bad319"
        },
        "OS-SRV-USG:terminated_at": null,
        "accessIPv4": "",
        "accessIPv6": "",
        "created": "2017-05-24T06:14:05Z",
        "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e",
        "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2",
        "key_name": "KeyPair-JX",
        "flavor": {
            "links": [
{
                    "rel": "bookmark",
                    "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium"
                }
            ],
            "id": "physical.83.medium"
        },
        "security_groups": [
{
                "name": "0011b620-4982-42e4-ad12-47c95ca495c4"
                }
        ],
        "config_drive": "",
        "OS-EXT-STS:vm_state": "active",
        "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3",
        "user_id": "1311c433dd9b408886f57d695c229cbe",
        "name": "bms-83",
        "progress": 0,
        "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078",
        "updated": "2017-05-25T03:40:25Z",
        "status": "ACTIVE"
                }
}

          

        

      
     