2016-04-12 09:03:46 -04:00
|
|
|
|
.. -*- rst -*-
|
2016-04-20 16:10:51 -04:00
|
|
|
|
.. needs:body_verification
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
===========================================
|
|
|
|
|
Servers - run an action (servers, action)
|
|
|
|
|
===========================================
|
|
|
|
|
|
2016-05-11 16:02:28 +05:30
|
|
|
|
Enables all users to perform an action on a server. Specify the action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
in the request body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
You can associate a fixed or floating IP address with a server,
|
|
|
|
|
or disassociate a fixed or floating IP address from a server.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
You can attach a volume to a server.
|
|
|
|
|
|
2017-04-25 12:05:48 -04:00
|
|
|
|
You can create an image from a server, create a backup of a server,
|
|
|
|
|
evacuate a server from a failed host to a new host, and force-delete a
|
|
|
|
|
server before deferred cleanup.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
You can lock, pause, reboot, rebuild, rescue, resize, resume, confirm
|
|
|
|
|
the resize of, revert a pending resize for, shelve, shelf-offload,
|
|
|
|
|
unshelve, start, stop, unlock, unpause, and unrescue a server. You can
|
|
|
|
|
also change the password of the server and add a security group to or
|
|
|
|
|
remove a security group from a server. You can also trigger a crash dump
|
|
|
|
|
into a server since Mitaka release.
|
|
|
|
|
|
|
|
|
|
You can get an RDP, serial, SPICE, or VNC console for a server.
|
|
|
|
|
|
2017-04-17 15:45:17 +08:00
|
|
|
|
Add (Associate) Floating Ip (addFloatingIp Action) (DEPRECATED)
|
|
|
|
|
================================================================
|
|
|
|
|
|
|
|
|
|
.. warning:: This API is deprecated and will fail with a 404 starting
|
|
|
|
|
from microversion 2.44. This is replaced with using the
|
|
|
|
|
Neutron networking service API.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Adds a floating IP address to a server, which associates
|
|
|
|
|
that address with the server.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
A pool of floating IP addresses, configured by the cloud administrator,
|
|
|
|
|
is available in OpenStack Compute. The project quota defines the maximum
|
|
|
|
|
number of floating IP addresses that you can allocate to the project.
|
|
|
|
|
After you `create (allocate) a floating IPaddress
|
2016-08-23 15:54:41 +07:00
|
|
|
|
<http://developer.openstack.org/api-ref/compute/#create-allocate-floating-ip-address>`__
|
2016-05-11 19:04:13 +00:00
|
|
|
|
for a project, you can associate that address with the server. Specify
|
|
|
|
|
the ``addFloatingIp`` action in the request body.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If an instance is connected to multiple networks, you can associate a
|
|
|
|
|
floating IP address with a specific fixed IP address by using the
|
|
|
|
|
optional ``fixed_address`` parameter.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The server must exist.
|
|
|
|
|
|
2016-08-31 08:08:49 -05:00
|
|
|
|
You can only add a floating IP address to the server when its status is ``ACTIVE`` or ``STOPPED``
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- addFloatingIp: addFloatingIp
|
|
|
|
|
- address: address
|
|
|
|
|
- fixed_address: fixed_address
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Add (Associate) Floating Ip (addFloatingIp Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-04-04 15:02:47 +09:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-addfloatingip-req.json
|
2017-03-16 19:15:18 +08:00
|
|
|
|
:language: javascript
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Add Security Group To A Server (addSecurityGroup Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
========================================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Adds a security group to a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``addSecurityGroup`` action in the request body.
|
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- addSecurityGroup: addSecurityGroup
|
|
|
|
|
- name: name
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Add Security Group To A Server (addSecurityGroup Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-security-groups/security-group-add-post-req.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Change Administrative Password (changePassword Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
======================================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Changes the administrative password for a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``changePassword`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409), notImplemented(501)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- changePassword: changePassword
|
2017-04-11 15:12:23 +09:00
|
|
|
|
- adminPass: adminPass_change_password
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Change Administrative Password (changePassword Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-admin-password/admin-password-change-password.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Confirm Resized Server (confirmResize Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=============================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Confirms a pending resize action for a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``confirmResize`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
After you make this request, you typically must keep polling the server
|
|
|
|
|
status to determine whether the request succeeded. A successfully
|
|
|
|
|
confirming resize operation shows a status of ``ACTIVE`` or ``SHUTOFF``
|
|
|
|
|
and a migration_status of ``confirmed``. You can also see the resized
|
|
|
|
|
server in the compute node that OpenStack Compute manages.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
You can only confirm the resized server where the status is
|
|
|
|
|
``VERIFY_RESIZED``, the vm_status is ``RESIZED``, and the
|
|
|
|
|
migration_status is ``finished`` or ``confirming``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server is locked, you must have administrator privileges
|
|
|
|
|
to confirm the server.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Troubleshooting**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server status remains ``RESIZED``, the request failed. Ensure you
|
|
|
|
|
meet the preconditions and run the request again. If the request fails
|
|
|
|
|
again, investigate the compute back end or ask your cloud provider.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 204
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- confirmResize: confirmResize
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Confirm Resized Server (confirmResize Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-confirm-resize.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2017-04-25 12:05:48 -04:00
|
|
|
|
Create Server Back Up (createBackup Action)
|
|
|
|
|
===========================================
|
|
|
|
|
|
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
|
|
|
|
|
|
|
|
|
Creates a back up of a server.
|
|
|
|
|
|
|
|
|
|
.. note:: This API is not supported for volume-backed instances.
|
|
|
|
|
|
|
|
|
|
Specify the ``createBackup`` action in the request body.
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Starting from version 2.39 the image quota enforcement with Nova `metadata`
|
|
|
|
|
is removed and quota checks should be performed using Glance API directly.
|
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
|
|
|
|
|
|
|
|
|
Request
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
|
|
- server_id: server_id_path
|
|
|
|
|
- createBackup: createBackup
|
|
|
|
|
- name: backup_name
|
|
|
|
|
- backup_type: backup_type
|
|
|
|
|
- rotation: backup_rotation
|
|
|
|
|
- metadata: metadata
|
|
|
|
|
|
2017-04-20 16:46:24 -04:00
|
|
|
|
**Example Create Server Back Up (createBackup Action)**
|
2017-04-25 12:05:48 -04:00
|
|
|
|
|
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-create-backup/create-backup-req.json
|
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2017-04-20 16:46:24 -04:00
|
|
|
|
- Location: image_location
|
|
|
|
|
- image_id: snapshot_id_resp_2_45
|
|
|
|
|
|
|
|
|
|
**Example Create Server Back Up (v2.45)**
|
|
|
|
|
|
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-create-backup/v2.45/create-backup-resp.json
|
|
|
|
|
:language: javascript
|
2017-04-25 12:05:48 -04:00
|
|
|
|
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Create Image (createImage Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Creates an image from a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``createImage`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
After you make this request, you typically must keep polling the status of
|
|
|
|
|
the created image to determine whether the request succeeded.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the operation succeeds, the created image has a status of ``active`` and
|
|
|
|
|
the server status returns to the original status. You can also see the new
|
|
|
|
|
image in the image back end that OpenStack Image service manages.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-12-01 18:37:28 +03:00
|
|
|
|
.. note::
|
|
|
|
|
Starting from version 2.39 the image quota enforcement with Nova `metadata`
|
|
|
|
|
is removed and quota checks should be performed using Glance API directly.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The server must exist.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
You can only create a new image from the server when its status is ``ACTIVE``,
|
|
|
|
|
``SHUTOFF``, ``PAUSED``, or ``SUSPENDED``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The connection to the Image service is valid.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Troubleshooting**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the image status remains uploading or shows another error status,
|
|
|
|
|
the request failed. Ensure you meet the preconditions and run the request
|
|
|
|
|
again. If the request fails again, investigate the image back end.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server status does not go back to an original server's status,
|
|
|
|
|
the request failed. Ensure you meet the preconditions, or check if
|
|
|
|
|
there is another operation that causes race conditions for the server,
|
|
|
|
|
then run the request again. If the request fails again, investigate the
|
|
|
|
|
compute back end or ask your cloud provider.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the request fails due to an error on OpenStack Compute service, the image
|
|
|
|
|
is purged from the image store that OpenStack Image service manages. Ensure
|
|
|
|
|
you meet the preconditions and run the request again. If the request fails
|
|
|
|
|
again, investigate OpenStack Compute service or ask your cloud provider.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- createImage: createImage
|
2017-04-11 15:12:23 +09:00
|
|
|
|
- name: image_name
|
|
|
|
|
- metadata: image_metadata
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Create Image (createImage Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-create-image.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-02-24 09:45:59 +08:00
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2017-04-11 15:12:23 +09:00
|
|
|
|
- Location: image_location
|
2017-04-20 16:46:24 -04:00
|
|
|
|
- image_id: snapshot_id_resp_2_45
|
|
|
|
|
|
|
|
|
|
**Example Create Image (v2.45)**
|
|
|
|
|
|
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/v2.45/server-action-create-image-resp.json
|
|
|
|
|
:language: javascript
|
2016-10-10 14:50:17 -04:00
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Lock Server (lock Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=========================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Locks a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``lock`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- lock: lock
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Lock Server (lock Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-lock-server/lock-server.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Pause Server (pause Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
===========================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Pauses a server. Changes its status to ``PAUSED``.
|
|
|
|
|
|
|
|
|
|
Specify the ``pause`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409), notImplemented(501)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- pause: pause
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Pause Server (pause Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-pause-server/pause-server.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Reboot Server (reboot Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Reboots a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``reboot`` action in the request body.
|
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- reboot: reboot
|
2017-04-11 16:52:47 +09:00
|
|
|
|
- type: reboot_type
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Reboot Server (reboot Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-reboot.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Rebuild Server (rebuild Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
===============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Rebuilds a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``rebuild`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
To rebuild the server with preservation of the ephemeral partition,
|
|
|
|
|
set the ``preserve_ephemeral`` parameter to ``true``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400),unauthorized(401), forbidden(403),
|
2017-03-30 13:16:02 +09:00
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- rebuild: rebuild
|
2017-04-07 15:28:12 +09:00
|
|
|
|
- imageRef: imageRef_rebuild
|
|
|
|
|
- accessIPv4: accessIPv4_in
|
|
|
|
|
- accessIPv6: accessIPv6_in
|
2017-03-24 07:11:25 +00:00
|
|
|
|
- adminPass: adminPass_request
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- metadata: metadata
|
2017-04-07 15:28:12 +09:00
|
|
|
|
- name: server_name_optional
|
|
|
|
|
- OS-DCF:diskConfig: OS-DCF:diskConfig
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- personality: personality
|
2017-04-07 15:28:12 +09:00
|
|
|
|
- personality.path: path
|
|
|
|
|
- personality.contents: contents
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- preserve_ephemeral: preserve_ephemeral
|
2017-04-07 15:28:12 +09:00
|
|
|
|
- description: server_description
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-02-13 09:55:01 -06:00
|
|
|
|
**Example Rebuild Server (rebuild Action) (v2.47)**
|
2016-04-18 07:15:10 -04:00
|
|
|
|
|
2017-02-13 09:55:01 -06:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/v2.47/server-action-rebuild.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-04-07 15:28:12 +09:00
|
|
|
|
.. rest_parameters:: parameters.yaml
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-04-07 15:28:12 +09:00
|
|
|
|
- Location: server_location
|
|
|
|
|
- server: server
|
|
|
|
|
- accessIPv4: accessIPv4
|
|
|
|
|
- accessIPv6: accessIPv6
|
|
|
|
|
- addresses: addresses_obj
|
|
|
|
|
- adminPass: adminPass_response
|
|
|
|
|
- created: created
|
2017-02-13 09:55:01 -06:00
|
|
|
|
- flavor: flavor_server
|
|
|
|
|
- flavor.id: flavor_id_body_2_46
|
|
|
|
|
- flavor.links: flavor_links_2_46
|
|
|
|
|
- flavor.vcpus: flavor_cpus_2_47
|
|
|
|
|
- flavor.ram: flavor_ram_2_47
|
|
|
|
|
- flavor.disk: flavor_disk_2_47
|
|
|
|
|
- flavor.ephemeral: flavor_ephem_disk_2_47
|
|
|
|
|
- flavor.swap: flavor_swap_2_47
|
|
|
|
|
- flavor.original_name: flavor_original_name
|
|
|
|
|
- flavor.extra_specs: extra_specs_2_47
|
|
|
|
|
- flavor.extra_specs.key: flavor_extra_spec_key_2_47
|
|
|
|
|
- flavor.extra_specs.value: flavor_extra_spec_value_2_47
|
2017-04-07 15:28:12 +09:00
|
|
|
|
- hostId: hostId
|
|
|
|
|
- id: server_id
|
|
|
|
|
- image: image
|
|
|
|
|
- image.id: image_id_body
|
|
|
|
|
- image.links: links
|
|
|
|
|
- links: server_links
|
|
|
|
|
- metadata: metadata_object
|
|
|
|
|
- name: server_name
|
|
|
|
|
- OS-DCF:diskConfig: disk_config
|
|
|
|
|
- progress: progress
|
|
|
|
|
- status: server_status
|
|
|
|
|
- tenant_id: tenant_id_body
|
|
|
|
|
- updated: updated
|
|
|
|
|
- user_id: user_id
|
|
|
|
|
- locked: locked
|
|
|
|
|
- description: server_description_resp
|
|
|
|
|
- tags: tags
|
|
|
|
|
|
2017-02-13 09:55:01 -06:00
|
|
|
|
**Example Rebuild Server (rebuild Action) (v2.47)**
|
2017-04-07 15:28:12 +09:00
|
|
|
|
|
2017-02-13 09:55:01 -06:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/v2.47/server-action-rebuild-resp.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
2017-04-17 15:45:17 +08:00
|
|
|
|
Remove (Disassociate) Floating Ip (removeFloatingIp Action) (DEPRECATED)
|
|
|
|
|
=========================================================================
|
|
|
|
|
|
|
|
|
|
.. warning:: This API is deprecated and will fail with a 404 starting
|
|
|
|
|
from microversion 2.44. This is replaced with using the
|
|
|
|
|
Neutron networking service API.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Removes, or disassociates, a floating IP address from a server.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
The IP address is returned to the pool of IP addresses that is available
|
|
|
|
|
for all projects. When you remove a floating IP address and that IP address
|
|
|
|
|
is still associated with a running instance, it is automatically
|
|
|
|
|
disassociated from that instance.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Specify the ``removeFloatingIp`` action in the request body.
|
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- removeFloatingIp: removeFloatingIp
|
|
|
|
|
- address: address
|
|
|
|
|
|
2017-03-16 19:15:18 +08:00
|
|
|
|
**Example Remove (Disassociate) Floating Ip (removeFloatingIp Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-04-04 15:02:47 +09:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-removefloatingip-req.json
|
2017-03-16 19:15:18 +08:00
|
|
|
|
:language: javascript
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Remove Security Group From A Server (removeSecurityGroup Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
================================================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Removes a security group from a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``removeSecurityGroup`` action in the request body.
|
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- removeSecurityGroup: removeSecurityGroup
|
|
|
|
|
- name: name
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Remove Security Group From A Server (removeSecurityGroup Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-security-groups/security-group-remove-post-req.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Rescue Server (rescue Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Puts a server in rescue mode and changes its status to ``RESCUE``.
|
|
|
|
|
|
|
|
|
|
Specify the ``rescue`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If you specify the ``rescue_image_ref`` extended attribute,
|
|
|
|
|
the image is used to rescue the instance. If you omit an image
|
|
|
|
|
reference, the base image reference is used by default.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Asynchronous Postconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
After you successfully rescue a server and make a ``GET
|
|
|
|
|
/servers/{server_id}`` request, its status changes to ``RESCUE``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-03-30 13:16:02 +09:00
|
|
|
|
Normal response codes: 200
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409), notImplemented(501)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- rescue: rescue
|
2017-03-24 07:11:25 +00:00
|
|
|
|
- adminPass: adminPass_rescue_request
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- rescue_image_ref: rescue_image_ref
|
|
|
|
|
|
2017-04-07 15:28:12 +09:00
|
|
|
|
**Example Rescue server (rescue Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-04-07 15:28:12 +09:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-rescue/server-rescue-req-with-image-ref.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2017-03-24 07:11:25 +00:00
|
|
|
|
- adminPass: adminPass_response
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2017-04-07 15:28:12 +09:00
|
|
|
|
**Example Rescue server (rescue Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-20 16:56:47 +09:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-rescue/server-rescue.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Resize Server (resize Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Resizes a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``resize`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
A successfully resized server shows a ``VERIFY_RESIZE`` status,
|
|
|
|
|
``RESIZED`` VM status, and ``finished`` migration status. If you set the
|
|
|
|
|
``resize_confirm_window`` option of the Compute service to an integer value,
|
|
|
|
|
the Compute service automatically confirms the resize operation after
|
|
|
|
|
the set interval in seconds.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
You can only resize a server when its status is ``ACTIVE`` or ``SHUTOFF``.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server is locked, you must have administrator privileges
|
|
|
|
|
to resize the server.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- resize: resize
|
2017-04-11 16:57:39 +09:00
|
|
|
|
- flavorRef: flavorRef_resize
|
|
|
|
|
- OS-DCF:diskConfig: OS-DCF:diskConfig
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Resize Server (Resize Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-resize.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Resume Suspended Server (resume Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=======================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Resumes a suspended server and changes its status to ``ACTIVE``.
|
|
|
|
|
|
|
|
|
|
Specify the ``resume`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- resume: resume
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Resume Suspended Server (Resume Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-suspend-server/server-resume.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Revert Resized Server (revertResize Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
===========================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Cancels and reverts a pending resize action for a server.
|
|
|
|
|
|
|
|
|
|
Specify the ``revertResize`` action in the request body.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-06-16 12:14:42 -04:00
|
|
|
|
You can only revert the resized server where the status is
|
|
|
|
|
``VERIFY_RESIZE`` and the OS-EXT-STS:vm_state is ``resized``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server is locked, you must have administrator privileges to revert
|
|
|
|
|
the resizing.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Asynchronous Postconditions**
|
2016-06-16 12:14:42 -04:00
|
|
|
|
|
|
|
|
|
After you make this request, you typically must keep polling the server status
|
|
|
|
|
to determine whether the request succeeded. A reverting resize operation shows
|
|
|
|
|
a status of ``REVERT_RESIZE`` and a task_state of ``resize_reverting``. If
|
|
|
|
|
successful, the status will return to ``ACTIVE`` or ``SHUTOFF``. You can also
|
|
|
|
|
see the reverted server in the compute node that OpenStack Compute manages.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Troubleshooting**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-06-16 12:14:42 -04:00
|
|
|
|
If the server status remains ``VERIFY_RESIZE``, the request failed. Ensure you
|
|
|
|
|
meet the preconditions and run the request again. If the request fails again,
|
2016-05-11 19:04:13 +00:00
|
|
|
|
investigate the compute back end.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The server is not reverted in the compute node that OpenStack Compute manages.
|
|
|
|
|
|
2016-04-18 16:41:58 -07:00
|
|
|
|
Normal response codes: 202
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403),
|
|
|
|
|
itemNotFound(404), conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- revertResize: revertResize
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Revert Resized Server (revertResize Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-revert-resize.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Start Server (os-start Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
==============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Starts a stopped server and changes its status to ``ACTIVE``.
|
|
|
|
|
|
|
|
|
|
Specify the ``os-start`` action in the request body.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The server status must be ``SHUTOFF``.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server is locked, you must have administrator privileges
|
|
|
|
|
to start the server.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Asynchronous Postconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
After you successfully start a server, its status changes to ``ACTIVE``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Troubleshooting**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server status does not change to ``ACTIVE``, the start operation failed.
|
|
|
|
|
Ensure that you meet the preconditions and run the request again.
|
|
|
|
|
If the request fails again, investigate whether another operation is running
|
|
|
|
|
that causes a race condition.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- os-start: os-start
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Start server**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-start.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Stop Server (os-stop Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Stops a running server and changes its status to ``SHUTOFF``.
|
|
|
|
|
|
|
|
|
|
Specify the ``os-stop`` action in the request body.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The server status must be ``ACTIVE`` or ``ERROR``.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
If the server is locked, you must have administrator privileges
|
|
|
|
|
to stop the server.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Asynchronous Postconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
After you successfully stop a server, its status changes to ``SHUTOFF``.
|
2017-03-15 18:39:38 -07:00
|
|
|
|
This API operation does not delete the server instance data and the data
|
|
|
|
|
will be available again after ``os-start`` action.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- os-stop: os-stop
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Stop server**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/servers/server-action-stop.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Suspend Server (suspend Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
===============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Suspends a server and changes its status to ``SUSPENDED``.
|
|
|
|
|
|
|
|
|
|
Specify the ``suspend`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- suspend: suspend
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Suspend Server (suspend Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-suspend-server/server-suspend.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Unlock Server (unlock Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Unlocks a locked server.
|
|
|
|
|
|
|
|
|
|
Specify the ``unlock`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- unlock: unlock
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Unlock Server (unlock Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-lock-server/unlock-server.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Unpause Server (unpause Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
===============================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Unpauses a paused server and changes its status to ``ACTIVE``.
|
|
|
|
|
|
|
|
|
|
Specify the ``unpause`` action in the request body.
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409), notImplemented(501)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- unpause: unpause
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Unpause Server (unpause Action)**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-pause-server/unpause-server.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Unrescue Server (unrescue Action)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
=================================
|
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
|
.. rest_method:: POST /servers/{server_id}/action
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Unrescues a server. Changes status to ``ACTIVE``.
|
|
|
|
|
|
|
|
|
|
Specify the ``unrescue`` action in the request body.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Preconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
The server must exist.
|
|
|
|
|
|
|
|
|
|
You can only unrescue a server when its status is ``RESCUE``.
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Asynchronous Postconditions**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
After you successfully unrescue a server and make a
|
2016-06-02 08:50:03 -04:00
|
|
|
|
``GET /servers/{server_id}``
|
2016-05-11 19:04:13 +00:00
|
|
|
|
request, its status changes to ``ACTIVE``.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Normal response codes: 202
|
|
|
|
|
|
2016-05-11 19:04:13 +00:00
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404),
|
|
|
|
|
conflict(409), notImplemented(501)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
2016-07-06 16:59:38 +08:00
|
|
|
|
- server_id: server_id_path
|
2016-04-12 09:03:46 -04:00
|
|
|
|
- unrescue: unrescue
|
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
**Example Unrescue server**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
2016-04-18 07:15:10 -04:00
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-rescue/server-unrescue-req.json
|
2016-04-12 09:03:46 -04:00
|
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
|
--------
|
2016-07-06 16:59:38 +08:00
|
|
|
|
|
2016-10-10 14:50:17 -04:00
|
|
|
|
If successful, this method does not return content in the response body.
|