b0e3e8a6a4
Error was "No path parameter ``role_id`` found in rest_parameter stanza.: Basically it means that the parameter role_id is used, but not defined in a corresponding yaml file. Mailing list post on openstack-dev: http://lists.openstack.org/pipermail/openstack-dev/2017-January/110606.html for reference. Change-Id: Id5863a70f2432a2ae22164aa66e29ae739ab3e11
164 lines
2.3 KiB
ReStructuredText
164 lines
2.3 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
=======
|
|
Image
|
|
=======
|
|
|
|
**Introductory Concepts**
|
|
|
|
When you create a server, you can specify a password through the
|
|
optional adminPass attribute. The password must meet the complexity
|
|
requirements set by your OpenStack Compute provider. The server might
|
|
enter an ``ERROR`` state if the complexity requirements are not met. In
|
|
this case, a client might issue a change password action to reset the
|
|
server password.
|
|
|
|
List the Images
|
|
===============
|
|
|
|
.. rest_method:: GET /v3/images/{role_id}/role/{id}/role/{image_id}
|
|
|
|
Short explanation about this GET method.
|
|
|
|
HTTP Status codes
|
|
-----------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
- 201
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 500
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- host: host
|
|
- id: id
|
|
- image_id: image_id
|
|
- name: name
|
|
- role_id: role_id
|
|
|
|
Create an Image
|
|
===============
|
|
|
|
.. rest_method:: POST /images
|
|
|
|
Explantory text about this POST method.
|
|
|
|
List of information:
|
|
|
|
- Item 1
|
|
- Item 2
|
|
- Item 3
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- name: name
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server: server.obj
|
|
- name: name
|
|
|
|
**Example List Servers:**
|
|
|
|
.. literalinclude:: update-server-resp.json
|
|
:language: javascript
|
|
|
|
|
|
Change or Update the Images
|
|
===========================
|
|
|
|
.. rest_method:: PATCH /servers
|
|
|
|
Explantory text about this PATCH method.
|
|
|
|
List of information:
|
|
|
|
- Item 1
|
|
- Item 2
|
|
- Item 3
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- name: name
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server: server.obj
|
|
- name: name
|
|
|
|
**Example List Servers:**
|
|
|
|
.. literalinclude:: update-server-resp.json
|
|
:language: javascript
|
|
|
|
|
|
Change or Update the Images
|
|
===========================
|
|
|
|
.. rest_method:: PUT /images
|
|
|
|
Explantory text about this PUT method.
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- name: name
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- server: server.obj
|
|
- name: name
|
|
|
|
**Example List Servers:**
|
|
|
|
.. literalinclude:: update-server-resp.json
|
|
:language: javascript
|
|
|
|
|
|
Delete an Image
|
|
===============
|
|
|
|
.. rest_method:: DELETE /image/{id}
|
|
|
|
Explain what the DELETE method does here.
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- id: id
|
|
|
|
Response
|
|
--------
|
|
|
|
No content in body of response.
|