Files
279f1a9bf65c4b904e01d26f0619a62ed99fc4d3
nova /api-ref /source /os-aggregates.inc

245 lines
5.2 KiB
PHP
Raw Normal View History

.. needs:example_verification
.. needs:body_verification
Host aggregates (os-aggregates)
================================
Creates and manages host aggregates. An aggregate assigns metadata to
groups of compute nodes. Aggregates are only visible to the cloud
provider.
===============
Normal response codes: 200
Response
================
Normal response codes: 200
Request
.. rest_parameters:: parameters.yaml
- availability_zone: availability_zone
**Example Create Aggregate: JSON request**
.. literalinclude:: ../../doc/api_samples/os-aggregates/aggregate-post-req.json
:language: javascript
Response
Show Aggregate Details
======================
Shows details for an aggregate. Details include hosts and metadata.
Normal response codes: 200
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
Response
Normal response codes: 200
itemNotFound(404), conflict(409)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
.. literalinclude:: ../../doc/api_samples/os-aggregates/aggregate-update-post-req.json
:language: javascript
.. literalinclude:: ../../doc/api_samples/os-aggregates/aggregate-update-post-resp.json
:language: javascript
Delete Aggregate
Normal response codes: 200
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
Response
Add Host
========
Adds a host to an aggregate.
Specify the ``add_host`` action in the request body.
Normal response codes: 200
itemNotFound(404), conflict(409)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
**Example Add Host: JSON request**
Response
===========
Normal response codes: 200
itemNotFound(404), conflict(409)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
Response
===================================
Normal response codes: 200
itemNotFound(404)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
Response