openstack/nova-specs
Code Issues Proposed changes

Amend generic-resource-pools

Browse Source 
Amends the generic-resource-pools spec with the following changes:

* Change terminology from "resource pool" to "resource provider"
* Change the REST API proposal to have /resource_providers endpoints
instead of /resource_pools endpoints
* Change the `openstack resource-pool` CLI commands to `openstack
resource-provider` CLI commands
* Adds a generation field to the output of the resource provider dicts
and update operations along with a note as to how the generation field
shall be used

Change-Id: Iefe28041fa9e81558ebac9f47016c4db43a92723
This commit is contained in:
Jay Pipes
2016-06-06 10:23:30 -04:00
parent 2cc649e35a
commit e79a21c17b
1 changed files with 160 additions and 133 deletions
Download Patch File Download Diff File Expand all files Collapse all files

293
specs/newton/approved/generic-resource-pools.rst
View File

@@ -12,7 +12,7 @@ https://blueprints.launchpad.net/nova/+spec/generic-resource-pools
This blueprint aims to address the problem of incorrect resource usage This blueprint aims to address the problem of incorrect resource usage
reporting by introducing the concept of a generic resource pool that manages a reporting by introducing the concept of a generic resource pool that manages a
particular amount of some resource. particular amount of some resources.
Problem description Problem description
=================== ===================
@@ -51,20 +51,20 @@ Cinder storage pool that contains the requested volume.
Proposed change Proposed change
=============== ===============
We propose to introduce the concept of a `resource pool` in Nova, and to create We propose a new RESTful placement API that allows the querying and management
a new RESTful scheduler API that allows the querying and management of these of resource providers, their inventory and allocation records, and their
resource pools. association to aggregates.
A resource pool is simply a resource provider for one or more resource types to A resource provider exposes amounts of one or more resource types to multiple
multiple consumers of those resources. Resource pools are not specific to consumers of those resources. Resource providers are not specific to shared
shared storage, even though the impetus for their design is to solve the storage, even though the impetus for their design is to solve the problem of
problem of shared storage accounting in Nova. shared storage accounting in Nova.
A RESTful API is proposed (see below for details) that will allow A RESTful API is proposed (see below for details) that will allow
administrative (or service) users to create resource pools, to update the administrative (or service) users to create resource providers, to update the
capacity and usage information for those pools, and to indicate which compute capacity and usage information for those providers, and to indicate which
nodes can use the pool's resources by associating the pool with one or more compute nodes can use the provider's resources by associating the pool with one
aggregates. or more aggregates.
Scenario 1: Shared disk storage used for VM disk images Scenario 1: Shared disk storage used for VM disk images
------------------------------------------------------- -------------------------------------------------------
@@ -85,16 +85,16 @@ All compute nodes in row 1, racks 6 through 10, are connected to this share.
2) The cloud deployer creates a resource pool representing the NFS share:: 2) The cloud deployer creates a resource pool representing the NFS share::
$RP_UUID=`openstack resource-pool create "/mnt/nfs/row1racks0610/" \ $RP_UUID=`openstack resource-provider create "/mnt/nfs/row1racks0610/" \
--aggregate-uuid=$AGG_UUID` --aggregate-uuid=$AGG_UUID`
Under the covers this command line does two REST API requests. Under the covers this command line does two REST API requests.
One to create the resource-pool, another to associate the One to create the resource provider, another to associate the
aggregate. aggregate.
3) The cloud deployer updates the resource pool's capacity of shared disk:: 3) The cloud deployer updates the resource pool's capacity of shared disk::
openstack resource-pool set inventory $RP_UUID \ openstack resource-provider set inventory $RP_UUID \
--resource-class=DISK_GB \ --resource-class=DISK_GB \
--total=100000 --reserved=1000 \ --total=100000 --reserved=1000 \
--min-unit=50 --max-unit=10000 --step-size=10 \ --min-unit=50 --max-unit=10000 --step-size=10 \
@@ -137,22 +137,22 @@ the subnet.
3) The cloud deployer creates a resource pool representing the routed network's 3) The cloud deployer creates a resource pool representing the routed network's
pool of IPs:: pool of IPs::
openstack resource-pool create "routed network rack 1 row 3" \ openstack resource-provider create "routed network rack 1 row 3" \
--uuid=$SUBNET_UUID \ --uuid=$SUBNET_UUID \
--aggregate-uuid=$AGG_UUID --aggregate-uuid=$AGG_UUID
.. note:: .. note::
Please note that the `--uuid` field in the `openstack resource-pool create` Please note that the `--uuid` field in the `openstack resource-provider
call above is an optional argument to `openstack resource-pool create`. You create` call above is an optional argument to `openstack resource-provider
may have noticed that in the first use case, we do not provide a UUID when create`. You may have noticed that in the first use case, we do not provide
creating the resource pool. a UUID when creating the resource provider.
The `--uuid` parameter allows passing in a UUID identifier so that external The `--uuid` parameter allows passing in a UUID identifier so that external
systems can supply an already-known external global identifier for the systems can supply an already-known external global identifier for the
resource pool. If the `--uuid` parameter is not provided in the call to resource pool. If the `--uuid` parameter is not provided in the call to
`openstack resource-pool create`, a new UUID will automatically be assigned `openstack resource-provider create`, a new UUID will automatically be
and displayed to the user. assigned and displayed to the user.
In the case above, we are assuming that the call to the `openstack In the case above, we are assuming that the call to the `openstack
subnet create` returns some value containing a UUID for the subnet IP subnet create` returns some value containing a UUID for the subnet IP
@@ -160,7 +160,7 @@ the subnet.
4) The cloud deployer updates the resource pool's capacity of IPv4 addresses:: 4) The cloud deployer updates the resource pool's capacity of IPv4 addresses::
openstack resource-pool set inventory $RP_UUID \ openstack resource-provider set inventory $RP_UUID \
--resource-class=IPV4_ADDRESS \ --resource-class=IPV4_ADDRESS \
--total=254 --reserved=5 \ --total=254 --reserved=5 \
--min-unit=1 --max-unit=1 --step-size=1 \ --min-unit=1 --max-unit=1 --step-size=1 \
@@ -246,10 +246,9 @@ an aggregate to be associated with one or more resource pools::
REFERENCES resource_providers (id) REFERENCES resource_providers (id)
); );
A new nova object model for resource pools will be introduced. This object A new nova object model for resource providers will be introduced. This object
model will be a thin facade over the `resource_providers` table and allow model will allow querying for the aggregates associated with the resource
querying for the aggregates associated with the resource pool along with the provider along with the inventory and allocation records for the pool.
inventory and allocation records for the pool.
REST API impact REST API impact
--------------- ---------------
@@ -273,20 +272,20 @@ the resource.
The API changes add resource endpoints to: The API changes add resource endpoints to:
* `GET` a list of resource pools * `GET` a list of resource providers
* `POST` a new resource pool * `POST` a new resource provider
* `GET` a single resource pool with links to its sub-resources * `GET` a single resource provider with links to its sub-resources
* `PUT` a single resource pool to change its name * `PUT` a single resource provider to change its name
* `DELETE` a single resource pool and its associated inventories (if * `DELETE` a single resource provider and its associated inventories (if
no allocations are present) and aggregates (the association is no allocations are present) and aggregates (the association is
removed, not the aggregates themselves) removed, not the aggregates themselves)
* `GET` a list of the inventories associated with a single resource * `GET` a list of the inventories associated with a single resource
pool provider
* `POST` a new inventory of a particular resource class * `POST` a new inventory of a particular resource class
* `GET` a single inventory of a given resource class * `GET` a single inventory of a given resource class
* `PUT` an update to an inventory * `PUT` an update to an inventory
* `DELETE` an inventory (if no allocations are present) * `DELETE` an inventory (if no allocations are present)
* `PUT` a list of aggregates to associate with this resource * `PUT` a list of aggregates to associate with this resource provider
* `GET` that list of aggregates * `GET` that list of aggregates
* `GET` a list, by resource class, of usages * `GET` a list, by resource class, of usages
@@ -297,10 +296,10 @@ Details follow.
The following new REST API calls will be added: The following new REST API calls will be added:
`GET /resource_pools` `GET /resource_providers`
********************** *************************
Return a list of all resource pools in this Nova deployment. Return a list of all resource providers in this Nova deployment.
Example:: Example::
@@ -308,58 +307,67 @@ Example::
Content-Type: application/json Content-Type: application/json
{ {
"resource_pools": [ "resource_providers": [
{ {
"uuid": "b6b065cc-fcd9-4342-a7b0-2aed2d146518", "uuid": "b6b065cc-fcd9-4342-a7b0-2aed2d146518",
"name": "RBD volume group", "name": "RBD volume group",
"generation": 12,
"links": [ "links": [
{ {
"rel": "self", "rel": "self",
"href": "/resource_pools/b6b065cc-fcd9-4342-a7b0-2aed2d146518" "href": "/resource_providers/b6b065cc-fcd9-4342-a7b0-2aed2d146518"
}, },
{ {
"rel": "inventories", "rel": "inventories",
"href": "/resource_pools/b6b065cc-fcd9-4342-a7b0-2aed2d146518/inventories" "href": "/resource_providers/b6b065cc-fcd9-4342-a7b0-2aed2d146518/inventories"
}, },
{ {
"rel": "aggregates", "rel": "aggregates",
"href": "resource_pools/b6b065cc-fcd9-4342-a7b0-2aed2d146518/aggregates" "href": "resource_providers/b6b065cc-fcd9-4342-a7b0-2aed2d146518/aggregates"
}, },
{ {
"rel": "usages", "rel": "usages",
"href": "resource-pools/b6b065cc-fcd9-4342-a7b0-2aed2d146518/usages" "href": "resource_providers/b6b065cc-fcd9-4342-a7b0-2aed2d146518/usages"
} }
] ]
}, },
{ {
"uuid": "eaaf1c04-ced2-40e4-89a2-87edded06d64", "uuid": "eaaf1c04-ced2-40e4-89a2-87edded06d64",
"name": "Global NFS share", "name": "Global NFS share",
"generation": 4,
"links": [ "links": [
{ {
"rel": "self", "rel": "self",
"href": "/resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64" "href": "/resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64"
}, },
{ {
"rel": "inventories", "rel": "inventories",
"href": "/resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories" "href": "/resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories"
}, },
{ {
"rel": "aggregates", "rel": "aggregates",
"href": "resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates" "href": "resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates"
}, },
{ {
"rel": "usages", "rel": "usages",
"href": "resource-pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/usages" "href": "resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/usages"
} }
] ]
} }
] ]
} }
`POST /resource_pools` .. note::
**********************
Create one new resource pool. The `generation` field in the above output is a consistent view marker. We
need to include this field in order for updaters of the inventory and
allocation information for a resource provider to indicate the state of the
resource provider when they initially read their information.
`POST /resource_providers`
**************************
Create one new resource provider.
An example POST request:: An example POST request::
@@ -389,23 +397,23 @@ The body of the request must match the following JSONSchema document::
} }
The response body is empty. The headers include a location header The response body is empty. The headers include a location header
pointing to the created resource pool:: pointing to the created resource provider::
201 Created 201 Created
Location: /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64 Location: /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64
A `409 Conflict` response code will be returned if another resource pool A `409 Conflict` response code will be returned if another resource provider
exists with the provided name. exists with the provided name.
`GET /resource_pools/{uuid}` `GET /resource_providers/{uuid}`
**************************** ********************************
Retrieve a representation of the resource pool identified by `{uuid}`. Retrieve a representation of the resource provider identified by `{uuid}`.
Example:: Example::
GET /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64 GET /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64
200 OK 200 OK
Content-Type: application/json Content-Type: application/json
@@ -413,37 +421,38 @@ Example::
{ {
"uuid": "eaaf1c04-ced2-40e4-89a2-87edded06d64", "uuid": "eaaf1c04-ced2-40e4-89a2-87edded06d64",
"name": "Global NFS share", "name": "Global NFS share",
"generation": 4,
"links": [ "links": [
{ {
"rel": "self", "rel": "self",
"href": "/resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64" "href": "/resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64"
}, },
{ {
"rel": "inventories", "rel": "inventories",
"href": "/resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories" "href": "/resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories"
}, },
{ {
"rel": "aggregates", "rel": "aggregates",
"href": "resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates" "href": "resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates"
}, },
{ {
"rel": "usages", "rel": "usages",
"href": "resource-pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/usages" "href": "resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/usages"
} }
] ]
} }
If the resource pool does not exist a `404 Not Found` must be If the resource provider does not exist a `404 Not Found` must be
returned. returned.
`PUT /resource_pools/{uuid}` `PUT /resource_providers/{uuid}`
***************************** ********************************
Update the name of resource pool identified by `{uuid}`. Update the name of the resource provider identified by `{uuid}`.
Example:: Example::
PUT /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64 PUT /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64
Content-type: application/json Content-type: application/json
@@ -460,10 +469,10 @@ The returned HTTP response code will be one of the following:
* `409 Conflict` if another resource pool exists with the provided * `409 Conflict` if another resource pool exists with the provided
name. name.
`DELETE /resource_pools/{uuid}` `DELETE /resource_providers/{uuid}`
******************************** ***********************************
Delete the resource pool identified by `{uuid}`. Delete the resource provider identified by `{uuid}`.
This will also disassociate aggregates and delete inventories. This will also disassociate aggregates and delete inventories.
@@ -473,26 +482,27 @@ The returned HTTP response code will be one of the following:
* `204 No Content` if the request was successful and the resource * `204 No Content` if the request was successful and the resource
pool was removed. pool was removed.
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was
not found. not found.
* `409 Conflict` if there exist allocations records for any of the * `409 Conflict` if there exist allocations records for any of the
inventories that would be deleted as a result of removing the inventories that would be deleted as a result of removing the
resource pool. resource provider.
`GET /resource_pools/{uuid}/inventories` `GET /resource_providers/{uuid}/inventories`
***************************************** ********************************************
Retrieve a list of inventories that are associated with the resource Retrieve a list of inventories that are associated with the resource
pool identified by `{uuid}`. provider identified by `{uuid}`.
Example:: Example::
GET /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories GET /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories
200 OK 200 OK
Content-Type: application/json Content-Type: application/json
{ {
"resource_provider_generation": 4,
"inventories": { "inventories": {
'DISK_GB': { 'DISK_GB': {
"total": 2048, "total": 2048,
@@ -513,20 +523,31 @@ Example::
} }
} }
.. note::
The `resource_provider_generation` field in the output provides the caller
with a consistent view marker. If the caller wishes to update the
inventory, they return this generation field value in a call to `PUT
/resource_providers/{uuid}/inventories/{resource_class}` and the server
will ensure that if another process has updated the state of the resource
provider's inventory or allocations in between the initial read of the
generation and the update of inventory, that a `409 Conflict` is returned,
allowing the caller to retry an operation.
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `200 OK` if the resource pools exists. * `200 OK` if the resource pools exists.
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was
not found. not found.
`POST /resource_pools/{uuid}/inventories` `POST /resource_providers/{uuid}/inventories`
***************************************** ********************************************
Create a new inventory for the resource pool identified by `{uuid}`. Create a new inventory for the resource provider identified by `{uuid}`.
Example:: Example::
POST /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories POST /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories
Content-Type: application/json Content-Type: application/json
{ {
@@ -575,38 +596,39 @@ The body of the request must match the following JSONSchema document::
} }
The response body is empty. The headers include a location header The response body is empty. The headers include a location header
pointing to the created resource pool:: pointing to the created resource provider::
201 Created 201 Created
Location: /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB Location: /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB
.. note:: .. note::
If some non-Nova things have consumed some amount of resources in the pool, If some non-Nova things have consumed some amount of resources in the
the "reserved" field should be used to adjust the total capacity of the provider, the "reserved" field should be used to adjust the total capacity
inventory. of the inventory.
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `201 Created` if the inventory is successfully created * `201 Created` if the inventory is successfully created
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was
not found not found
* `400 Bad Request` for bad or invalid syntax (for example an * `400 Bad Request` for bad or invalid syntax (for example an
invalid resource class) invalid resource class)
* `409 Conflict` if an inventory for the proposed resource class * `409 Conflict` if an inventory for the proposed resource class
already exists already exists
`GET /resource_pools/{uuid}/inventories/{resource_class}` `GET /resource_providers/{uuid}/inventories/{resource_class}`
********************************************************** *************************************************************
Retrieve a single inventory of class `{resource_class}` associated Retrieve a single inventory of class `{resource_class}` associated
with the resource pool identified by `{uuid}`. with the resource provider identified by `{uuid}`.
Example:: Example::
GET /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB GET /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB
200 OK 200 OK
{ {
"resource_provider_generation": 4,
"resource_class": "DISK_GB", "resource_class": "DISK_GB",
"total": 2048, "total": 2048,
"reserved": 512, "reserved": 512,
@@ -620,19 +642,20 @@ Example::
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `200 OK` if the inventory exists * `200 OK` if the inventory exists
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was
not found or an inventory of `{resource_class}` is not associated not found or an inventory of `{resource_class}` is not associated
with the resource pool with the resource provider
`PUT /resource_pools/{uuid}/inventories/{resource_class}` `PUT /resource_providers/{uuid}/inventories/{resource_class}`
********************************************************** *************************************************************
Update an existing inventory. Update an existing inventory.
Example:: Example::
PUT /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB PUT /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB
{ {
"resource_provider_generation": 4,
"total": 1024, "total": 1024,
"reserved": 512, "reserved": 512,
"min_unit": 10, "min_unit": 10,
@@ -648,44 +671,47 @@ required and if present is ignored.
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `204 No Content` if the inventory is successfully created * `204 No Content` if the inventory is successfully created
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was
not found not found
* `400 Bad Request` for bad or invalid syntax * `400 Bad Request` for bad or invalid syntax
* `409 Conflict` if the changes `total`, `reserved` or * `409 Conflict` if the changes `total`, `reserved` or
`allocation_ratio` would causes existing allocations to be in `allocation_ratio` would causes existing allocations to be in
conflict with proposed capacity conflict with proposed capacity
* `409 Conflict` if another process updated the same inventory record since the
`resource_provider_generation` view marker was returned.
`DELETE /resource_pools/{uuid}/inventories/{resource_class}` `DELETE /resource_providers/{uuid}/inventories/{resource_class}`
************************************************************* ****************************************************************
Delete an existing inventory. Delete an existing inventory.
Example:: Example::
DELETE /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB DELETE /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/inventories/DISK_GB
The body is empty. The body is empty.
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `204 No Content` if the inventory is successfully removed * `204 No Content` if the inventory is successfully removed
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was not found
not found or if there is no associated inventory of or if there is no associated inventory of
`{resource_class}` `{resource_class}`
* `400 Bad Request` for bad or invalid syntax * `400 Bad Request` for bad or invalid syntax
* `409 Conflict` if there are existing allocations for this * `409 Conflict` if there are existing allocations for this
inventory inventory
`GET /resource_pools/{uuid}/aggregates` `GET /resource_providers/{uuid}/aggregates`
*************************************** *******************************************
Get a list of aggregates associated with this resource pool. Get a list of aggregates associated with this resource provider.
Example:: Example::
GET /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates GET /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates
{"aggregates": {
"aggregates":
[ [
"21d7c4aa-d0b6-41b1-8513-12a1eac17c0c", "21d7c4aa-d0b6-41b1-8513-12a1eac17c0c",
"7a2e7fd2-d1ec-4989-b530-5508c3582025" "7a2e7fd2-d1ec-4989-b530-5508c3582025"
@@ -698,18 +724,18 @@ Example::
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `200 OK` if the resource pool exists * `200 OK` if the resource provider exists
* `404 Not Found` if the resource pool identified by `{uuid}` was * `404 Not Found` if the resource provider identified by `{uuid}` was
not found not found
`PUT /resource_pools/{uuid}/aggregates` `PUT /resource_providers/{uuid}/aggregates`
************************************** *******************************************
Associate a list of aggregates with this resource pool. Associate a list of aggregates with this resource provider.
Example:: Example::
PUT /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates PUT /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/aggregates
[ [
"21d7c4aa-d0b6-41b1-8513-12a1eac17c0c", "21d7c4aa-d0b6-41b1-8513-12a1eac17c0c",
@@ -719,22 +745,23 @@ Example::
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `204 No content` if the aggregates are successfully updated * `204 No content` if the aggregates are successfully updated
* `404 Not Found` if the resource pool does not exist * `404 Not Found` if the resource provider does not exist
* `400 Bad Request` for bad or invalid syntax. * `400 Bad Request` for bad or invalid syntax.
`GET /resource_pools/{uuid}/usages` `GET /resource_providers/{uuid}/usages`
*********************************** ***************************************
Retrieve a report of usage information for resources associated with Retrieve a report of usage information for resources associated with
the resource pool identified by `{uuid}`. The value is a dictionary the resource provider identified by `{uuid}`. The value is a dictionary
of resource classes paired with the sum of the allocations of that of resource classes paired with the sum of the allocations of that
resource class for this resource pool. resource class for this resource provider.
Example:: Example::
GET /resource_pools/eaaf1c04-ced2-40e4-89a2-87edded06d64/usages GET /resource_providers/eaaf1c04-ced2-40e4-89a2-87edded06d64/usages
{ {
"resource_provider_generation": 4,
"usages": { "usages": {
"DISK_GB": 480, "DISK_GB": 480,
"IPV4_ADDRESS": 2 "IPV4_ADDRESS": 2
@@ -743,9 +770,9 @@ Example::
The returned HTTP response code will be one of the following: The returned HTTP response code will be one of the following:
* `200 OK` if the resource pool exists. If there are no associated * `200 OK` if the resource provider exists. If there are no associated
inventories the `usages` dictionary should be empty. inventories the `usages` dictionary should be empty.
* `404 Not Found` if the resource pool does not exist. * `404 Not Found` if the resource provider does not exist.
.. note:: Usages are read only. .. note:: Usages are read only.
@@ -758,9 +785,9 @@ None.
Notifications impact Notifications impact
-------------------- --------------------
We should create new notification messages for when resource pools are created, We should create new notification messages for when resource providers are
destroyed, updated, associated with an aggregate and disassociated from an created, destroyed, updated, associated with an aggregate and disassociated
aggregate. from an aggregate.
Other end user impact Other end user impact
--------------------- ---------------------
@@ -768,15 +795,15 @@ Other end user impact
New openstackclient CLI commands should be created for the corresponding New openstackclient CLI commands should be created for the corresponding
functionality: functionality:
* `openstack resource-pool list` * `openstack resource-provider list`
* `openstack resource-pool show $UUID` * `openstack resource-provider show $UUID`
* `openstack resource-pool create "Global NFS share" \ * `openstack resource-provider create "Global NFS share" \
--aggregate-uuid=$AGG_UUID \ --aggregate-uuid=$AGG_UUID \
[--uuid=$UUID]` [--uuid=$UUID]`
* `openstack resource-pool delete $UUID` * `openstack resource-provider delete $UUID`
* `openstack resource-pool update $UUID --name="New name"` * `openstack resource-provider update $UUID --name="New name"`
* `openstack resource-pool list inventory $UUID` * `openstack resource-provider list inventory $UUID`
* `openstack resource-pool set inventory $UUID \ * `openstack resource-provider set inventory $UUID \
--resource-class=DISK_GB \ --resource-class=DISK_GB \
--total=1024 \ --total=1024 \
--reserved=450 \ --reserved=450 \
@@ -784,10 +811,10 @@ functionality:
--max-unit=1 \ --max-unit=1 \
--step-size=1 \ --step-size=1 \
--allocation-ratio=1.0` --allocation-ratio=1.0`
* `openstack resource-pool delete inventory $UUID \ * `openstack resource-provider delete inventory $UUID \
--resource-class=DISK_GB` --resource-class=DISK_GB`
* `openstack resource-pool add aggregate $UUID $AGG_UUID` * `openstack resource-provider add aggregate $UUID $AGG_UUID`
* `openstack resource-pool delete aggregate $UUID $AGG_UUID` * `openstack resource-provider delete aggregate $UUID $AGG_UUID`
Performance Impact Performance Impact
------------------ ------------------
@@ -801,7 +828,7 @@ Deployers who are using shared storage will need to create a resource pool for
their shared disk storage, create any host aggregates that may need to be their shared disk storage, create any host aggregates that may need to be
created for any compute nodes that utilize that shared storage, associate the created for any compute nodes that utilize that shared storage, associate the
resource pool with those aggregates, and schedule (cronjob or the like) some resource pool with those aggregates, and schedule (cronjob or the like) some
script to periodically run `openstack resource-pool set inventory $UUID script to periodically run `openstack resource-provider set inventory $UUID
--resource-class=DISK_GB --total=X --reserved=Y`. --resource-class=DISK_GB --total=X --reserved=Y`.
We should include a sample script along with the documentation for this. We should include a sample script along with the documentation for this.