Files
a7fa4f426e4c00725a3470aca2cb81b02d6f8cb8
nova /api-ref /source /os-fping.inc

103 lines
2.1 KiB
PHP
Raw Normal View History

===========================
Ping instances (os-fping)
===========================
Ping Instances
==============
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
owner of the server to perform this operation. Cloud providers can
change these permissions through the ``policy.json`` file.
Normal response codes: 200
Request
.. rest_parameters:: parameters.yaml
- include: include
- exclude: exclude
Response
- servers: servers
- alive: alive
- id: server_id
- project_id: project_id
|
**Example Ping Instances**
Ping An Instance
================
Runs the fping utility to ping an instance and reports whether the instance is alive.
owner of the server to perform this operation. Cloud providers can
change these permissions through the ``policy.json`` file.
Normal response codes: 200
itemNotFound(404)
Request
.. rest_parameters:: parameters.yaml
Response
- server: server
- alive: alive
- id: server_id
- project_id: project_id
|
**Example Ping An Instance**