diff --git a/docs/vbs/api-ref/ALL_META.TXT.json b/docs/vbs/api-ref/ALL_META.TXT.json new file mode 100644 index 000000000..e578a4e2b --- /dev/null +++ b/docs/vbs/api-ref/ALL_META.TXT.json @@ -0,0 +1,452 @@ +[ + { + "uri":"en-us_topic_0061309333.html", + "product_code":"vbs", + "code":"1", + "des":"Public cloud APIs comply with the RESTful API design principles. REST-based Web services are organized into resources. Each resource is identified by one or more Uniform ", + "doc_type":"api", + "kw":"API Usage Guidelines,API Reference", + "title":"API Usage Guidelines", + "githuburl":"" + }, + { + "uri":"en-us_topic_0134476439.html", + "product_code":"vbs", + "code":"2", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"API Description", + "title":"API Description", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237254.html", + "product_code":"vbs", + "code":"3", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"VBS Backups", + "title":"VBS Backups", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237255.html", + "product_code":"vbs", + "code":"4", + "des":"This API is used to create a VBS backup.If the API is successfully called, the backup task is successfully delivered. You can query the backup status by using the API for", + "doc_type":"api", + "kw":"Creating a VBS Backup,VBS Backups,API Reference", + "title":"Creating a VBS Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237256.html", + "product_code":"vbs", + "code":"5", + "des":"This API is used to delete a VBS backup. This API is deprecated. You are advised to use the API described in Deleting a VBS Backup (Native OpenStack API) to delete a back", + "doc_type":"api", + "kw":"Deleting a VBS Backup (Deprecated),VBS Backups,API Reference", + "title":"Deleting a VBS Backup (Deprecated)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237257.html", + "product_code":"vbs", + "code":"6", + "des":"This API is used to restore a disk using a VBS backup.URI formatPOST /v2/{project_id}/cloudbackups/{backup_id}/restorePOST /v2/{project_id}/cloudbackups/{backup_id}/res", + "doc_type":"api", + "kw":"Restoring a Disk Using a VBS Backup,VBS Backups,API Reference", + "title":"Restoring a Disk Using a VBS Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060614329.html", + "product_code":"vbs", + "code":"7", + "des":"This API is used to create a VBS backup.URI formatPOST /v2/{project_id}/backupsPOST /v2/{project_id}/backupsParameter descriptionParameterMandatoryDescriptionproject_idYe", + "doc_type":"api", + "kw":"Creating a VBS Backup (Native OpenStack API),VBS Backups,API Reference", + "title":"Creating a VBS Backup (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0143705534.html", + "product_code":"vbs", + "code":"8", + "des":"This API is used to create a VBS backup.URI formatPOST /v3/{project_id}/backupsPOST /v3/{project_id}/backupsParameter descriptionParameterMandatoryDescriptionproject_idYe", + "doc_type":"api", + "kw":"Creating a VBS Backup (Native OpenStack V3 API),VBS Backups,API Reference", + "title":"Creating a VBS Backup (Native OpenStack V3 API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237258.html", + "product_code":"vbs", + "code":"9", + "des":"This API is used to query summary information about VBS backups.URI formatGET /v2/{project_id}/backupsGET /v2/{project_id}/backupsParameter descriptionParameterMandatoryD", + "doc_type":"api", + "kw":"Querying Summary Information About VBS Backups (Native OpenStack API),VBS Backups,API Reference", + "title":"Querying Summary Information About VBS Backups (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0143705535.html", + "product_code":"vbs", + "code":"10", + "des":"This API is used to query summary information about VBS backups.URI formatGET /v3/{project_id}/backupsGET /v3/{project_id}/backupsParameter descriptionParameterMandatoryD", + "doc_type":"api", + "kw":"Querying Summary Information About VBS Backups (Native OpenStack V3 API),VBS Backups,API Reference", + "title":"Querying Summary Information About VBS Backups (Native OpenStack V3 API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237259.html", + "product_code":"vbs", + "code":"11", + "des":"This API is used to query the details about VBS backups.URI formatGET /v2/{project_id}/backups/detailGET /v2/{project_id}/backups/detailParameter descriptionParameterMand", + "doc_type":"api", + "kw":"Querying Details About VBS Backups (Native OpenStack API),VBS Backups,API Reference", + "title":"Querying Details About VBS Backups (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0143705536.html", + "product_code":"vbs", + "code":"12", + "des":"This API is used to query the details about VBS backups.URI formatGET /v3/{project_id}/backups/detailGET /v3/{project_id}/backups/detailParameter descriptionParameterMand", + "doc_type":"api", + "kw":"Querying Details About VBS Backups (Native OpenStack V3 API),VBS Backups,API Reference", + "title":"Querying Details About VBS Backups (Native OpenStack V3 API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237260.html", + "product_code":"vbs", + "code":"13", + "des":"This API is used to query details about a VBS backup.URI formatGET /v2/{project_id}/backups/{backup_id}GET /v2/{project_id}/backups/{backup_id}Parameter descriptionParame", + "doc_type":"api", + "kw":"Querying Details About a VBS Backup (Native OpenStack API),VBS Backups,API Reference", + "title":"Querying Details About a VBS Backup (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0143705537.html", + "product_code":"vbs", + "code":"14", + "des":"This API is used to query details about a VBS backup.URI formatGET /v3/{project_id}/backups/{backup_id}GET /v3/{project_id}/backups/{backup_id}Parameter descriptionParame", + "doc_type":"api", + "kw":"Querying Details About a VBS Backup (Native OpenStack V3 API),VBS Backups,API Reference", + "title":"Querying Details About a VBS Backup (Native OpenStack V3 API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0020237251.html", + "product_code":"vbs", + "code":"15", + "des":"This API is used to query the execution status of a job, such as VBS backup creation, VBS backup deletion, and VBS backup-based disk restoration.URI formatGET /v1/{projec", + "doc_type":"api", + "kw":"Querying the Job Status,VBS Backups,API Reference", + "title":"Querying the Job Status", + "githuburl":"" + }, + { + "uri":"en-us_topic_0049453221.html", + "product_code":"vbs", + "code":"16", + "des":"This API is used to delete a VBS backup.URI formatDELETE /v2/{project_id}/backups/{backup_id}DELETE /v2/{project_id}/backups/{backup_id}Parameter descriptionParameterMand", + "doc_type":"api", + "kw":"Deleting a VBS Backup (Native OpenStack API),VBS Backups,API Reference", + "title":"Deleting a VBS Backup (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0143705538.html", + "product_code":"vbs", + "code":"17", + "des":"This API is used to delete a VBS backup.URI formatDELETE /v3/{project_id}/backups/{backup_id}DELETE /v3/{project_id}/backups/{backup_id}Parameter descriptionParameterMand", + "doc_type":"api", + "kw":"Deleting a VBS Backup (Native OpenStack V3 API),VBS Backups,API Reference", + "title":"Deleting a VBS Backup (Native OpenStack V3 API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0067142129.html", + "product_code":"vbs", + "code":"18", + "des":"This API is used to restore a disk using a VBS backup.URI formatPOST /v2/{project_id}/backups/{backup_id}/restorePOST /v2/{project_id}/backups/{backup_id}/restoreParamete", + "doc_type":"api", + "kw":"Restoring a Disk Using a VBS Backup (Native OpenStack API),VBS Backups,API Reference", + "title":"Restoring a Disk Using a VBS Backup (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0143705539.html", + "product_code":"vbs", + "code":"19", + "des":"This API is used to restore a disk using a VBS backup.URI formatPOST /v3/{project_id}/backups/{backup_id}/restorePOST /v3/{project_id}/backups/{backup_id}/restoreParamete", + "doc_type":"api", + "kw":"Restoring a Disk Using a VBS Backup (Native OpenStack V3 API),VBS Backups,API Reference", + "title":"Restoring a Disk Using a VBS Backup (Native OpenStack V3 API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0078214151.html", + "product_code":"vbs", + "code":"20", + "des":"This API is used to share a backup to another project.URI formatPOST /v2/{project_id}/os-vendor-backup-sharingPOST /v2/{project_id}/os-vendor-backup-sharingParameter desc", + "doc_type":"api", + "kw":"Sharing a Backup,VBS Backups,API Reference", + "title":"Sharing a Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0078214152.html", + "product_code":"vbs", + "code":"21", + "des":"This API is used to cancel the sharing of a backup.URI formatDELETE /v2/{project_id}/os-vendor-backup-sharing/{id}DELETE /v2/{project_id}/os-vendor-backup-sharing/{id}Par", + "doc_type":"api", + "kw":"Canceling Sharing of a Backup,VBS Backups,API Reference", + "title":"Canceling Sharing of a Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0078214153.html", + "product_code":"vbs", + "code":"22", + "des":"This API is used to query backup sharings.URI formatGET /v2/{project_id}/os-vendor-backup-sharing/detailGET /v2/{project_id}/os-vendor-backup-sharing/detailParameter desc", + "doc_type":"api", + "kw":"Querying Backup Sharings,VBS Backups,API Reference", + "title":"Querying Backup Sharings", + "githuburl":"" + }, + { + "uri":"en-us_topic_0078214154.html", + "product_code":"vbs", + "code":"23", + "des":"This API is used to count backup sharings with conditions.URI formatGET /v2/{project_id}/os-vendor-backup-sharing/countGET /v2/{project_id}/os-vendor-backup-sharing/count", + "doc_type":"api", + "kw":"Counting Backup Sharings,VBS Backups,API Reference", + "title":"Counting Backup Sharings", + "githuburl":"" + }, + { + "uri":"en-us_topic_0078214155.html", + "product_code":"vbs", + "code":"24", + "des":"This API is used to query details about a backup sharing.URI formatGET /v2/{project_id}/os-vendor-backup-sharing/{id}GET /v2/{project_id}/os-vendor-backup-sharing/{id}Par", + "doc_type":"api", + "kw":"Querying Details About a Backup Sharing,VBS Backups,API Reference", + "title":"Querying Details About a Backup Sharing", + "githuburl":"" + }, + { + "uri":"en-us_topic_0113236392.html", + "product_code":"vbs", + "code":"25", + "des":"This API is used to query tenant quotas.URIGET /v2/{project_id}/cloudbackups/quotaGET /v2/{project_id}/cloudbackups/quotaParameter descriptionParameterMandatoryDescriptio", + "doc_type":"api", + "kw":"Querying Quotas,VBS Backups,API Reference", + "title":"Querying Quotas", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410516.html", + "product_code":"vbs", + "code":"26", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Backup Policies", + "title":"Backup Policies", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410517.html", + "product_code":"vbs", + "code":"27", + "des":"This API is used to create a backup policy. A tenant can create a maximum of 10 backup policies.URI formatPOST /v2/{project_id}/backuppolicyPOST /v2/{project_id}/backuppo", + "doc_type":"api", + "kw":"Creating a Backup Policy,Backup Policies,API Reference", + "title":"Creating a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410558.html", + "product_code":"vbs", + "code":"28", + "des":"This API is used to query all backup policies of a tenant.URI formatGET /v2/{project_id}/backuppolicyGET /v2/{project_id}/backuppolicyParameter descriptionParameterMandat", + "doc_type":"api", + "kw":"Querying Backup Policies,Backup Policies,API Reference", + "title":"Querying Backup Policies", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410559.html", + "product_code":"vbs", + "code":"29", + "des":"This API is used to modify a backup policy.URI formatPUT /v2/{project_id}/backuppolicy/{policy_id}PUT /v2/{project_id}/backuppolicy/{policy_id}Parameter descriptionParame", + "doc_type":"api", + "kw":"Modifying a Backup Policy,Backup Policies,API Reference", + "title":"Modifying a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410560.html", + "product_code":"vbs", + "code":"30", + "des":"This API is used to delete a backup policy.URI formatDELETE /v2/{project_id}/backuppolicy/{policy_id}DELETE /v2/{project_id}/backuppolicy/{policy_id}Parameter description", + "doc_type":"api", + "kw":"Deleting a Backup Policy,Backup Policies,API Reference", + "title":"Deleting a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410561.html", + "product_code":"vbs", + "code":"31", + "des":"This API is used to associate one or more resources with a backup policy.URI formatPOST /v2/{project_id}/backuppolicyresourcesPOST /v2/{project_id}/backuppolicyresourcesP", + "doc_type":"api", + "kw":"Associating Resources with a Backup Policy,Backup Policies,API Reference", + "title":"Associating Resources with a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410562.html", + "product_code":"vbs", + "code":"32", + "des":"This API is used to disassociate one or more resources from a backup policy.URI formatPOST /v2/{project_id}/backuppolicyresources/{policy_id}/deleted_resourcesPOST /v2/{p", + "doc_type":"api", + "kw":"Disassociating Resources from a Backup Policy,Backup Policies,API Reference", + "title":"Disassociating Resources from a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410563.html", + "product_code":"vbs", + "code":"33", + "des":"This API is used to back up resources associated with a backup policy at once.URI formatPOST /v2/{project_id}/backuppolicy/{policy_id}/actionPOST /v2/{project_id}/backupp", + "doc_type":"api", + "kw":"Executing a Backup Policy At Once,Backup Policies,API Reference", + "title":"Executing a Backup Policy At Once", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043410564.html", + "product_code":"vbs", + "code":"34", + "des":"This API is used to enable or disable a backup policy. After a backup policy is enabled, it will be scheduled based on the specified time. After a backup policy is disabl", + "doc_type":"api", + "kw":"Enabling or Disabling a Backup Policy,Backup Policies,API Reference", + "title":"Enabling or Disabling a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0043430177.html", + "product_code":"vbs", + "code":"35", + "des":"This API is used to query the status of backup jobs triggered by a backup policy.URI formatGET /v2/{project_id}/backuppolicy/{policy_id}/backuptasksGET /v2/{project_id}/b", + "doc_type":"api", + "kw":"Querying Backup Jobs Triggered by a Backup Policy,Backup Policies,API Reference", + "title":"Querying Backup Jobs Triggered by a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098527676.html", + "product_code":"vbs", + "code":"36", + "des":"This API is used to add a tag to a backup policy.URI formatPOST /v2/{project_id}/backuppolicy/{policy_id}/tagsPOST /v2/{project_id}/backuppolicy/{policy_id}/tagsParameter", + "doc_type":"api", + "kw":"Adding a Tag to a Backup Policy,Backup Policies,API Reference", + "title":"Adding a Tag to a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098527677.html", + "product_code":"vbs", + "code":"37", + "des":"This API is used to remove a tag from a backup policy.URI formatDELETE /v2/{project_id}/backuppolicy/{policy_id}/tags/{key}DELETE /v2/{project_id}/backuppolicy/{policy_id", + "doc_type":"api", + "kw":"Removing a Tag from a Backup Policy,Backup Policies,API Reference", + "title":"Removing a Tag from a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0067142130.html", + "product_code":"vbs", + "code":"38", + "des":"This API is used to query tags of all backup policies.URI formatGET /v2/{project_id}/backuppolicy/tagsGET /v2/{project_id}/backuppolicy/tagsParameter descriptionParameter", + "doc_type":"api", + "kw":"Querying All Backup Policy Tags,Backup Policies,API Reference", + "title":"Querying All Backup Policy Tags", + "githuburl":"" + }, + { + "uri":"en-us_topic_0067142131.html", + "product_code":"vbs", + "code":"39", + "des":"This API is used to query the tags of a specific backup policy.URI formatGET /v2/{project_id}/backuppolicy/{policy_id}/tagsGET /v2/{project_id}/backuppolicy/{policy_id}/t", + "doc_type":"api", + "kw":"Querying Tags of a Backup Policy,Backup Policies,API Reference", + "title":"Querying Tags of a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0067142132.html", + "product_code":"vbs", + "code":"40", + "des":"This API is used to update or remove the tags of a backup policy.URI formatPOST /v2/{project_id}/backuppolicy/{policy_id}/tags/actionPOST /v2/{project_id}/backuppolicy/{p", + "doc_type":"api", + "kw":"Batch Updating or Removing Tags of a Backup Policy,Backup Policies,API Reference", + "title":"Batch Updating or Removing Tags of a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0067142133.html", + "product_code":"vbs", + "code":"41", + "des":"This API is used to query backup policies by tag.URI formatPOST /v2/{project_id}/backuppolicy/resource_instances/actionPOST /v2/{project_id}/backuppolicy/resource_instanc", + "doc_type":"api", + "kw":"Querying Backup Policies by Tag,Backup Policies,API Reference", + "title":"Querying Backup Policies by Tag", + "githuburl":"" + }, + { + "uri":"en-us_topic_0022472082.html", + "product_code":"vbs", + "code":"42", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Appendix", + "title":"Appendix", + "githuburl":"" + }, + { + "uri":"en-us_topic_0134480835.html", + "product_code":"vbs", + "code":"43", + "des":"NormalStatus CodeDescription200 OKSpecifies the normal response for the GET and PUT operations.201 CreatedSpecifies the normal response for the POST operation.202 Accepte", + "doc_type":"api", + "kw":"Status Codes,Appendix,API Reference", + "title":"Status Codes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0022472083.html", + "product_code":"vbs", + "code":"44", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Error Codes,Appendix,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0024723797.html", + "product_code":"vbs", + "code":"45", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Change History,API Reference", + "title":"Change History", + "githuburl":"" + } +] \ No newline at end of file diff --git a/docs/vbs/api-ref/CLASS.TXT.json b/docs/vbs/api-ref/CLASS.TXT.json new file mode 100644 index 000000000..accfa8452 --- /dev/null +++ b/docs/vbs/api-ref/CLASS.TXT.json @@ -0,0 +1,407 @@ +[ + { + "desc":"Public cloud APIs comply with the RESTful API design principles. REST-based Web services are organized into resources. Each resource is identified by one or more Uniform ", + "product_code":"vbs", + "title":"API Usage Guidelines", + "uri":"en-us_topic_0061309333.html", + "doc_type":"api", + "p_code":"", + "code":"1" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"vbs", + "title":"API Description", + "uri":"en-us_topic_0134476439.html", + "doc_type":"api", + "p_code":"", + "code":"2" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"vbs", + "title":"VBS Backups", + "uri":"en-us_topic_0020237254.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"This API is used to create a VBS backup.If the API is successfully called, the backup task is successfully delivered. You can query the backup status by using the API for", + "product_code":"vbs", + "title":"Creating a VBS Backup", + "uri":"en-us_topic_0020237255.html", + "doc_type":"api", + "p_code":"3", + "code":"4" + }, + { + "desc":"This API is used to delete a VBS backup. This API is deprecated. You are advised to use the API described in Deleting a VBS Backup (Native OpenStack API) to delete a back", + "product_code":"vbs", + "title":"Deleting a VBS Backup (Deprecated)", + "uri":"en-us_topic_0020237256.html", + "doc_type":"api", + "p_code":"3", + "code":"5" + }, + { + "desc":"This API is used to restore a disk using a VBS backup.URI formatPOST /v2/{project_id}/cloudbackups/{backup_id}/restorePOST /v2/{project_id}/cloudbackups/{backup_id}/res", + "product_code":"vbs", + "title":"Restoring a Disk Using a VBS Backup", + "uri":"en-us_topic_0020237257.html", + "doc_type":"api", + "p_code":"3", + "code":"6" + }, + { + "desc":"This API is used to create a VBS backup.URI formatPOST /v2/{project_id}/backupsPOST /v2/{project_id}/backupsParameter descriptionParameterMandatoryDescriptionproject_idYe", + "product_code":"vbs", + "title":"Creating a VBS Backup (Native OpenStack API)", + "uri":"en-us_topic_0060614329.html", + "doc_type":"api", + "p_code":"3", + "code":"7" + }, + { + "desc":"This API is used to create a VBS backup.URI formatPOST /v3/{project_id}/backupsPOST /v3/{project_id}/backupsParameter descriptionParameterMandatoryDescriptionproject_idYe", + "product_code":"vbs", + "title":"Creating a VBS Backup (Native OpenStack V3 API)", + "uri":"en-us_topic_0143705534.html", + "doc_type":"api", + "p_code":"3", + "code":"8" + }, + { + "desc":"This API is used to query summary information about VBS backups.URI formatGET /v2/{project_id}/backupsGET /v2/{project_id}/backupsParameter descriptionParameterMandatoryD", + "product_code":"vbs", + "title":"Querying Summary Information About VBS Backups (Native OpenStack API)", + "uri":"en-us_topic_0020237258.html", + "doc_type":"api", + "p_code":"3", + "code":"9" + }, + { + "desc":"This API is used to query summary information about VBS backups.URI formatGET /v3/{project_id}/backupsGET /v3/{project_id}/backupsParameter descriptionParameterMandatoryD", + "product_code":"vbs", + "title":"Querying Summary Information About VBS Backups (Native OpenStack V3 API)", + "uri":"en-us_topic_0143705535.html", + "doc_type":"api", + "p_code":"3", + "code":"10" + }, + { + "desc":"This API is used to query the details about VBS backups.URI formatGET /v2/{project_id}/backups/detailGET /v2/{project_id}/backups/detailParameter descriptionParameterMand", + "product_code":"vbs", + "title":"Querying Details About VBS Backups (Native OpenStack API)", + "uri":"en-us_topic_0020237259.html", + "doc_type":"api", + "p_code":"3", + "code":"11" + }, + { + "desc":"This API is used to query the details about VBS backups.URI formatGET /v3/{project_id}/backups/detailGET /v3/{project_id}/backups/detailParameter descriptionParameterMand", + "product_code":"vbs", + "title":"Querying Details About VBS Backups (Native OpenStack V3 API)", + "uri":"en-us_topic_0143705536.html", + "doc_type":"api", + "p_code":"3", + "code":"12" + }, + { + "desc":"This API is used to query details about a VBS backup.URI formatGET /v2/{project_id}/backups/{backup_id}GET /v2/{project_id}/backups/{backup_id}Parameter descriptionParame", + "product_code":"vbs", + "title":"Querying Details About a VBS Backup (Native OpenStack API)", + "uri":"en-us_topic_0020237260.html", + "doc_type":"api", + "p_code":"3", + "code":"13" + }, + { + "desc":"This API is used to query details about a VBS backup.URI formatGET /v3/{project_id}/backups/{backup_id}GET /v3/{project_id}/backups/{backup_id}Parameter descriptionParame", + "product_code":"vbs", + "title":"Querying Details About a VBS Backup (Native OpenStack V3 API)", + "uri":"en-us_topic_0143705537.html", + "doc_type":"api", + "p_code":"3", + "code":"14" + }, + { + "desc":"This API is used to query the execution status of a job, such as VBS backup creation, VBS backup deletion, and VBS backup-based disk restoration.URI formatGET /v1/{projec", + "product_code":"vbs", + "title":"Querying the Job Status", + "uri":"en-us_topic_0020237251.html", + "doc_type":"api", + "p_code":"3", + "code":"15" + }, + { + "desc":"This API is used to delete a VBS backup.URI formatDELETE /v2/{project_id}/backups/{backup_id}DELETE /v2/{project_id}/backups/{backup_id}Parameter descriptionParameterMand", + "product_code":"vbs", + "title":"Deleting a VBS Backup (Native OpenStack API)", + "uri":"en-us_topic_0049453221.html", + "doc_type":"api", + "p_code":"3", + "code":"16" + }, + { + "desc":"This API is used to delete a VBS backup.URI formatDELETE /v3/{project_id}/backups/{backup_id}DELETE /v3/{project_id}/backups/{backup_id}Parameter descriptionParameterMand", + "product_code":"vbs", + "title":"Deleting a VBS Backup (Native OpenStack V3 API)", + "uri":"en-us_topic_0143705538.html", + "doc_type":"api", + "p_code":"3", + "code":"17" + }, + { + "desc":"This API is used to restore a disk using a VBS backup.URI formatPOST /v2/{project_id}/backups/{backup_id}/restorePOST /v2/{project_id}/backups/{backup_id}/restoreParamete", + "product_code":"vbs", + "title":"Restoring a Disk Using a VBS Backup (Native OpenStack API)", + "uri":"en-us_topic_0067142129.html", + "doc_type":"api", + "p_code":"3", + "code":"18" + }, + { + "desc":"This API is used to restore a disk using a VBS backup.URI formatPOST /v3/{project_id}/backups/{backup_id}/restorePOST /v3/{project_id}/backups/{backup_id}/restoreParamete", + "product_code":"vbs", + "title":"Restoring a Disk Using a VBS Backup (Native OpenStack V3 API)", + "uri":"en-us_topic_0143705539.html", + "doc_type":"api", + "p_code":"3", + "code":"19" + }, + { + "desc":"This API is used to share a backup to another project.URI formatPOST /v2/{project_id}/os-vendor-backup-sharingPOST /v2/{project_id}/os-vendor-backup-sharingParameter desc", + "product_code":"vbs", + "title":"Sharing a Backup", + "uri":"en-us_topic_0078214151.html", + "doc_type":"api", + "p_code":"3", + "code":"20" + }, + { + "desc":"This API is used to cancel the sharing of a backup.URI formatDELETE /v2/{project_id}/os-vendor-backup-sharing/{id}DELETE /v2/{project_id}/os-vendor-backup-sharing/{id}Par", + "product_code":"vbs", + "title":"Canceling Sharing of a Backup", + "uri":"en-us_topic_0078214152.html", + "doc_type":"api", + "p_code":"3", + "code":"21" + }, + { + "desc":"This API is used to query backup sharings.URI formatGET /v2/{project_id}/os-vendor-backup-sharing/detailGET /v2/{project_id}/os-vendor-backup-sharing/detailParameter desc", + "product_code":"vbs", + "title":"Querying Backup Sharings", + "uri":"en-us_topic_0078214153.html", + "doc_type":"api", + "p_code":"3", + "code":"22" + }, + { + "desc":"This API is used to count backup sharings with conditions.URI formatGET /v2/{project_id}/os-vendor-backup-sharing/countGET /v2/{project_id}/os-vendor-backup-sharing/count", + "product_code":"vbs", + "title":"Counting Backup Sharings", + "uri":"en-us_topic_0078214154.html", + "doc_type":"api", + "p_code":"3", + "code":"23" + }, + { + "desc":"This API is used to query details about a backup sharing.URI formatGET /v2/{project_id}/os-vendor-backup-sharing/{id}GET /v2/{project_id}/os-vendor-backup-sharing/{id}Par", + "product_code":"vbs", + "title":"Querying Details About a Backup Sharing", + "uri":"en-us_topic_0078214155.html", + "doc_type":"api", + "p_code":"3", + "code":"24" + }, + { + "desc":"This API is used to query tenant quotas.URIGET /v2/{project_id}/cloudbackups/quotaGET /v2/{project_id}/cloudbackups/quotaParameter descriptionParameterMandatoryDescriptio", + "product_code":"vbs", + "title":"Querying Quotas", + "uri":"en-us_topic_0113236392.html", + "doc_type":"api", + "p_code":"3", + "code":"25" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"vbs", + "title":"Backup Policies", + "uri":"en-us_topic_0043410516.html", + "doc_type":"api", + "p_code":"2", + "code":"26" + }, + { + "desc":"This API is used to create a backup policy. A tenant can create a maximum of 10 backup policies.URI formatPOST /v2/{project_id}/backuppolicyPOST /v2/{project_id}/backuppo", + "product_code":"vbs", + "title":"Creating a Backup Policy", + "uri":"en-us_topic_0043410517.html", + "doc_type":"api", + "p_code":"26", + "code":"27" + }, + { + "desc":"This API is used to query all backup policies of a tenant.URI formatGET /v2/{project_id}/backuppolicyGET /v2/{project_id}/backuppolicyParameter descriptionParameterMandat", + "product_code":"vbs", + "title":"Querying Backup Policies", + "uri":"en-us_topic_0043410558.html", + "doc_type":"api", + "p_code":"26", + "code":"28" + }, + { + "desc":"This API is used to modify a backup policy.URI formatPUT /v2/{project_id}/backuppolicy/{policy_id}PUT /v2/{project_id}/backuppolicy/{policy_id}Parameter descriptionParame", + "product_code":"vbs", + "title":"Modifying a Backup Policy", + "uri":"en-us_topic_0043410559.html", + "doc_type":"api", + "p_code":"26", + "code":"29" + }, + { + "desc":"This API is used to delete a backup policy.URI formatDELETE /v2/{project_id}/backuppolicy/{policy_id}DELETE /v2/{project_id}/backuppolicy/{policy_id}Parameter description", + "product_code":"vbs", + "title":"Deleting a Backup Policy", + "uri":"en-us_topic_0043410560.html", + "doc_type":"api", + "p_code":"26", + "code":"30" + }, + { + "desc":"This API is used to associate one or more resources with a backup policy.URI formatPOST /v2/{project_id}/backuppolicyresourcesPOST /v2/{project_id}/backuppolicyresourcesP", + "product_code":"vbs", + "title":"Associating Resources with a Backup Policy", + "uri":"en-us_topic_0043410561.html", + "doc_type":"api", + "p_code":"26", + "code":"31" + }, + { + "desc":"This API is used to disassociate one or more resources from a backup policy.URI formatPOST /v2/{project_id}/backuppolicyresources/{policy_id}/deleted_resourcesPOST /v2/{p", + "product_code":"vbs", + "title":"Disassociating Resources from a Backup Policy", + "uri":"en-us_topic_0043410562.html", + "doc_type":"api", + "p_code":"26", + "code":"32" + }, + { + "desc":"This API is used to back up resources associated with a backup policy at once.URI formatPOST /v2/{project_id}/backuppolicy/{policy_id}/actionPOST /v2/{project_id}/backupp", + "product_code":"vbs", + "title":"Executing a Backup Policy At Once", + "uri":"en-us_topic_0043410563.html", + "doc_type":"api", + "p_code":"26", + "code":"33" + }, + { + "desc":"This API is used to enable or disable a backup policy. After a backup policy is enabled, it will be scheduled based on the specified time. After a backup policy is disabl", + "product_code":"vbs", + "title":"Enabling or Disabling a Backup Policy", + "uri":"en-us_topic_0043410564.html", + "doc_type":"api", + "p_code":"26", + "code":"34" + }, + { + "desc":"This API is used to query the status of backup jobs triggered by a backup policy.URI formatGET /v2/{project_id}/backuppolicy/{policy_id}/backuptasksGET /v2/{project_id}/b", + "product_code":"vbs", + "title":"Querying Backup Jobs Triggered by a Backup Policy", + "uri":"en-us_topic_0043430177.html", + "doc_type":"api", + "p_code":"26", + "code":"35" + }, + { + "desc":"This API is used to add a tag to a backup policy.URI formatPOST /v2/{project_id}/backuppolicy/{policy_id}/tagsPOST /v2/{project_id}/backuppolicy/{policy_id}/tagsParameter", + "product_code":"vbs", + "title":"Adding a Tag to a Backup Policy", + "uri":"en-us_topic_0098527676.html", + "doc_type":"api", + "p_code":"26", + "code":"36" + }, + { + "desc":"This API is used to remove a tag from a backup policy.URI formatDELETE /v2/{project_id}/backuppolicy/{policy_id}/tags/{key}DELETE /v2/{project_id}/backuppolicy/{policy_id", + "product_code":"vbs", + "title":"Removing a Tag from a Backup Policy", + "uri":"en-us_topic_0098527677.html", + "doc_type":"api", + "p_code":"26", + "code":"37" + }, + { + "desc":"This API is used to query tags of all backup policies.URI formatGET /v2/{project_id}/backuppolicy/tagsGET /v2/{project_id}/backuppolicy/tagsParameter descriptionParameter", + "product_code":"vbs", + "title":"Querying All Backup Policy Tags", + "uri":"en-us_topic_0067142130.html", + "doc_type":"api", + "p_code":"26", + "code":"38" + }, + { + "desc":"This API is used to query the tags of a specific backup policy.URI formatGET /v2/{project_id}/backuppolicy/{policy_id}/tagsGET /v2/{project_id}/backuppolicy/{policy_id}/t", + "product_code":"vbs", + "title":"Querying Tags of a Backup Policy", + "uri":"en-us_topic_0067142131.html", + "doc_type":"api", + "p_code":"26", + "code":"39" + }, + { + "desc":"This API is used to update or remove the tags of a backup policy.URI formatPOST /v2/{project_id}/backuppolicy/{policy_id}/tags/actionPOST /v2/{project_id}/backuppolicy/{p", + "product_code":"vbs", + "title":"Batch Updating or Removing Tags of a Backup Policy", + "uri":"en-us_topic_0067142132.html", + "doc_type":"api", + "p_code":"26", + "code":"40" + }, + { + "desc":"This API is used to query backup policies by tag.URI formatPOST /v2/{project_id}/backuppolicy/resource_instances/actionPOST /v2/{project_id}/backuppolicy/resource_instanc", + "product_code":"vbs", + "title":"Querying Backup Policies by Tag", + "uri":"en-us_topic_0067142133.html", + "doc_type":"api", + "p_code":"26", + "code":"41" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"vbs", + "title":"Appendix", + "uri":"en-us_topic_0022472082.html", + "doc_type":"api", + "p_code":"", + "code":"42" + }, + { + "desc":"NormalStatus CodeDescription200 OKSpecifies the normal response for the GET and PUT operations.201 CreatedSpecifies the normal response for the POST operation.202 Accepte", + "product_code":"vbs", + "title":"Status Codes", + "uri":"en-us_topic_0134480835.html", + "doc_type":"api", + "p_code":"42", + "code":"43" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"vbs", + "title":"Error Codes", + "uri":"en-us_topic_0022472083.html", + "doc_type":"api", + "p_code":"42", + "code":"44" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"vbs", + "title":"Change History", + "uri":"en-us_topic_0024723797.html", + "doc_type":"api", + "p_code":"", + "code":"45" + } +] \ No newline at end of file diff --git a/docs/vbs/api-ref/PARAMETERS.txt b/docs/vbs/api-ref/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/vbs/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/vbs/api-ref/en-us_topic_0020237251.html b/docs/vbs/api-ref/en-us_topic_0020237251.html new file mode 100644 index 000000000..50b5568d3 --- /dev/null +++ b/docs/vbs/api-ref/en-us_topic_0020237251.html @@ -0,0 +1,243 @@ + + +
This API is used to query the execution status of a job, such as VBS backup creation, VBS backup deletion, and VBS backup-based disk restoration.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+string + |
+Job status +
|
+
entities + |
+map<string, string> + |
+Response to the job. Each type of job has different contents. + |
+
job_id + |
+string + |
+Job ID + |
+
job_type + |
+string + |
+Job type + |
+
begin_time + |
+string + |
+Time when the job started + |
+
end_time + |
+string + |
+Time when the job finished + |
+
error_code + |
+string + |
+Error code returned after the job execution fails + |
+
fail_reason + |
+string + |
+Cause of the execution failure + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
sub_jobs + |
+list + |
+Execution information about a sub-job. When no sub-job exists, the value of this parameter is left blank. The structure of each sub-job is similar to that of the parent job. + |
+
{
+ "status": "SUCCESS",
+ "entities": {
+ "bks_create_volume_name": "autobk_volume",
+ "backup_id": "ba5401a2-7cd2-4c01-8c0d-c936ab412d6d",
+ "volume_id": "7e5fdc5a-5e36-4b22-8bcc-7f17037290cc",
+ "snapshot_id": "a77a96bf-dd18-40bf-a446-fdcefc1719ec"
+ },
+ "job_id": "4010b39b5281d3590152874bfa3b1604",
+ "job_type": "bksCreateBackup",
+ "begin_time": "2016-01-28T16:14:09.466Z",
+ "end_time": "2016-01-28T16:25:27.690Z",
+ "error_code": null,
+ "fail_reason": null
+}
+or
+{
+"error": {
+"message": "XXXX",
+"code": "XXX"
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to create a VBS backup.
+If the API is successfully called, the backup task is successfully delivered. You can query the backup status by using the API for Querying Details About a VBS Backup (Native OpenStack API).
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup + |
+Yes + |
+dict + |
+Backup to be created. For details, see the backup field description. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
volume_id + |
+Yes + |
+string + |
+ID of the disk to be backed up + |
+
snapshot_id + |
+No + |
+string + |
+Snapshot ID of the disk to be backed up + |
+
name + |
+Yes + |
+string + |
+Backup name. The value is a string of 1 to 64 characters that can contain digits, letters, underscores (_), and hyphens (-), not starting with auto. + |
+
description + |
+No + |
+string + |
+Backup description. The value is a string of 1 to 64 characters and cannot contain the less-than sign (<) or greater-than sign (>). + |
+
tags + |
+No + |
+list<dict> + |
+List of tags to be configured for the backup resources. For details, see the tag field description. + |
+
extend_param + |
+No + |
+map<string,string> + |
+Additional information for creating the VBS backup. The FullBackup field is supported. If FullBackup is set to true, full backup will be adopted this time. If FullBackup is set to false or the parameter is left blank, incremental backup will be adopted. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+string + |
+Tag key. A tag key consists of up to 36 characters. A tag key cannot contain non-printable ASCII characters (0-31) and the following special characters: =*<>\,|/ + |
+
value + |
+Yes + |
+string + |
+Tag value. A tag value consists of 0 to 43 characters. A tag key cannot contain non-printable ASCII characters (0-31) and the following special characters: =*<>\,|/ + |
+
When you use Instant Restore for the first time and the to-be-restored disk has been backed up before the feature is enabled, you need to perform a full backup on the disk on the console or directly call the API for creating a full backup (POST /v2/{tenant_id}/cloudbackups). After doing this, the disk backups generated through APIs will support this feature.
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
job_id + |
+string + |
+Job ID + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
+}
+or
+{
+"error": {
+"message": "XXXX",
+"code": "XXX"
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to delete a VBS backup. This API is deprecated. You are advised to use the API described in Deleting a VBS Backup (Native OpenStack API) to delete a backup.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
job_id + |
+string + |
+Job ID + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
+}
+or
+{
+"error": {
+"message": "XXXX",
+"code": "XXX"
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to restore a disk using a VBS backup.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
restore + |
+Yes + |
+dict + |
+Restoration operation + |
+
volume_id + |
+Yes + |
+string + |
+ID of the disk to be restored + |
+
{
+"restore":{
+"volume_id":"c96e4a94-927a-425c-8795-63f9964cfebd"
+}
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
job_id + |
+string + |
+Job ID + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
+}
+or
+{
+"error": {
+"message": "XXXX",
+"code": "XXX"
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query summary information about VBS backups.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
name + |
+No + |
+string + |
+Name of the backups to be queried. This parameter is used to query the backups whose names are specified character strings. + |
+
status + |
+No + |
+string + |
+Status of the backups to be queried. This parameter is used to query the backups in a specified state. The value can be available, error, restoring, creating, deleting, or error_restoring. + |
+
offset + |
+No + |
+int + |
+Offset of the queried information + |
+
limit + |
+No + |
+int + |
+Maximum number of query results that can be returned + |
+
volume_id + |
+No + |
+string + |
+Disk ID of the backups to be queried. It is used to query the backups for specific disks. + |
+
GET /v2/{project_id}/backups?name=backup&status=error&limit=10&volume_id=7d7c6fbe-d7ee-4b4d-8bae-bdd08b5604bb
+
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backups + |
+list<dict> + |
+Backup list returned by the query request. For details, see the backup field description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+string + |
+Backup ID + |
+
links + |
+list<dict> + |
+Backup URL. For details, see the links field description. + |
+
name + |
+string + |
+Backup name + |
+
backups_links + |
+list<dict> + |
+Only part of a tenant's backup information is queried, such as query by page with the limit specified and when the number of backups exceeds 1000. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
href + |
+string + |
+URL of the last backup queried + |
+
rel + |
+string + |
+Relationship between the query result and href. The value next indicates that some backups are not obtained. + |
+
{
+"backups": [
+{
+"id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "bookmark"
+}
+],
+"name": null
+},
+{
+"id": "b3cf7a16-decc-4beb-8077-682737d94a58",
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "bookmark"
+}
+],
+"name": null
+}
+],
+"backups_links": [
+ {
+ "href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups?limit=1&offset=1&marker=b3cf7a16-decc-4beb-8077-682737d94a58",
+ "rel": "next"
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query the details about VBS backups.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
name + |
+No + |
+string + |
+Name of the backups to be queried. This parameter is used to query the backups whose names are specified character strings. + |
+
status + |
+No + |
+string + |
+Status of the backups to be queried. This parameter is used to query the backups in a specified state. The value can be available, error, restoring, creating, deleting, or error_restoring. + |
+
sort_key + |
+No + |
+string + |
+Sorts by attribute. Possible values are name, status, container_format, disk_format, size, id, created_at, and updated_at. The default value is created_at. This API uses the natural sort direction of the sort_key attribute. + |
+
sort_dir + |
+No + |
+string + |
+Sorts by a set of one or more sort direction and attribute (sort_key) combinations. If you omit the sort direction in a set, the value defaults to desc. + |
+
offset + |
+No + |
+int + |
+Offset of the queried information + |
+
limit + |
+No + |
+int + |
+Maximum number of query results that can be returned + |
+
volume_id + |
+No + |
+string + |
+Disk ID of the backups to be queried. It is used to query the backups for specific disks. + |
+
GET /v2/{project_id}/backups/detail?name=backup&status=error&limit=10&volume_id=7d7c6fbe-d7ee-4b4d-8bae-bdd08b5604bb
+
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backups + |
+list<dict> + |
+List of queried backups + |
+
status + |
+string + |
+Backup status + |
+
description + |
+string + |
+Backup description + |
+
links + |
+list<dict> + |
+Backup URL + |
+
availability_zone + |
+string + |
+AZ where the backup resides + |
+
volume_id + |
+string + |
+Source disk ID of the backup + |
+
fail_reason + |
+string + |
+Cause of the backup failure + |
+
id + |
+string + |
+Backup ID + |
+
size + |
+int + |
+Backup size + |
+
object_count + |
+int + |
+Number of objects on Object Storage Service (OBS) for the disk data + |
+
container + |
+string + |
+Container of the backup + |
+
name + |
+string + |
+Backup name + |
+
created_at + |
+string + |
+Backup creation time + |
+
os-bak-tenant-attr:tenant_id + |
+string + |
+ID of the project that owns the VBS backup + |
+
service_metadata + |
+string + |
+Backup metadata + |
+
updated_at + |
+string + |
+Time when the backup was updated + |
+
data_timestamp + |
+string + |
+Current time + |
+
has_dependent_backups + |
+boolean + |
+Whether a dependent backup exists. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
snapshot_id + |
+string + |
+ID of the snapshot associated with the backup + |
+
is_incremental + |
+boolean + |
+Whether the backup is an incremental backup. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
backups_links + |
+list<dict> + |
+Only part of a tenant's backup information is queried, such as query by page with the limit specified and when the number of backups exceeds 1000. + |
+
href + |
+string + |
+URL of the last backup queried + |
+
rel + |
+string + |
+Relationship between the query result and href. The value next indicates that some backups are not obtained. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
DL + |
+int + |
+0: non-deduplication and non-compression; 1: deduplication and non-compression; 2: non-deduplication and compression; 3: deduplication and compression If this key is not specified, the value is 0 (non-deduplication and non-compression). + |
+
VK + |
+string + |
+Encryption VK of an encrypted volume. The value is a string of 64 characters. + |
+
bootable + |
+boolean + |
+Whether the disk is the boot disk + |
+
backupurl + |
+string + |
+Backup image ID on the backup system + |
+
SP + |
+string + |
+Path name of the backup image in the storage unit + |
+
VMID + |
+string + |
+ID of the VM to which the backup image belongs + |
+
ST + |
+int + |
+Backup service type. 0: disk backup; 1: VM backup; 4: disk backup copy, 5: VM backup copy. If this tag does not exist, disk backup is specified. + |
+
BT + |
+int + |
+Backup storage type + |
+
SS + |
+int + |
+Space saving rate + |
+
BP + |
+string + |
+Storage unit path + |
+
CMKID + |
+string + |
+Specifies the CMK ID of an encrypted volume. The content is UUID and contains 36 characters. + |
+
progress + |
+int + |
+Backup progress + |
+
CS + |
+int + |
+Total backup data of the chain where the backup is located. The unit is MB. + |
+
VT + |
+string + |
+Production storage disk type + |
+
OMID + |
+string + |
+Host ID of the job execution node + |
+
Type + |
+int + |
+Backup type. 0: full backup; 1: incremental backup + |
+
ebk_T_I + |
+string + |
+Job ID of the backup system + |
+
AT + |
+float + |
+Average rate (Average Throughput). The unit is MB/s. One digit is reserved after the decimal point. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
DESC + |
+string + |
+Backup description + |
+
INC + |
+int + |
+Whether the backup request was an incremental backup call. 1: incremental backup; 0: full backup + |
+
{
+"backups": [
+{
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:48:03.000000",
+"os-bak-tenant-attr:tenant_id": "b23b579f08c84228b9b4673c46f0c442",
+"service_metadata": " {\"bootable\": false, \"backupurl\": \"58d94782-6509-45ad-9442-970d2a005050\", \"BackupSize\": 0, \"progress\": \"0\", \"snap_id\": \"665e411f5d87431ca98c199fbd4a64fd\", \"Type\": 0} "
+},
+{
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/80e17946-6e56-46e0-9547-e9ba4f1619bd",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/80e17946-6e56-46e0-9547-e9ba4f1619bd",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "80e17946-6e56-46e0-9547-e9ba4f1619bd",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:56:58.000000"
+},
+{
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "b3cf7a16-decc-4beb-8077-682737d94a58",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:46:31.000000"
+}
+],
+"backups_links": [
+ {
+ "href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups?limit=1&offset=1&marker=b3cf7a16-decc-4beb-8077-682737d94a58",
+ "rel": "next"
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query details about a VBS backup.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup + |
+dict + |
+List of queried backups + |
+
status + |
+string + |
+Backup status + |
+
description + |
+string + |
+Backup description + |
+
links + |
+list<dict> + |
+Backup URL + |
+
availability_zone + |
+string + |
+AZ where the backup resides + |
+
volume_id + |
+string + |
+Source disk ID of the backup + |
+
fail_reason + |
+string + |
+Cause of the backup failure + |
+
id + |
+string + |
+Backup ID + |
+
size + |
+int + |
+Backup size + |
+
object_count + |
+int + |
+Number of objects on OBS for the disk data + |
+
container + |
+string + |
+Container of the backup + |
+
name + |
+string + |
+Backup name + |
+
created_at + |
+string + |
+Backup creation time + |
+
os-bak-tenant-attr:tenant_id + |
+string + |
+ID of the project that owns the VBS backup + |
+
service_metadata + |
+string + |
+Backup metadata + |
+
updated_at + |
+string + |
+Time when the backup was updated + |
+
data_timestamp + |
+string + |
+Current time + |
+
has_dependent_backups + |
+boolean + |
+Whether a dependent backup exists + |
+
snapshot_id + |
+string + |
+ID of the snapshot associated with the backup + |
+
is_incremental + |
+boolean + |
+Whether the backup is an incremental backup + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
DL + |
+int + |
+0: non-deduplication and non-compression; 1: deduplication and non-compression; 2: non-deduplication and compression; 3: deduplication and compression If this key is not specified, the value is 0 (non-deduplication and non-compression). + |
+
VK + |
+string + |
+Encryption VK of an encrypted volume. The value is a string of 64 characters. + |
+
bootable + |
+boolean + |
+Whether the disk is the boot disk + |
+
backupurl + |
+string + |
+Backup image ID on the backup system + |
+
SP + |
+string + |
+Path name of the backup image in the storage unit + |
+
VMID + |
+string + |
+ID of the VM to which the backup image belongs + |
+
ST + |
+int + |
+Backup service type. 0: disk backup; 1: VM backup; 4: disk backup copy, 5: VM backup copy. If this tag does not exist, disk backup is specified. + |
+
BT + |
+int + |
+Backup storage type + |
+
SS + |
+int + |
+Space saving rate + |
+
BP + |
+string + |
+Storage unit path + |
+
CMKID + |
+string + |
+CMK ID of an encrypted volume. The content is UUID and contains 36 characters. + |
+
progress + |
+int + |
+Backup progress + |
+
CS + |
+int + |
+Total backup data of the chain where the backup is located. The unit is MB. + |
+
VT + |
+string + |
+Production storage disk type + |
+
OMID + |
+string + |
+Host ID of the job execution node + |
+
Type + |
+int + |
+Backup type. 0: full backup; 1: incremental backup + |
+
ebk_T_I + |
+string + |
+Job ID of the backup system + |
+
AT + |
+float + |
+Average rate (Average Throughput). The unit is MB/s. One digit is reserved after the decimal point. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
DESC + |
+string + |
+Backup description + |
+
INC + |
+int + |
+Whether the backup request was an incremental backup call. 1: incremental backup; 0: full backup + |
+
{
+"backup": {
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:48:03.000000",
+"os-bak-tenant-attr:tenant_id": "b23b579f08c84228b9b4673c46f0c442",
+"service_metadata": " {\"bootable\": false, \"backupurl\": \"58d94782-6509-45ad-9442-970d2a005050\", \"BackupSize\": 0, \"progress\": \"0\", \"snap_id\": \"665e411f5d87431ca98c199fbd4a64fd\", \"Type\": 0} "
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+Module + |
+Error Code + |
+Description + |
+
|---|---|---|
Shared + |
+common.0011 + |
+Failed to query the task. + |
+
VolumeBackup.0014 + |
+Failed to submit the task. + |
+|
VolumeBackup.0041 + |
+Failed to check user rights. + |
+|
VolumeBackup.0042 + |
+The user does not have the rights to perform operations. + |
+|
VolumeBackup.0044 + |
+User rights are invalid. + |
+|
Creating a Backup + |
+VolumeBackup.0002 + |
+The request format is incorrect. + |
+
VolumeBackup.0003 + |
+Parameter name in the request is too long. + |
+|
VolumeBackup.0004 + |
+Parameter name in the request contains invalid characters. + |
+|
VolumeBackup.0005 + |
+Parameter name in the request starts with auto. + |
+|
VolumeBackup.0006 + |
+Parameter description in the request is too long or contains invalid characters. + |
+|
VolumeBackup.0007 + |
+Parameter name in the request is empty. + |
+|
VolumeBackup.0008 + |
+Failed to obtain the permission. + |
+|
VolumeBackup.0009 + |
+Failed to obtain the key. + |
+|
VolumeBackup.0010 + |
+Parameter volume_id in the request is empty. + |
+|
VolumeBackup.0011 + |
+The format of parameter volume_id in the request is incorrect. + |
+|
VolumeBackup.0012 + |
+The disk status is not available or in_use. + |
+|
VolumeBackup.0013 + |
+The previous backup creation task is not complete. + |
+|
VolumeBackup.0017 + |
+Failed to create the snapshot. + |
+|
VolumeBackup.0018 + |
+The snapshot creation result is empty. + |
+|
VolumeBackup.0019 + |
+Failed to query the snapshot during backup creation. + |
+|
VolumeBackup.0020 + |
+The snapshot query result is empty. + |
+|
VolumeBackup.0021 + |
+The EVS disk does not exist or has been deleted. + |
+|
VolumeBackup.0022 + |
+Failed to create the temporary disk. + |
+|
VolumeBackup.0023 + |
+The result of creating the temporary disk is empty. + |
+|
VolumeBackup.0024 + |
+Failed to query the temporary disk. + |
+|
VolumeBackup.0025 + |
+The result of querying the temporary disk is empty. + |
+|
VolumeBackup.0026 + |
+Parameter name in the request is too short. + |
+|
VolumeBackup.0027 + |
+Failed to create the backup. + |
+|
VolumeBackup.0028 + |
+The backup creation result is empty. + |
+|
VolumeBackup.0029 + |
+Failed to query the backup result. + |
+|
VolumeBackup.0030 + |
+The backup query result is empty. + |
+|
VolumeBackup.0035 + |
+Failed to query all disks of a user. + |
+|
VolumeBackup.0036 + |
+Failed to query all backups of a user. + |
+|
VolumeBackup.0037 + |
+Failed to query the snapshot status. + |
+|
VolumeBackup.0038 + |
+Failed to query the status of the temporary disk. + |
+|
VolumeBackup.0039 + |
+Failed to query the backup status. + |
+|
VolumeBackup.0040 + |
+The number of backups for the disk has reached the upper limit (20). + |
+|
VolumeBackup.0043 + |
+Failed to query the disk or backup. + |
+|
VolumeBackup.0049 + |
+The tag parameter is invalid. + |
+|
VolumeBackup.0050 + |
+The number of tags has reached the upper limit. + |
+|
VolumeBackup.0053 + |
+DESS disks do not support backup. + |
+|
VolumeBackup.0062 + |
+The snapshot status is error. + |
+|
VolumeBackup.0063 + |
+The status of the temporary disk is error. + |
+|
VolumeBackup.0064 + |
+The backup status is error. + |
+|
VolumeBackup.0070 + |
+Failed to query the quota information. + |
+|
VolumeBackup.0071 + |
+The quota for the number of SAS disks has been used up. + |
+|
VolumeBackup.0072 + |
+The quota for the capacity of SAS disks has been used up. + |
+|
VolumeBackup.0073 + |
+The quota for the number of SATA disks has been used up. + |
+|
VolumeBackup.0074 + |
+The quota for the capacity of SATA disks has been used up. + |
+|
VolumeBackup.0075 + |
+The quota for the number of SSD disks has been used up. + |
+|
VolumeBackup.0076 + |
+The quota for the capacity of SSD disks has been used up. + |
+|
VolumeBackup.0077 + |
+The quota for the number of SAS disk snapshots has been used up. + |
+|
VolumeBackup.0078 + |
+The quota for the number of SATA disk snapshots has been used up. + |
+|
VolumeBackup.0079 + |
+The quota for the number of SSD disk snapshots has been used up. + |
+|
VolumeBackup.0080 + |
+The quota for the number of backups has been used up. + |
+|
VolumeBackup.0081 + |
+The quota for the capacity of backups has been used up. + |
+|
VolumeBackup.0082 + |
+The quota for the number of disks has been used up. + |
+|
VolumeBackup.0083 + |
+The quota for the capacity of disks has been used up. + |
+|
VolumeBackup.0084 + |
+The quota for the number of snapshots has been used up. + |
+|
Deleting a Backup + + + + + + + + + + + + + |
+VolumeBackup.0100 + |
+Failed to submit the subtask. + |
+
VolumeBackup.0101 + |
+Failed to delete the snapshot. + |
+|
VolumeBackup.0102 + |
+Failed to delete the backup. + |
+|
VolumeBackup.0103 + |
+Failed to query the backup details. + |
+|
VolumeBackup.0104 + |
+Failed to obtain the image information. + |
+|
VolumeBackup.0105 + |
+The format of the backup deletion request is incorrect. + |
+|
VolumeBackup.0109 + |
+Failed to query the snapshot during backup deletion. + |
+|
VolumeBackup.0110 + |
+Failed to query the backup. + |
+|
VolumeBackup.0113 + |
+The backup has already been used to create an image and cannot be deleted. + |
+|
VolumeBackup.0123 + |
+Failed to query all backups. + |
+|
VolumeBackup.0125 + |
+Failed to perform the backup deletion operation. + |
+|
VolumeBackup.0900 + |
+The service is unavailable. + |
+|
Restoring a Disk Using a Backup + + + + + + + + + + + + + |
+VolumeBackup.0111 + |
+The disk to be restored or the backup used to restore the disk does not exist. + |
+
VolumeBackup.0200 + |
+Failed to restore data. + |
+|
VolumeBackup.0201 + |
+The data restoration result is empty. + |
+|
VolumeBackup.0202 + |
+The disk status is error. + |
+|
VolumeBackup.0203 + |
+Parameter backup_id in the request is empty. + |
+|
VolumeBackup.0204 + |
+The format of parameter backup_id in the request is incorrect. + |
+|
VolumeBackup.0205 + |
+The disk status is unavailable. + |
+|
VolumeBackup.0206 + |
+A backup is being created for the disk. + |
+|
VolumeBackup.0207 + |
+The disk to be queried does not exist. + |
+|
VolumeBackup.0208 + |
+Parameter volume_id in the request is incorrect. + |
+|
VolumeBackup.0209 + |
+The capacity of the disk must be greater than or equal to that of the backup. + |
+|
VolumeBackup.0210 + |
+The format of the disk restoration request is incorrect. + |
+|
VolumeBackup.0211 + |
+Cloud disks at the disaster recovery site cannot be restored. + |
+|
VolumeBackup.0089 + |
+The disk backup status is unavailable. + |
+|
Backup Policy + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + |
+AutoBackup.0000 + |
+The request is empty. + |
+
AutoBackup.0001 + |
+The object contained in the request is empty. + |
+|
AutoBackup.0002 + |
+The token contained in the request header is empty. + |
+|
AutoBackup.0003 + |
+The token contained in the request header has expired. + |
+|
AutoBackup.0005 + |
+Failed to obtain the domain ID from the token contained in the request header. + |
+|
AutoBackup.0006 + |
+The policy ID contained in the request is empty. + |
+|
AutoBackup.0008 + |
+Failed to convert the request into a JSON object. + |
+|
AutoBackup.0009 + |
+An exception occurred in internal system processing. + |
+|
AutoBackup.0100 + |
+The tenant cannot modify the default backup policy. + |
+|
AutoBackup.0101 + |
+The length of the backup policy name is invalid. + |
+|
AutoBackup.0102 + |
+The parameter of the backup policy name is invalid. + |
+|
AutoBackup.0103 + |
+The parameter of the backup job start time is invalid. + |
+|
AutoBackup.0104 + |
+The parameter of the backup policy status is invalid. + |
+|
AutoBackup.0105 + |
+The parameter of whether to retain the first backup in the current month is invalid. + |
+|
AutoBackup.0106 + |
+The parameter of the backup job interval is invalid. + |
+|
AutoBackup.0107 + |
+The parameter of the number of retained backups is invalid. + |
+|
AutoBackup.0203 + |
+The number of existing backup policies has reached the upper limit. + |
+|
AutoBackup.0204 + |
+The number of associated volumes has reached the upper limit. + |
+|
AutoBackup.0205 + |
+The policy does not exist. + |
+|
AutoBackup.1100 + |
+The queried policy does not exist. + |
+|
AutoBackup.1300 + |
+Failed to delete the policy. + |
+|
AutoBackup.1400 + |
+The resource to be associated is invalid. + |
+|
AutoBackup.1700 + |
+Failed to execute the backup policy. + |
+|
AutoBackup.0206 + |
+The status of the disk to be associated is invalid. + |
+|
AutoBackup.0207 + |
+The resource to be associated is empty. + |
+|
AutoBackup.0208 + |
+An exception occurred when you were obtaining details about the associated resource. + |
+|
AutoBackup.0209 + |
+The resource ID or name is empty. + |
+|
AutoBackup.0210 + |
+HANA disks cannot be associated with the backup policy. + |
+|
AutoBackup.0211 + |
+The resource type is invalid. + |
+|
AutoBackup.0213 + |
+The request is not authorized. + |
+|
AutoBackup.0214 + |
+The tag parameter is invalid. + |
+|
AutoBackup.0215 + |
+The number of tags has reached the upper limit. + |
+|
AutoBackup.0216 + |
+The tag does not exist. + |
+|
AutoBackup.0217 + |
+The snapshot quota is insufficient. + |
+|
AutoBackup.0218 + |
+The backup quota is insufficient. + |
+|
AutoBackup.0220 + |
+DESS disks cannot be associated with the backup policy. + |
+|
AutoBackup.0221 + |
+The request cannot contain less-than signs (<) or greater-than signs (>). + |
+|
AutoBackup.0222 + |
+Only specified actions are supported. + |
+|
AutoBackup.0225 + |
+The policy is being executed. + |
+|
AutoBackup.0226 + |
+The time zone parameter is invalid. + |
+|
AutoBackup.9002 + |
+An internal exception occurred in system authentication. + |
+
Release Date + |
+What's New + |
+
|---|---|
2022-06-02 + |
+Updated the following content: +Optimized the descriptions of the Type and INC parameters in sections "Querying Details About VBS Backups (Native OpenStack API)" and "Querying Details About a VBS Backup (Native OpenStack API)." + |
+
2021-09-24 + |
+Updated the following content: +Added section "Querying Quotas." + |
+
2018-12-30 + |
+Updated the following content: +Added the following sections: Creating a VBS Backup (Native OpenStack V3 API), Querying Summary Information About VBS Backups (Native OpenStack V3 API), Querying Details About VBS Backups (Native OpenStack V3 API), Querying Details About a VBS Backup (Native OpenStack V3 API), Deleting a VBS Backup (Native OpenStack V3 API), and Restoring a Disk Using a VBS Backup (Native OpenStack V3 API). + |
+
2018-09-07 + |
+Accepted in OTC-3.2. + |
+
2018-08-15 + |
+Updated the following content: +
|
+
2018-07-30 + |
+Updated the following content: +
|
+
2018-06-11 + |
+Accepted in OTC 3.1. + |
+
2018-05-30 + |
+Updated the following content: +Modified the description of parameter "key" in section "Deleting a Tag of a Backup Policy". + |
+
2018-04-30 + |
+Updated the following content: +
|
+
2018-01-23 + |
+Updated the following content: +
|
+
2017-09-22 + |
+Updated the following content: +
|
+
2017-07-30 + |
+Updated the following content: +
|
+
2017-05-26 + |
+Updated the following content: +
|
+
2017-04-28 + |
+Updated the following content: +
|
+
2017-03-30 + |
+Updated the following content: +
|
+
2017-02-28 + |
+This issue is the tenth official release. +Updated the following content: +
|
+
2017-02-22 + |
+Updated the following content: +
|
+
2017-01-20 + |
+Updated the following content: +
|
+
2016-12-30 + |
+Updated the following content: +
|
+
2016-11-24 + |
+Updated the following content: +
|
+
2016-09-30 + |
+Updated the following content: +
|
+
2016-08-25 + |
+Updated the following content: +
|
+
2016-06-02 + |
+Updated the following content: +
|
+
2016-04-14 + |
+Updated the following content: +
|
+
2016-03-09 + |
+This issue is the first official release. + |
+
This API is used to create a backup policy. A tenant can create a maximum of 10 backup policies.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup_policy_name + |
+Yes + |
+string + |
+Backup policy name +The name is a string of 1 to 64 characters consisting of letters, digits, underscores (_), and hyphens (-). It cannot start with default. + |
+
scheduled_policy + |
+Yes + |
+dict + |
+Details about the scheduling policy + |
+
start_time + |
+Yes + |
+string + |
+Backup execution time (UTC), in the format of HH:mm +You need to set the execution time to a full hour. You can set multiple execution times, and use commas (,) to separate one time from another. To set multiple backup execution times, enter them in ascending order by local time. For example, if your local time is 2 hours ahead of UTC and you want to perform backups at the local times 00:00, 02:00, and 04:00, set this parameter to 22:00,00:00,02:00 (UTC times) and time_zone to UTC+02:00. + |
+
frequency + |
+No (Either this field or week_frequency must be specified.) + |
+integer + |
+Backup interval (1 to 14 days). Set either this parameter or week_frequency. If you set both, this parameter is used. + |
+
week_frequency + |
+No (Either this field or frequency must be specified.) + |
+list<string> + |
+Defines on which days of each week backup jobs are executed. The value can be one or more of the following: +SUN, MON, TUE, WED, THU, FRI, SAT + |
+
rentention_num + |
+No (Either this field or rentention_day must be specified.)\ + |
+integer + |
+Number (from 2 to 14) of retained backups. Set either this parameter or rentention_day. If you set both, this parameter is used. + |
+
rentention_day + |
+No (Either this field or rentention_num must be specified.) + |
+integer + |
+Retention days of backups. The value is an integer ranging from 2 to 99999. If you enter a floating point number, the number will be rounded down to the nearest integer when you send the request. + |
+
remain_first_backup_of_curMonth + |
+No + |
+string + |
+Whether to retain the first backup in the current month +
|
+
status + |
+Yes + |
+string + |
+Backup policy status +
|
+
tags + |
+No + |
+list<dict> + |
+Tags to be configured for the backup policy + |
+
key + |
+Yes + |
+string + |
+Tag key. It contains 1 to 36 characters, A tag key can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+Yes + |
+string + |
+Tag value. A tag value consists of 0 to 43 characters. A tag value can contain only letters, digits, hyphens (-), and underscores (_). + |
+
time_zone + |
+No + |
+string + |
+Time zone. The value is in the UTC+/-HH:mm format. +This parameter specifies the time zone of the local time with the Daylight Saving Time (DST) offset, for example, UTC+08:00 or UTC-02:00. If execution times are in different days after converting into UTC times, this parameter must be used with week_frequency and start_time. + |
+
{
+ "backup_policy_name": "policy_01",
+ "scheduled_policy" : {
+ "remain_first_backup_of_curMonth" : "Y",
+ "rentention_day" : 30,
+ "week_frequency" : ["SUN","WED"],
+ "start_time" : "12:00",
+ "status" : "ON"
+ },
+ "tags":[{
+ "key":"key",
+ "value":"value"
+ }],
+ "time_zone": "UTC+08:00"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup_policy_id + |
+string + |
+Backup policy ID returned if the operation is successful + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "backup_policy_id": "af8a20b0-117d-4fc3-ae53-aa3968a4f870"
+}
+or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query all backup policies of a tenant.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup_policies + |
+list<dict> + |
+List of backup policies + |
+
backup_policy_name + |
+string + |
+Backup policy name + |
+
scheduled_policy + |
+dict + |
+Details about the scheduling policy + |
+
start_time + |
+string + |
+Backup execution time (on a full hour), which is expressed in the UTC format. If you want to set multiple execution times, separate them using commas (,). + |
+
frequency + |
+integer + |
+Backup interval (1 to 14 days) + |
+
week_frequency + |
+list<string> + |
+Week information list + |
+
rentention_num + |
+integer + |
+Number of retained backups. The value must be an integer from 2 to 14. + |
+
rentention_day + |
+integer + |
+Retention days of backups. The value is an integer ranging from 2 to 99999. If you enter a floating point number, the number will be rounded down to the nearest integer when you send the request. + |
+
remain_first_backup_of_curMonth + |
+string + |
+Whether to retain the first backup in the current month +
|
+
status + |
+string + |
+Backup policy status +
|
+
backup_policy_id + |
+string + |
+Backup policy ID + |
+
policy_resource_count + |
+integer + |
+Number of volumes associated with the backup policy + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
time_zone + |
+string + |
+Time zone for the backup execution time + |
+
{
+ "backup_policies" : [
+ {
+ "backup_policy_id" : "XX",
+ "backup_policy_name": "plan01",
+ "scheduled_policy" : {
+ "remain_first_backup_of_curMonth" : "Y",
+ "rentention_num" : 10,
+ "frequency" : 1,
+ "start_time" : "12:00",
+ "status" : "ON"
+ },
+ "policy_resource_count": 0
+ },
+ {
+ "backup_policy_id" : "YY",
+ "backup_policy_name ": "plan02",
+ "scheduled_policy" : {
+ "remain_first_backup_of_curMonth" : "Y",
+ "rentention_num" : 10,
+ "frequency" : 1,
+ "start_time" : "14:00",
+ "status" : "ON"
+ },
+ "policy_resource_count": 10
+ }]
+}
+or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to modify a backup policy.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup_policy_name + |
+No + |
+string + |
+Backup policy name +The name is a string of 1 to 64 characters consisting of letters, digits, underscores (_), and hyphens (-). It cannot start with default. +The default backup policy cannot be renamed. + |
+
scheduled_policy + |
+No + |
+dict + |
+Details about the scheduling policy + |
+
start_time + |
+No + |
+string + |
+Backup execution time (UTC), in the format of HH:mm +You need to set the execution time to a full hour. You can set multiple execution times, and use commas (,) to separate one time from another. To set multiple backup execution times, enter them in ascending order by local time. For example, if your local time is 2 hours ahead of UTC and you want to perform backups at the local times 00:00, 02:00, and 04:00, set this parameter to 22:00,00:00,02:00 (UTC times) and time_zone to UTC+02:00. + |
+
frequency + |
+No (Either this field or week_frequency must be specified.) + |
+integer + |
+Backup interval (1 to 14 days). Set either this parameter or week_frequency. If you set both, this parameter is used. + |
+
week_frequency + |
+No (Either this field or frequency must be specified.) + |
+list<string> + |
+Defines on which days of each week backup jobs are executed. The value can be one or more of the following: +SUN, MON, TUE, WED, THU, FRI, SAT + |
+
rentention_num + |
+No + |
+integer + |
+Number of retained backups. The value must be an integer from 2 to 14. If you set this parameter and rentention_day at the same time, this parameter is used. + |
+
rentention_day + |
+No + |
+integer + |
+Retention days of backups. The value is an integer ranging from 2 to 99999. If you enter a floating point number, the number will be rounded down to the nearest integer when you send the request. + |
+
remain_first_backup_of_curMonth + |
+No + |
+string + |
+Whether to retain the first backup in the current month +
|
+
status + |
+No + |
+string + |
+Backup policy status +
|
+
time_zone + |
+No + |
+string + |
+Time zone. The value is in the UTC+/-HH:mm format. +This parameter specifies the time zone of the local time with the DST offset, for example, UTC+08:00 or UTC-02:00. If execution times are in different days after converting into UTC times, this parameter must be used with week_frequency and start_time. + |
+
{
+ "backup_policy_name": "policy_01",
+ "scheduled_policy" : {
+ "remain_first_backup_of_curMonth" : "Y",
+ "rentention_num" : 10,
+ "week_frequency" : ["MON"],
+ "start_time" : "12:00",
+ "status" : "ON"
+ },
+ "time_zone": "UTC+08:00"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup_policy_id + |
+string + |
+Backup policy ID returned if the operation is successful + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "backup_policy_id": "af8a20b0-117d-4fc3-ae53-aa3968a4f870"
+}
+or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to delete a backup policy.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to associate one or more resources with a backup policy.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup_policy_id + |
+Yes + |
+string + |
+Backup policy ID + |
+
resources + |
+Yes + |
+list<dict> + |
+Information about the associated resource + |
+
resource_id + |
+Yes + |
+string + |
+Resource ID + |
+
resource_type + |
+Yes + |
+string + |
+Resource type. The options are as follows: +
|
+
{
+ "backup_policy_id":"915d1fd8-63cb-4054-a2b0-2778210e3a75",
+ "resources":[{
+ "resource_id":"0f187b65-8d0e-4fc0-9096-3b55d330531e",
+ "resource_type":"volume"
+ },{
+ "resource_id":"0f187b65-8d0e-4fc0-9096-3b55d330531d",
+ "resource_type":"volume"
+ }]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
success_resources + |
+list<dict> + |
+List of successfully associated resources + |
+
resource_id + |
+string + |
+Resource ID + |
+
resource_type + |
+string + |
+Resource type + |
+
availability_zone + |
+string + |
+AZ to which the resource belongs + |
+
os_vol_host_attr + |
+string + |
+Point of delivery (POD) to which the resource belongs + |
+
fail_resources + |
+list<dict> + |
+List of the resources that fail to be associated + |
+
resource_id + |
+string + |
+Resource ID + |
+
resource_type + |
+string + |
+Resource type + |
+
availability_zone + |
+string + |
+AZ to which the resource belongs + |
+
os_vol_host_attr + |
+string + |
+POD to which the resource belongs + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "success_resources": [
+ {
+ "resource_id": "bce8d47a-af17-4169-901f-4c7ae9f29c2c",
+ "os_vol_host_attr": "pod01.eu-de-01",
+ "availability_zone": "eu-de-01",
+ "resource_type": "volume"
+ }
+ ],
+ "fail_resources": [ ]
+}
+or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to disassociate one or more resources from a backup policy.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
resources + |
+Yes + |
+list<dict> + |
+Information about the associated resource + |
+
resource_id + |
+Yes + |
+string + |
+Resource ID + |
+
{
+ "resources": [
+ {
+ "resource_id": "bce8d47a-af17-4169-901f-4c7ae9f29c2c"
+ }
+ ]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
success_resources + |
+list<dict> + |
+List of successfully disassociated resources + |
+
resource_id + |
+string + |
+Resource ID + |
+
fail_resources + |
+list<dict> + |
+List of the resources that fail to be disassociated + |
+
resource_id + |
+string + |
+Resource ID + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "success_resources": [],
+ "fail_resources": [
+ {
+ "resource_id": "bbba7509-f457-4732-97f1-a8e24b6ed9bc"
+ }]
+}
+or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to back up resources associated with a backup policy at once.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
or
+{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to enable or disable a backup policy. After a backup policy is enabled, it will be scheduled based on the specified time. After a backup policy is disabled, it will not be scheduled.
+Set the backup policy status to ON or OFF. For details, see Modifying a Backup Policy.
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
status + |
+Yes + |
+string + |
+Backup policy status +
|
+
This API is used to query the status of backup jobs triggered by a backup policy.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
policy_id + |
+Yes + |
+Backup policy ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
sort_dir + |
+No + |
+string + |
+Sorting order. Possible values are asc (ascending) and desc (descending). + |
+
limit + |
+No + |
+integer + |
+Maximum number of query results that can be returned. The default value is 20. + |
+
marker + |
+No + |
+string + |
+Start number from which backup jobs are queried. The value is the backup job ID. + |
+
job_id + |
+No + |
+string + |
+Backup job ID + |
+
status + |
+No + |
+string + |
+Backup job status +
|
+
sort_key + |
+No + |
+string + |
+Keyword for sorting query results. The value must be created_at. + |
+
offset + |
+No + |
+integer + |
+Query offset. The default value is 0. + |
+
GET /v2/{project_id}/backuppolicy/{policy_id}/backuptasks?limit=10
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
count + |
+integer + |
+Total number of queried jobs + |
+
tasks + |
+list<dict> + |
+Details about the backup jobs + |
+
status + |
+string + |
+Backup job status +
|
+
job_id + |
+string + |
+Backup job ID + |
+
created_at + |
+string + |
+Time the backup job was created. The time is in UTC format, for example, 2016-12-02T09:06:46.706. + |
+
finished_at + |
+string + |
+Time the backup job was completed. The time is in UTC format, for example, 2016-12-02T13:00:00.121. + |
+
backup_name + |
+string + |
+Backup name + |
+
resource_id + |
+string + |
+Resource ID + |
+
resource_type + |
+string + |
+Resource type + |
+
vbs_job_id + |
+string + |
+VBS backup job ID + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "tasks": [
+ {
+ "status": "RUNNING",
+ "job_id": "0781095c-b8ab-4ce5-99f3-4c5f6ff75319",
+ "created_at": "2016-12-03T06:24:34.467",
+ "backup_name": "autobk_a61d",
+ "resource_id": "f47a4ab5-11f5-4509-97f5-80ce0dd74e37",
+ "resource_type": "volume"
+ },
+ {
+ "status": "EXECUTE_SUCCESS",
+ "job_id": "c11b5a18-4559-4731-b7b3-58e2bd89cdb9",
+ "created_at": "2016-12-02T09:06:46.706",
+ "finished_at": "2016-12-02T13:00:00.121",
+ "backup_name": "autobk_e6d2",
+ "resource_id": "f47a4ab5-11f5-4509-97f5-80ce0dd74e37",
+ "resource_type": "volume"
+ }
+ ],
+ "count": 2
+}
+or
+{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to delete a VBS backup.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+int + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
or
+{
+"itemNotFound": {
+"message": "Backup 592a0c4d-65a3-4051-8d51-1e2b6401b2d8 could not be found.",
+"code": 404 }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page or resources. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to create a VBS backup.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup + |
+Yes + |
+dict + |
+Backup to be created. For details, see the backup field description. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
volume_id + |
+Yes + |
+string + |
+ID of the disk to be backed up + |
+
snapshot_id + |
+Yes + |
+string + |
+Snapshot ID of the disk to be backed up + |
+
name + |
+No + |
+string + |
+Backup name. The value is a string of 1 to 64 characters that can contain digits, letters, underscores (_), and hyphens (-), not starting with auto. + |
+
description + |
+No + |
+string + |
+Backup description. The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
container + |
+No + |
+string + |
+Backup container. This parameter is reserved and will be skipped. + |
+
incremental + |
+No + |
+boolean + |
+Whether it is an incremental backup. The value true indicates an incremental backup and false indicates a full backup. By default, VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter is skipped. + |
+
force + |
+No + |
+boolean + |
+Whether to forcibly back up the attached disks. true indicates a forcible backup and false indicates a non-forcible backup. The value defaults to false. + |
+
project_id + |
+No + |
+string + |
+Project ID + |
+
{
+ "backup": {
+ "volume_id": "c68ae7fb-0aa5-4a97-ab01-ed02c5b7e768",
+ "snapshot_id": "2bb856e1-b3d8-4432-a858-09e4ce939389",
+ "name": "backup1",
+ "description": "Backup_Demo"
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup + |
+dict + |
+Information about the created backup + |
+
id + |
+string + |
+Backup ID + |
+
name + |
+string + |
+Backup name + |
+
links + |
+list<dict> + |
+Information about the backup URL + |
+
href + |
+string + |
+Backup URL + |
+
rel + |
+string + |
+Relationship between the query result and href + |
+
{
+ "backup": {
+ "id": "54ba0e69-48a0-4a77-9cdf-a7979a7e2648",
+ "links": [
+ {
+ "href": "https://volume.Region.dc1.domainname.com/v2/5751d8c3f2f6415993ee4326b41630ec/backups/54ba0e69-48a0-4a77-9cdf-a7979a7e2648",
+ "rel": "self"
+ },
+ {
+ "href": "https://volume.Region.dc1.domainname.com/5751d8c3f2f6415993ee4326b41630ec/backups/54ba0e69-48a0-4a77-9cdf-a7979a7e2648",
+ "rel": "bookmark"
+ }
+ ],
+ "name": "backup1"
+ }
+}
+or
+{
+"badRequest": {
+"code": "XXXX",
+"message": "XXX"
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+Public cloud APIs comply with the RESTful API design principles. REST-based Web services are organized into resources. Each resource is identified by one or more Uniform Resource Identifiers (URIs). An application accesses a resource based on the resource's Unified Resource Locator (URL). A URL is usually in the following format: https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the API access path.
+Public cloud APIs use HTTPS as the transmission protocol. Requests/Responses are transmitted by using JSON messages, with media type represented by Application/json.
+For details about how to use APIs, see API Usage Guidelines.
+This API is used to restore a disk using a VBS backup.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
restore + |
+Yes + |
+dict + |
+Information about the disk to be restored + |
+
volume_id + |
+Yes + |
+string + |
+ID of the disk to be restored + |
+
{
+ "restore": {
+ "volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024"
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup_id + |
+String + |
+Backup ID + |
+
volume_id + |
+String + |
+Disk ID + |
+
volume_name + |
+String + |
+Disk name + |
+
{
+ "restore": {
+ "backup_id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+ "volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+ "volume_name": "test_volume"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page or resources. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query tags of all backup policies.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+list<dict> + |
+List of tag details + |
+
key + |
+string + |
+Tag key + |
+
values + |
+list<string> + |
+List of tag values + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "tags": [
+ {
+ "key": "RUNNING",
+ "values":[
+ "0781095c-b8ab-4ce5-99f3-4c5f6ff75319",
+ "2016-12-03T06:24:34.467"
+ ]
+ },
+ {
+ "key": "WAITING",
+ "values":[
+ "0781095c-b8ab-4ce5-99f3-4c5f6ff75319",
+ "2016-12-03T06:24:34.467"
+ ]
+ }
+ ]
+}
+or
+{
+ "error": {
+ "code": "XXXX",
+ "message": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query the tags of a specific backup policy.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+list<dict> + |
+List of tag details + |
+
key + |
+string + |
+Tag key + |
+
value + |
+string + |
+Tag value + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "tags": [
+ {
+ "key": "RUNNING",
+ "value":"0781095c-b8ab-4ce5-99f3-4c5f6ff75319"
+ },
+ {
+ "key": "WAITING",
+ "values":"2016-12-03T06:24:34.467"
+ }
+ ]
+}
+or
+{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to update or remove the tags of a backup policy.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
action + |
+Yes + |
+string + |
+Operator (case-sensitive). Possible values are: +create: indicates creating tags. A tag will be created when no tag with the same key exists. +update: indicates updating tags. A tag will be created when no tag with the same key exists. +delete: indicates deleting tags. + |
+
tags + |
+No + |
+list<dict> + |
+List of tags you want to operate + |
+
key + |
+Yes + |
+string + |
+Tag key. It cannot be left null. When action is create or update, the maximum length of a tag key is 36 characters; when action is delete, that is 127 characters. A tag key cannot contain non-printable ASCII characters (0-31) and the following special characters: =*<>\,|/ + |
+
value + |
+No (mandatory when action is set to create and optional when action is set to delete) + |
+string + |
+Tag value. When action is create or update, the maximum length of a tag value is 43 characters; when action is delete, that is 255 characters. A tag value can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "action":"delete",
+ "tags":[{
+ "key":"0f187b65-8d0e-4fc0-9096-3b55d330531e",
+ "value":"volume"
+ },{
+ "key":"0f187b65-8d0e-4fc0-9096-3b55d330531d",
+ "value":"volume"
+ }]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query backup policies by tag.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+No + |
+list<dict> + |
+List of tags. Backup policies with these tags will be filtered. This list can have a maximum of 10 tags. + |
+
key + |
+Yes + |
+string + |
+Tag key. Tag keys must be unique. + |
+
values + |
+Yes + |
+list<string> + |
+List of tag values. This list can have a maximum of 10 tag values and these values must be unique. + |
+
tags_any + |
+No + |
+list<dict> + |
+List of tags. Backups with any tags in this list will be filtered. +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. +The response returns resources containing any tags in this list. Keys in this list are in an OR relationship while values in each key-value structure is in an OR relationship. + |
+
key + |
+Yes + |
+string + |
+Tag key + |
+
values + |
+Yes + |
+list<string> + |
+List of tag values + |
+
not_tags + |
+No + |
+list<dict> + |
+List of excluded tags. Backups without these tags will be filtered. +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. +The response returns resources containing no tags in this list. Keys in this list are in an AND relationship while values in each key-value structure is in an OR relationship. + |
+
key + |
+Yes + |
+string + |
+Tag key + |
+
values + |
+Yes + |
+list<string> + |
+List of tag values + |
+
not_tags_any + |
+No + |
+list<dict> + |
+List of tags. Backups without any tags in this list will be filtered. +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. +The response returns resources without any tags in this list. Keys in this list are in an OR relationship while values in each key-value structure is in an OR relationship. + |
+
key + |
+Yes + |
+string + |
+Tag key + |
+
values + |
+Yes + |
+list<string> + |
+List of tag values + |
+
matches + |
+No + |
+list<dict> + |
+Search criteria. Fuzzy search is supported. + |
+
key + |
+Yes + |
+string + |
+Field for searching. Currently, only resource_name is supported. + |
+
value + |
+Yes + |
+string + |
+Search value + |
+
limit + |
+No + |
+string + |
+Number of queried records. This parameter is not displayed if action is set to count. The default value is 1000 if action is set to filter. The value must be an integer ranging from 1000. + |
+
offset + |
+No + |
+string + |
+Query index. (This parameter is not displayed if action is set to count.) The query starts from the next piece of data indexed by this parameter. If action is set to filter, the default value is 0 which indicates the query starts from the first piece of data. The value must be a non-negative integer. + |
+
action + |
+Yes + |
+string + |
+Operator. Possible values are: +filter: queries backup policies by specifying filtering conditions. +count: queries backup policies by specifying the total number. + |
+
{
+ "limit": "10",
+ "offset": "0",
+ "tags":
+ [
+ {
+ "key": "Tag001",
+ "values":["Value001","Value002"]
+ }
+ ],
+ "action":"filter"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_count + |
+integer + |
+Total number of resources + |
+
resources + |
+list<dict> + |
+List of resources + |
+
resource_id + |
+string + |
+Resource ID + |
+
resouce_detail + |
+object + |
+Resource details, used for extension + |
+
resource_name + |
+string + |
+Resource name + |
+
tags + |
+list<dict> + |
+List of tags + |
+
key + |
+string + |
+Tag key + |
+
value + |
+string + |
+Tag value + |
+
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "total_count":10,
+ "resources":[
+ {
+ "resource_name": "name",
+ "resource_id": "0781095c-b8ab-4ce5-99f3-4c5f6ff75319",
+ "resource_detail": null,
+ "tags": [{
+ "key":"key",
+ "value":"value"
+ }]
+ }
+ ]
+}
+or
+{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to share a backup to another project.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
shared + |
+Yes + |
+dict + |
+Information about the backup sharing + |
+
backup_id + |
+Yes + |
+string + |
+ID of the backup to be shared + |
+
to_project_ids + |
+Yes + |
+list<string> + |
+IDs of projects with which the backup is shared + |
+
{
+ "shared": {
+ "to_project_ids": [
+ "722513ed0a324dadaabe5b2d0fe848c9",
+ "722513ed0a324dadaabe5b2d0fe84919"
+ ],
+ "backup_id": "066b1e37-9305-4057-97e5-2e99b21fc71d"
+ }
+}
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
shared + |
+Yes + |
+dict + |
+Information about the backup sharing + |
+
backup_id + |
+Yes + |
+string + |
+Backup ID + |
+
id + |
+Yes + |
+string + |
+Backup sharing ID + |
+
to_project_id + |
+Yes + |
+string + |
+ID of the project to which the backup is shared + |
+
from_project_id + |
+Yes + |
+string + |
+ID of the project that shares the backup + |
+
created_at + |
+Yes + |
+string + |
+Creation time of the backup sharing + |
+
updated_at + |
+Yes + |
+string + |
+Update time of the backup sharing + |
+
deleted + |
+Yes + |
+string + |
+Whether the backup sharing has been canceled + |
+
deleted_at + |
+Yes + |
+string + |
+Deletion time + |
+
{
+ "shared": [
+ {
+ "backup_id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "deleted": null,
+ "created_at": null,
+ "updated_at": null,
+ "to_project_id": "722513ed0a324dadaabe5b2d0fe848c9",
+ "from_project_id": "c13f5220dc1949b0b741ea81a7cd5554",
+ "deleted_at": null,
+ "id": "8332443e-9866-41d8-8a58-a898cf5db030"
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to cancel the sharing of a backup.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
id + |
+Yes + |
+Backup ID or backup sharing ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
is_backup_id + |
+No + |
+boolean + |
+Whether the ID in the URL is a backup sharing ID or a backup ID. The value true indicates a backup ID, and all backup sharings of this backup will be canceled. The value false indicates a backup sharing ID. + |
+
Canceling a specific backup sharing:
+DELETE /v2/{project_id}/os-vendor-backup-sharing/e842bf23-1e05-4c2c-b0f9-25222f4686da
+Canceling sharing of a backup:
+DELETE /v2/{project_id}/os-vendor-backup-sharing
+None
+None
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query backup sharings.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
share_to_me + |
+No + |
+boolean + |
+If this parameter is set to true, this API will list the backups shared with the current project. Or, this API will list the backups shared by the current project. + |
+
volume_id + |
+No + |
+string + |
+Disk ID + |
+
name + |
+No + |
+string + |
+Backup name. Fuzzy match is supported. + |
+
status + |
+No + |
+string + |
+Backup status + |
+
backup_id + |
+No + |
+string + |
+Backup ID + |
+
from_project_id + |
+No + |
+string + |
+ID of the project that shares the backup + |
+
to_project_id + |
+No + |
+string + |
+ID of the project to which the backup is shared + |
+
avalilability_zone + |
+No + |
+string + |
+AZ name + |
+
sort_dir + |
+No + |
+string + |
+Sorting direction + |
+
sort_key + |
+No + |
+string + |
+Sorts by attribute. Possible values are name, status, container_format, disk_format, size, id, created_at, and updated_at. The default value is created_at. + |
+
limit + |
+No + |
+int + |
+Number of sharings to be queried + |
+
offset + |
+No + |
+int + |
+Offset of the query + |
+
None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
shared + |
+list<dict> + |
+Backup sharing list + |
+
backup_id + |
+string + |
+Backup ID + |
+
created_at + |
+string + |
+Creation time of the backup sharing + |
+
from_project_id + |
+string + |
+ID of the project that shares the backup + |
+
id + |
+string + |
+Backup sharing ID + |
+
to_project_id + |
+string + |
+ID of the project to which the backup is shared + |
+
updated_at + |
+string + |
+Update time of the backup sharing + |
+
backup + |
+dict + |
+Details about the source backup + |
+
availability_zone + |
+string + |
+AZ where the backup resides + |
+
container + |
+string + |
+Container of the backup + |
+
created_at + |
+string + |
+Backup creation time + |
+
data_timestamp + |
+string + |
+Current time + |
+
description + |
+string + |
+Backup description + |
+
fail_reason + |
+string + |
+Cause of the backup failure + |
+
has_dependent_backup + |
+boolean + |
+Whether a dependent backup exists. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
id + |
+string + |
+Backup ID + |
+
is_incremental + |
+boolean + |
+Whether the backup is an incremental backup. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
name + |
+string + |
+Backup name + |
+
object_count + |
+int + |
+Number of objects on OBS for the disk data + |
+
size + |
+int + |
+Backup size + |
+
snapshot_id + |
+string + |
+ID of the snapshot associated with the backup + |
+
status + |
+string + |
+Backup status + |
+
updated_at + |
+string + |
+Update time of the backup + |
+
volume_id + |
+string + |
+Source disk ID of the backup + |
+
service_metadata + |
+string + |
+Backup metadata + |
+
{
+ "shared": [
+ {
+ "backup": {
+ "availability_zone": "AZ1",
+ "container": null,
+ "created_at": "2017-08-08T04:03:27.456859",
+ "data_timestamp": "2017-08-08T04:03:27.456859",
+ "description": null,
+ "fail_reason": "Invalid InitiatorConnector protocol specified DSWARE",
+ "has_dependent_backups": null,
+ "id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "is_incremental": null,
+ "name": "lbf",
+ "object_count": null,
+ "size": 1,
+ "snapshot_id": null,
+ "status": "available",
+ "updated_at": "2017-08-08T04:03:35.109308",
+ "volume_id": "a7d7783f-02b7-4645-b0e3-61df63f0ba10",
+ "service_metadata": null
+ },
+ "backup_id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "created_at": "2017-08-10T12:25:40.480424",
+ "from_project_id": "c13f5220dc1949b0b741ea81a7cd5554",
+ "id": "e842bf23-1e05-4c2c-b0f9-25222f4686da",
+ "to_project_id": "722513ed0a324dadaabe5b2d0fe848b9",
+ "updated_at": "2017-08-14T06:41:49.381069"
+ },
+ {
+ "backup": {
+ "availability_zone": "AZ1",
+ "container": null,
+ "created_at": "2017-08-08T04:03:27.456859",
+ "data_timestamp": "2017-08-08T04:03:27.456859",
+ "description": null,
+ "fail_reason": "Invalid InitiatorConnector protocol specified DSWARE",
+ "has_dependent_backups": null,
+ "id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "is_incremental": null,
+ "name": "lbf",
+ "object_count": null,
+ "size": 1,
+ "snapshot_id": null,
+ "status": "available",
+ "updated_at": "2017-08-08T04:03:35.109308",
+ "volume_id": "a7d7783f-02b7-4645-b0e3-61df63f0ba10",
+ "service_metadata": null
+ },
+ "backup_id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "created_at": "2017-08-10T12:19:37.318031",
+ "from_project_id": "c13f5220dc1949b0b741ea81a7cd5554",
+ "id": "f842bf23-1e05-4c2c-b0f9-25222f4686da",
+ "to_project_id": "722513ed0a324dadaabe5b2d0fe848a9",
+ "updated_at": null
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to count backup sharings with conditions.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
share_to_me + |
+No + |
+boolean + |
+If this parameter is set to true, this API will list the backups shared with the current project. Or, this API will list the backups shared by the current project. + |
+
volume_id + |
+No + |
+string + |
+Disk ID + |
+
name + |
+No + |
+string + |
+Backup name. Fuzzy match is supported. + |
+
status + |
+No + |
+string + |
+Backup status + |
+
backup_id + |
+No + |
+string + |
+Backup ID + |
+
from_project_id + |
+No + |
+string + |
+ID of the project that shares the backup + |
+
to_project_id + |
+No + |
+string + |
+ID of the project to which the backup is shared + |
+
avalilability_zone + |
+No + |
+string + |
+AZ name + |
+
None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
count + |
+int + |
+Total count + |
+
{
+ "count": 2
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query details about a backup sharing.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
shared + |
+dict + |
+Information about the backup sharing + |
+
backup_id + |
+string + |
+Backup ID + |
+
created_at + |
+string + |
+Creation time of the backup sharing + |
+
from_project_id + |
+string + |
+ID of the project that shares the backup + |
+
id + |
+string + |
+Backup sharing ID + |
+
to_project_id + |
+string + |
+ID of the project to which the backup is shared + |
+
updated_at + |
+string + |
+Update time of the backup sharing + |
+
backup + |
+dict + |
+Details about the source backup + |
+
availability_zone + |
+string + |
+AZ where the backup resides + |
+
container + |
+string + |
+Container of the backup + |
+
created_at + |
+string + |
+Backup creation time + |
+
data_timestamp + |
+string + |
+Current time + |
+
description + |
+string + |
+Backup description + |
+
fail_reason + |
+string + |
+Cause of the backup failure + |
+
has_dependent_backup + |
+boolean + |
+Whether a dependent backup exists. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
id + |
+string + |
+Backup ID + |
+
is_incremental + |
+boolean + |
+Whether the backup is an incremental backup. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
name + |
+string + |
+Backup name + |
+
object_count + |
+int + |
+Number of objects on OBS for the disk data + |
+
size + |
+int + |
+Backup size + |
+
snapshot_id + |
+string + |
+ID of the snapshot associated with the backup + |
+
status + |
+string + |
+Backup status + |
+
updated_at + |
+string + |
+Update time of the backup + |
+
volume_id + |
+string + |
+Source disk ID of the backup + |
+
service_metadata + |
+string + |
+Backup metadata + |
+
{
+ "shared": {
+ "backup": {
+ "availability_zone": "AZ1",
+ "container": null,
+ "created_at": "2017-08-08T04:03:27.000000",
+ "data_timestamp": "2017-08-08T04:03:27.000000",
+ "description": null,
+ "fail_reason": "Invalid InitiatorConnector protocol specified DSWARE",
+ "has_dependent_backups": null,
+ "id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "is_incremental": null,
+ "name": "lbf",
+ "object_count": 0,
+ "size": 1,
+ "snapshot_id": null,
+ "status": "available",
+ "updated_at": "2017-08-16T07:24:24.786297",
+ "volume_id": "a7d7783f-02b7-4645-b0e3-61df63f0ba10",
+ "service_metadata": null
+ },
+ "backup_id": "066b1e37-9305-4057-97e5-2e99b21fc71d",
+ "created_at": "2017-08-22T08:43:16.699374",
+ "from_project_id": "c13f5220dc1949b0b741ea81a7cd5554",
+ "id": "8332443e-9866-41d8-8a58-a898cf5db030",
+ "to_project_id": "722513ed0a324dadaabe5b2d0fe848c9",
+ "updated_at": null
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to add a tag to a backup policy.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tag + |
+Yes + |
+dict + |
+Tag to be added + |
+
key + |
+Yes + |
+string + |
+Tag key. It contains 1 to 36 characters, chosen from letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+Yes + |
+string + |
+Tag value. A tag value consists of 0 to 43 characters, chosen from letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "tag":{
+ "key":"0f187b65-8d0e-4fc0-9096-3b55d330531e",
+ "value":"volume"
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to remove a tag from a backup policy.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
policy_id + |
+Yes + |
+Backup policy ID + |
+
key + |
+Yes + |
+Tag key + NOTE:
+If the key contains special characters, encode it using ASCII first. +For example, the number sign (#) will be displayed as %23 after encoding. + |
+
DELETE /v2/{project_id}/backuppolicy/{policy_id}/tags/{key}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+string + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
{
+ "error": {
+ "message": "XXXX",
+ "code": "XXX"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query tenant quotas.
+None
+ GET /v2/{project_id}/cloudbackups/quota
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
quotas + |
+Yes + |
+map<string, string> + |
+Quota resource information + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
resources + |
+Yes + |
+List<resource_resp> + |
+Quota resources + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
reserved + |
+Yes + |
+Integer + |
+Reserved amount + |
+
used + |
+Yes + |
+Integer + |
+Used amount + |
+
quota + |
+Yes + |
+Integer + |
+Quota size. -1 indicates no restriction on the quota size. + |
+
type + |
+Yes + |
+String + |
+Type +Enum:[ backup_gigabytes ,backups] + |
+
{
+ "quotas": {
+ "resources":[{
+ "type" :"backups",
+ "used" : 114,
+ "reserved" : 0,
+ "quota" : 5014
+ },
+ {
+ "type": "backup_ gigabytes",
+ "used" : 4838,
+ "reserved" : 0,
+ "quota" : -1
+ }]
+ }
+}
+200
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
Status Code + |
+Description + |
+
|---|---|
200 OK + |
+Specifies the normal response for the GET and PUT operations. + |
+
201 Created + |
+Specifies the normal response for the POST operation. + |
+
202 Accepted + |
+The request has been accepted for processing. + |
+
204 No Content + |
+The results of the DELETE operation are returned as expected. + |
+
Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
This API is used to create a VBS backup.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup + |
+Yes + |
+dict + |
+Backup to be created +For details, see the backup field description. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
volume_id + |
+Yes + |
+string + |
+ID of the disk to be backed up + |
+
snapshot_id + |
+Yes + |
+string + |
+Snapshot ID of the disk to be backed up + |
+
name + |
+No + |
+string + |
+Backup name. The value is a string of 1 to 64 characters that can contain digits, letters, underscores (_), and hyphens (-), not starting with auto. + |
+
description + |
+No + |
+string + |
+Backup description + |
+
container + |
+No + |
+string + |
+Backup container. This parameter will be skipped. + |
+
incremental + |
+No + |
+boolean + |
+Whether it is an incremental backup. The value true indicates an incremental backup and false indicates a full backup. By default, VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter is skipped. + |
+
force + |
+No + |
+boolean + |
+Whether to forcibly back up the attached disks. The value true indicates a forcible backup and false indicates a non-forcible backup. + |
+
project_id + |
+No + |
+string + |
+Project ID + |
+
{
+ "backup": {
+ "volume_id": "c5834fe1-577f-462e-9bf3-1b158e1dde9c",
+ "snapshot_id": "251f910a-a2bd-443e-a77a-90a3dbd26b7b",
+ "name": "backup1",
+ "description": "Backup_Demo"
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup + |
+dict + |
+Information about the created backup + |
+
id + |
+string + |
+Backup ID + |
+
name + |
+string + |
+Backup name + |
+
links + |
+list<dict> + |
+Information about the backup URL + |
+
href + |
+string + |
+Backup URL + |
+
rel + |
+string + |
+Relationship between the query result and href + |
+
{
+ "backup": {
+ "id": "bb089eba-6b38-41c8-85a4-2b94fad7d570",
+ "links": [
+ {
+ "href": "https://volume.Region.dc1.domainname.com/v3/648bba9ba87e4b3f8484d0fc60e2e6cc/backups/bb089eba-6b38-41c8-85a4-2b94fad7d570",
+ "rel": "self"
+ },
+ {
+ "href": "https://volume.Region.dc1.domainname.com/648bba9ba87e4b3f8484d0fc60e2e6cc/backups/bb089eba-6b38-41c8-85a4-2b94fad7d570",
+ "rel": "bookmark"
+ }
+ ],
+ "name": "backup1"
+ }
+}
+or
+{
+"badRequest": {
+"code": "XXXX",
+"message": "XXX"
+}
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query summary information about VBS backups.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
name + |
+No + |
+string + |
+Name of the backups to be queried. This parameter is used to query the backups whose names are specified character strings. + |
+
status + |
+No + |
+string + |
+Status of the backups to be queried. This parameter is used to query the backups in a specified state. The value can be available, error, restoring, creating, deleting, or error_restoring. + |
+
offset + |
+No + |
+int + |
+Offset of the queried information + |
+
limit + |
+No + |
+int + |
+Maximum number of query results that can be returned + |
+
volume_id + |
+No + |
+string + |
+Disk ID of the backups to be queried. It is used to query the backups for specific disks. + |
+
with_count + |
+No + |
+boolean + |
+The query result contains the count field whose default value is False. This field is first available in version 3.45. + |
+
name~ + |
+No + |
+string + |
+Fuzzy query by backup name. This parameter is added in version 3.31. + |
+
status~ + |
+No + |
+string + |
+Fuzzy query by backup status. This parameter is added in version 3.31. + |
+
volume_id~ + |
+No + |
+string + |
+Fuzzy query by disk ID. This parameter is added in version 3.31. + |
+
If the version features such as with_count, name~, status~, and volume_id~ are used, add Openstack-Api-Version": volume 3.45 (3.45 is the version number) to the header when requesting the URL.
+GET /v3/{project_id}/backups?name=backup&status=error&limit=10&volume_id=7d7c6fbe-d7ee-4b4d-8bae-bdd08b5604bb
+
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backups + |
+list<dict> + |
+Backup list returned by the query request. For details, see the backup field description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+string + |
+Backup ID + |
+
links + |
+list<dict> + |
+Backup URL. For details, see the links field description. + |
+
name + |
+string + |
+Backup name + |
+
backups_links + |
+list<dict> + |
+Only part of a tenant's backup information is queried, such as query by page with the limit specified and when the number of backups exceeds 1000. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
href + |
+string + |
+URL of the last backup queried + |
+
rel + |
+string + |
+Relationship between the query result and href. The value next indicates that some backups are not obtained. + |
+
{
+"backups": [
+{
+"id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "bookmark"
+}
+],
+"name": null
+},
+{
+"id": "b3cf7a16-decc-4beb-8077-682737d94a58",
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "bookmark"
+}
+],
+"name": null
+}
+],
+"backups_links": [
+ {
+ "href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups?limit=1&offset=1&marker=b3cf7a16-decc-4beb-8077-682737d94a58",
+ "rel": "next"
+ }
+ ]
+}
+Status Codes + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to query the details about VBS backups.
+Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
name + |
+No + |
+string + |
+Name of the backups to be queried. This parameter is used to query the backups whose names are specified character strings. + |
+
status + |
+No + |
+string + |
+Status of the backups to be queried. This parameter is used to query the backups in a specified state. The value can be available, error, restoring, creating, deleting, or error_restoring. + |
+
offset + |
+No + |
+int + |
+Offset of the queried information + |
+
limit + |
+No + |
+int + |
+Maximum number of query results that can be returned + |
+
volume_id + |
+No + |
+string + |
+Disk ID of the backups to be queried. It is used to query the backups for specific disks. + |
+
with_count + |
+No + |
+boolean + |
+The query result contains the count field whose default value is False. This field is first available in version 3.45. + |
+
name~ + |
+No + |
+string + |
+Fuzzy query by backup name. This parameter is added in version 3.31. + |
+
status~ + |
+No + |
+string + |
+Fuzzy query by backup status. This parameter is added in version 3.31. + |
+
volume_id~ + |
+No + |
+string + |
+Fuzzy query by disk ID. This parameter is added in version 3.31. + |
+
If the version features such as with_count, name~, status~, and volume_id~ are used, add Openstack-Api-Version": volume 3.45 (3.45 is the version number) to the header when requesting the URL.
+GET /v3/{project_id}/backups/detail?name=backup&status=error&limit=10&volume_id=7d7c6fbe-d7ee-4b4d-8bae-bdd08b5604bb
+
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backups + |
+list<dict> + |
+List of queried backups + |
+
status + |
+string + |
+Backup status + |
+
description + |
+string + |
+Backup description + |
+
links + |
+list<link> + |
+Backup URL + |
+
availability_zone + |
+string + |
+AZ where the backup resides + |
+
volume_id + |
+string + |
+Source disk ID of the backup + |
+
fail_reason + |
+string + |
+Cause of the backup failure + |
+
id + |
+string + |
+Backup ID + |
+
size + |
+int + |
+Backup size + |
+
object_count + |
+int + |
+Number of objects on OBS for the disk data + |
+
container + |
+string + |
+Container of the backup + |
+
name + |
+string + |
+Backup name + |
+
created_at + |
+string + |
+Backup creation time + |
+
os-backup-project-attr:project_id + |
+string + |
+ID of the project that owns the VBS backup + |
+
updated_at + |
+string + |
+Time when the backup was updated + |
+
data_timestamp + |
+string + |
+Current time + |
+
has_dependent_backups + |
+boolean + |
+Whether a dependent backup exists + |
+
snapshot_id + |
+string + |
+ID of the snapshot associated with the backup + |
+
is_incremental + |
+boolean + |
+Whether the backup is an incremental backup. VBS generates a full backup for the initial backup operation and incremental backups for subsequent backup operations. Therefore, this parameter will be skipped. + |
+
count + |
+int + |
+Number of returned items. This parameter is first available in the 3.45 version. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
DESC + |
+string + |
+Backup description + |
+
INC + |
+int + |
+Whether the backup request was an incremental backup call. 1: incremental backup; 0: full backup + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
href + |
+string + |
+URL of the last backup queried + |
+
rel + |
+string + |
+Relationship between the query result and href. The value next indicates that some backups are not obtained. + |
+
{
+"backups": [
+{
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:48:03.000000",
+"os-backup-project-attr:project_id": "b23b579f08c84228b9b4673c46f0c442",
+"snapshot_id": "66a574c0-4415-499e-b0b1-3f340d7f7932",
+"updated_at": "2019-03-27T12:36:17.596602",
+"data_timestamp": "2019-03-16T11:56:00.917245",
+"has_dependent_backups": false,
+"is_incremental": false
+},
+{
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/80e17946-6e56-46e0-9547-e9ba4f1619bd",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/80e17946-6e56-46e0-9547-e9ba4f1619bd",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "80e17946-6e56-46e0-9547-e9ba4f1619bd",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:56:58.000000",
+"os-backup-project-attr:project_id": "b23b579f08c84228b9b4673c46f0c442",
+"snapshot_id": "66a574c0-4415-499e-b0b1-3f340d7f7932",
+"updated_at": "2019-03-27T12:36:17.596602",
+"data_timestamp": "2019-03-16T11:56:00.917245",
+"has_dependent_backups": false,
+"is_incremental": false
+},
+{
+"status": "error",
+"description": null,
+"links": [
+{
+"href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "self"
+},
+{
+"href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/b3cf7a16-decc-4beb-8077-682737d94a58",
+"rel": "bookmark"
+}
+],
+"availability_zone": null,
+"volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+"fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+"id": "b3cf7a16-decc-4beb-8077-682737d94a58",
+"size": 1,
+"object_count": null,
+"container": "volumebackups",
+"name": null,
+"created_at": "2013-06-27T08:46:31.000000",
+"snapshot_id": "66a574c0-4415-499e-b0b1-3f340d7f7932",
+"updated_at": "2019-03-27T12:36:17.596602",
+"data_timestamp": "2019-03-16T11:56:00.917245",
+"has_dependent_backups": false,
+"is_incremental": false
+}
+]
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
This API is used to query details about a VBS backup.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup + |
+dict + |
+List of queried backups + |
+
status + |
+string + |
+Backup status + |
+
description + |
+string + |
+Backup description + |
+
links + |
+list<link> + |
+Backup URL + |
+
availability_zone + |
+string + |
+AZ where the backup resides + |
+
volume_id + |
+string + |
+Source disk ID of the backup + |
+
fail_reason + |
+string + |
+Cause of the backup failure + |
+
id + |
+string + |
+Backup ID + |
+
size + |
+int + |
+Backup size + |
+
object_count + |
+int + |
+Number of objects on OBS for the disk data + |
+
container + |
+string + |
+Container of the backup + |
+
name + |
+string + |
+Backup name + |
+
created_at + |
+string + |
+Backup creation time + |
+
os-backup-project-attr:tenant_id + |
+string + |
+ID of the project that owns the VBS backup + |
+
updated_at + |
+string + |
+Update time of the backup + |
+
data_timestamp + |
+string + |
+Current time + |
+
has_dependent_backups + |
+boolean + |
+Whether a dependent backup exists + |
+
snapshot_id + |
+string + |
+ID of the snapshot associated with the backup + |
+
is_incremental + |
+boolean + |
+Whether the backup is an incremental backup + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
DESC + |
+string + |
+Backup description + |
+
INC + |
+int + |
+Whether the backup request was an incremental backup call. 1: incremental backup; 0: full backup + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
href + |
+string + |
+URL of the last backup queried + |
+
rel + |
+string + |
+Relationship between the query result and href. The value next indicates that some backups are not obtained. + |
+
{
+ "backup": {
+ "status": "error",
+ "description": null,
+ "links": [{
+ "href": "http://192.168.82.222:8776/v2/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+ "rel": "self"
+ },
+ {
+ "href": "http://192.168.82.222:8776/b23b579f08c84228b9b4673c46f0c442/backups/1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+ "rel": "bookmark"
+ }],
+ "availability_zone": null,
+ "volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024",
+ "fail_reason": "Connection to swift failed: [Errno 111] ECONNREFUSED",
+ "id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+ "size": 1,
+ "object_count": null,
+ "container": "volumebackups",
+ "name": null,
+ "created_at": "2013-06-27T08:48:03.000000",
+ "os-backup-project-attr:project_id": "b23b579f08c84228b9b4673c46f0c442",
+ "snapshot_id": "66a574c0-4415-499e-b0b1-3f340d7f7932",
+ "updated_at": "2019-03-27T12:36:17.596602",
+ "data_timestamp": "2019-03-16T11:56:00.917245",
+ "has_dependent_backups": false,
+ "is_incremental": false
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to delete a VBS backup.
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+string + |
+Error message returned after an error occurs + |
+
code + |
+int + |
+Error code returned after an error occurs +For details about error codes, see Error Codes. + |
+
or
+{
+"itemNotFound": {
+"message": "Backup 592a0c4d-65a3-4051-8d51-1e2b6401b2d8 could not be found.",
+"code": 404 }
+}
+Status Codes + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page or resources. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+This API is used to restore a disk using a VBS backup.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
restore + |
+Yes + |
+dict + |
+Information about the disk to be restored + |
+
volume_id + |
+Yes + |
+string + |
+ID of the disk to be restored + |
+
{
+ "restore": {
+ "volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024"
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup_id + |
+String + |
+Backup ID + |
+
volume_id + |
+String + |
+Disk ID + |
+
volume_name + |
+String + |
+Disk name + |
+
{
+ "restore": {
+ "backup_id": "1d1139d8-8989-49d3-8aa1-83eb691e6db2",
+ "volume_id": "2748f2f2-4394-4e6e-af8d-8dd34496c024"
+ "volume_name": "test_volume"
+ }
+}
+Status Codes + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page or resources. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
For details, see Error Codes.
+