Querying Details About BMSs (Native OpenStack API)

Function

This interface is used query details about BMSs using search criteria and to display the BMS details in a list. The interface version is v2.1. Querying with the micro version number is supported. Add a group of key-value pairs to the request header. The key is fixed at X-OpenStack-Nova-API-Version, and the value is the microversion number, for example 2.26 indicating that the microversion number is 2.26.

Constraints

• The query result returned by this interface includes both ECS and BMS details. You need to filter out the BMS details using the flavor used to create the BMSs or the tags added to the BMSs during BMS creation.
• If the image is used as the search criteria, other search criteria and pagination criteria are not supported. If both the image and other search criteria are used, the BMS details are filtered out by image. If the image is not used as the search criteria, this interface has no restrictions.

URI

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

Table 1 lists the parameters.

For the optional parameters that can be used to query BMSs, see Table 2 in section Querying BMSs (Native OpenStack API).

Request Message

N/A

Response Message

• Response parameters

  Parameter	Type	Description
  servers	List data structure For details, see [1] server field data structure description in section Querying Details About a BMS (Native OpenStack API).	Specifies the BMS details list.

• Example response

  {
      "servers": [
  {
              "tenant_id": "c685484a8cc2416b97260938705deb64",
              "addresses": {
                  "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
  {
                          "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c4: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": "az1",
              "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",
              "progress": 0, 
              "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078",
              "updated": "2017-05-25T03:40:25Z",
              "status": "ACTIVE"
                      }
      ]
  }

Returned Values

See section Common Returned Values.