nova/api-guide/source/request_and_response_formats.rst
Sean Dague 44a36ba7af simplify the request / response format document
This document previously existed to explain how to use either
application/json or application/xml with Nova. It's mostly confusing
in it's current state, and we're correctly defaulting to
application/json on request and response now.

Just remove most of what's confusing, users don't need to send
headers, we only do one thing now.

Change-Id: I597aeab73f1075f400f053016b4ea7bda01893a5
2015-12-14 12:35:14 -05:00

1.2 KiB

Request and response formats

The OpenStack Compute API only supports JSON request and response formats, with a mime-type of application/json. As there is only one supported content type, all content is assumed to be application/json in both request and response formats.

Request and response examples

The examples below show a request body in JSON format.

Example: JSON request with headers

POST /v2/010101/servers HTTP/1.1
 Host: servers.api.openstack.org
 X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
{
    "server": {
        "name": "server-test-1",
        "imageRef": "b5660a6e-4b46-4be3-9707-6b47221b454f",
        "flavorRef": "2",
        "max_count": 1,
        "min_count": 1,
        "networks": [
            {
                "uuid": "d32019d3-bc6e-4319-9c1d-6722fc136a22"
            }
        ],
        "security_groups": [
            {
                "name": "default"
            },
            {
                "name": "another-secgroup-name"
            }
        ]
    }
}