/mgmt/status/default/PCIbus GET

Use the HTTP GET method with the /mgmt/status/default/PCIbus resource to request status information about PCI functions on the appliance.

Resource URL

https://host:port/mgmt/status/default/PCIbus
Where port is 5554 by default.

Request headers

The following header must be sent with the request:
Authorization
This header must be sent to perform authentication.

Request body format

None.

Security requirements

The caller must be authenticated as an appliance user with sufficient authority. For more information about security, see Types of user and how they are authenticated and User authorization, credential mapping, and access profiles.

Response status codes

200
Status information retrieved successfully.
400
Invalid data provided.
401
Not authenticated.
The caller must be authenticated as an appliance user. See Types of user and how they are authenticated for more information.
403
Not authorized.
The caller is authenticated but does not the authority to perform this action. See User authorization, credential mapping, and access profiles for more information.

Response headers

Content-Type
This header is returned with a value of application/json.

Response body format

The response is in JSON format. The response includes information about PCI functions. Each object contains the following fields:
Address
String.
The PCI address of this function. The address is a series of hexadecimal numbers, in the format xxxx:xx:xx.x, with each group being domain, bus, target, and function in turn. So 0000:01:02.3 is domain 0, bus 1, target 2, and function 3.
VendorID
String.
The vendor identification of this PCI function.
DeviceID
String.
The device identification of this PCI function. Each vendor assigns their own device identifications.
Class
String.
The class of this PCI function. Class values are assigned by the PCI SIG.
Revision
String.
The Revision of this PCI function.
InterruptLine
String.
The interrupt line assigned to this PCI function, if any. If none is assigned, no value is displayed.

Examples

The following example requests information about appliance PCI functions.

The following URL is used with the HTTP GET method:
https://localhost:5554/mgmt/status/default/PCIbus
The following listing shows an extract from an example received response:
{
  "_links": {
    "self": {
      "href": "/mgmt/status/default/PCIBus"
    },
    "doc": {
      "href": "/mgmt/docs/status/PCIBus"
    }
  },
  "PCIBus": [
    {
      "Address": "0000:00:00.0",
      "VendorID": "0x8086",
      "DeviceID": "0x0E00",
      "Class": "0x0600",
      "Revision": 4,
      "InterruptLine": ""
    },
    {
      "Address": "0000:00:01.0",
      "VendorID": "0x8086",
      "DeviceID": "0x0E02",
      "Class": "0x0604",
      "Revision": 4,
      "InterruptLine": 11
    },
    {
      "Address": "0000:00:02.0",
      "VendorID": "0x8086",
      "DeviceID": "0x0E04",
      "Class": "0x0604",
      "Revision": 4,
      "InterruptLine": 11
    },
...
   {
      "Address": "0000:ff:16.1",
      "VendorID": "0x8086",
      "DeviceID": "0x0EC9",
      "Class": "0x0880",
      "Revision": 4,
      "InterruptLine": ""
    },
    {
      "Address": "0000:ff:16.2",
      "VendorID": "0x8086",
      "DeviceID": "0x0ECA",
      "Class": "0x0880",
      "Revision": 4,
      "InterruptLine": ""
    }
  ]
}