449da03245
APIs which are being Obsoleted and return 410 like nova-net only APIs, have been moved to "Obsolete API" section in api-ref. In favour of moving them in "Obsolete API" section, "DEPRECATED" tag on those API ref can be removed to avoid confusion whether these APIs are deprecated or gone. Part of blueprint remove-nova-network ref- https://review.openstack.org/#/c/567682/1/api-ref/source/os-fping.inc@4 Change-Id: I47eaf08a9c06e33d707fdfe88f6771e165f377b5
111 lines
2.4 KiB
ReStructuredText
111 lines
2.4 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
==========================
|
|
Ping instances (os-fping)
|
|
==========================
|
|
|
|
.. warning::
|
|
|
|
This API only works with ``nova-network`` which is
|
|
deprecated. It should be avoided in any new applications.
|
|
These will fail with a 404 starting from microversion 2.36.
|
|
It was removed in the 18.0.0 Rocky release.
|
|
|
|
Pings instances and reports which instances are alive.
|
|
|
|
Ping Instances
|
|
==============
|
|
|
|
.. rest_method:: GET /os-fping
|
|
|
|
Runs the fping utility to ping instances and reports which instances are alive.
|
|
|
|
Specify the ``all_tenants=1`` query parameter to ping instances for all tenants. For example:
|
|
|
|
::
|
|
|
|
GET /os-fping?all_tenants=1
|
|
|
|
Specify the ``include`` and ``exclude`` query parameters to filter the results. For example:
|
|
|
|
::
|
|
|
|
GET /os-fping?all_tenants=1&include=uuid1,uuid2&exclude=uuid3,uuid4
|
|
|
|
Policy defaults enable only users with the administrative role or the
|
|
owner of the server to perform this operation. Cloud providers can
|
|
change these permissions through the ``policy.json`` file.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: serviceUnavailable(503), unauthorized(401), forbidden(403),
|
|
itemNotFound(404), gone(410)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
- all_tenants: all_tenants
|
|
- include: include
|
|
- exclude: exclude
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- servers: servers
|
|
- alive: alive
|
|
- id: server_id
|
|
- project_id: project_id
|
|
|
|
|
|
|
|
|
**Example Ping Instances**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-fping/fping-get-resp.json
|
|
:language: javascript
|
|
|
|
Ping An Instance
|
|
================
|
|
|
|
.. rest_method:: GET /os-fping/{instance_id}
|
|
|
|
Runs the fping utility to ping an instance and reports whether the instance is alive.
|
|
|
|
Policy defaults enable only users with the administrative role or the
|
|
owner of the server to perform this operation. Cloud providers can
|
|
change these permissions through the ``policy.json`` file.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: serviceUnavailable(503), unauthorized(401), forbidden(403),
|
|
itemNotFound(404), gone(410)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
- instance_id: instance_id
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server: server
|
|
- alive: alive
|
|
- id: server_id
|
|
- project_id: project_id
|
|
|
|
|
|
|
|
|
**Example Ping An Instance**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-fping/fping-get-details-resp.json
|
|
:language: javascript
|