Pci-api-support - Revision history

Shuangtai-tian: /* What the REST PCI API will look like */

2013-12-03T16:49:07Z

‎What the REST PCI API will look like

2013-12-03T16:09:34Z

‎Create and show PCI device alias list on the node

2013-11-21T01:53:53Z

‎What the REST PCI API will look like

2013-11-20T05:55:29Z

‎What the REST PCI API will look like

2013-11-20T03:37:53Z

2013-11-20T03:36:37Z

‎Use case

2013-11-20T03:32:40Z

‎Use case

2013-11-20T03:21:44Z

‎List an show PCI stats on hypervisors

2013-11-20T03:20:00Z

‎List an show PCI devices on VMs

2013-11-20T03:19:25Z

@@ Line 51: / Line 51: @@
     nova list
     nova show VM name
-The response JSON will contain the variable "os-pci-devices":
+The response JSON will contain the variable "os-pci:pci_devices":
-     { "server": {"os-pci-devices": [{"id": 1}], "tenant_id": "openstack", "user_id": "fake"}}
+     { "server": {"os-pci:pci_devices": [{"id": 1}], "tenant_id": "openstack", "user_id": "fake"}}
 you can see which PCI device was used by the server of interest to you. The value of "os-pci-devices" means this VM used one PCI device(id=1).
@@ Line 62: / Line 62: @@
     nova hypervisor-list
     nova hypervisor-show id
-The response JOSN contains the variable "os-pci-stats":
+The response JOSN contains the variable "pci_stats":
-     {"hypervisor": {"os-pci-stats": [{"count": 5, "vendor_id": "8086", "product_id": "1520", "extra_info": {"phys_function": "abc", "key1": "value1"}}}]}
+     {"hypervisor": {"pci_stats": [{"count": 5, "vendor_id": "8086", "product_id": "1520", "extra_info": {"phys_function": "abc", "key1": "value1"}}}]}
 # We also need to add PCI APIs like to get PCI device information.

@@ Line 41: / Line 41: @@
 # instance UUID
 # other infomation
 === What the REST PCI API will look like ===

@@ Line 72: / Line 72: @@
  Request:
       GET v2/{tenant_id}/os-pci
  The response JSON may like below :
      {"pci_devices": [{ "address": "0000:04:10.0",  "compute_node_id": 1, "id": 1, "product_id": "1520",  "status": "available",  "vendor_id": "8086" } ]}
 Request:
       GET v2/{tenant_id}/os-pci/detail
 The response JSON may like below :
      { "pci_devices": [ { "address": "0000:04:10.0", "compute_node_id": 1, "created_at": null, "deleted": false,  "deleted_at": null, "dev_id": "pci_0000_04_10_0",  "dev_type": "type-VF", "extra_info": { "key1": "value1", "key2": "value2", "phys_function": "0x004" }, "id": 1, "instance_uuid": "246ca", "label": "label_8086_1520", "product_id": "1520", "status": "available",  "updated_at": null, "vendor_id": "8086"}]}

@@ Line 51: / Line 51: @@
 Request:
      GET v2/{tenant_id}/servers/{server_id}
 The response JSON will contain the variable "os-pci-devices":
      { "server": {"os-pci-devices": [{"id": 1}], "tenant_id": "openstack", "user_id": "fake"}}
@@ Line 59: / Line 62: @@
 Request:
      GET v2/{tenant_id}/os-hypervisors/{hypervisor_hostname}
 The response JOSN contains the variable "os-pci-stats":
      {"hypervisor": {"os-pci-stats": [{"count": 5, "vendor_id": "8086", "product_id": "1520", "extra_info": {"phys_function": "abc", "key1": "value1"}}}]}
 # We also need to add PCI APIs like to get PCI device information.
 Use case : Show PCI device infomation
 Request:
      GET v2/{tenant_id}/os-pci/{pci_device_id}
 The response JSON may like below :
      {"pci_device": { "address": "0000:04:10.0","compute_node_id": 1, "created_at": null, "deleted": false, "deleted_at": null, "dev_id": "pci_0000_04_10_0", "dev_type": "type-VF", "extra_info": {"key1": "value1", "key2": "value2", "phys_function": "0x004"}, "id": 1, "instance_uuid": "246ca", "label": "label_8086_1520", "product_id": "1520",  "status": "available",  "updated_at": null, "vendor_id": "8086"}}
 We intend to add the PCI APIs into V2 and V3. The patch may be big, so I want to split the patch into 3 parts in V2 and V3.
 # extend the sever API.
 # extend hypervisor API.
 # add PCI API.

@@ Line 3: / Line 3: @@
 === Use case===
 ==== List and show PCI devices on VMs ====
 * The use case starts with User logging in as Administrator using CLI, Web GUI or Management application.

@@ Line 10: / Line 10: @@
 # PCI device UUID
-==== List an show PCI stats on hypervisors ====
+==== List and show PCI stats on hypervisors ====
 * The use case starts with User logging in as Administrator using CLI, Web GUI or Management application.
 * User issues 'nova hypervisor-show or nova hypervisor-list ' command, User can know  PCI device  stats on hypervisor.