Files
baaeec1b63429d48cd1137e33e3e550a14f7838c
nova /api-ref /source /os-aggregates.inc

343 lines
7.6 KiB
PHP
Raw Normal View History

.. 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
- aggregates: aggregates
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- hosts: aggregate_host_list
- id: aggregate_id_body
- metadata: aggregate_metadata
- name: aggregate_name
- updated_at: updated_consider_null
================
Normal response codes: 200
Request
.. rest_parameters:: parameters.yaml
**Example Create Aggregate: JSON request**
.. literalinclude:: ../../doc/api_samples/os-aggregates/aggregate-post-req.json
:language: javascript
Response
- aggregate: aggregate
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- id: aggregate_id_body
- name: aggregate_name
- updated_at: updated_consider_null
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
- aggregate: aggregate
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- hosts: hosts
- id: aggregate_id_body
- metadata: aggregate_metadata
- name: aggregate_name
- updated_at: updated_consider_null
Normal response codes: 200
itemNotFound(404), conflict(409)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
- name: aggregate_name_optional
- availability_zone: aggregate_az_optional
.. literalinclude:: ../../doc/api_samples/os-aggregates/aggregate-update-post-req.json
:language: javascript
- aggregate: aggregate
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- hosts: hosts
- id: aggregate_id_body
- metadata: aggregate_metadata
- name: aggregate_name
- updated_at: updated_consider_null
.. 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 and host name in the request body.
Normal response codes: 200
itemNotFound(404), conflict(409)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
- host: host_name_body
**Example Add Host: JSON request**
Response
- aggregate: aggregate
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- hosts: hosts
- id: aggregate_id_body
- metadata: aggregate_metadata
- name: aggregate_name
- updated_at: updated_consider_null
===========
Specify the ``remove_host`` action and host name in the request body.
Normal response codes: 200
itemNotFound(404), conflict(409)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
- host: host_name_body
Response
- aggregate: aggregate
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- hosts: hosts
- id: aggregate_id_body
- metadata: aggregate_metadata
- name: aggregate_name
- updated_at: updated_consider_null
===================================
Normal response codes: 200
itemNotFound(404)
Request
.. rest_parameters:: parameters.yaml
- aggregate_id: aggregate_id
- metadata: metadata_set_required
Response
- aggregate: aggregate
- availability_zone: aggregate_az
- created_at: created
- deleted_at: deleted_at
- deleted: deleted
- hosts: hosts
- id: aggregate_id_body
- metadata: aggregate_metadata
- name: aggregate_name
- updated_at: updated_consider_null