From 47b48b99c131e3d6738625edb0a81d52ec40cf76 Mon Sep 17 00:00:00 2001 From: Xiaojun Liao Date: Thu, 16 Nov 2017 18:36:15 +0800 Subject: [PATCH] Fix v3 api-ref for restoring backup are wrongly described In v3 api-ref for restoring backup, the request contents are wrongly described, it is mandatory to specify either the UUID or name of the volume, Actually it's OK if you specify nothing. The name parameter will work only if a new volume is created for restore. Closes-Bug:#1732664 Change-Id: Ia6a9b99df0c7b83999a2e5ac9c945c91b284f807 Signed-off-by: Xiaojun Liao --- api-ref/source/v3/ext-backups.inc | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/api-ref/source/v3/ext-backups.inc b/api-ref/source/v3/ext-backups.inc index b1aa071c2a5..2770631648e 100644 --- a/api-ref/source/v3/ext-backups.inc +++ b/api-ref/source/v3/ext-backups.inc @@ -178,8 +178,14 @@ Restore a backup Restores a Block Storage backup to an existing or new Block Storage volume. -You must specify either the UUID or name of the volume. If you -specify both the UUID and name, the UUID takes priority. +The name parameter will work only if a new volume is created. + +If UUID is specified, the backup will be restored to the specified volume. + +If no existing volume UUID is provided, the backup will be restored to a +new volume matching the size and name of the originally backed up volume. +In this case, if the name parameter is provided, it will be used as the +name of the new volume. Normal response codes: 202