Media Detach from Server


Detach media from the Baremetal Server associated with server_id. This request will be accepted only when the task_state is None.


  • Detach

API Operation Object

  • None

Synchronous / Asynchronous

  • Asynchronous


HTTP Request Method

  • POST

HTTP Request Path


HTTP Request Header

Accept: application/json
Content-Type: application/json
X-Auth-Token: <token>

HTTP Request Body


  "media-detach": {
    "imageRef": "<uuid>"

Request Parameter

Input Parameters
name style format description required/optional default value action for invalid parameter response code for invalid parameter
tenant_id URL UUID ID for the tenant. required - Terminate 403, 404
server_id URL UUID ID for the server. required - Terminate 404
token Header Authentication token string Keystone authentication token. required - Terminate 401
media-detach Request Media-Detach This attribute is User Image ID. required - Terminate 400, 404


HTTP Response Header


HTTP/1.1 200 OK
  • <response_code>: see “HTTP Responses” section
  • <message>: message based on the response code

Response Code

Response Codes
response code condition
200 normal end
400 specified parameter is invalid
401 unauthorized
403 tenant is not available
404 not found a specified item
405 request URL or method is invalid
409 conflict server action requests. request will be accepted only when the task_state is None
415 bad media type
500 compute fault. If an error other than above has occurred, the response code is always 500.

HTTP Response Body

  • None

Sample Request and Response

Sample API Request

Request URI

Request Header

POST v2/b322a85578de48beba0f92acce57869b/servers/c880a4b5-0230-4925-a8f5-16fb48249275/action HTTP/1.1
User-Agent: curl/7.35.0
Accept: application/json
Content-Type: application/json
X-Auth-Token: 62d528dc0cca4827b0ed465efe1c2588

Request Body

    "media-detach": {
        "imageRef": "3339fd5f-ec06-4ef8-9337-c1c70218a748"

Sample API Response

Response Header

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <content-length>
Date: Thu, 17 Jul 2014 04:21:06 GMT

Response Body

  • None