Working with PowerVC via its REST APIs

Managing PowerVC via REST APIs
1

© 2016 IBM Corporation
• Types of REST APIs : OpenStack, PowerVC Enhanced OpenStack and PowerVC supported APIs
• Example PowerVC APIs: PowerVM, HMCs, and SCGs
• PowerVC GUI uses REST APIs
• http://www-01.ibm.com/support/knowledgecenter/api/content/nl/en-
us/SSXK2N_1.3.2/com.ibm.powervc.standard.help.doc/powervc_pg_kickoff_hmc.html
• Secured with https (TLS 1.2)
• Can be used on any system running Python 2.7 (do not need PowerVC installed to run APIs)
• Need a recent level of Python 2.7 version
Overview

Basic flow:
Authenticate (PowerVC uses TLS 1.2)
Use authentication token to make subsequent API calls
Example: Display list of PowerVC Networks
REST
API
client
Keystone
Neutron
(Post) Authentication
Request
Authentication
Response – includes the
token needed for
subsequent requests
(Get) list of networks
Using authorization
token
JSON based response
A list of networks
Working with REST APIs

 The easiest way to get started is to observe the PowerVC UI as it makes API calls
 Use a browser plugin like Firebug for Firefox or the Chrome Developers Toolkit
Getting Started

Example: logging in
From the PowerVC GUI, log into PowerVC
Make sure you have selected the Persist button to see all the requests. The login
process sends a POST request to the PowerVC server as the first request
Hover over request to see the URL
Getting Started

Select the Post tab to see the actual JSON data that is sent from the browser in the request
to PowerVC
Using Firebug you can see the source data or a more readable JSON version. This source data
is exactly the same data you would use from your own custom client script or application!
Getting Started

From the Response tab you can see the entire raw JSON response
These are the data your custom client script or application will need to process
Getting Started

You can also view the response in a more user-friendly JSON display format.
Getting Started

REST API – Creation of an LPAR
 For creating an LPAR/VM you need:
– An API token
• After authenticating with user/password you get a token
– The tenant
• A tenant is a project. The terms project or tenant are interchangeable.
• The default project is “ibm-default”, but since PowerVC 1.3.1 also other user
defined projects are possible.
– The IDs of:
• The used network
• The desired image
• The Storage Connectivity Group
– Details of the new LPAR, like name, size and so on …

REST API – using curl – Get token
 Create the following file auth.json with the correct user name and password:
{"auth":
{"scope":
{"project":
{"name": "ibm-default", "domain":
{"name": "Default"}
}
}, "identity":
{"methods": ["password"], "password":
{"user":
{"domain":
{"name": "Default"},
"name": "userName",
"password": "userPassword"
}
}
}
}
}

REST API – using curl – Get token
 Use the file auth.json with the following curl command:
# curl -1 -k -i -X POST https://<PowerVC URL>:5000/v3/auth/tokens -H "Accept:
application/json" -H "Content-Type: application/json" -d @auth.json
HTTP/1.1 201 Created
Date: Fri, 15 Apr 2016 11:29:38 GMT
Server: Apache
X-Subject-Token: 35af31a38ca948788b771b5e8fbb0ddc
Vary: X-Auth-Token
x-openstack-request-id: req-a90f45bc-354e-4e76-8c2e-fda44508c7c1
Content-Length: 4858
Content-Type: application/json
{"token": {"methods": ["password"], "roles": [{"id": "b7d2cade8fa1493a962ac7fb926324fe",
"name": "admin"}], "expires_at": "2016-04-15T17:29:39.061651Z", "project": {"domain":
{"id": "default", "name": "Default"}, "id": "1953082a91d54db8a51fc8a742df46c6", "name":
"ibm-default"}, "catalog": [{"endpoints": [{"region_id": "RegionOne", "url": "https://cl-
powervc.ibm-tce-cloud.com:35357/v3", "region": "RegionOne", "interface": "a …

REST API – using curl – Get tenant
 Get the tenant using the token …
# curl -1 -k -i -X GET https://powervc:5000/v3/projects -H "X-Auth-Token:<Token>“
HTTP/1.1 200 OK
Date: Fri, 15 Apr 2016 12:03:55 GMT
Server: Apache
Vary: X-Auth-Token
x-openstack-request-id: req-caba8d80-e4a0-4b23-a5bf-2f250dcd6949
Content-Length: 725
{"links": {"self": "https://cl-powervc.ibm-tce-cloud.com:5000/v3/projects", "previous":
null, "next": null}, "projects": [{"is_domain": false, "description": "IBM Default
Tenant", "links": {"self": "https://cl-powervc.ibm-tce-
cloud.com:5000/v3/projects/1953082a91d54db8a51fc8a742df46c6"}, "enabled": true, "id":
"1953082a91d54db8a51fc8a742df46c6", "parent_id": null, "domain_id": "default", "name":
"ibm-default"}, {"is_domain": false, "description": "Service Tenant", "links": {"self":
"https://cl-powervc.ibm-tce-
cloud.com:5000/v3/projects/d8d34c62047647598eb3fc2caca25027"}, "enabled": true, "id":
"d8d34c62047647598eb3fc2caca25027", "parent_id": null, "domain_id":
"495548495c1d4cbb928a80a141c3b775", "name": "service"}]}

Tipp: REST API – using curl – Get tenant – with JSON parser
 To make the output better readable, remove the “-i” and add “| python -
mjson.tool”
# curl -1 -k -X GET https://powervc:5000/v3/projects -H "X-Auth-Token:<Token>“| python -
mjson.tool
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 725 100 725 0 0 1942 0 --:--:-- --:--:-- --:--:-- 1943
{
"links": {
"next": null,
"previous": null,
"self": "https://cl-powervc.ibm-tce-cloud.com:5000/v3/projects"
},
"projects": [
{
"description": "IBM Default Tenant",
"domain_id": "default",
"enabled": true,
"id": "1953082a91d54db8a51fc8a742df46c6",

REST API – using curl – Get networks
 Get the networks using the token …
# curl -1 -k -i -X GET https://powervc:5000//powervc/openstack/network/v2.0/networks -H
"X-Auth-Token: <Token>" -H "Content-Type: application/json“
HTTP/1.1 200 OK
Date: Fri, 15 Apr 2016 12:08:59 GMT
Server: Apache
Content-Type: application/json; charset=UTF-8
Content-Length: 767
X-Openstack-Request-Id: req-be727fca-2bee-4f06-9a7b-aa577676ecaa
Cache-control: no-cache
Pragma: no-cache
{"networks": [{"status": "ACTIVE", "subnets": ["749dbcf1-3f63-4e69-9233-c2f6cd38c0b6"],
"name": "Cloud Network", "provider:physical_network": "default", "admin_state_up": true,
"tenant_id": "1953082a91d54db8a51fc8a742df46c6", "mtu": null, "router:external": false,
"shared": true, "provider:network_type": "vlan", "id": "c50d3a61-a2a5-43eb-9c6b-
dcf38b4f1dd3", "provider:segmentation_id": 1}, {"status": "ACTIVE", "subnets":
["7b27af7b-3ac4-4bb0-94fe-87a5efd2017d"], "name": "9erNetwork",
"provider:physical_network": "default", "admin_state_up": true, "tenant_id":
"1953082a91d54db8a51fc8a742df46c6", "mtu": null, "router:external": false, "shared":
true, "provider:network_type": "vlan", "id": "f9de96c4-c5eb-4f74-912d-43a658e88e92",
"provider:segmentation_id": 2}]}

REST API – using curl – Get images
 Get the images using the token for the tenant …
# curl -1 -k -i -X GET https://powervc:5000/powervc/openstack/compute/v2/<Tenant>/images
-H "X-Auth-Token: <Token> " -H "Content-Type: application/json“
HTTP/1.1 200 OK
Date: Fri, 15 Apr 2016 12:13:21 GMT
Server: Apache
Content-Length: 4987
X-Compute-Request-Id: req-cd36fc90-7d0b-473f-b7fd-21c505b6326a
Pragma: no-cache
{"images": [{"id": "c3f2de51-385d-4ee7-8a2e-61ca0bf7c58a", "links": [{"href":
"https://cl-powervc.ibm-tce-
cloud.com:8774/v2/1953082a91d54db8a51fc8a742df46c6/images/c3f2de51-385d-4ee7-8a2e-
61ca0bf7c58a", "rel": "self"}, {"href": "https://cl-powervc.ibm-tce-
cloud.com:8774/1953082a91d54db8a51fc8a742df46c6/images/c3f2de51-385d-4ee7-8a2e-
61ca0bf7c58a", "rel": "bookmark"}, {"href": "https://cl-powervc.ibm-tce-
cloud.com:9292/images/c3f2de51-385d-4ee7-8a2e-61ca0bf7c58a", "type":
"application/vnd.openstack.image", "rel": "alternate"}], "name": "SLES11CI"}, {"id":
"a1ad5dfd-e990-4f07-bcb4-10a8a4e25c54", "links": [{"href": "https://cl-powervc.ibm-tce-
cloud.com:8774/v2/1953082a91d54db8a51fc8a742df46c6/images/a1ad5dfd-e990-4f07-bcb4-
10a8a4e25c54", "rel": "self"}, {"href": "https://cl-powervc.ibm-tce-
cloud.com:8774/1953082a91d54db8a51fc8a742df46c6/images/a1ad5dfd-e990-4f07-bcb4-
…

REST API – using curl – Get Storage Connectivity Group
 Get the SCGs using the token for the tenant …
# curl -1 -k -i -X GET
https://powervc:5000/powervc/openstack/compute/v2/<Tenant>/storage-connectivity-groups -H
"X-Auth-Token: <Token>" -H "Content-Type: application/json“
HTTP/1.1 200 OK
Date: Fri, 15 Apr 2016 12:17:07 GMT
Server: Apache
Content-Type: application/json; charset=UTF-8
Content-Length: 749
X-Compute-Request-Id: req-56b63f94-534f-4853-bc06-8ddb361531e1
Pragma: no-cache
{"storage_connectivity_groups": [{"display_name": "Any host, all VIOS", "id": "6a180ca0-
b2a4-483d-a864-0c1f92294e21"}, {"display_name": "Any host in cl-cluster", "id":
"be661942-4e87-4517-8678-5cbe3ff79b2b"}, {"display_name": "Belt", "id": "485ed115-5b6d-
429d-bf5c-782428699d9b"}, {"display_name": "vSCSI", "id": "b15e278d-ee5e-41bb-9ab9-
770955c8082a"}, {"display_name": "BB_vSCSI", "id": "5befa22d-5fd1-4f19-ab28-
dc374e0e0b21"}, {"display_name": "auto-vscsi_npiv", "id": "a29ba01d-a7ae-47b8-8734-
90ddd769d1a3"}, {"display_name": "Braces", "id": "99bcb22f-c7c0-4020-b07e-af0451b5acdc"},
{"display_name": "vSCSI_NPIV", "id": "edc59fbe-e305-405e-959f-1d1785c55565"},
{"display_name": "auto-vscsi_vscsi", "id": "017a9f94-2cd1-4576-8969-e3203df955d0"}]}

REST API – using curl – Deploy a VM
 Use all the data to deploy a VM
# curl -1 -k -i -X POST
https://powervc:5000/powervc/openstack/compute/v2/<Tenant>/servers -H "X-Auth-Token:
<Token>" -H "Content-Type: application/json" -d '{"server":{ "name": “MyName",
"max_count": 1,"networkId":“<Network ID>", "imageRef": “<Image ID>", "networks":[{"uuid":
“<Network ID>"}],"flavor": {"ram":1024,"vcpus":1,"disk": 30,"extra_specs": {
"powervm:proc_units":"0.1", "powervm:storage_connectivity_group":“<Storage Connectivity
Group ID>"}}}}‘
HTTP/1.1 202 Accepted
Date: Fri, 15 Apr 2016 12:20:39 GMT
Server: Apache
Location: https://cl-powervc.ibm-tce-
cloud.com:8774/v2/1953082a91d54db8a51fc8a742df46c6/servers/f312a9f0-2b96-4645-b588-
a7d7b2473c71
Content-Length: 474
X-Compute-Request-Id: req-2ace156a-0993-4cd9-8cd8-ce208fcd179d
Pragma: no-cache
{"server": {"security_groups": [{"name": "default"}], "OS-DCF:diskConfig": "MANUAL",
"id": "f312a9f0-2b96-4645-b588-a7d7b2473c71", "links": [{"href": "https://cl-powervc.ibm-
tce-cloud.com:8774/v2/1953082a91d54db8a51fc8a742df46c6/servers/f312a9f0-2b96-4645-b588-
a7d7b2473c71", "rel": "self"}, {"href": "https://cl-powervc.ibm-tce-
cloud.com:8774/1953082a91d54db8a51fc8a742df46c6/servers/f312a9f0-2b96-4645-b588-
a7d7b2473c71", "rel": "bookmark"}], "adminPass": "73kgFCSZXEhW"}}

REST API – using curl – List VMs

REST API – using curl – List Volume, WWPN and Zoning for VM

REST API – Using Python – Creation of an LPAR – API token
– Get the token … If you did not specify user and password
# openstack token issue --os-username=<User>
Password:
+------------+------------------------------------------------------------------+
| Field | Value |
+------------+------------------------------------------------------------------+
| expires | 2016-07-19T19:46:46.961130Z |
| id | c400003fc6a24c48b52abe52b7f9a51b |
| project_id | 3c10a75d0cd14cb19c1567cccaf76991 |
| user_id | 4b0d1b529006c03834a03106992f24c73a31c4b7537d91560e73973c63a685f8 |
+------------+------------------------------------------------------------------+
– The token is valid for 4 hours
– If you did not source anything and want another project (ex. marketing), use:
# openstack token issue --os-username=<user> --os-auth-url=https://cl-powervc.ibm-
tce-cloud.com:5000/v3/ --os-project-name=marketing --os-cacert=/etc/pki/tls/certs/
powervc.crt --os-user-domain-name=Default --os-project-domain-name=Default
Password:
+------------+-----------------------------------------------------------------+
| Field | Value |
+------------+-----------------------------------------------------------------+
| expires | 2016-07-19T20:18:56.945144Z |
| id | 4c90450a0879471694a4c10f772a2d68 |
| project_id | 804682d760974ca9949d55da7efe9662 |
| user_id | 4b0d1b529006c03834a03106992f24c73a31c4b7537d91560e73973c63a685f8|
+------------+-----------------------------------------------------------------+

REST API – Creation of an LPAR – Tenant
 To get the tenant, the following script could be used <tenants>*):
#!/usr/bin/python
import httplib
import json
import os
import sys
def main():
token = raw_input("Please enter PowerVC token : ")
print "PowerVC token used = "+token
conn = httplib.HTTPSConnection('localhost')
headers = {"X-Auth-Token":token, "Content-type":"application/json"}
body = ""
conn.request("GET", "/powervc/openstack/identity/v2.0/tenants", body, headers)
conn.request("GET", "/powervc/openstack/identity/v3/projects", body, headers)
response = conn.getresponse()
raw_response = response.read()
conn.close()
json_data = json.loads(raw_response)
print json.dumps(json_data, indent=4, sort_keys=True)
if __name__ == "__main__":
main()

REST API – Creation of an LPAR – Tenant
The output of the tenants script:
# ./tenants
Please enter PowerVC token : c192e0016c844d1c865238beb5994aac
PowerVC token used = c192e0016c844d1c865238beb5994aac
{
"links": {
"next": null,
"previous": null,
"self": "https://cl-powervc.ibm-tce-cloud.com/powervc/openstack/identity/v3/projects"
},
"projects": [
{
"description": "IBM Default Tenant",
"domain_id": "default",
"enabled": true,
"id": "b8b4106dee504ed9b2882bf39db94486",
"is_domain": false,
…

REST API – Creation of an LPAR – Network ID
 To get the network IDs, the following script could be used <networks>*):
#!/usr/bin/python
import httplib
import json
import os
import sys
def main():
body = ""
conn.request("GET", "/powervc/openstack/network/v2.0/networks", body, headers)
conn.close()
if __name__ == "__main__":
main()

REST API – Creation of an LPAR – Network ID
The output of the networks script:
# ./networks
{
"networks": [
{
"admin_state_up": true,
"id": "8e11a651-c019-4d87-a648-ab7e04842094",
"mtu": null,
"name": "Cloud Network",
"provider:network_type": "vlan",
"provider:physical_network": "default",
"provider:segmentation_id": 1,
"router:external": false,
"shared": true,
"status": "ACTIVE",
"subnets": [
"2d395a1c-e25b-4ed7-b5b7-2c7fdb487c9b"
],
"tenant_id": "b8b4106dee504ed9b2882bf39db94486"
},
{
"admin_state_up": true,
"id": "a24cbb7d-65fb-43af-9750-dec63dd50389",
"name": "9er Network",
…

REST API – Creation of an LPAR – Image ID
 To get the image IDs, the following script could be used <images>*):
#!/usr/bin/python
import httplib
import json
import os
import sys
def main():
tenant_id = raw_input("Please enter PowerVC Tenant ID : ")
body = ""
conn.request("GET", "/powervc/openstack/compute/v2/"+tenant_id+"/images", body, headers)
conn.close()
if __name__ == "__main__":
main()

REST API – Creation of an LPAR – Image ID
The output of the images script:
# ./images
Please enter PowerVC Tenant ID : b8b4106dee504ed9b2882bf39db94486
{
"images": [
{
"id": "8f0ca045-ddab-4d6d-8294-adbc0941e336",
"links": [
{
"href": "https://powervc:8774/v2/b8b4106dee504ed9b2882bf39db94486/images/8f0ca045-
ddab-4d6d-8294-adbc0941e336",
"rel": "self"
},
{
"href": "https://powervc:8774/b8b4106dee504ed9b2882bf39db94486/images/8f0ca045-ddab-
4d6d-8294-adbc0941e336",
"rel": "bookmark"
},
{
"href": "https://powervc:9292/b8b4106dee504ed9b2882bf39db94486/images/8f0ca045-ddab-
4d6d-8294-adbc0941e336",
"rel": "alternate",
"type": "application/vnd.openstack.image"
}
],
"name": "AIX_71_TL3_Standard_Image_NPIV"
},
…

REST API – Creation of an LPAR – SCG ID
 To get the IDs of the storage connectivity groups, the following script could be
used <scg>*):
#!/usr/bin/python
import httplib
import json
import os
import sys
def main():
body = ""
conn.request("GET", "/powervc/openstack/compute/v2/"+tenant_id+"/storage-connectivity-groups", body, headers)
conn.close()
if __name__ == "__main__":
main()

REST API – Creation of an LPAR – SCG ID
The output of the scg script:
# ./scg
Please enter PowerVC token : eee5d529e2eb4f13a30ba32aafcc5601
Please enter PowerVC Tenant ID : 1953082a91d54db8a51fc8a742df46c6
{
"storage_connectivity_groups": [
{
"display_name": "Any host, all VIOS",
"id": "6a180ca0-b2a4-483d-a864-0c1f92294e21"
},
{
"display_name": "Any host in cl-cluster",
"id": "be661942-4e87-4517-8678-5cbe3ff79b2b"
},
…

 The final creation script <create>*):
#!/usr/bin/python
import httplib
import json
import os
import sys
def main():
print "PowerVC token used = "+token
print "Tenant ID = "+tenant_id
lpar_name = raw_input("Please enter the new LPAR name: ")
print "LPAR Name = "+lpar_name
network_id = raw_input("Please enter the ID for the network: ")
print "Network ID = "+network_id
image_id = raw_input("Please enter the ID for the image: ")
print "Image ID = "+image_id
scg_id = raw_input("Please enter the ID for the SCG: ")
print "SCG = "+scg_id
headers = {"Content-Type": "application/json"}
…

 The final creation script <create>*):
…
body = {
"server": {
"name": lpar_name,
"max_count": 1,
"networkId": network_id,
"imageRef": image_id,
"networks": [ {
"uuid": network_id } ],
"flavor": {
"ram": 1024,
"vcpus": 1,
"disk": 30,
"extra_specs": {
"powervm:proc_units": 0.1,
"powervm:storage_connectivity_group": scg_id }
}
}
}
conn.request("POST", "/powervc/openstack/compute/v2/"+tenant_id+"/servers",
json.dumps(body), headers)
conn.close()
if __name__ == "__main__":
main()
To use a fixed IP, add the attribute “fixed_ip” in the “networks” section.

The output of the create script:
# ./create
Please enter PowerVC Tenant ID : b8b4106dee504ed9b2882bf39db94486
Please enter the new LPAR name: aix123
Please enter the ID for the image: 8f0ca045-ddab-4d6d-8294-adbc0941e336
Please enter the ID for the network: 8e11a651-c019-4d87-a648-ab7e04842094
Please enter the ID for the SCG: 6a180ca0-b2a4-483d-a864-0c1f92294e21
{
"server": {
"OS-DCF:diskConfig": "MANUAL",
"adminPass": "Lh8f8NhqB4iB",
"id": "d7cb48e1-47f6-48c4-a939-08082cd26400",
"links": [
{
"href": "https://cl-powervc.ibm-tce-
cloud.com:8774/v2/1953082a91d54db8a51fc8a742df46c6/servers/d7cb48e1-47f6-48c4-a939-08082cd26400",
"rel": "self"
},
…

pvcmd commands
 Benoit Creau also created ready to use commands using the REST API of
PowerVC:
– pvcmkvm – Create a virtual machine
– pvcgrowlun – Extend a LUN
 More Information could be found in GitHub:
https://github.com/chmod666org/pvcmd
or:
http://chmod666.org/index.php/tips-and-tricks-for-powervc-1-2-3-pvid-ghostdev-
clouddev-rest-api-growing-volumes-deleting-boot-volume-powervc-1-2-3-redbook/

PowerVC – Metering
 With PowerVC 1.3.1 metering was introduced. In this first version with metering,
the following meters (meter name in brackets) are available:
– Dedicated memory of an LPAR (total_memory)
– Capacity Entitlement (total_vcpu)
– Allocated disk space (total_volumes)
– CPU usage on a host basis (compute.node.cpu.percent)
 The default sampling interval is 10 minutes for total_memory, total_vcpu,
total_volumes and 1 minute for compute.node.cpu.percent.
 Metering data is stored for 14 days per default:
# powervc-config metering meter_ttl
Current value: 14 days, 0:00:00
Default value: 14 days, 0:00:00
To change it (for example to 30 days - 30*24=720) use:
# powervc-config metering meter_ttl --set 720 --unit hr
Setting metering_time_to_live to 720 hr

 To get metering data using “the curl method” do the following:
– Source environment (for a specific project - example here ibm-default)
# source /opt/ibm/powervc/powervcrc
– Get token
# openstack token issue
+------------+------------------------------------------------------------------+
| Field | Value |
+------------+------------------------------------------------------------------+
| expires | 2016-07-20T20:15:59.033226Z |
| id | 8237ab6075454c408dbf291370af0246 |
| project_id | 1953082a91d54db8a51fc8a742df46c6 |
| user_id | 4b0d1b529006c03834a03106992f24c73a31c4b7537d91560e73973c63a685f8 |
+------------+------------------------------------------------------------------+
– Examples how to get data:
• Get all data for a given project for all users in that project (in JSON Format)
# curl -1 -k -X GET
"https://localhost:5000/powervc/openstack/metering/v2/samples?q.field=project_
id&q.value=<Project ID>" -H "X-Auth-Token:<Token ID>" | python -mjson.tool
• Get all data for a given user for all projects that user belongs to (in JSON Format)
# curl -1 -k -X GET
"https://localhost:5000/powervc/openstack/metering/v2/samples?q.field=user_id&
q.value=<User ID>" -H "X-Auth-Token:<Token ID>" | python -mjson.tool

– (more examples) …
• Get CPU EC values for a given project for all users in that project (in JSON Format)
# curl -1 -k -X GET
"https://localhost:5000/powervc/openstack/metering/v2/meters/total_vcpu?q.field
=project_id&q.value=<Project ID>" -H "X-Auth-Token:<Token ID>" | python -
mjson.tool
• Get host CPU utilization values for a given project for all users in that project (in JSON
Format)
# curl -1 -k -X GET
"https://localhost:5000/powervc/openstack/metering/v2/meters/compute.node.cpu.p
ercent?" -H "X-Auth-Token:<Token ID>" | python -mjson.tool
– Output see next foil …

PowerVC – Metering - Output
[
{
"id": "3b908cc2-4cc4-11e6-b6a0-6afdedb69202",
"metadata": {},
"meter": "total_memory",
"project_id": "804682d760974ca9949d55da7efe9662",
"recorded_at": "2016-07-18T08:47:17.885101",
"resource_id": "instances",
"source": "openstack",
"timestamp": "2016-07-18T08:47:17.800824",
"type": "gauge",‘
"unit": "MB",
"user_id": "b7f3a90cc35f00ce747b1b8162ad7e912f33660e2138840765b492390c06df5a",
"volume": 1024.0
},
{
"id": "3b9078ea-4cc4-11e6-b6a0-6afdedb69202",
…
ID of the sampling interval itself
Name of the meter
ID of the project. To find the
project name, use:
# openstack project list
Timestamp
Unit
Value
ID of the user. To find the user
name, use:
# openstack user list
The output above is from “metering/v2/samples”. The output of a specific meter
“metering/v2/meters/<specific meter>” has some other keywords, but shows the
same amount of data.

PowerVC – Metering - Output of a host
[
{
"counter_name": "compute.node.cpu.percent",
"counter_type": "gauge",
"counter_unit": "percent",
"counter_volume": 13.0,
"message_id": "5d541b86-4e6c-11e6-a197-6afdedb69202",
"project_id": null,
"recorded_at": "2016-07-20T11:23:21.090247",
"resource_id": "8205E6B_061E6AR_8205E6B_061E6AR",
"resource_metadata": {
"event_type": "compute.metrics.update",
"host": "compute.8205E6B_061E6AR",
"source": "powervc_nova.virt.ibmpowervm.hmc.driver.PowerVMDriver"
},
"source": "openstack",
"timestamp": "2016-07-20T11:23:20.625730",
"user_id": null
},
… Timestamp
Unit
Value
Type/model_serial of the host

PowerVC – Metering - Output of a host
 Per default, a query for data gives back a maximum of 100 entries. If you want
more entries add a “?limit=<Number>” to the query.
 Default example with 100 entries:
# curl -1 -k -X GET
"https://localhost:5000/powervc/openstack/metering/v2/meters/total_volumes?q.field=project
_id&q.value=<Project ID>" -H "X-Auth-Token:<Token ID>" | python -mjson.tool | grep
counter_name | wc -l
Dload Upload Total Spent Left Speed100 45100 100 45100 0 0 99k 0
--:--:-- --:--:-- --:--:-- 99k
100
 Now for 1000 entries:
# curl -1 -k -X GET
"https://localhost:5000/powervc/openstack/metering/v2/meters/total_volumes?limit=1000
?q.field=project_id&q.value=<Project ID>" -H "X-Auth-Token:<Token ID>" | python
-mjson.tool | grep counter_name | wc -l
Dload Upload Total Spent Left Speed100 431k 100 431k 0 0 402k 0
0:00:01 0:00:01 --:--:-- 402k
1000

For more information about metering see:
1. AIXpert Blog - PowerVC 1.3.1 Cloud Edition - Metering via REST API
https://www.ibm.com/developerworks/community/blogs/aixpert/entry/PowerVC_1_3_1_Cloud_Edition_Metering_via_REST_
API?lang=en

Technical Resources
 PowerVC Knowledge Center:
https://www.ibm.com/support/knowledgecenter/SSXK2N_1.3.2/com.ibm.powervc.standard.help.
doc/powervc_hwandsw_reqs_hmc.html

Working with PowerVC via its REST APIs

More Related Content

What's hot

Similar to Working with PowerVC via its REST APIs

Recently uploaded

Working with PowerVC via its REST APIs

Editor's Notes