From 925dc7aa128d060e0d0f9275a3b1fcdc98eecbf3 Mon Sep 17 00:00:00 2001
From: Matt Riedemann <mriedem@us.ibm.com>
Date: Mon, 14 Nov 2016 16:12:29 -0500
Subject: [PATCH] api-ref: method verification for server-migrations

We don't have any api-ref for server-migrations. os-migrations
is frozen and server-migrations replaces it, but we don't
have any docs for it, so this is a start.

Partial-Bug: #1641713

Part of blueprint api-ref-in-rst-ocata

Change-Id: I3da6ff6a4a0abf2f9c8bae3fb28fe23fdc3b0959
---
 api-ref/source/index.rst             |  1 +
 api-ref/source/server-migrations.inc | 30 ++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 api-ref/source/server-migrations.inc

diff --git a/api-ref/source/index.rst b/api-ref/source/index.rst
index 19b0cb46977f..0848ca9c72b6 100644
--- a/api-ref/source/index.rst
+++ b/api-ref/source/index.rst
@@ -47,6 +47,7 @@ refer to `API guide <http://developer.openstack.org/api-guide/compute/index.html
 .. include:: os-hypervisors.inc
 .. include:: os-instance-usage-audit-log.inc
 .. include:: os-migrations.inc
+.. include:: server-migrations.inc
 .. include:: os-quota-sets.inc
 .. include:: os-server-groups.inc
 .. include:: os-server-tags.inc
diff --git a/api-ref/source/server-migrations.inc b/api-ref/source/server-migrations.inc
new file mode 100644
index 000000000000..e89b4e5d0a20
--- /dev/null
+++ b/api-ref/source/server-migrations.inc
@@ -0,0 +1,30 @@
+.. -*- rst -*-
+.. needs:parameter_verification
+.. needs:example_verification
+.. needs:body_verification
+
+=========================================
+ Server migrations (servers, migrations)
+=========================================
+
+List, show, perform actions on and delete server migrations.
+
+List Migrations
+===============
+
+.. rest_method:: GET /servers/{server_id}/migrations
+
+Show Migration Details
+======================
+
+.. rest_method:: GET /servers/{server_id}/migrations/{migration_id}
+
+Force Migration Complete Action (force_complete Action)
+=======================================================
+
+.. rest_method:: POST /servers/{server_id}/migrations/{migration_id}/action
+
+Delete (Abort) Migration
+========================
+
+.. rest_method:: DELETE /servers/{server_id}/migrations/{migration_id}