Prev Next

4.10. Removing hosts from aggregates¶

POST /os-aggregates/{aggregate_id}/action

Removes a host from an aggregate.

Specify the remove_host action and host name in the request body.

Source: https://docs.openstack.org/api-ref/compute/?expanded=remove-host-detail,create-or-update-aggregate-metadata-detail#remove-host

4.10.1. Request¶

Name	In	Type	Description
`aggregate_id`	path	integer	The aggregate ID.
`remove_host`	body	object	The add_host object used to remove host from aggregate.
`host`	body	string	The name of the host.

4.10.1.1. Example¶

curl -ks -X POST -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' -d '
{
    "remove_host": {
        "host": "hci-ac-am1.vstoragedomain"
    }
}' https://<node_IP_addr>:8774/v2.1/6ef5371261ea42008e3d1d41ba051977/os-aggregates/4/action

4.10.2. Response¶

Name	In	Type	Description
`aggregate`	body	object	The host aggregate object.
`availability_zone`	body	string	The availability zone of the host aggregate.
`created_at`	body	string	The date and time when the resource was created. The date and time stamp format is ISO 8601 CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In the previous example, the offset value is `-05:00`.
`deleted_at`	body	string	The date and time when the resource was deleted. If the resource has not been deleted yet, this field will be `null`, The date and time stamp format is ISO 8601 CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In the previous example, the offset value is `-05:00`.
`deleted`	body	boolean	A boolean indicates whether this aggregate is deleted or not, if it has not been deleted, `false` will appear.
`hosts`	body	array	An array of host information.
`id`	body	integer	The ID of the host aggregate.
`metadata`	body	object	Metadata key and value pairs associated with the aggregate.
`name`	body	string	The name of the host aggregate.
`updated_at`	body	string	The date and time when the resource was updated, if the resource has not been updated, this field will show as `null`. The date and time stamp format is ISO 8601 CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In the previous example, the offset value is `-05:00`.
`uuid`	body	string	The UUID of the host aggregate. New in version 2.41

4.10.2.1. Status codes¶

4.10.2.1.1. Success¶

Code	Reason
`200 - OK`	Request was successful.

4.10.2.1.2. Error¶

Code	Reason
`400 - Bad Request`	Some content in the request was invalid.
`401 - Unauthorized`	User must authenticate before making a request.
`403 - Forbidden`	Policy does not allow current user to do this operation.
`404 - Not Found`	The requested resource could not be found.
`409 - Conflict`	This operation conflicted with another operation on this resource.

4.10.2.2. Example¶

{
  "aggregate": {
    "name": "CUSTOM_HCI_0A7F6A35E650420CB30200A8359861D9",
    "availability_zone": null,
    "deleted": false,
    "created_at": "2020-04-19T12:56:10.191466",
    "updated_at": null,
    "hosts": [],
    "deleted_at": null,
    "id": 4,
    "metadata": {}
  }
}

Version 4.5.0 — Feb 15, 2021

Prev Next