From 1a5b0c0133ad09e9c34fdf93582db2c78485d6ff Mon Sep 17 00:00:00 2001
From: TommyLike <tommylikehu@gmail.com>
Date: Wed, 16 May 2018 15:29:09 +0800
Subject: [PATCH] Fix create backup API document

Make 'snapshot_id' optional as well as
reword parameter description.

Change-Id: I9ee404a8db5320d2a4cd7b50c2166446169bbba5
---
 api-ref/source/v2/parameters.yaml | 2 +-
 api-ref/source/v3/ext-backups.inc | 2 +-
 api-ref/source/v3/parameters.yaml | 6 ++----
 3 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/api-ref/source/v2/parameters.yaml b/api-ref/source/v2/parameters.yaml
index 843dec23800..055124c975f 100644
--- a/api-ref/source/v2/parameters.yaml
+++ b/api-ref/source/v2/parameters.yaml
@@ -1470,7 +1470,7 @@ snapshot_id_2:
   description: |
     The UUID of the source volume snapshot.
   in: body
-  required: true
+  required: false
   type: string
 source_cgid:
   description: |
diff --git a/api-ref/source/v3/ext-backups.inc b/api-ref/source/v3/ext-backups.inc
index 48ef410a3c3..8b9674d55cc 100644
--- a/api-ref/source/v3/ext-backups.inc
+++ b/api-ref/source/v3/ext-backups.inc
@@ -263,7 +263,7 @@ Create a backup
 
 .. rest_method::  POST /v3/{project_id}/backups
 
-Creates a Block Storage backup from a volume.
+Creates a Block Storage backup from a volume or snapshot.
 
 Response codes
 --------------
diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 161e9800ac7..0b7a821cc82 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -2398,11 +2398,9 @@ snapshot_id_2:
   type: string
 snapshot_id_3:
   description: |
-    The UUID of the source volume snapshot. The API
-    creates a new volume snapshot with the same size as the source
-    volume snapshot unless a larger size is requested.
+    The UUID of the source snapshot that you want to back up.
   in: body
-  required: true
+  required: false
   type: string
 snapshot_id_4:
   description: |