From 8bb1081fe3c83e99246ff6e997f72c2b64219624 Mon Sep 17 00:00:00 2001 From: Takashi NATSUME Date: Thu, 12 May 2016 08:19:24 +0900 Subject: [PATCH] api-ref: Method verification for os-volume_attachments.inc Change-Id: I560908b28c1193622ee6e042322024fc6d0df5d6 Implements: blueprint api-ref-in-rst --- api-ref/source/os-volume-attachments.inc | 85 +++++++++++++++++++++++- 1 file changed, 84 insertions(+), 1 deletion(-) diff --git a/api-ref/source/os-volume-attachments.inc b/api-ref/source/os-volume-attachments.inc index b9f8e61f01..b1eb0a3bb5 100644 --- a/api-ref/source/os-volume-attachments.inc +++ b/api-ref/source/os-volume-attachments.inc @@ -1,5 +1,4 @@ .. -*- rst -*- -.. needs:method_verification .. needs:parameter_verification .. needs:example_verification .. needs:body_verification @@ -12,3 +11,87 @@ Attaches volumes that are created through the volume API to server instances. Also, lists volume attachments for a server instance, shows details for a volume attachment, and detaches a volume. +List volume attachments for an instance +======================================= + +.. rest_method:: GET /v2.1/{tenant_id}/servers/{server_id}/os-volume_attachments + +List volume attachments for an instance. + +Normal response codes: 200 + +Error response codes: unauthorized(401), forbidden(403), itemNotFound(404) + +Request +------- + +Response +-------- + +Attach a volume to an instance +============================== + +.. rest_method:: POST /v2.1/{tenant_id}/servers/{server_id}/os-volume_attachments + +Attach a volume to an instance. + +Normal response codes: 200 + +Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404), conflict(409) + +Request +------- + +Response +-------- + +Show a detail of a volume attachment +==================================== + +.. rest_method:: GET /v2.1/{tenant_id}/servers/{server_id}/os-volume_attachments/{attachment_id} + +Show a detail of a volume attachment. + +Normal response codes: 200 + +Error response codes: unauthorized(401), forbidden(403), itemNotFound(404) + +Request +------- + +Response +-------- + +Update a volume attachment +========================== + +.. rest_method:: PUT /v2.1/{tenant_id}/servers/{server_id}/os-volume_attachments/{attachment_id} + +Update a volume attachment. + +Normal response codes: 202 + +Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404), conflict(409) + +Request +------- + +Response +-------- + +Detach a volume from an instance +================================ + +.. rest_method:: DELETE /v2.1/{tenant_id}/servers/{server_id}/os-volume_attachments/{attachment_id} + +Detach a volume from an instance. + +Normal response codes: 202 + +Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404), conflict(409) + +Request +------- + +Response +--------