diff --git a/docs/csbs/api-ref/ALL_META.TXT.json b/docs/csbs/api-ref/ALL_META.TXT.json new file mode 100644 index 000000000..ea56fc8f4 --- /dev/null +++ b/docs/csbs/api-ref/ALL_META.TXT.json @@ -0,0 +1,392 @@ +[ + { + "uri":"en-us_topic_0061309751.html", + "product_code":"csbs", + "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_0059304034.html", + "product_code":"csbs", + "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_0059304218.html", + "product_code":"csbs", + "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":"Resource Management", + "title":"Resource Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304219.html", + "product_code":"csbs", + "code":"4", + "des":"This API is used to create a backup for a specified resource.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/{resource_id}/actionPOST ", + "doc_type":"api", + "kw":"Creating a Backup for a Resource,Resource Management,API Reference", + "title":"Creating a Backup for a Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304220.html", + "product_code":"csbs", + "code":"5", + "des":"This API is used to query whether a resource can be backed up.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/actionPOST https://{endp", + "doc_type":"api", + "kw":"Querying the Backup Capability of a Resource,Resource Management,API Reference", + "title":"Querying the Backup Capability of a Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304221.html", + "product_code":"csbs", + "code":"6", + "des":"This API is used to check whether a target resource can be restored.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/actionPOST https:/", + "doc_type":"api", + "kw":"Querying the Restoration Capability of a Resource,Resource Management,API Reference", + "title":"Querying the Restoration Capability of a Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304222.html", + "product_code":"csbs", + "code":"7", + "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 Policy Management", + "title":"Backup Policy Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304223.html", + "product_code":"csbs", + "code":"8", + "des":"This API is used to create a backup policy to back up servers periodically.URI formatPOST https://{endpoint}/v1/{project_id}/policiesPOST https://{endpoint}/v1/{project_i", + "doc_type":"api", + "kw":"Creating a Backup Policy,Backup Policy Management,API Reference", + "title":"Creating a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304224.html", + "product_code":"csbs", + "code":"9", + "des":"This API is used to delete a backup policy by ID.URI formatDELETE https://{endpoint}/v1/{project_id}/policies/{policy_id}DELETE https://{endpoint}/v1/{project_id}/policie", + "doc_type":"api", + "kw":"Deleting a Backup Policy,Backup Policy Management,API Reference", + "title":"Deleting a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304225.html", + "product_code":"csbs", + "code":"10", + "des":"This API is used to update a backup policy by ID.URI formatPUT https://{endpoint}/v1/{project_id}/policies/{policy_id}PUT https://{endpoint}/v1/{project_id}/policies/{pol", + "doc_type":"api", + "kw":"Updating a Backup Policy,Backup Policy Management,API Reference", + "title":"Updating a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304226.html", + "product_code":"csbs", + "code":"11", + "des":"This API is used to query a backup policy by ID.URI formatGET https://{endpoint}/v1/{project_id}/policies/{policy_id}GET https://{endpoint}/v1/{project_id}/policies/{poli", + "doc_type":"api", + "kw":"Querying a Backup Policy,Backup Policy Management,API Reference", + "title":"Querying a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304227.html", + "product_code":"csbs", + "code":"12", + "des":"This API is used to query the backup policy list. Filtering parameters are supported.URI formatGET https://{endpoint}/v1/{project_id}/policiesGET https://{endpoint}/v1/{p", + "doc_type":"api", + "kw":"Querying the Backup Policy List,Backup Policy Management,API Reference", + "title":"Querying the Backup Policy List", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304229.html", + "product_code":"csbs", + "code":"13", + "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 Management", + "title":"Backup Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304230.html", + "product_code":"csbs", + "code":"14", + "des":"This API is used to manually execute a backup policy and create a backup task.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpointsPOST ht", + "doc_type":"api", + "kw":"Executing a Backup Policy,Backup Management,API Reference", + "title":"Executing a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304233.html", + "product_code":"csbs", + "code":"15", + "des":"This API is used to query the number of backups. Filtering parameters are supported.URI formatGET https://{endpoint}/v1/{project_id}/checkpoint_items/countGET https://{en", + "doc_type":"api", + "kw":"Querying the Number of Backups,Backup Management,API Reference", + "title":"Querying the Number of Backups", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304234.html", + "product_code":"csbs", + "code":"16", + "des":"This API is used to query a single backup by ID.URI formatGET https://{endpoint}/v1/{project_id}/checkpoint_items/{checkpoint_item_id}GET https://{endpoint}/v1/{project_i", + "doc_type":"api", + "kw":"Querying a Single Backup,Backup Management,API Reference", + "title":"Querying a Single Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304235.html", + "product_code":"csbs", + "code":"17", + "des":"This API is used to query all backups. Filtering parameters are supported.URI formatGET https://{endpoint}/v1/{project_id}/checkpoint_itemsGET https://{endpoint}/v1/{proj", + "doc_type":"api", + "kw":"Querying All Backups,Backup Management,API Reference", + "title":"Querying All Backups", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304232.html", + "product_code":"csbs", + "code":"18", + "des":"This API is used to delete a backup.The deletion operation is asynchronous. Tasks will be queued depending on the background task execution status. Therefore, the deletio", + "doc_type":"api", + "kw":"Deleting a Backup,Backup Management,API Reference", + "title":"Deleting a Backup", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304236.html", + "product_code":"csbs", + "code":"19", + "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":"Restoration Management", + "title":"Restoration Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304237.html", + "product_code":"csbs", + "code":"20", + "des":"This API is used to perform backup-based restoration.URI formatPOST https://{endpoint}/v1/{project_id}/restoresPOST https://{endpoint}/v1/{project_id}/restoresParameter d", + "doc_type":"api", + "kw":"Creating a Restoration Task,Restoration Management,API Reference", + "title":"Creating a Restoration Task", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304238.html", + "product_code":"csbs", + "code":"21", + "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":"Quota Management", + "title":"Quota Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0059304243.html", + "product_code":"csbs", + "code":"22", + "des":"This API is used to query tenant quotas.URI formatGET https://{endpoint}/v1/{project_id}/quotasGET https://{endpoint}/v1/{project_id}/quotasParameter descriptionParameter", + "doc_type":"api", + "kw":"Querying Quotas,Quota Management,API Reference", + "title":"Querying Quotas", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098466174.html", + "product_code":"csbs", + "code":"23", + "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":"Tag Management", + "title":"Tag Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635086.html", + "product_code":"csbs", + "code":"24", + "des":"This API is used to filter resources by tag.Tag Management Service (TMS) uses this API to filter and list resources of each service by tag. These services must have the q", + "doc_type":"api", + "kw":"Querying Backup Resources by Tag,Tag Management,API Reference", + "title":"Querying Backup Resources by Tag", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635087.html", + "product_code":"csbs", + "code":"25", + "des":"This API is used to add or remove tags of a specific resource in batches.TMS may use this API to manage service resource tags.A resource can have up to 10 tags.The API is", + "doc_type":"api", + "kw":"Batch Adding or Removing Tags of a Backup Resource,Tag Management,API Reference", + "title":"Batch Adding or Removing Tags of a Backup Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635088.html", + "product_code":"csbs", + "code":"26", + "des":"A resource can have up to 10 tags.The API is idempotent.If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one", + "doc_type":"api", + "kw":"Adding a Tag to a Backup Resource,Tag Management,API Reference", + "title":"Adding a Tag to a Backup Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635089.html", + "product_code":"csbs", + "code":"27", + "des":"The API is idempotent.When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings.URI formatDELETE https://", + "doc_type":"api", + "kw":"Removing a Tag from a Backup Resource,Tag Management,API Reference", + "title":"Removing a Tag from a Backup Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635090.html", + "product_code":"csbs", + "code":"28", + "des":"This API is used to query tags of a specific resource.TMS uses this API to query all tags of a specific resource.URI formatGET https://{endpoint}/v1/{project_id}/csbs_bac", + "doc_type":"api", + "kw":"Querying Tags of a Backup Resource,Tag Management,API Reference", + "title":"Querying Tags of a Backup Resource", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635091.html", + "product_code":"csbs", + "code":"29", + "des":"This API is used to query a tenant's tag set in a specific region and of a specific resource type.TMS uses this API to list tags created by a tenant to facilitate tag cre", + "doc_type":"api", + "kw":"Querying Backup Tags of a Project,Tag Management,API Reference", + "title":"Querying Backup Tags of a Project", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635092.html", + "product_code":"csbs", + "code":"30", + "des":"This API is used to filter backup policies by tag.TMS uses this API to filter and list resources of each service by tag. These services must have the query capabilities.U", + "doc_type":"api", + "kw":"Querying Backup Policies by Tag,Tag Management,API Reference", + "title":"Querying Backup Policies by Tag", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635093.html", + "product_code":"csbs", + "code":"31", + "des":"This API is used to add or remove tags of a specific resource in batches.TMS may use this API to manage service resource tags.A resource can have up to 10 tags.The API is", + "doc_type":"api", + "kw":"Batch Adding or Removing Tags of a Backup Policy,Tag Management,API Reference", + "title":"Batch Adding or Removing Tags of a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635094.html", + "product_code":"csbs", + "code":"32", + "des":"A resource can have up to 10 tags.The API is idempotent.If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one", + "doc_type":"api", + "kw":"Adding a Tag to a Backup Policy,Tag Management,API Reference", + "title":"Adding a Tag to a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635095.html", + "product_code":"csbs", + "code":"33", + "des":"The API is idempotent.When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings.URI formatDELETE https://", + "doc_type":"api", + "kw":"Removing a Tag from a Backup Policy,Tag Management,API Reference", + "title":"Removing a Tag from a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635096.html", + "product_code":"csbs", + "code":"34", + "des":"This API is used to query tags of a specific resource.TMS uses this API to query all tags of a specific resource.URI formatGET https://{endpoint}/v1/{project_id}/csbs_bac", + "doc_type":"api", + "kw":"Querying Tags of a Backup Policy,Tag Management,API Reference", + "title":"Querying Tags of a Backup Policy", + "githuburl":"" + }, + { + "uri":"en-us_topic_0098635097.html", + "product_code":"csbs", + "code":"35", + "des":"This API is used to query a tenant's tag set in a specific region and of a specific resource type.TMS uses this API to list tags created by a tenant to facilitate tag cre", + "doc_type":"api", + "kw":"Querying Backup Policy Tags of a Project,Tag Management,API Reference", + "title":"Querying Backup Policy Tags of a Project", + "githuburl":"" + }, + { + "uri":"en-us_topic_0071888296.html", + "product_code":"csbs", + "code":"36", + "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":"Appendixes", + "title":"Appendixes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0134484533.html", + "product_code":"csbs", + "code":"37", + "des":"NormalStatus CodeDescription200 OKThe results of GET and PUT operations are returned as expected.201 CreatedThe results of the POST operation are returned as expected.202", + "doc_type":"api", + "kw":"Status Codes,Appendixes,API Reference", + "title":"Status Codes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0071888297.html", + "product_code":"csbs", + "code":"38", + "des":"An example response error is returned as follows:Table 1 describes the error codes.Karbor native APIs:http://developer.openstack.org/api-ref/data-protection-orchestration", + "doc_type":"api", + "kw":"Error Codes,Appendixes,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0071888298.html", + "product_code":"csbs", + "code":"39", + "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/csbs/api-ref/CLASS.TXT.json b/docs/csbs/api-ref/CLASS.TXT.json new file mode 100644 index 000000000..340b38613 --- /dev/null +++ b/docs/csbs/api-ref/CLASS.TXT.json @@ -0,0 +1,353 @@ +[ + { + "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":"csbs", + "title":"API Usage Guidelines", + "uri":"en-us_topic_0061309751.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":"csbs", + "title":"API Description", + "uri":"en-us_topic_0059304034.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":"csbs", + "title":"Resource Management", + "uri":"en-us_topic_0059304218.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"This API is used to create a backup for a specified resource.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/{resource_id}/actionPOST ", + "product_code":"csbs", + "title":"Creating a Backup for a Resource", + "uri":"en-us_topic_0059304219.html", + "doc_type":"api", + "p_code":"3", + "code":"4" + }, + { + "desc":"This API is used to query whether a resource can be backed up.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/actionPOST https://{endp", + "product_code":"csbs", + "title":"Querying the Backup Capability of a Resource", + "uri":"en-us_topic_0059304220.html", + "doc_type":"api", + "p_code":"3", + "code":"5" + }, + { + "desc":"This API is used to check whether a target resource can be restored.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/actionPOST https:/", + "product_code":"csbs", + "title":"Querying the Restoration Capability of a Resource", + "uri":"en-us_topic_0059304221.html", + "doc_type":"api", + "p_code":"3", + "code":"6" + }, + { + "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":"csbs", + "title":"Backup Policy Management", + "uri":"en-us_topic_0059304222.html", + "doc_type":"api", + "p_code":"2", + "code":"7" + }, + { + "desc":"This API is used to create a backup policy to back up servers periodically.URI formatPOST https://{endpoint}/v1/{project_id}/policiesPOST https://{endpoint}/v1/{project_i", + "product_code":"csbs", + "title":"Creating a Backup Policy", + "uri":"en-us_topic_0059304223.html", + "doc_type":"api", + "p_code":"7", + "code":"8" + }, + { + "desc":"This API is used to delete a backup policy by ID.URI formatDELETE https://{endpoint}/v1/{project_id}/policies/{policy_id}DELETE https://{endpoint}/v1/{project_id}/policie", + "product_code":"csbs", + "title":"Deleting a Backup Policy", + "uri":"en-us_topic_0059304224.html", + "doc_type":"api", + "p_code":"7", + "code":"9" + }, + { + "desc":"This API is used to update a backup policy by ID.URI formatPUT https://{endpoint}/v1/{project_id}/policies/{policy_id}PUT https://{endpoint}/v1/{project_id}/policies/{pol", + "product_code":"csbs", + "title":"Updating a Backup Policy", + "uri":"en-us_topic_0059304225.html", + "doc_type":"api", + "p_code":"7", + "code":"10" + }, + { + "desc":"This API is used to query a backup policy by ID.URI formatGET https://{endpoint}/v1/{project_id}/policies/{policy_id}GET https://{endpoint}/v1/{project_id}/policies/{poli", + "product_code":"csbs", + "title":"Querying a Backup Policy", + "uri":"en-us_topic_0059304226.html", + "doc_type":"api", + "p_code":"7", + "code":"11" + }, + { + "desc":"This API is used to query the backup policy list. Filtering parameters are supported.URI formatGET https://{endpoint}/v1/{project_id}/policiesGET https://{endpoint}/v1/{p", + "product_code":"csbs", + "title":"Querying the Backup Policy List", + "uri":"en-us_topic_0059304227.html", + "doc_type":"api", + "p_code":"7", + "code":"12" + }, + { + "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":"csbs", + "title":"Backup Management", + "uri":"en-us_topic_0059304229.html", + "doc_type":"api", + "p_code":"2", + "code":"13" + }, + { + "desc":"This API is used to manually execute a backup policy and create a backup task.URI formatPOST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpointsPOST ht", + "product_code":"csbs", + "title":"Executing a Backup Policy", + "uri":"en-us_topic_0059304230.html", + "doc_type":"api", + "p_code":"13", + "code":"14" + }, + { + "desc":"This API is used to query the number of backups. Filtering parameters are supported.URI formatGET https://{endpoint}/v1/{project_id}/checkpoint_items/countGET https://{en", + "product_code":"csbs", + "title":"Querying the Number of Backups", + "uri":"en-us_topic_0059304233.html", + "doc_type":"api", + "p_code":"13", + "code":"15" + }, + { + "desc":"This API is used to query a single backup by ID.URI formatGET https://{endpoint}/v1/{project_id}/checkpoint_items/{checkpoint_item_id}GET https://{endpoint}/v1/{project_i", + "product_code":"csbs", + "title":"Querying a Single Backup", + "uri":"en-us_topic_0059304234.html", + "doc_type":"api", + "p_code":"13", + "code":"16" + }, + { + "desc":"This API is used to query all backups. Filtering parameters are supported.URI formatGET https://{endpoint}/v1/{project_id}/checkpoint_itemsGET https://{endpoint}/v1/{proj", + "product_code":"csbs", + "title":"Querying All Backups", + "uri":"en-us_topic_0059304235.html", + "doc_type":"api", + "p_code":"13", + "code":"17" + }, + { + "desc":"This API is used to delete a backup.The deletion operation is asynchronous. Tasks will be queued depending on the background task execution status. Therefore, the deletio", + "product_code":"csbs", + "title":"Deleting a Backup", + "uri":"en-us_topic_0059304232.html", + "doc_type":"api", + "p_code":"13", + "code":"18" + }, + { + "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":"csbs", + "title":"Restoration Management", + "uri":"en-us_topic_0059304236.html", + "doc_type":"api", + "p_code":"2", + "code":"19" + }, + { + "desc":"This API is used to perform backup-based restoration.URI formatPOST https://{endpoint}/v1/{project_id}/restoresPOST https://{endpoint}/v1/{project_id}/restoresParameter d", + "product_code":"csbs", + "title":"Creating a Restoration Task", + "uri":"en-us_topic_0059304237.html", + "doc_type":"api", + "p_code":"19", + "code":"20" + }, + { + "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":"csbs", + "title":"Quota Management", + "uri":"en-us_topic_0059304238.html", + "doc_type":"api", + "p_code":"2", + "code":"21" + }, + { + "desc":"This API is used to query tenant quotas.URI formatGET https://{endpoint}/v1/{project_id}/quotasGET https://{endpoint}/v1/{project_id}/quotasParameter descriptionParameter", + "product_code":"csbs", + "title":"Querying Quotas", + "uri":"en-us_topic_0059304243.html", + "doc_type":"api", + "p_code":"21", + "code":"22" + }, + { + "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":"csbs", + "title":"Tag Management", + "uri":"en-us_topic_0098466174.html", + "doc_type":"api", + "p_code":"2", + "code":"23" + }, + { + "desc":"This API is used to filter resources by tag.Tag Management Service (TMS) uses this API to filter and list resources of each service by tag. These services must have the q", + "product_code":"csbs", + "title":"Querying Backup Resources by Tag", + "uri":"en-us_topic_0098635086.html", + "doc_type":"api", + "p_code":"23", + "code":"24" + }, + { + "desc":"This API is used to add or remove tags of a specific resource in batches.TMS may use this API to manage service resource tags.A resource can have up to 10 tags.The API is", + "product_code":"csbs", + "title":"Batch Adding or Removing Tags of a Backup Resource", + "uri":"en-us_topic_0098635087.html", + "doc_type":"api", + "p_code":"23", + "code":"25" + }, + { + "desc":"A resource can have up to 10 tags.The API is idempotent.If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one", + "product_code":"csbs", + "title":"Adding a Tag to a Backup Resource", + "uri":"en-us_topic_0098635088.html", + "doc_type":"api", + "p_code":"23", + "code":"26" + }, + { + "desc":"The API is idempotent.When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings.URI formatDELETE https://", + "product_code":"csbs", + "title":"Removing a Tag from a Backup Resource", + "uri":"en-us_topic_0098635089.html", + "doc_type":"api", + "p_code":"23", + "code":"27" + }, + { + "desc":"This API is used to query tags of a specific resource.TMS uses this API to query all tags of a specific resource.URI formatGET https://{endpoint}/v1/{project_id}/csbs_bac", + "product_code":"csbs", + "title":"Querying Tags of a Backup Resource", + "uri":"en-us_topic_0098635090.html", + "doc_type":"api", + "p_code":"23", + "code":"28" + }, + { + "desc":"This API is used to query a tenant's tag set in a specific region and of a specific resource type.TMS uses this API to list tags created by a tenant to facilitate tag cre", + "product_code":"csbs", + "title":"Querying Backup Tags of a Project", + "uri":"en-us_topic_0098635091.html", + "doc_type":"api", + "p_code":"23", + "code":"29" + }, + { + "desc":"This API is used to filter backup policies by tag.TMS uses this API to filter and list resources of each service by tag. These services must have the query capabilities.U", + "product_code":"csbs", + "title":"Querying Backup Policies by Tag", + "uri":"en-us_topic_0098635092.html", + "doc_type":"api", + "p_code":"23", + "code":"30" + }, + { + "desc":"This API is used to add or remove tags of a specific resource in batches.TMS may use this API to manage service resource tags.A resource can have up to 10 tags.The API is", + "product_code":"csbs", + "title":"Batch Adding or Removing Tags of a Backup Policy", + "uri":"en-us_topic_0098635093.html", + "doc_type":"api", + "p_code":"23", + "code":"31" + }, + { + "desc":"A resource can have up to 10 tags.The API is idempotent.If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one", + "product_code":"csbs", + "title":"Adding a Tag to a Backup Policy", + "uri":"en-us_topic_0098635094.html", + "doc_type":"api", + "p_code":"23", + "code":"32" + }, + { + "desc":"The API is idempotent.When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings.URI formatDELETE https://", + "product_code":"csbs", + "title":"Removing a Tag from a Backup Policy", + "uri":"en-us_topic_0098635095.html", + "doc_type":"api", + "p_code":"23", + "code":"33" + }, + { + "desc":"This API is used to query tags of a specific resource.TMS uses this API to query all tags of a specific resource.URI formatGET https://{endpoint}/v1/{project_id}/csbs_bac", + "product_code":"csbs", + "title":"Querying Tags of a Backup Policy", + "uri":"en-us_topic_0098635096.html", + "doc_type":"api", + "p_code":"23", + "code":"34" + }, + { + "desc":"This API is used to query a tenant's tag set in a specific region and of a specific resource type.TMS uses this API to list tags created by a tenant to facilitate tag cre", + "product_code":"csbs", + "title":"Querying Backup Policy Tags of a Project", + "uri":"en-us_topic_0098635097.html", + "doc_type":"api", + "p_code":"23", + "code":"35" + }, + { + "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":"csbs", + "title":"Appendixes", + "uri":"en-us_topic_0071888296.html", + "doc_type":"api", + "p_code":"", + "code":"36" + }, + { + "desc":"NormalStatus CodeDescription200 OKThe results of GET and PUT operations are returned as expected.201 CreatedThe results of the POST operation are returned as expected.202", + "product_code":"csbs", + "title":"Status Codes", + "uri":"en-us_topic_0134484533.html", + "doc_type":"api", + "p_code":"36", + "code":"37" + }, + { + "desc":"An example response error is returned as follows:Table 1 describes the error codes.Karbor native APIs:http://developer.openstack.org/api-ref/data-protection-orchestration", + "product_code":"csbs", + "title":"Error Codes", + "uri":"en-us_topic_0071888297.html", + "doc_type":"api", + "p_code":"36", + "code":"38" + }, + { + "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":"csbs", + "title":"Change History", + "uri":"en-us_topic_0071888298.html", + "doc_type":"api", + "p_code":"", + "code":"39" + } +] \ No newline at end of file diff --git a/docs/csbs/api-ref/PARAMETERS.txt b/docs/csbs/api-ref/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/csbs/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/csbs/api-ref/en-us_topic_0059304034.html b/docs/csbs/api-ref/en-us_topic_0059304034.html new file mode 100644 index 000000000..4785df950 --- /dev/null +++ b/docs/csbs/api-ref/en-us_topic_0059304034.html @@ -0,0 +1,21 @@ + + +
This API is used to create a backup for a specified resource.
+POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/{resource_id}/action
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resource_id + |
+Yes + |
+String + |
+ID of a backup server. For details about how to obtain the server ID, see the Elastic Cloud Server API Reference. + |
+
Backup provider IDs mentioned in this document are all fc4d5750-22e7-4798-8a46-f48f62c4c1da.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
protect + |
+Yes + |
+protect_param + |
+Backup parameters +For details, see Table 3. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup_name + |
+No + |
+String + |
+Backup name. The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
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 (<). + |
+
incremental + |
+No + |
+Boolean + |
+Backup type. Value True indicates incremental backup and value False indicates full backup. For the initial backup, full backup is always adopted, in spite of which value is set. + |
+
resource_type + |
+No + |
+String + |
+Entity object type of the backup object +The current value is OS::Nova::Server indicating that the backup object is an ECS. If this parameter is not passed, the backup object type defaults to OS::Nova::Server. + |
+
tags + |
+No + |
+List<resource_tag> + |
+Tag list +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. + |
+
extra_info + |
+No + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+Yes + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
POST
+https://{endpoint}/v1/b942cc8342734d15bcb246babb1953cf/providers/fc4d5750-22e7-4798-8a46-f48f62c4c1da/resources/9506416d-db6c-406e-8bca-c0f43793d914/action
+{
+ "protect" : {
+ "backup_name" : "backup",
+ "description" : "backup des",
+ "extra_info" : {
+ }
+
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint + |
+protect_resp + |
+Backup response +For details, see Table 6. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Backup status +Value range: waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, and deleted + |
+
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
id + |
+String + |
+Backup record ID + |
+
resource_graph + |
+String + |
+Resource diagram, which displays the inclusion relationship between backups and sub-backups + |
+
project_id + |
+String + |
+Project ID + |
+
protection_plan + |
+plan_resp + |
+Backup plan information +For details, see Table 7. + |
+
extra_info + |
+String + |
+Additional information + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup policy ID + |
+
name + |
+String + |
+Backup policy name + |
+
resources + |
+List<resource> + |
+Backup object list +For details, see Table 8. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup object ID + |
+
type + |
+String + |
+Entity object type of the backup object. The value is fixed at OS::Nova::Server, indicating that the object type is ECS. + |
+
name + |
+String + |
+Backup object name + |
+
extra_info + |
+Dict + |
+Additional information about the backup object + |
+
{
+ "checkpoint" : {
+ "status" : "protecting",
+ "created_at" : "2017-04-18T01:21:52.701973",
+ "id" : "4468f4b8-7c78-4222-a2ca-346b5d557dd2",
+ "resource_graph" : null,
+ "project_id" : "b942cc8342734d15bcb246babb1953cf",
+ "extra_info" : null,
+ "protection_plan" : {
+ "id" : "fake_04f8ea0f-2000-4389-a5ce-93a3e20d0faf",
+ "resources" : [ {
+ "type" : "OS::Nova::Server",
+ "id" : "9506416d-db6c-406e-8bca-c0f43793d914",
+ "name" : "resource_9506416d-db6c-406e-8bca-c0f43793d914",
+ "extra_info" : {
+ }
+ } ],
+ "name" : "server protect plan for 9506416d-db6c-406e-8bca-c0f43793d914"
+ }
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query whether a resource can be backed up.
+POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/action
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
check_protectable + |
+Yes + |
+List<protectable_param> + |
+Query parameter list +For details, see Table 3. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
resource_id + |
+Yes + |
+String + |
+ID of the resource (server or disk) to be checked +For details about how to obtain the server ID, see the Elastic Cloud Server API Reference. For details about how to obtain the disk ID, see the Elastic Volume Service API Reference. + |
+
resource_type + |
+Yes + |
+String + |
+Type of the resource to be checked, for example, OS::Nova::Server for an ECS + |
+
POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/action
+{
+ "check_protectable" : [ {
+ "resource_id" : "6507cb66-90dc-4a12-a573-c9f3398f899d",
+ "resource_type" : "OS::Nova::Server"
+ } ]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
protectable + |
+List<check_resp> + |
+Check result list +For details, see Table 5. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
result + |
+Boolean + |
+Whether the resource can be backed up +true: yes +false: no + |
+
resource_type + |
+String + |
+Resource type +Possible values are OS::Nova::Server (ECS) and OS::Ironic::BareMetalServer (BMS). + |
+
error_code + |
+String + |
+Error code. If an error occurs, a value is returned. + |
+
error_msg + |
+String + |
+Error message, which will be returned if the VM is associated with a backup policy. If an error occurs, a value is returned. + |
+
resource_id + |
+String + |
+Resource ID + |
+
{
+ "protectable" : [ {
+ "resource_id" : "6507cb66-90dc-4a12-a573-c9f3398f899d",
+ "resource_type" : "OS::Nova::Server",
+ "result" : true
+ } ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to check whether a target resource can be restored.
+POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/action
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
check_restorable + |
+Yes + |
+List<restorable_param> + |
+Query parameter list +For details, see Table 3. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
checkpoint_item_id + |
+Yes + |
+String + |
+ID of the backup used to restore data + |
+
target + |
+Yes + |
+restorable_target + |
+Restoration target +For details, see Table 4. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
resource_id + |
+Yes + |
+String + |
+ID of the resource to which the backup is restored + |
+
resource_type + |
+Yes + |
+String + |
+Type of the target to which the backup is restored, for example, OS::Nova::Server for an ECS + |
+
volumes + |
+Yes + |
+List<restore_volume_mapping> + |
+Disk mapping list for restoring an ECS. Enter the mapping between disks and backups based on the actual situation. +For details, see Table 5. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup_id + |
+Yes + |
+String + |
+Disk backup ID. Use the API in Querying a Single Backup to obtain the disk backup ID. + |
+
volume_id + |
+Yes + |
+String + |
+ID of the destination disk for the restoration + |
+
POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/resources/action
+{
+ "check_restorable" : [ {
+ "checkpoint_item_id" : "8986ce68-3da7-4d29-9cc2-1921e9504975",
+ "target" : {
+ "resource_type" : "OS::Nova::Server",
+ "resource_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
+ "volumes" : [ {
+ "backup_id" : "7ea119a8-d25b-43a7-8d1b-88e12788513a",
+ "volume_id" : "45baf976-c20a-4894-a7c3-c94b7376bf55"
+ } ]
+ }
+ } ]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
restorable + |
+List<check_resp> + |
+Response parameter list +For details, see Table 7. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
result + |
+Boolean + |
+Whether the resource can be restored + |
+
resource_type + |
+String + |
+Resource type + |
+
error_code + |
+String + |
+Error code + |
+
error_msg + |
+String + |
+Error reason + |
+
resource_id + |
+String + |
+Resource ID + |
+
{
+ "restorable" : [ {
+ "resource_id" : "6507cb66-90dc-4a12-a573-c9f3398f899d",
+ "resource_type" : "OS::Nova::Server",
+ "result" : true,
+ "error_msg" : "",
+ "error_code" : ""
+ } ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to create a backup policy to back up servers periodically.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
policy + |
+Yes + |
+policy_create + |
+Creation parameters +For details, see Table 3. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
description + |
+No + |
+String + |
+Backup policy description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
name + |
+Yes + |
+String + |
+Backup policy name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
parameters + |
+Yes + |
+policy_param + |
+Backup parameters +For details, see Table 4. + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resources + |
+Yes + |
+List<resource> + |
+Backup object list. The list can be blank. +For details, see Table 5. + |
+
scheduled_operations + |
+Yes + |
+List<scheduled_operation_create> + |
+Scheduling period +For details, see Table 6. + |
+
tags + |
+No + |
+List<resource_tag> + |
+Tag list +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
id + |
+Yes + |
+String + |
+Backup object ID + |
+
type + |
+Yes + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+Yes + |
+String + |
+Backup object name + |
+
extra_info + |
+No + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
description + |
+No + |
+String + |
+Scheduling period description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
enabled + |
+Yes + |
+Boolean + |
+Whether the backup policy is enabled +If it is set to true, automatic scheduling is enabled. If it is set to false, automatic scheduling is disabled but you can execute the policy manually. + |
+
name + |
+No + |
+String + |
+Scheduling period name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
operation_type + |
+Yes + |
+String + |
+Operation type +Enumeration values: backup + |
+
operation_definition + |
+Yes + |
+operation_definition + |
+Scheduling period parameters +For details, see Table 7. + |
+
trigger + |
+Yes + |
+trigger + |
+Scheduling policy + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
max_backups + |
+No + |
+Integer + |
+Maximum number of backups that can be automatically created for a backup object. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by quantity limit. + |
+
retention_duration_days + |
+No + |
+Integer + |
+Duration of retaining a backup, in days. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by retention duration. + |
+
permanent + |
+No + |
+Boolean + |
+Whether backups are permanently retained. false: no. true: yes + |
+
plan_id + |
+No + |
+String + |
+Backup policy ID + |
+
provider_id + |
+No + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
day_backups + |
+No + |
+Integer + |
+Maximum number of daily backups that can be retained. The latest backup of each day is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
week_backups + |
+No + |
+Integer + |
+Maximum number of weekly backups that can be retained. The latest backup of each week is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
month_backups + |
+No + |
+Integer + |
+Maximum number of monthly backups that can be retained. The latest backup of each month is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
year_backups + |
+No + |
+Integer + |
+Maximum number of yearly backups that can be retained. The latest backup of each year is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
timezone + |
+No + |
+String + |
+Time zone where the user is located, for example, UTC+08:00. Set this parameter only after you have configured any of the parameters day_backups, week_backups, month_backups, and year_backups. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
properties + |
+Yes + |
+trigger_properties + |
+Scheduler properties +For details, see Table 9. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
pattern + |
+Yes + |
+String + |
+Scheduling policy of the scheduler. The value consists of a maximum of 10,240 characters. The scheduling policy complies with iCalendar RFC 2445, but it supports only four parameters, which are FREQ, BYDAY, BYHOUR, and BYMINUTE. FREQ can be set only to WEEKLY or DAILY. BYDAY can be set to MO, TU, WE, TH, FR, SA, or SU (seven days of a week). BYHOUR ranges from 0 to 23 hours. BYMINUTE ranges from 0 to 59 minutes. The scheduling interval cannot be less than 1 hour. A maximum of 24 time points are allowed in a day. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+Yes + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
POST https://{endpoint}/v1/{project_id}/policies
+{
+ "policy" : {
+ "name" : "my-plan",
+ "description" : "My plan",
+ "provider_id" : "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "scheduled_operations" : [ {
+ "name" : "my-backup-policy",
+ "description" : "My backup policy",
+ "enabled" : true,
+ "operation_definition" : {
+ "max_backups" : 20
+ },
+ "trigger" : {
+ "properties" : {
+ "pattern" : "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nRRULE:FREQ=WEEKLY;BYDAY=TH;BYHOUR=12;BYMINUTE=27\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"
+ }
+ },
+ "operation_type" : "backup"
+ }
+
+ ],
+ "resources" : [ {
+ "id" : "45baf976-c20a-4894-a7c3-c94b7376bf55",
+ "type" : "OS::Nova::Server",
+ "name" : "resource1",
+ }, {
+ "id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
+ "type" : "OS::Nova::Server",
+ "name" : "resource2"
+ } ]
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
policy + |
+policy_resp + |
+For details, see Table 12. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
description + |
+String + |
+Backup policy description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
id + |
+String + |
+Backup policy ID + |
+
name + |
+String + |
+Backup policy name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
parameters + |
+policy_param + |
+Parameters of a backup policy +For details, see Table 13. + |
+
project_id + |
+String + |
+Project ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resources + |
+List<resource> + |
+Backup object list +For details, see Table 14. + |
+
scheduled_operations + |
+List<scheduled_operation_resp> + |
+Scheduling period list +For details, see Table 15. + |
+
status + |
+String + |
+Backup policy status +disabled: indicates that the backup policy is unavailable. +enabled: indicates that the backup policy is available. + |
+
tags + |
+List<resource_tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup object ID + |
+
type + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+String + |
+Backup object name + |
+
extra_info + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
description + |
+String + |
+Scheduling period description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
enabled + |
+Boolean + |
+Whether the scheduling period is enabled +The default value is true. If it is set to false, automatic scheduling is disabled but manual scheduling is supported. + |
+
name + |
+String + |
+Scheduling period name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
operation_type + |
+String + |
+Operation type +Enumeration values: backup + |
+
operation_definition + |
+operation_definition + |
+Scheduling period parameters +For details, see Table 16. + |
+
trigger + |
+trigger_resp + |
+Scheduling policy + |
+
id + |
+String + |
+Scheduling period ID + |
+
trigger_id + |
+String + |
+Scheduler ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
max_backups + |
+String + |
+Maximum number of backups that can be automatically created for a backup object. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by quantity limit. + |
+
retention_duration_days + |
+String + |
+Duration of retaining a backup, in days. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by retention duration. + |
+
permanent + |
+String + |
+Whether backups are permanently retained + |
+
plan_id + |
+String + |
+Backup policy ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
properties + |
+trigger_properties_resp + |
+Scheduler properties +For details, see Parameter description of field trigger_properties_resp. + |
+
id + |
+String + |
+Scheduler ID + |
+
name + |
+String + |
+Scheduler name + |
+
type + |
+String + |
+Scheduling type. The value is fixed at time. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
pattern + |
+String + |
+Scheduling policy of the scheduler +The value consists of a maximum of 10,240 characters. The scheduling policy complies with iCalendar RFC 2445, but it supports only four parameters, which are FREQ, BYDAY, BYHOUR, and BYMINUTE. FREQ can be set to WEEKLY and DAILY, BYDAY can be set to MO, TU, WE, TH, FR, SA, and SU (seven days of a week), BYHOUR ranges from 0 hours to 23 hours, and BYMINUTE ranges from 0 minutes to 59 minutes. The scheduling interval must not be less than 1 hour. A maximum of 24 time points are allowed in a day. + |
+
start_time + |
+String + |
+Scheduler start time, for example, 2017-04-18T01:21:52 + |
+
format + |
+String + |
+Scheduler type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "policy" : {
+ "created_at" : "2017-03-07T09:27:40.928000",
+ "description" : "My plan",
+ "id" : "f766c171-9336-479a-8b30-b83cabf6381e",
+ "name" : "my-plan",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "project_id" : "tenant",
+ "provider_id" : "c714180d-ea34-4b13-9a5e-577c7c416eec",
+ "resources" : [ {
+ "id" : "45baf976-c20a-4894-a7c3-c94b7376bf55",
+ "name" : "resource1",
+ "type" : "OS::Nova::Server",
+ "extra_info" : {
+ }
+ }, {
+ "id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
+ "name" : "resource2",
+ "type" : "OS::Nova::Server"
+ } ],
+ "scheduled_operations" : [ {
+ "description" : "My backup policy",
+ "enabled" : true,
+ "id" : "9303a23d-e433-48e7-b88a-5ee6442e434e",
+ "name" : "my-backup-policy",
+ "operation_definition" : {
+ "max_backups" : "20",
+ "plan_id" : "f766c171-9336-479a-8b30-b83cabf6381e",
+ "provider_id" : "c714180d-ea34-4b13-9a5e-577c7c416eec"
+ },
+ "operation_type" : "backup",
+ "trigger" : {
+ "id" : "8178846b-766d-4fe6-941f-b38c76b6f3b9",
+ "name" : "default",
+ "properties" : {
+ "pattern" : "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nRRULE:FREQ=WEEKLY;BYDAY=TH;BYHOUR=12;BYMINUTE=27\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
+ "start_time" : "2017-03-07 09:27:41",
+ "format" : "ical"
+ },
+ "type" : "time"
+ },
+ "trigger_id" : "8178846b-766d-4fe6-941f-b38c76b6f3b9"
+ }
+,
+ ],
+ "status" : "suspended"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to delete a backup policy by ID.
+None
+DELETE https://{endpoint}/v1/{project_id}/policies/{policy_id}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to update a backup policy by ID.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
policy + |
+Yes + |
+policy_update + |
+For details, see Table 3. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
description + |
+No + |
+String + |
+Backup policy description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
name + |
+No + |
+String + |
+Backup policy name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
resources + |
+No + |
+List<resource> + |
+Backup objects +For details, see Table 4. + |
+
scheduled_operations + |
+No + |
+List<scheduled_operation_update> + |
+Scheduling period. A backup policy has only one backup period. +For details, see Table 5. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
id + |
+Yes + |
+String + |
+Backup object ID + |
+
type + |
+Yes + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+Yes + |
+String + |
+Backup object name + |
+
extra_info + |
+No + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
description + |
+No + |
+String + |
+Scheduling period description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
enabled + |
+No + |
+Boolean + |
+Whether the backup policy is enabled +The default value is true. If it is set to false, automatic scheduling is disabled but manual scheduling is supported. + |
+
name + |
+No + |
+String + |
+Scheduling period name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
operation_definition + |
+No + |
+operation_definition + |
+Scheduling period parameter +For details, see Table 6. + |
+
trigger + |
+No + |
+trigger + |
+Scheduling policy + |
+
id + |
+Yes + |
+String + |
+Scheduling period ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
max_backups + |
+No + |
+Integer + |
+Maximum number of backups that can be automatically created for a backup object. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by quantity limit. + |
+
retention_duration_days + |
+No + |
+Integer + |
+Duration of retaining a backup, in days. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by retention duration. + |
+
permanent + |
+No + |
+Boolean + |
+Whether backups are permanently retained + |
+
plan_id + |
+No + |
+String + |
+Backup policy ID + |
+
provider_id + |
+No + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
day_backups + |
+No + |
+Integer + |
+Maximum number of daily backups that can be retained. The latest backup of each day is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
week_backups + |
+No + |
+Integer + |
+Maximum number of weekly backups that can be retained. The latest backup of each week is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
month_backups + |
+No + |
+Integer + |
+Maximum number of monthly backups that can be retained. The latest backup of each month is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
year_backups + |
+No + |
+Integer + |
+Maximum number of yearly backups that can be retained. The latest backup of each year is saved in the long term. This parameter and max_backups will both be applied. If this parameter is configured, timezone is mandatory. + |
+
timezone + |
+No + |
+String + |
+Time zone where the user is located, for example, UTC+08:00. Set this parameter only after you have configured any of the parameters day_backups, week_backups, month_backups, and year_backups. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
properties + |
+Yes + |
+trigger_properties + |
+Scheduler properties +For details, see Table 8. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
pattern + |
+Yes + |
+String + |
+Scheduling policy of the scheduler +The value consists of a maximum of 10,240 characters. The scheduling policy complies with iCalendar RFC 2445, but it supports only four parameters, which are FREQ, BYDAY, BYHOUR, and BYMINUTE. FREQ can be set to WEEKLY and DAILY, BYDAY can be set to MO, TU, WE, TH, FR, SA, and SU (seven days of a week), BYHOUR ranges from 0 hours to 23 hours, and BYMINUTE ranges from 0 minutes to 59 minutes. The scheduling interval must not be less than 1 hour. A maximum of 24 time points are allowed in a day. + |
+
PUT https://{endpoint}/v1/{project_id}/policies/{policy_id}
+{
+ "policy" : {
+ "name" : "my-plan",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "scheduled_operations" : [ {
+ "id" : "fed3c8f1-7b6e-4e24-b1ad-473838bad569",
+ "name" : "my-backup-policy",
+ "description" : "My backup policy ",
+ "enabled" : true,
+ "operation_definition" : {
+ "retention_duration_days" : -1,
+ "max_backups" : 20
+ },
+ "trigger" : {
+ "properties" : {
+ "pattern" : "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nRRULE:FREQ=WEEKLY;BYDAY=TH;BYHOUR=12;BYMINUTE=27\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"
+ }
+ }
+ }
+ ]
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
policy + |
+policy_resp + |
+For details, see Table 10. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
description + |
+String + |
+Backup policy description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
id + |
+String + |
+Backup policy ID + |
+
name + |
+String + |
+Backup policy name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
parameters + |
+policy_param + |
+Parameters of a backup policy +For details, see Table 11. + |
+
project_id + |
+String + |
+Project ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resources + |
+List<resource> + |
+Backup object list +For details, see Table 12. + |
+
scheduled_operations + |
+List<scheduled_operation_resp> + |
+Scheduling period list +For details, see Table 13. + |
+
status + |
+String + |
+Backup policy status +
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup object ID + |
+
type + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+String + |
+Backup object name + |
+
extra_info + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
description + |
+String + |
+Scheduling period description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
enabled + |
+Boolean + |
+Whether the scheduling period is enabled +The default value is true. If it is set to false, automatic scheduling is disabled but manual scheduling is supported. + |
+
name + |
+String + |
+Scheduling period name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
operation_type + |
+String + |
+Operation type +Enum:[ backup] + |
+
operation_definition + |
+operation_definition + |
+Scheduling period parameters +For details, see Table 14. + |
+
trigger + |
+trigger_resp + |
+Scheduling policy +For details, see Table 15. + |
+
id + |
+String + |
+Scheduling period ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
max_backups + |
+String + |
+Maximum number of backups that can be automatically created for a backup object. +The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by quantity limit. + |
+
retention_duration_days + |
+String + |
+Duration of retaining a backup, in days. +The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by retention duration. + |
+
permanent + |
+String + |
+Whether backups are permanently retained + |
+
plan_id + |
+String + |
+Backup policy ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
properties + |
+trigger_properties_resp + |
+Scheduler properties +For details, see Table 16. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
pattern + |
+String + |
+Scheduling policy of the scheduler +The value consists of a maximum of 10,240 characters. The scheduling policy complies with iCalendar RFC 2445, but it supports only four parameters, which are FREQ, BYDAY, BYHOUR, and BYMINUTE. FREQ can be set to WEEKLY and DAILY, BYDAY can be set to MO, TU, WE, TH, FR, SA, and SU (seven days of a week), BYHOUR ranges from 0 hours to 23 hours, and BYMINUTE ranges from 0 minutes to 59 minutes. The scheduling interval must not be less than 1 hour. A maximum of 24 time points are allowed in a day. + |
+
start_time + |
+String + |
+Start time of the scheduler + |
+
format + |
+String + |
+Scheduler type +The value is fixed at ical (Internet calendar). + |
+
{
+ "policy" : {
+ "status" : "disabled",
+ "provider_id" : "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
+ "description" : "",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "scheduled_operations" : [ {
+ "description" : "My backup policy ",
+ "enabled" : true,
+ "trigger" : {
+ "properties" : {
+ "pattern" : "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nRRULE:FREQ=WEEKLY;BYDAY=TH;BYHOUR=12;BYMINUTE=27\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
+ "start_time" : "2017-04-09 14:31:25",
+ "format" : "ical"
+ }
+ },
+ "operation_definition" : {
+ "provider_id" : "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
+ "plan_id" : "17e2b861-3a35-434d-afbb-073d5cd5af08",
+ "max_backups" : "20",
+ "retention_duration_days" : "-1",
+ "permanent" : "False",
+
+ },
+ "operation_type" : "backup",
+ "id" : "fed3c8f1-7b6e-4e24-b1ad-473838bad569",
+ "name" : "my-backup-policy"
+ }
+,
+ "format" : "ical"
+ ],
+ "id" : "17e2b861-3a35-434d-afbb-073d5cd5af08",
+ "name" : "my-plan",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "created_at" : "2017-04-09T14:31:25.504569",
+ "project_id" : "0c89d4e457c3401a89c65420fd45f3a2",
+ "resources" : [ {
+ "type" : "OS::Nova::Server",
+ "id" : "8421f405-1334-4206-b71c-b3f64d39abc4",
+ "name" : "wqeq3",
+ "extra_info" : {
+ }
+ } ]
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query a backup policy by ID.
+None
+GET https://{endpoint}/v1/{project_id}/policies/{policy_id}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
policy + |
+policy_resp + |
+Query response + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
description + |
+String + |
+Backup policy description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
id + |
+String + |
+Backup policy ID + |
+
name + |
+String + |
+Backup policy name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
parameters + |
+policy_param + |
+Parameters of a backup policy + |
+
project_id + |
+String + |
+Project ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resources + |
+List<resource> + |
+Backup object list + |
+
scheduled_operations + |
+List<scheduled_operation_resp> + |
+Scheduling period list + |
+
status + |
+String + |
+Backup policy status + |
+
tags + |
+List<resource_tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
common + |
+common_param + |
+General backup policy parameters, which are blank by default + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup object ID + |
+
type + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+String + |
+Backup object name + |
+
extra_info + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
description + |
+String + |
+Scheduling period description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
enabled + |
+Boolean + |
+Whether the scheduling period is enabled +The default value is true. If it is set to false, automatic scheduling is disabled but manual scheduling is supported. + |
+
name + |
+String + |
+Scheduling period name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
operation_type + |
+String + |
+Operation type +Enumeration values: backup + |
+
operation_definition + |
+operation_definition + |
+Scheduling period parameters + |
+
trigger + |
+trigger_resp + |
+Scheduling policy + |
+
id + |
+String + |
+Scheduling period ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
max_backups + |
+Integer + |
+Maximum number of backups that can be automatically created for a backup object. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by quantity limit. + |
+
retention_duration_days + |
+Integer + |
+Duration of retaining a backup, in days. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by retention duration. + |
+
permanent + |
+Boolean + |
+Whether backups are permanently retained + |
+
plan_id + |
+String + |
+Backup policy ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
properties + |
+trigger_properties_resp + |
+Scheduler properties + |
+
id + |
+String + |
+Scheduler ID + |
+
name + |
+String + |
+Scheduler name + |
+
type + |
+String + |
+Scheduling type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
pattern + |
+String + |
+Scheduling policy of the scheduler +The value consists of a maximum of 10,240 characters. The scheduling policy complies with iCalendar RFC 2445, but it supports only four parameters, which are FREQ, BYDAY, BYHOUR, and BYMINUTE. FREQ can be set to WEEKLY and DAILY, BYDAY can be set to MO, TU, WE, TH, FR, SA, and SU (seven days of a week), BYHOUR ranges from 0 hours to 23 hours, and BYMINUTE ranges from 0 minutes to 59 minutes. The scheduling interval must not be less than 1 hour. A maximum of 24 time points are allowed in a day. + |
+
start_time + |
+String + |
+Scheduler start time, for example, 2017-04-18T01:21:52.701973 + |
+
format + |
+String + |
+Scheduler type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "policy" : {
+ "created_at" : "2017-03-07T09:31:08.265000",
+ "description" : "My plan",
+ "id" : "27b11f3f-578d-4464-89d1-7c6d5894f753",
+ "name" : "my-plan",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "project_id" : "tenant",
+ "provider_id" : "c714180d-ea34-4b13-9a5e-577c7c416eec",
+ "resources" : [ {
+ "id" : "45baf976-c20a-4894-a7c3-c94b7376bf55",
+ "name" : "resource1",
+ "type" : "OS::Nova::Server",
+ "extra_info" : {
+ }
+ }, {
+ "id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
+ "name" : "resource2",
+ "type" : "OS::Nova::Server",
+ "extra_info" : {
+ }
+ } ],
+ "scheduled_operations" : [ {
+ "description" : "My backup policy",
+ "enabled" : true,
+ "id" : "3b2fdf8c-2cc2-4887-9605-a8443922f6f2",
+ "name" : "my-backup-policy",
+ "operation_definition" : {
+ "max_backups" : "20",
+ "plan_id" : "27b11f3f-578d-4464-89d1-7c6d5894f753",
+ "provider_id" : "c714180d-ea34-4b13-9a5e-577c7c416eec"
+ },
+ "operation_type" : "backup",
+ "trigger" : {
+ "id" : "f1246246-ec6a-4e9a-917e-d050dc2808c9",
+ "name" : "default",
+ "properties" : {
+ "pattern" : "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nRRULE:FREQ=WEEKLY;BYDAY=TH;BYHOUR=12;BYMINUTE=27\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
+ "start_time" : "2017-03-07 09:31:08",
+ "format": "ical"
+ },
+ "type" : "time"
+ },
+ "trigger_id" : "f1246246-ec6a-4e9a-917e-d050dc2808c9"
+ } ],
+ "status" : "disabled"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query the backup policy list. Filtering parameters are supported.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
limit + |
+No + |
+Integer + |
+Number of resources displayed per page. The value must be a positive integer. The value defaults to 1000. + |
+
marker + |
+No + |
+String + |
+ID of the last record displayed on the previous page when pagination query is applied + |
+
sort + |
+No + |
+String + |
+The value of sort is a group of properties separated by commas (,) and sorting directions. The value format is <key1>[:<direction>],<key2>[:<direction>], where the value of direction is asc (in ascending order) or desc (in descending order). If the parameter direction is not specified, backup policies are sorted in descending order by time. The value of sort contains a maximum of 255 characters. + |
+
name + |
+No + |
+String + |
+Exact matching based on field name + |
+
all_tenants + |
+No + |
+Boolean + |
+Whether backup policies of all tenants can be queried +This parameter is only available for administrators. + |
+
offset + |
+No + |
+Integer + |
+Offset value, which is a positive integer. + |
+
None
+Querying all backup policies:
+GET https://{endpoint}/v1/{project_id}/policies
+Querying backup policies with certain conditions:
+GET https://{endpoint}/v1/{project_id}/policies?sort=created_at%3Aasc&limit=3&offset=3
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
policies + |
+List<policy_resp> + |
+For details, see the policy_resp field description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
description + |
+String + |
+Backup policy description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
id + |
+String + |
+Backup policy ID + |
+
name + |
+String + |
+Backup policy name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
parameters + |
+policy_param + |
+Parameters of a backup policy + |
+
project_id + |
+String + |
+Project ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resources + |
+List<resource> + |
+Backup object list + |
+
scheduled_operations + |
+List<scheduled_operation_resp> + |
+Scheduling period list + |
+
status + |
+String + |
+Backup policy status + |
+
tags + |
+List<resource_tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
common + |
+common_param + |
+General backup policy parameters, which are blank by default + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup object ID + |
+
type + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+String + |
+Backup object name + |
+
extra_info + |
+Dict + |
+Additional information about the backup object + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
description + |
+String + |
+Scheduling period description +The value consists of 0 to 255 characters and must not contain a greater-than sign (>) or less-than sign (<). + |
+
enabled + |
+Boolean + |
+Whether the scheduling period is enabled +The default value is true. If it is set to false, automatic scheduling is disabled but manual scheduling is supported. + |
+
name + |
+String + |
+Scheduling period name +The value consists of 1 to 255 characters and can contain only letters, digits, underscores (_), and hyphens (-). + |
+
operation_type + |
+String + |
+Operation type +Enumeration values: backup + |
+
operation_definition + |
+operation_definition + |
+Scheduling period parameters + |
+
trigger + |
+trigger_resp + |
+Scheduling policy + |
+
id + |
+String + |
+Scheduling period ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
max_backups + |
+Integer + |
+Maximum number of backups that can be automatically created for a backup object. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by quantity limit. + |
+
retention_duration_days + |
+Integer + |
+Duration of retaining a backup, in days. The value can be -1 or ranges from 0 to 99999. If the value is set to -1, backups will not be cleared by retention duration. + |
+
permanent + |
+Boolean + |
+Whether backups are permanently retained + |
+
plan_id + |
+String + |
+Backup policy ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
properties + |
+trigger_properties_resp + |
+Scheduler properties + |
+
id + |
+String + |
+Scheduler ID + |
+
name + |
+String + |
+Scheduler name + |
+
type + |
+String + |
+Scheduling type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
pattern + |
+String + |
+Scheduling policy of the scheduler +The value consists of a maximum of 10,240 characters. The scheduling policy complies with iCalendar RFC 2445, but it supports only four parameters, which are FREQ, BYDAY, BYHOUR, and BYMINUTE. FREQ can be set to WEEKLY and DAILY, BYDAY can be set to MO, TU, WE, TH, FR, SA, and SU (seven days of a week), BYHOUR ranges from 0 hours to 23 hours, and BYMINUTE ranges from 0 minutes to 59 minutes. The scheduling interval must not be less than 1 hour. A maximum of 24 time points are allowed in a day. + |
+
start_time + |
+String + |
+Start time of the scheduler, for example, 2017-03-07 09:31:08 + |
+
format + |
+String + |
+Scheduler type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "policies" : [ {
+ "created_at" : "2017-03-07T09:31:08.265000",
+ "description" : "My plan",
+ "id" : "27b11f3f-578d-4464-89d1-7c6d5894f753",
+ "name" : "my-plan",
+ "parameters" : {
+ "common" : {
+ }
+ },
+ "project_id" : "tenant",
+ "provider_id" : "c714180d-ea34-4b13-9a5e-577c7c416eec",
+ "resources" : [ {
+ "id" : "45baf976-c20a-4894-a7c3-c94b7376bf55",
+ "name" : "resource1",
+ "type" : "OS::Nova::Server",
+ "extra_info" : {
+ }
+ }, {
+ "id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
+ "name" : "resource2",
+ "type" : "OS::Nova::Server",
+ "extra_info" : {
+ }
+ } ],
+ "scheduled_operations" : [ {
+ "description" : "My backup policy",
+ "enabled" : true,
+ "id" : "3b2fdf8c-2cc2-4887-9605-a8443922f6f2",
+ "name" : "my-backup-policy",
+ "operation_definition" : {
+ "max_backups" : "20",
+ "plan_id" : "27b11f3f-578d-4464-89d1-7c6d5894f753",
+ "provider_id" : "c714180d-ea34-4b13-9a5e-577c7c416eec"
+ },
+ "operation_type" : "backup",
+ "trigger" : {
+ "id" : "f1246246-ec6a-4e9a-917e-d050dc2808c9",
+ "name" : "default",
+ "properties" : {
+ "pattern" : "BEGIN:VCALENDAR\r\nBEGIN:VEVENT\r\nRRULE:FREQ=WEEKLY;BYDAY=TH;BYHOUR=12;BYMINUTE=27\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
+ "start_time" : "2017-03-07 09:31:08",
+ "format": "ical"
+ },
+ "type" : "time"
+ },
+ "trigger_id" : "f1246246-ec6a-4e9a-917e-d050dc2808c9"
+ } ],
+ "status" : "disabled"
+ } ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to manually execute a backup policy and create a backup task.
+POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
checkpoint + |
+Yes + |
+checkpoint_req + |
+For details, see the checkpoint_req field description. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
parameters + |
+Yes + |
+checkpoint_param + |
+Backup parameters + |
+
plan_id + |
+Yes + |
+String + |
+Backup policy ID. Refer to the backup policy ID that is returned by the API of Querying the Backup Policy List. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
auto_trigger + |
+No + |
+Boolean + |
+Whether automatic trigger is enabled + |
+
resources + |
+No + |
+List<String> + |
+ID list of resources to be backed up + |
+
POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints
+{
+ "checkpoint" : {
+ "plan_id" : "62171999-3df1-42f7-9513-6f9b1bea4744",
+ "parameters" : {
+ "auto_trigger" : false,
+ "resources" : [ "7a32a8b5-7977-4e24-b5da-e0eb457db75b", "b2b433bf-7dd6-4a74-aa8f-85673dfbda48" ]
+ }
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint + |
+checkpoint_resp + |
+See the checkpoint_resp field description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Status. The value can be protecting, deleting, available, or error. + |
+
created_at + |
+String + |
+Creation time, for example, 2016-12-06T21:20:29.898823 + |
+
id + |
+String + |
+Backup record ID + |
+
resource_graph + |
+String + |
+Resource diagram, which displays the mapping relationship between resources and backups. If the value is null, the backup contains only the resource backup of the entire system. + |
+
project_id + |
+String + |
+Project ID + |
+
protection_plan + |
+plan_resp + |
+Backup policy information + |
+
extra_info + |
+String + |
+Additional information about the backup object, such as the backup creation mode + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup policy ID + |
+
name + |
+String + |
+Backup policy name + |
+
resources + |
+List<resource> + |
+Backup object list + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Backup object ID + |
+
type + |
+String + |
+Entity object type of backup objects +The value is fixed at OS::Nova::Server (ECSs). + |
+
name + |
+String + |
+Backup object name + |
+
extra_info + |
+String + |
+Additional information of the resource + |
+
{
+ "checkpoint" : {
+ "status" : "protecting",
+ "created_at" : "2016-12-06T21:20:29.898823",
+ "id" : "14626f11-b54a-44ea-8e69-7463e527506a",
+ "resource_graph" : null,
+ "project_id" : "b942cc8342734d15bcb246babb1953cf",
+ "protection_plan" : {
+ "id" : "6a6cda7e-7b89-4b14-8e5c-3b6821a97d2c",
+ "resources" : [ {
+ "type" : "OS::Nova::Server",
+ "id" : "1c960fe4-e679-421a-97cd-4f7463d2344b",
+ "name" : "server0",
+ "extra_info": "{}"
+ } ],
+ "name" : "backup"
+ },
+ "extra_info": "{"created_by": "manual"}"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to delete a backup.
+
The deletion operation is asynchronous. Tasks will be queued depending on the background task execution status. Therefore, the deletion will not be completed immediately. You need to query the task information continuously to obtain the deletion result. A maximum of 30 minutes is required.
+For example, a user can execute a maximum of five backup deletion tasks concurrently. If the number exceeds five, the sixth and subsequent tasks are queued.
+DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
checkpoint_id + |
+Yes + |
+String + |
+Backup record ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
checkpoint_items + |
+No + |
+String + |
+Indicates the ID list of the backup records to be deleted. If this parameter is not set, all backup records of checkpoint will be deleted. + |
+
Deleting all backups in the specified backup record:
+DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}
+Deleting a single backup in the specified backup record:
+DELETE https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/{checkpoint_id}?checkpoint_items={checkpoint_items_id}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query the number of backups. Filtering parameters are supported.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
status + |
+No + |
+String + |
+Query based on field status is supported. +Value range: waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, and deleted + |
+
all_tenants + |
+No + |
+Boolean + |
+Whether to query the backups of all tenants. Only administrators can query the backups of all tenants. + |
+
name + |
+No + |
+String + |
+Supports query by backup name. + |
+
az + |
+No + |
+String + |
+AZ-based filtering is supported. + |
+
resource_id + |
+No + |
+String + |
+Filtering based on the backup object ID is supported. + |
+
resource_name + |
+No + |
+String + |
+Filtering based on the backup object name is supported. + |
+
start_time + |
+No + |
+String + |
+Filtering based on the backup time is supported. This is the backup start time. For example, 2017-04-15T04:25:38 + |
+
end_time + |
+No + |
+String + |
+Filtering based on the backup time is supported. This is the backup end time. For example, 2017-04-15T04:25:38 + |
+
image_type + |
+No + |
+String + |
+Supports filtering by backup image type. This parameter can be used only when images are created using backups. The image type can be obtained from Image Management Service. + |
+
policy_id + |
+No + |
+String + |
+Filtering based on policy_id is supported. + |
+
ip + |
+No + |
+String + |
+Searching based on the VM's IP address is supported. + |
+
checkpoint_id + |
+No + |
+String + |
+Filtering based on checkpoint_id is supported. + |
+
resource_type + |
+No + |
+String + |
+Type of the backup object. For example, OS::Nova::Server + |
+
Querying the total number of backups:
+GET https://{endpoint}/v1/{project_id}/checkpoint_items/count
+Querying the number of backups with certain conditions:
+GET https://{endpoint}/v1/{project_id}/checkpoint_items/count?status=error
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
count + |
+Integer + |
+Number of backups + |
+
{
+ "count" : 10
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query a single backup by ID.
+GET https://{endpoint}/v1/{project_id}/checkpoint_items/{checkpoint_item_id}
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
checkpoint_item_id + |
+Yes + |
+String + |
+Backup ID + |
+
GET https://{endpoint}/v1/{project_id}/checkpoint_items/{checkpoint_item_id}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint_item + |
+checkpoint_item + |
+For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint_id + |
+String + |
+Backup record ID + |
+
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
extend_info + |
+Dict + |
+Extension information + |
+
id + |
+String + |
+Backup ID + |
+
name + |
+String + |
+Backup name + |
+
resource_id + |
+String + |
+Backup object ID + |
+
status + |
+String + |
+Backup status +Value range: waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, and deleted + |
+
updated_at + |
+String + |
+Modification time, for example, 2017-04-18T01:21:52.701973 + |
+
backup_data + |
+Dict + |
+VM metadata + |
+
description + |
+string + |
+Backup description + |
+
tags + |
+List<resource_tag> + |
+List of backup tags +Keys in the tag list must be unique. + |
+
resource_type + |
+String + |
+Backup object type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
auto_trigger + |
+Boolean + |
+Whether automatic trigger is enabled + |
+
average_speed + |
+Integer + |
+Average rate. The unit is kb/s + |
+
copy_from + |
+String + |
+The destination region of a backup replication. The value is left blank by default. + |
+
copy_status + |
+String + |
+Backup replication status. The default value is na. +Possible values are na, waiting_copy, copying, success, and fail. + |
+
fail_code + |
+fail_code + |
+Error code + |
+
fail_op + |
+String + |
+Type of the failed operation +Enum: [backup, restore, delete] + |
+
fail_reason + |
+String + |
+Description of the failure cause + |
+
image_type + |
+String + |
+Backup type, for example, backup + |
+
incremental + |
+Boolean + |
+Whether the backup is an enhanced backup + |
+
progress + |
+Integer + |
+Backup progress. The value is an integer ranging from 0 to 100. + |
+
resource_az + |
+String + |
+AZ to which the backup resource belongs + |
+
resource_name + |
+String + |
+Backup object name + |
+
resource_type + |
+String + |
+Type of the backup object. For example, OS::Nova::Server + |
+
size + |
+Integer + |
+Backup capacity. The unit is MB. + |
+
space_saving_ratio + |
+Integer + |
+Space saving rate + |
+
volume_backups + |
+List<volume_backup> + |
+Disk backup list + |
+
finished_at + |
+String + |
+Backup completion time, for example, 2017-04-18T01:21:52.701973 + |
+
supported_restore_mode + |
+String + |
+Restoration mode. Possible values are na, snapshot, and backup. +backup: Data is restored from backups of the disks of the server. +na: Restoration is not supported. + |
+
os_images_data + |
+List<image_data> + |
+Image data. This parameter has a value if an image has been created for the VM. + |
+
support_lld + |
+Boolean + |
+Whether to allow lazyloading for fast restoration + |
+
taskid + |
+String + |
+Job ID + |
+
hypervisor_type + |
+String + |
+Virtualization type +The value is fixed at QEMU. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
__openstack_region_name + |
+String + |
+Name of the AZ where the server is located. If this parameter is left blank, such information about the server has not been obtained. + |
+
cloudservicetype + |
+String + |
+Server type +The value is fixed at server (ECSs). + |
+
disk + |
+Integer + |
+System disk size corresponding to the server specifications + |
+
imagetype + |
+String + |
+Image type +The value can be: +gold: public image +private: private image +market: market image + |
+
ram + |
+Integer + |
+Memory size of the server, in MB + |
+
vcpus + |
+Integer + |
+CPU cores corresponding to the server + |
+
eip + |
+String + |
+Elastic IP address of the server. If this parameter is left blank, such information about the server has not been obtained. + |
+
private_ip + |
+String + |
+Internal IP address of the server. If this parameter is left blank, such information about the server has not been obtained. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
image_id + |
+String + |
+Image ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
Code + |
+Long + |
+Error code + |
+
Description + |
+String + |
+Error description + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
average_speed + |
+Integer + |
+Average rate, in MB/s + |
+
bootable + |
+Boolean + |
+Whether the disk functions as a system disk +The value can be true or false. + |
+
id + |
+String + |
+Cinder backup ID + |
+
image_type + |
+String + |
+Backup set type +Enum:[ backup] + |
+
incremental + |
+Boolean + |
+Whether incremental backup is used + |
+
name + |
+String + |
+Disk backup name + |
+
size + |
+Integer + |
+Accumulated size (MB) of backups + |
+
source_volume_id + |
+String + |
+Source disk ID + |
+
source_volume_size + |
+Integer + |
+Source disk size in GB + |
+
space_saving_ratio + |
+Integer + |
+Space saving rate + |
+
status + |
+String + |
+Status + |
+
source_volume_name + |
+String + |
+Source disk name + |
+
snapshot_id + |
+String + |
+ID of the snapshot from which the backup is generated + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "checkpoint_item": {
+ "status": "available",
+ "backup_data": {
+ "eip": "",
+ "cloudservicetype": "",
+ "ram": 4096,
+ "vcpus": 4,
+ "__openstack_region_name": "",
+ "private_ip": "",
+ "disk": 0,
+ "imagetype": ""
+ },
+ "name": "backup_d32c",
+ "resource_id": "f45c477a-57e5-465f-999f-d845083962db",
+ "created_at": "2017-04-15T04:20:37.277880",
+ "checkpoint_id": "f672a1bb-6912-446a-816c-72792c5263e0",
+ "updated_at": "2017-04-15T04:25:38.680638",
+ "resource_type": "OS::Nova::Server",
+ "extend_info": {
+ "auto_trigger": false,
+ "space_saving_ratio": 0,
+ "copy_status": "na",
+ "fail_reason": "",
+ "resource_az": "az1.dc1",
+ "image_type": "backup",
+ "finished_at": "2017-04-15T04:25:38.675478",
+ "average_speed": 0,
+ "copy_from": "",
+ "supported_restore_mode": "backup",
+ "support_lld": false,
+ "os_images_data": [
+ {
+ "image_id": "fe84dd80-0229-4918-8d3d-cbb33154b565"
+ }
+ ],
+ "volume_backups": [
+ {
+ "status": "available",
+ "space_saving_ratio": 0,
+ "name": "manualbk_47222",
+ "bootable": true,
+ "average_speed": 0,
+ "source_volume_size": 20,
+ "source_volume_id": "ee27f809-6fb5-40ae-ac46-c932bb4ee8fe",
+ "incremental": false,
+ "image_type": "backup",
+ "source_volume_name": "karbor_02",
+ "id": "70675cbc-d3a8-43a7-9f81-c8b6bc3f5d6d",
+ "size": 0,
+ "snapshot_id": "36f520e1-d2ea-4907-956a-3d9cd53e2d38"
+ },
+ {
+ "status": "available",
+ "space_saving_ratio": 0,
+ "name": "manualbk_47222",
+ "bootable": true,
+ "average_speed": 0,
+ "source_volume_size": 20,
+ "source_volume_id": "e7f48980-927c-48de-afd4-f0245d2e5100",
+ "incremental": false,
+ "image_type": "backup",
+ "source_volume_name": "karbor_01",
+ "id": "8eb98e91-8924-4d4b-b6d6-28fb7b751e9c",
+ "size": 0,
+ "snapshot_id": "36f520e1-d2ea-4907-956a-3d9cd53e2d38"
+ }
+ ],
+ "fail_code": {},
+ "incremental": false,
+ "taskid": "e0a21692-2192-11e7-bf23-0242ac110007",
+ "hypervisor_type": "QEMU",
+ "progress": 100,
+ "fail_op": "",
+ "resource_name": "karbor_02",
+ "size": 0
+ },
+ "id": "90c1d5fa-1b9f-4aeb-b2f4-81c806e98190"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query all backups. Filtering parameters are supported.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
status + |
+No + |
+String + |
+Query based on field status is supported. +Value range: waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, and deleted + |
+
limit + |
+No + |
+Integer + |
+Number of resources displayed per page. The value must be a positive integer. The value defaults to 1000. + |
+
marker + |
+No + |
+String + |
+ID of the last record displayed on the previous page + |
+
sort + |
+No + |
+String + |
+A group of properties separated by commas (,) and sorting directions. The value format is <key1>[:<direction>],<key2>[:<direction>], where the value of direction is asc (in ascending order) or desc (in descending order). If the parameter direction is not specified, the default sorting direction is desc. The value of sort contains a maximum of 255 characters. Enumeration values of the key are as follows: created_at, updated_at, name, status, protected_at, and id. + |
+
all_tenants + |
+No + |
+Boolean + |
+Whether to query the backups of all tenants. Only administrators can query the backups of all tenants. + |
+
name + |
+No + |
+String + |
+Fuzzy search based on field name is supported. + |
+
az + |
+No + |
+String + |
+Filtering based on the backup AZ is supported. + |
+
resource_id + |
+No + |
+String + |
+Filtering based on the backup object ID is supported. + |
+
resource_name + |
+No + |
+String + |
+Fuzzy search based on the backup object name is supported. + |
+
start_time + |
+No + |
+String + |
+Filtering based on the backup start time is supported. +For example: 2017-04-18T01:21:52.701973 + |
+
end_time + |
+No + |
+String + |
+Filtering based on the backup end time is supported. +For example: 2017-04-18T01:21:52.701973 + |
+
image_type + |
+No + |
+String + |
+Supports filtering by image type, for example, backup. + |
+
policy_id + |
+No + |
+String + |
+Filtering based on policy_id is supported. + |
+
offset + |
+No + |
+Integer + |
+Offset value, which is a positive integer. + |
+
checkpoint_id + |
+No + |
+String + |
+Filtering based on checkpoint_id is supported. + |
+
resource_type + |
+No + |
+String + |
+Type of the backup object. For example, OS::Nova::Server + |
+
Querying all backups:
+GET https://{endpoint}/v1/{project_id}/checkpoint_items
+Querying backups with specified parameters:
+GET https://{endpoint}/v1/{project_id}/checkpoint_items?name=backup&status=error&limit=2
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint_items + |
+List<checkpoint_item> + |
+- + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint_id + |
+String + |
+Backup record ID + |
+
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
extend_info + |
+Dict + |
+Extension information + |
+
id + |
+String + |
+Backup ID + |
+
name + |
+String + |
+Backup name + |
+
resource_id + |
+String + |
+Backup object ID + |
+
status + |
+String + |
+Backup status +The value can be waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, or deleted. + |
+
updated_at + |
+String + |
+Modification time, for example, 2017-04-18T01:21:52.701973 + |
+
backup_data + |
+Dict + |
+VM metadata + |
+
description + |
+string + |
+Backup description + |
+
tags + |
+List<resource_tag> + |
+List of backup tags +Keys in the tag list must be unique. + |
+
resource_type + |
+String + |
+Backup object type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
auto_trigger + |
+Boolean + |
+Whether automatic trigger is enabled + |
+
average_speed + |
+Integer + |
+Average rate. The unit is kb/s + |
+
copy_from + |
+String + |
+The destination region of a backup replication. The value is left blank by default. + |
+
copy_status + |
+String + |
+Backup replication status. The default value is na. +Possible values are na, waiting_copy, copying, success, and fail. + |
+
fail_code + |
+fail_code + |
+Error code + |
+
fail_op + |
+String + |
+Type of the failed operation +Enum: [backup, restore, delete] + |
+
fail_reason + |
+String + |
+Description of the failure cause + |
+
image_type + |
+String + |
+Backup type, for example, backup + |
+
incremental + |
+Boolean + |
+Whether the backup is an enhanced backup + |
+
progress + |
+Integer + |
+Backup progress. The value is an integer ranging from 0 to 100. + |
+
resource_az + |
+String + |
+AZ to which the backup resource belongs + |
+
resource_name + |
+String + |
+Backup object name + |
+
resource_type + |
+String + |
+Type of the backup object. For example, OS::Nova::Server + |
+
size + |
+Integer + |
+Backup capacity. The unit is MB. + |
+
space_saving_ratio + |
+Integer + |
+Space saving rate + |
+
volume_backups + |
+List<volume_backup> + |
+Disk backup list + |
+
finished_at + |
+String + |
+Backup completion time, for example, 2017-04-18T01:21:52.701973 + |
+
supported_restore_mode + |
+String + |
+Restoration mode. Possible values are na, snapshot, and backup. +backup: Data is restored from backups of the disks of the server. +na: Restoration is not supported. + |
+
os_images_data + |
+List<image_data> + |
+Image data. This parameter has a value if an image has been created for the VM. + |
+
support_lld + |
+Boolean + |
+Whether to allow lazyloading for fast restoration + |
+
taskid + |
+String + |
+Job ID + |
+
hypervisor_type + |
+String + |
+Virtualization type +The value is fixed at QEMU. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
image_id + |
+String + |
+Image ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
__openstack_region_name + |
+String + |
+Name of the AZ where the server is located. If this parameter is left blank, such information about the server has not been obtained. + |
+
cloudservicetype + |
+String + |
+Server type + |
+
disk + |
+Integer + |
+System disk size corresponding to the server specifications + |
+
imagetype + |
+String + |
+Image type +The value can be: +gold: public image +private: private image +market: market image + |
+
ram + |
+Integer + |
+Memory size of the server, in MB + |
+
vcpus + |
+Integer + |
+CPU cores corresponding to the server + |
+
eip + |
+String + |
+Elastic IP address of the server. If this parameter is left blank, such information about the server has not been obtained. + |
+
private_ip + |
+String + |
+Internal IP address of the server. If this parameter is left blank, such information about the server has not been obtained. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
Code + |
+Long + |
+Error code + |
+
Description + |
+String + |
+Error description + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
average_speed + |
+Integer + |
+Average rate, in MB/s + |
+
bootable + |
+Boolean + |
+Whether the disk functions as a system disk +The value can be true or false. + |
+
id + |
+String + |
+Cinder backup ID + |
+
image_type + |
+String + |
+Backup set type +Enum:[ backup] + |
+
incremental + |
+Boolean + |
+Whether incremental backup is used + |
+
name + |
+String + |
+Disk backup name + |
+
size + |
+Integer + |
+Accumulated size (MB) of backups + |
+
source_volume_id + |
+String + |
+Source disk ID + |
+
source_volume_size + |
+Integer + |
+Source disk size in GB + |
+
space_saving_ratio + |
+Integer + |
+Space saving rate + |
+
status + |
+String + |
+Status + |
+
source_volume_name + |
+String + |
+Source disk name + |
+
snapshot_id + |
+String + |
+ID of the snapshot from which the backup is generated + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "checkpoint_items" : [ {
+ "status" : "available",
+ "backup_data" : {
+ "eip" : "",
+ "cloudservicetype" : "",
+ "ram" : 4096,
+ "vcpus" : 4,
+ "__openstack_region_name" : "",
+ "private_ip" : "",
+ "disk" : 0,
+ "imagetype" : ""
+ },
+ "name" : "backup_d32c",
+ "resource_id" : "f45c477a-57e5-465f-999f-d845083962db",
+ "created_at" : "2017-04-15T04:20:37.277880",
+ "checkpoint_id" : "f672a1bb-6912-446a-816c-72792c5263e0",
+ "updated_at" : "2017-04-15T04:25:38.680638",
+ "resource_type": "OS::Nova::Server",
+ "extend_info" : {
+ "auto_trigger" : false,
+ "space_saving_ratio" : 0,
+ "copy_status" : "na",
+ "fail_reason" : "",
+ "resource_az" : "az1.dc1",
+ "image_type" : "backup",
+ "finished_at" : "2017-04-15T04:25:38.675478",
+ "average_speed" : 0,
+ "copy_from" : "",
+ "supported_restore_mode": "backup",
+ "support_lld": false,
+ "os_images_data": [
+ {
+ "image_id": "fe84dd80-0229-4918-8d3d-cbb33154b565"
+ }
+ ],
+ "volume_backups" : [ {
+ "status" : "available",
+ "space_saving_ratio" : 0,
+ "name" : "manualbk_47222",
+ "bootable" : true,
+ "average_speed" : 0,
+ "source_volume_size" : 20,
+ "source_volume_id" : "ee27f809-6fb5-40ae-ac46-c932bb4ee8fe",
+ "incremental" : false,
+ "image_type" : "backup",
+ "source_volume_name" : "karbor_xj_02",
+ "id" : "70675cbc-d3a8-43a7-9f81-c8b6bc3f5d6d",
+ "size" : 0,
+ "snapshot_id": "36f520e1-d2ea-4907-956a-3d9cd53e2d38"
+ }, {
+ "status" : "available",
+ "space_saving_ratio" : 0,
+ "name" : "manualbk_47222",
+ "bootable" : true,
+ "average_speed" : 0,
+ "source_volume_size" : 20,
+ "source_volume_id" : "e7f48980-927c-48de-afd4-f0245d2e5100",
+ "incremental" : false,
+ "image_type" : "backup",
+ "source_volume_name" : "karbor_01",
+ "id" : "8eb98e91-8924-4d4b-b6d6-28fb7b751e9c",
+ "size" : 0,
+ "snapshot_id": "36f520e1-d2ea-4907-956a-3d9cd53e2d38"
+ } ],
+ "fail_code" : { },
+ "incremental" : false,
+ "taskid" : "e0a21692-2192-11e7-bf23-0242ac110007",
+ "hypervisor_type" : "QEMU",
+ "progress" : 100,
+ "fail_op" : "",
+ "resource_name" : "karbor_02",
+ "size" : 0
+ },
+ "id" : "90c1d5fa-1b9f-4aeb-b2f4-81c806e98190"
+ } ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to perform backup-based restoration.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
restore + |
+Yes + |
+restore_req + |
+Restoration request + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
checkpoint_id + |
+Yes + |
+String + |
+Backup record ID + |
+
parameters + |
+Yes + |
+restore_param + |
+Restoration parameters + |
+
provider_id + |
+Yes + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
restore_target + |
+No + |
+String + |
+Restoration target + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
checkpoint_item_id + |
+Yes + |
+String + |
+Backup ID + |
+
power_on + |
+Yes + |
+Boolean + |
+Whether to instantly power on the VM after restoration + |
+
targets + |
+Yes + |
+restore_target + |
+Restoration target + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
server_id + |
+Yes + |
+String + |
+ID of the ECS to be restored + |
+
volumes + |
+Yes + |
+List<restore_volume_mapping> + |
+List of the mappings between disk backups and target disks + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
backup_id + |
+Yes + |
+String + |
+Disk backup ID + |
+
volume_id + |
+Yes + |
+String + |
+ID of the destination disk for the restoration + |
+
POST https://{endpoint}/v1/{project_id}/restores
+{
+ "restore" : {
+ "provider_id" : "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
+ "checkpoint_id" : "a2b9fb53-2770-4fcd-9bad-6cadd56e6c09",
+ "parameters" : {
+ "checkpoint_item_id" : "504b7d59-c361-411f-9ed3-814f35d08e3d",
+ "power_on" : true,
+ "targets" : {
+ "server_id" : "f45c477a-57e5-465f-999f-d845083962db",
+ "volumes" : [ {
+ "backup_id" : "bc118c24-3234-4afd-8423-d66d3d677649",
+ "volume_id" : "ee27f809-6fb5-40ae-ac46-c932bb4ee8fe"
+ }]
+ }
+ }
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
restore + |
+restore_resp + |
+Restoration response + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Restoration ID + |
+
checkpoint_id + |
+String + |
+Backup record ID + |
+
parameters + |
+restore_param + |
+Restoration parameters + |
+
project_id + |
+String + |
+Project ID + |
+
provider_id + |
+String + |
+Backup provider ID, which specifies whether the backup object is a server or disk. This parameter has a fixed value. For CSBS, the value is fc4d5750-22e7-4798-8a46-f48f62c4c1da. + |
+
resources_reason + |
+Dict + |
+Cause of the resource restoration failure + |
+
resources_status + |
+Dict + |
+Resource status after the resource is restored, for example, available + |
+
restore_target + |
+String + |
+Restoration target + |
+
status + |
+String + |
+Status + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint_item_id + |
+String + |
+Backup ID + |
+
power_on + |
+Boolean + |
+Whether to power on the VM after restoration + |
+
targets + |
+restore_target + |
+Restoration target + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
server_id + |
+String + |
+ID of the ECS to be restored + |
+
volumes + |
+List<restore_volume_mapping> + |
+List of the mappings between disk backups and target disks + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
backup_id + |
+String + |
+Disk backup ID + |
+
volume_id + |
+String + |
+ID of the disk to which data is restored + |
+
{
+ "restore" : {
+ "restore_target" : "http://192.168.1.2:35357/v2.0/",
+ "status" : "in_progress",
+ "provider_id" : "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
+ "resources_status" : in_progress,
+ "parameters" : {
+ "power_on" : true,
+ "targets" : {
+ "server_id" : "f45c477a-57e5-465f-999f-d845083962db",
+ "volumes" : [ {
+ "backup_id" : "bc118c24-3234-4afd-8423-d66d3d677649",
+ "volume_id" : "ee27f809-6fb5-40ae-ac46-c932bb4ee8fe"
+ } ]
+ },
+ "checkpoint_item_id" : "504b7d59-c361-411f-9ed3-814f35d08e3d"
+ },
+ "checkpoint_id" : "a2b9fb53-2770-4fcd-9bad-6cadd56e6c09",
+ "project_id" : "b942cc8342734d15bcb246babb1953cf",
+ "id" : "d3a54e80-6483-485d-98f6-c0409e6f2e0a",
+ "resources_reason" : { }
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
For details, see Error Codes.
+This API is used to query tenant quotas.
+GET https://{endpoint}/v1/{project_id}/quotas
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
quotas + |
+quota + |
+See the quota field description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+List<resource_resp> + |
+Quota resources + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
unit + |
+String + |
+Unit + |
+
used + |
+Integer + |
+Used quota + |
+
quota + |
+Integer + |
+Quota size + |
+
type + |
+String + |
+Type +backup_capacity specifies the backup storage capacity quota. Value -1 indicates no restriction on the quota size. +backups specifies the number of retained backups. + |
+
{
+ "quotas" : {
+ "resources" : [{
+ "type" : "backup_capacity",
+ "unit" : "GB",
+ "quota" : -1,
+ "used" : 0
+ },
+ {
+ "used": 0,
+ "type": "backups",
+ "quota": 600
+ }]
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid request parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+No operation permission. + |
+
404 + |
+Requested object not found. + |
+
500 + |
+Service internal error. + |
+
503 + |
+Service unavailable. + |
+
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.
+An example response error is returned as follows:
+{
+ "error_code": xxxx,//Error code
+ "error_msg": xxxxx//Error message
+}
+Table 1 describes the error codes.
+ +Status Code + |
+Error Code + |
+Error Message + |
+Description + |
+Solution + |
+
|---|---|---|---|---|
400 + |
+CSBS.0001 + |
+Service over limit + |
+The number of backup policies has reached the upper limit. + |
+Delete an existing backup policy and try again. + |
+
400 + |
+CSBS.6000 + |
+server do not exist + |
+The server does not exist. + |
+Check whether the server exists. + |
+
400 + |
+CSBS.6001 + |
+The server has stopped. + |
+The server has stopped. + |
+Check whether the server has stopped. + |
+
400 + |
+CSBS.6003 + |
+Resource (%s) type (%s) is not support protection. + |
+Currently, only cloud server backup is supported. + |
+Select servers and add them to the backup policy. + |
+
400 + |
+CSBS.6005 + |
+Server (%s) is already in service. + |
+The current server status does not allow backup. + |
+Ensure that the server status allows restoration and try again. + |
+
400 + |
+CSBS.6006 + |
+Server (%s) status (%s) is not allowed to protect. + |
+This type of server does not support backup. + |
+Select servers of a correct type. + |
+
400 + |
+CSBS.6007 + |
+No volume attached to the server (%s) for protect. + |
+Servers without EVS disks do not support backup. + |
+Check whether an EVS disk is attached to the server. + |
+
400 + |
+CSBS.6010 + |
+Volume (%s) attached to server (%s) is shareable volume. + |
+The server does not support backup, because it hosts shared EVS disks. + |
+Remove the shared disk and perform the backup again. + |
+
400 + |
+CSBS.6013 + |
+Resource (%s) type (%s) is not support restoration. + |
+Only server restoration is supported currently. + |
+Select servers for restoration. + |
+
400 + |
+CSBS.6014 + |
+Volume(s) (%s) not found in target server. + |
+The specified EVS disk is not attached to the server to be restored. + |
+Select an EVS disk attached to the server to be restored. + |
+
400 + |
+CSBS.6015 + |
+The server is restoring. + |
+The server in the current status cannot be restored. + |
+Ensure that the server status allows restoration and try again. + |
+
400 + |
+CSBS.9001 + |
+provider invalid + |
+Parameter verification failed. + |
+Enter the correct parameter. + |
+
403 + |
+CSBS.9009 + |
+User is unverified. + |
+The user is not authenticated by real name. Authenticate the user's real name and try again. + |
+Authenticate the user's real name and try again. + |
+
400 + |
+CSBS.9009 + |
+The backup or replication space after reduction cannot be less than the used space. + |
+The backup or replication space after applying for reduction is less than the used space. + |
+Ensure that the remaining space is greater than the used space. + |
+
500 + |
+CSBS.9998 + |
+System not support + |
+Service unavailable + |
+Try later or contact technical support. + |
+
500 + |
+CSBS.9999 + |
+%s failed + |
+System internal error + |
+Try later or contact technical support. + |
+
400 + |
+CSBS.0002 + |
+Volume of services from different storagetype + |
+The volumes of the server have different storage types. (Not used currently.) + |
+Use the same type of volumes. + |
+
500 + |
+CSBS.1001 + |
+The policy is executing backup. + |
+The backup task cannot be executed, because a manual backup task is being executed. + |
+Re-execute the backup task after the manual backup task is complete. + |
+
400 + |
+CSBS.2003 + |
+item in executing + |
+The selected backup is in the Backing up, Restoring, or Deleting state. + |
+Try again after the task is complete. + |
+
400 + |
+CSBS.2004 + |
+item in plan executing + |
+The policy is being executed for backup. Try again after the backup is complete. + |
+Try again after the task is complete. + |
+
404 + |
+CSBS.3001 + |
+Checkpoint_item (%s) is not found. + |
+The backup does not exist. + |
+Check whether the backup exists. + |
+
400 + |
+CSBS.6027 + |
+The AZ where the resource (%s) is located does not support backup. + |
+The AZ to which the ECS belongs does not support backup. + |
+Contact the administrator to reconfigure the AZ. + |
+
500 + |
+CSBS.6030 + |
+auto plan executing + |
+The backup task cannot be executed, because an automatic backup task is being executed. + |
+Re-execute the backup task after the automatic backup task is complete. + |
+
400 + |
+CSBS.6031 + |
+manual copy executing + |
+The replication task cannot be executed, because a manual replication task is being executed. + |
+Re-execute the replication task after the manual replication task is complete. + |
+
500 + |
+CSBS.6032 + |
+plan has no resource backup + |
+There are no servers that can be backed up in the backup policy. + |
+Bind the policy to servers or wait until the bound server is restored to a state that supports backup. + |
+
400 + |
+CSBS.6033 + |
+Service type of volume %s(belong to server %s) is dss. + |
+A server with DSS disks cannot be backed up. + |
+Check whether a dedicated storage disk has been attached to the server. + |
+
400 + |
+CSBS.6061 + |
+volume of server in this pod does not support backup + |
+The current server does not support backup or restoration. + |
+Deselect the disks that do not support backup and retry. + |
+
500 + |
+CSBS.8001 + |
+The backup status is not allowed to create image + |
+Backups in the current status cannot be registered as images. + |
+Try later or contact technical support. + |
+
400 + |
+CSBS.8007 + |
+The backup {checkpoint_item_id} has register to image, can't be delete + |
+An image has been created by using the backup and the backup cannot be deleted. + |
+Delete the created image first and then the backup. + |
+
500 + |
+CSBS.8008 + |
+The backup {checkpoint_item_id}'s status is not allowed query + |
+The current backup status does not support query. + |
+Check whether the backup exists. + |
+
500 + |
+CSBS.8009 + |
+The backup has not system disk backup is not allowed to create image + |
+The backup does not contain the system disk data and cannot be used to create an image. + |
+Check whether the backup contains a system disk. + |
+
400 + |
+CSBS.9006 + |
+Quota exceeded for resources: %s + |
+Insufficient quota + |
+Contact the administrator to change the quota or delete the backups that are no longer needed. + |
+
500 + |
+CSBS.1002 + |
+resource_in_protecting + |
+The selected server is being backed up. (Not used currently.) + |
+Try again after the backup task is complete. + |
+
500 + |
+CSBS.2001 + |
+item in plan is executing + |
+A task is being executed by using this backup policy. (Not used currently.) + |
+Try again after the task is complete. + |
+
404 + |
+CSBS.3000 + |
+plan not found + |
+The backup policy does not exist. + |
+Check whether the backup policy exists. + |
+
500 + |
+CSBS.5001 + |
+Scheduel operation status can't be set unable + |
+Failed to stop the policy. + |
+Check the backup policy status. + |
+
400 + |
+CSBS.6004 + |
+Server (%s) is already in service. + |
+The server has been bound to a backup policy and cannot be bound again. + |
+Check whether the server has been bound to a backup policy. + |
+
400 + |
+CSBS.9007 + |
+duplicate service name + |
+The backup policy name already exists. + |
+Change the name and try again. + |
+
400 + |
+CSBS.7000 + |
+request tags exceed the max allowed count: %s. + |
+The resource's tags have reached the upper limit. + |
+Delete unnecessary tags and try again. + |
+
404 + |
+CSBS.7001 + |
+The backup tag does not exist. + |
+The resource tag to be deleted does not exist. + |
+Refresh the page to check whether the tag has been deleted. + |
+
400 + |
+CSBS.4000 + |
+checkpoint item not available + |
+The current backup status does not allow restoration. + |
+Try again later or contact technical support. + |
+
400 + |
+CSBS.6016 + |
+can not restore server type is not allow + |
+This type of server does not support restoration. + |
+Select servers of a correct type. + |
+
400 + |
+CSBS.6017 + |
+Can not find backup(s) (%s) in checkpoint item (%s). + |
+The specified backup disk is not in the specified backup. + |
+Select a backup disk in the specified backup for restoration. + |
+
400 + |
+CSBS.6018 + |
+Not assign backup(s) (%s) to volume(s), partial restore is not supported." + |
+The system does not support the restoration of some backup disks in the backup. + |
+Select all backup disks in the backup for restoration. + |
+
500 + |
+CSBS.6019 + |
+The source server (%s) type (%s) is not the same as the target server (%s) type (%s). + |
+The type of the target server is different from that of the source server. + |
+Select a target server of the same type as the source server. + |
+
400 + |
+CSBS.6020 + |
+No volume attached to the server (%s) for restore. + |
+Servers without EVS disks do not support restoration. + |
+Check whether an EVS disk is attached to the server. + |
+
400 + |
+CSBS.6021 + |
+Volume (%s) attached to server (%s) is shareable volume. + |
+The backup cannot be restored to a shared EVS disk of the server. + |
+Restore the backup to a non-shared EVS disk of the server. + |
+
500 + |
+CSBS.6023 + |
+Can not restore data volume to system volume. server id is (%s). + |
+The backup for a data disk cannot be restored to a system disk of the server. + |
+Restore the backup to a data disk of the server. + |
+
400 + |
+CSBS.6024 + |
+Target volume (%s) size (%s) small than volume backup (%s) size (%s). + |
+Restoration cannot be executed because the size of the disk attached to the server is smaller than the backup size. + |
+Expand the disk and try again, or restore backup data to a disk that has a larger size than the backup. + |
+
400 + |
+CSBS.6025 + |
+The AZ of local checkpoint item (%s) is not support to restore the resource (%s). + |
+Restoration is not supported between the AZ to which the specified backup belongs and the AZ to which the server belongs. + |
+Contact the administrator to reconfigure the AZ. + |
+
400 + |
+CSBS.9008 + |
+Checkpoint Item Status Not Support Create VM + |
+Only backups in the Available state can be used to create ECSs. + |
+Check whether the backup is available. + |
+
404 + |
+CSBS.6040 + |
+task not found + |
+The backup job to be deleted does not exist. + |
+Check whether the backup job exists. + |
+
Karbor native APIs:
+http://developer.openstack.org/api-ref/data-protection-orchestration/v1/index.html
+Release Date + |
+What's New + |
+
|---|---|
2022-08-19 + |
+Updated the following content: +Optimized some descriptions in this document. + |
+
2021-08-30 + |
+Updated the following content: +Deleted the parameters field and the table that describes the policy_param field from section "Updating a Backup Policy." + |
+
2021-07-21 + |
+Updated the following content: +Deleted the description of parameter app_consistency. + |
+
2020-03-06 + |
+Updated the following content: +Optimized the descriptions of parameters day_backups, week_backups, month_backups, and year_backups in section "Creating a Backup Policy." + |
+
2020-03-05 + |
+Updated the following content: +
|
+
2020-02-17 + |
+Updated the following content: +
|
+
2020-02-11 + |
+Updated the following content: +
|
+
2019-02-12 + |
+Updated the following content: +Modified the description of the enabled parameter in section "Creating a Backup Policy." + |
+
2019-02-02 + |
+Updated the following content: +Changed the enabled parameter in section "Creating a Backup Policy" to mandatory and modified the parameter description. + |
+
2018-10-15 + |
+Updated the following content: +
|
+
2018-09-07 + |
+Accepted in OTC-3.2. + |
+
2018-08-15 + |
+Updated the following content: +Modified the description of the pattern parameter. + |
+
2018-07-30 + |
+Updated the following content: +Added fields related to BMS backup. + |
+
2018-06-26 + |
+Updated the following content: +
|
+
2018-05-03 + |
+Updated the following content: +Deleted the former sections 1 API Calling and 2 Common Message Headers, and added section 1 API Usage Guidelines. + |
+
2018-03-30 + |
+Updated the following content: +Added APIs related to tag management. + |
+
2018-01-23 + |
+Updated the following content: +
|
+
2017-09-08 + |
+Updated the following content: +Some ease-of-use issues are resolved. + |
+
2017-07-30 + |
+This issue is the first official release. + |
+
This API is used to filter resources by tag.
+Tag Management Service (TMS) uses this API to filter and list resources of each service by tag. These services must have the query capabilities.
+POST https://{endpoint}/v1/{project_id}/csbs_backup/resource_instances/action
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+No + |
+List<tag> + |
+List of included tags. Backups with 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. +Keys in this list are in an AND relationship. +The response returns resources containing all 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. + |
+
tags_any + |
+No + |
+List<tag> + |
+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. + |
+
not_tags + |
+No + |
+List<tag> + |
+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. + |
+
not_tags_any + |
+No + |
+List<tag> + |
+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. + |
+
limit + |
+No + |
+String + |
+Query count (This parameter is not displayed if action is set to count.) +If action is set to filter, the value defaults to 1000. The value ranges from 1 to 1000. If you set a value out of this range, an error will be reported. The number of returned records does not exceed the value of limit. + |
+
offset + |
+No + |
+String + |
+Query index (This parameter is not displayed if action is set to count.) +If action is set to filter, the value defaults to 0 (minimum value). The first record in the query result is the offset+1 record that meets the query criteria. + |
+
action + |
+Yes + |
+String + |
+Operation type +Possible values are filter and count. +filter indicates pagination query and count indicates that a specified number of queried records will be returned. + |
+
matches + |
+No + |
+List<match> + |
+List of query criteria supported by resources +This list cannot be an empty list. +Keys in this list must be unique. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +A tag key consists of up to 127 characters. +A tag key cannot be an empty string. +Spaces before and after a key will be deprecated. + |
+
values + |
+Yes + |
+List<String> + |
+List of tag values +The list can contain up to 10 values. +A tag value consists of up to 255 characters. +Spaces before and after a key will be deprecated. +Values in this list must be unique. +Values in this list are in an OR relationship. +This list can be empty and each value can be an empty character string. +If this list is left blank, it indicates that all values are included. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +Possible values are: +resource_name: indicates the resource name. + |
+
value + |
+Yes + |
+String + |
+Tag value +A tag value consists of up to 255 characters. +If key is set to resource_name, an empty character string indicates exact matching and any non-empty string indicates fuzzy matching. + |
+
POST https://{endpoint}/v1/{project_id}/csbs_backup/resource_instances/action
+{
+ "offset": "100",
+ "limit": "100",
+ "action": "filter",
+ "matches": [{
+ "key": "resource_name",
+ "value": "resource1"
+ }
+ ],
+ "not_tags": [{
+ "key": "key1",
+ "values": [
+ "*value1",
+ "value2"
+ ]
+ }
+ ],
+ "tags": [{
+ "key": "key1",
+ "values": [
+ "*value1",
+ "value2"
+ ]
+ }
+ ],
+ "tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "not_tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ]
+}
+{
+ "action": "count",
+ "not_tags": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "*value2"
+ ]
+ }
+ ],
+ "tags": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "not_tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "matches": [{
+ "key": "resource_name",
+ "value": "resource1"
+ }
+ ]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+List<resource> + |
+List of matched resources (This parameter is not displayed if action is set to count.) + |
+
total_count + |
+Integer + |
+Total number of matched resources + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resource_id + |
+String + |
+Resource ID + |
+
resource_detail + |
+Object + |
+Resource details +Backup details, including tags + |
+
tags + |
+List<resource_tag> + |
+Tag list + |
+
resource_name + |
+String + |
+Resource name + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
checkpoint_id + |
+String + |
+Backup record ID + |
+
created_at + |
+String + |
+Creation time, for example, 2017-04-18T01:21:52.701973 + |
+
extend_info + |
+Dict + |
+Extension information + |
+
id + |
+String + |
+Backup ID + |
+
name + |
+String + |
+Backup name + |
+
resource_id + |
+String + |
+Backup object ID + |
+
status + |
+String + |
+Backup status +Value range: waiting_protect, protecting, available, waiting_restore, restoring, error, waiting_delete, deleting, and deleted + |
+
updated_at + |
+String + |
+Modification time, for example, 2017-04-18T01:21:52.701973 + |
+
backup_data + |
+Dict + |
+VM metadata + |
+
description + |
+string + |
+Backup description + |
+
tags + |
+List<resource_tag> + |
+Tag list + |
+
resource_type + |
+String + |
+Backup object type + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
auto_trigger + |
+Boolean + |
+Whether automatic trigger is enabled + |
+
average_speed + |
+Integer + |
+Average speed + |
+
copy_from + |
+String + |
+This parameter is left blank by default. + |
+
copy_status + |
+String + |
+This parameter is left blank by default. + |
+
fail_code + |
+fail_code + |
+Error code + |
+
fail_op + |
+String + |
+Type of the failed operation +Enum: [backup, restore, delete, verify, copy] + |
+
fail_reason + |
+String + |
+Description of the failure cause + |
+
image_type + |
+String + |
+Backup type + |
+
incremental + |
+Boolean + |
+Whether incremental backup is used + |
+
progress + |
+Integer + |
+Backup progress. The value is an integer ranging from 0 to 100. + |
+
resource_az + |
+String + |
+AZ to which the backup resource belongs + |
+
resource_name + |
+String + |
+Backup object name + |
+
resource_type + |
+String + |
+Backup object type + |
+
size + |
+Integer + |
+Backup capacity + |
+
space_saving_ratio + |
+Integer + |
+Space saving rate + |
+
volume_backups + |
+List<volume_backup> + |
+Disk backup list + |
+
finished_at + |
+String + |
+Backup completion time, for example, 2017-04-18T01:21:52.701973 + |
+
supported_restore_mode + |
+String + |
+Restoration mode. Possible values are na, snapshot, and backup. +snapshot: Data is restored from snapshots of the disks of the server. +backup: Data is restored from backups of the disks of the server. +na: Restoration is not supported. + |
+
tags + |
+List<resource_tag> + |
+Tag list + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
__openstack_region_name + |
+String + |
+Name of the AZ where the ECS resides + |
+
cloudservicetype + |
+String + |
+ECS type + |
+
disk + |
+String + |
+System disk size corresponding to the ECS specifications + |
+
imagetype + |
+String + |
+Image type. Possible values are gold (public image), private (private image), and market (market image). +Enum: [gold, private, market] + |
+
ram + |
+String + |
+Memory size of the ECS, in MB + |
+
vcpus + |
+String + |
+CPU cores corresponding to the ECS + |
+
eip + |
+String + |
+Elastic IP address of the ECS + |
+
private_ip + |
+String + |
+Internal IP address of the ECS + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
image_id + |
+String + |
+Image ID + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
Code + |
+Long + |
+Error code + |
+
Description + |
+String + |
+Error description + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
average_speed + |
+Integer + |
+Average speed + |
+
bootable + |
+Boolean + |
+Whether the disk functions as a system disk + |
+
id + |
+String + |
+Cinder backup ID + |
+
image_type + |
+String + |
+Backup set type +Enum:[ backup] + |
+
incremental + |
+Boolean + |
+Whether incremental backup is used + |
+
name + |
+String + |
+Disk backup name + |
+
size + |
+Integer + |
+Accumulated size (MB) of backups + |
+
source_volume_id + |
+String + |
+Source disk ID + |
+
source_volume_size + |
+Integer + |
+Source disk size in GB + |
+
space_saving_ratio + |
+Integer + |
+Space saving rate + |
+
status + |
+String + |
+Status + |
+
source_volume_name + |
+String + |
+Source disk name + |
+
snapshot_id + |
+String + |
+ID of the snapshot from which the backup is generated + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + + |
+
{
+ "status":"aviable",
+ "backup_data":{
+ "eip":"",
+ "cloudservicetype":"QEMU",
+ "ram":1024,
+ "__openstack_region_name":"",
+ "vcpus":1,
+ "private_ip":"",
+ "disk":0,
+ "imagetype":"gold"
+ },
+ "periodic_type":null,
+ "name":"manualbk_ea67",
+ "resource_id":"58482e0b-a357-4125-bdad-102f796b0e0c",
+ "created_at":"2020-02-11T06:34:43.897750",
+ "checkpoint_id":"ee45c782-71f8-4265-8392-e31fc701836c",
+ "replication_records":[
+
+ ],
+ "updated_at":"2020-02-11T06:38:29.765609",
+ "protected_at":"2020-02-11T06:30:26.000000",
+ "tags":[
+
+ ],
+ "extend_info":{
+ "auto_trigger":false,
+ "finished_at":"2020-02-11T06:38:29.748932",
+ "volume_backups":[
+
+ ],
+ "incremental":true,
+ "copy_from":null,
+ "dec_size":0,
+ "size":0,
+ "resource_az":"br-iaas-odin1b",
+ "copy_status":"na",
+ "image_type":"backup",
+ "average_speed":0,
+ "taskid":"e9c97c75-59fa-4b99-8b4b-1dd991dbba33",
+ "progress":8,
+ "resource_type":"OS::Nova::Server"
+ },
+ "progress":null,
+ "expired_at":null,
+ "id":"a6d04e0e-0121-41d1-8371-eaeab14482f8",
+ "resource_type":"OS::Nova::Server",
+ "description":"--"
+}
+{
+ total_count": 1000
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to add or remove tags of a specific resource in batches.
+TMS may use this API to manage service resource tags.
+A resource can have up to 10 tags.
+The API is idempotent.
+If there are duplicate keys in the request body when you add tags, an error is reported.
+If the key of the to-be-created tag is the same as that of an existing tag, the value of the existing tag will be overwritten.
+When deleting tags, you can upload duplicate keys.
+When tags are being deleted and some tags do not exist, the operation is considered successful by default, and the character set of the tags will not be checked upon deletion. A key and a value can respectively consist of up to 127 and 255 characters. The tag structure cannot be missing, and the key cannot be left blank or an empty string.
+POST https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags/action
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+Yes + |
+List<resource_tag> + |
+Tag list +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. + |
+
action + |
+Yes + |
+String + |
+Operation to be performed. The value can be set to create or delete only. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key (when action is set to create) +It consists of up to 36 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). +Tag key (when action is set to delete) +It consists of up to 127 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. + |
+
value + |
+Yes + |
+String + |
+Tag value (when action is set to create) +This parameter is mandatory. +It consists of up to 43 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). +Tag value (when action is set to delete) +The tag value can be passed or not. +It consists of up to 255 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +If the value is not passed, the tag is located and deleted based on the key and value. If the value is passed, the tag is located and deleted based on the key. + |
+
POST https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags/action
+{
+ "action": "create",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key",
+ "value": "value3"
+ }
+ ]
+}
+or
+{
+ "action": "delete",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+
+None
+Status Code + |
+Description + |
+
|---|---|
204 + |
+No Content + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid action. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+A resource can have up to 10 tags.
+The API is idempotent.
+If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one.
+POST https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tag + |
+Yes + |
+tag + |
+List of tags + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+Yes + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
POST https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags
+{
+ "tag":
+ {
+ "key":"DEV",
+ "value":"DEV1"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
204 + |
+No Content + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid action. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+The API is idempotent.
+When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings.
+DELETE https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags/{key}
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
key + |
+Yes + |
+String + |
+Tag key +A tag key consists of up to 127 characters. +A tag key cannot be an empty string. +Spaces before and after a key will be deprecated. +It cannot contain the following characters: ASCII (0-31), asterisks (*), less-than signs (<), greater-than signs (>), backslashes (\), equal signs (=), commas (,), vertical bars (|), and slashes (/). +(The code only verifies whether the key is an empty character string, instead of the length and character set. Keys are checked and used after deleting the spaces before and after them. Even invalid tags existing at the bottom layer can be deleted.) + |
+
DELETE https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags/{key}
+Status Code + |
+Description + |
+
|---|---|
204 + |
+No Content + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to query tags of a specific resource.
+TMS uses this API to query all tags of a specific resource.
+GET https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
GET https://{endpoint}/v1/{project_id}/csbs_backup/{resource_id}/tags
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+List<resource_tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to query a tenant's tag set in a specific region and of a specific resource type.
+TMS uses this API to list tags created by a tenant to facilitate tag creation and resource filtering on the console.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
GET https://{endpoint}/v1/{project_id}/csbs_backup/tags
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+List<tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
values + |
+List<String> + |
+List of tag values +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "tags": [
+ {
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ },
+ {
+ "key": "key2",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to filter backup policies by tag.
+TMS uses this API to filter and list resources of each service by tag. These services must have the query capabilities.
+POST https://{endpoint}/v1/{project_id}/csbs_backup_policy/resource_instances/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+No + |
+List<tag> + |
+List of included tags. Backup resources with 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. +Keys in this list are in an AND relationship. + |
+
tags_any + |
+No + |
+List<tag> + |
+List of tags. Backup resources 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. + |
+
not_tags + |
+No + |
+List<tag> + |
+List of excluded tags. Backup resources 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. + |
+
not_tags_any + |
+No + |
+List<tag> + |
+List of tags. Backup resources 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. + |
+
action + |
+Yes + |
+String + |
+Operation type +Possible values are filter and count. +filter indicates pagination query and count indicates that a specified number of queried records will be returned. + |
+
matches + |
+No + |
+List<match> + |
+List of query criteria supported by resources +This list cannot be an empty list. +Keys in this list must be unique. + |
+
limit + |
+No + |
+String + |
+Query count (This parameter is not displayed if action is set to count.) +If action is set to filter, the value defaults to 1000. The value ranges from 1 to 1000. If you set a value out of this range, an error will be reported. The number of returned records does not exceed the value of limit. + |
+
offset + |
+No + |
+String + |
+Query index (This parameter is not displayed if action is set to count.) +If action is set to filter, the value defaults to 0 (minimum value). The first record in the query result is the offset+1 record that meets the query criteria. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +A tag key consists of up to 127 characters. +A tag key cannot be an empty string. +Spaces before and after a key will be deprecated. + |
+
values + |
+Yes + |
+List<String> + |
+List of tag values +The list can contain up to 10 values. +A tag value consists of up to 255 characters. +Spaces before and after a key will be deprecated. +Values in this list must be unique. +Values in this list are in an OR relationship. +This list can be empty and each value can be an empty character string. +If this list is left blank, it indicates that all values are included. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +Possible values are: +resource_name: indicates the resource name. + |
+
value + |
+Yes + |
+String + |
+Tag value +A tag value consists of up to 255 characters. +If key is set to resource_name, an empty character string indicates exact matching and any non-empty string indicates fuzzy matching. + |
+
POST https://{endpoint}/v1/{project_id}/csbs_backup_policy/resource_instances/action
+{
+ "offset": "100",
+ "limit": "100",
+ "action": "filter",
+ "matches": [{
+ "key": "resource_name",
+ "value": "resource1"
+ }
+ ],
+ "not_tags": [{
+ "key": "key1",
+ "values": [
+ "*value1",
+ "value2"
+ ]
+ }
+ ],
+ "tags": [{
+ "key": "key1",
+ "values": [
+ "*value1",
+ "value2"
+ ]
+ }
+ ],
+ "tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "not_tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ]
+}
+{
+ "action": "count",
+ "not_tags": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "*value2"
+ ]
+ }
+ ],
+ "tags": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "not_tags_any": [{
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "matches": [{
+ "key": "resource_name",
+ "value": "resource1"
+ }
+ ]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+List<resource> + |
+List of matched resources (This parameter is not displayed if action is set to count.) + |
+
total_count + |
+Integer + |
+Total number of matched resources + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resource_id + |
+String + |
+Resource ID + |
+
resource_detail + |
+Object + |
+Resource details +The returned value is an empty dictionary. + |
+
tags + |
+List<resource_tag> + |
+Tag list + |
+
resource_name + |
+String + |
+Resource name + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "resources": [
+ {
+ "resource_detail": {},
+ "resource_id": "cdfs_cefs_wesas_12_dsad",
+ "resource_name": "resouece1",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ }
+ ]
+ }
+ ],
+ "total_count": 1000
+}
+When action is set to count:
+{
+ "total_count": 1000
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to add or remove tags of a specific resource in batches.
+TMS may use this API to manage service resource tags.
+A resource can have up to 10 tags.
+The API is idempotent.
+If there are duplicate keys in the request body when you add tags, an error is reported.
+If the key of the to-be-created tag is the same as that of an existing tag, the value of the existing tag will be overwritten.
+When tags are being deleted and some tags do not exist, the operation is considered successful by default, and the character set of the tags will not be checked upon deletion. A key and a value can respectively consist of up to 127 and 255 characters. The tag structure cannot be missing, and the key cannot be left blank or an empty string.
+POST https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags/action
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+Yes + |
+List<resource_tag> + |
+Tag list +This list cannot be an empty list. +The list can contain up to 10 keys. +Keys in this list must be unique. + |
+
action + |
+Yes + |
+String + |
+Operation to be performed. The value can be set to create or delete only. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key (when action is set to create) +It consists of up to 36 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). +Tag key (when action is set to delete) +It consists of up to 127 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. + |
+
value + |
+No + |
+String + |
+Tag value (when action is set to create) +This parameter is mandatory. +It consists of up to 43 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). +Tag value (when action is set to delete) +The tag value can be passed or not. +It consists of up to 255 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +If the value is not passed, the tag is located and deleted based on the key and value. If the value is passed, the tag is located and deleted based on the key. + |
+
POST https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags/action
+{
+ "action": "create",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key",
+ "value": "value3"
+ }
+ ]
+}
+or
+{
+ "action": "delete",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+None
+Status Code + |
+Description + |
+
|---|---|
204 + |
+No Content + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid action. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+A resource can have up to 10 tags.
+The API is idempotent.
+If a to-be-created tag has the same key as an existing tag, the tag will be created and overwrite the existing one.
+POST https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tag + |
+Yes + |
+tag + |
+List of tags + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +Spaces before and after a key will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+Yes + |
+String + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +Spaces before and after a tag value will be deprecated. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
POST https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags
+{
+ "tag":
+ {
+ "key":"DEV",
+ "value":"DEV1"
+ }
+}
+Status Code + |
+Description + |
+
|---|---|
204 + |
+No Content + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid action. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+The API is idempotent.
+When you delete a nonexistent tag, error code 404 will be returned. Tag keys cannot be empty or be empty character strings.
+DELETE https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags/{key}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
key + |
+Yes + |
+String + |
+Tag key +A tag key consists of up to 127 characters. +A tag key cannot be an empty string. +Spaces before and after a key will be deprecated. +It cannot contain the following characters: ASCII (0-31), asterisks (*), less-than signs (<), greater-than signs (>), backslashes (\), equal signs (=), commas (,), vertical bars (|), and slashes (/). +(The code only verifies whether the key is an empty character string, instead of the length and character set. Keys are checked and used after deleting the spaces before and after them. Even invalid tags existing at the bottom layer can be deleted.) + |
+
DELETE https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags/{key}
+Status Code + |
+Description + |
+
|---|---|
204 + |
+No Content + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to query tags of a specific resource.
+TMS uses this API to query all tags of a specific resource.
+GET https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
GET https://{endpoint}/v1/{project_id}/csbs_backup_policy/{resource_id}/tags
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+List<resource_tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
value + |
+List<String> + |
+Tag value +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+This API is used to query a tenant's tag set in a specific region and of a specific resource type.
+TMS uses this API to list tags created by a tenant to facilitate tag creation and resource filtering on the console.
+GET https://{endpoint}/v1/{project_id}/csbs_backup_policy/tags
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
Content-type + |
+Yes + |
+MIME type of the body in the request + |
+application/json + |
+
X-Auth-Token + |
+Yes + |
+User token + |
+- + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Project ID + |
+
None
+GET https://{endpoint}/v1/{project_id}/csbs_backup_policy/tags
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+List<tag> + |
+Tag list +Keys in the tag list must be unique. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Tag key +It consists of up to 36 characters. +It cannot be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
values + |
+List<String> + |
+List of tag values +It consists of up to 43 characters. +It can be an empty string. +It can contain only letters, digits, hyphens (-), and underscores (_). + |
+
{
+ "tags": [
+ {
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ },
+ {
+ "key": "key2",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ]
+}
+Status Code + |
+Description + |
+
|---|---|
200 + |
+OK + |
+
Status Code + |
+Description + |
+
|---|---|
400 + |
+Invalid parameters. + |
+
401 + |
+Authentication failed. + |
+
403 + |
+You do not have permission to perform this operation. + |
+
404 + |
+The requested resource was not found. + |
+
500 + |
+A system exception occurs. + |
+
For details, see Error Codes.
+Status Code + |
+Description + |
+
|---|---|
200 OK + |
+The results of GET and PUT operations are returned as expected. + |
+
201 Created + |
+The results of the POST operation are returned as expected. + |
+
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 page requested. + |
+
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 cannot be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication. Then the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request cannot be processed due to a conflict. + |
+
500 Internal Server Error + |
+The request is not completed because the service is abnormal. + |
+
501 Not Implemented + |
+The request is not completed because the server does not support the requested function. + |
+
502 Bad Gateway + |
+The request is not completed because the request is invalid. + |
+
503 Service Unavailable + |
+The request is not completed because the system is out of service temporarily. + |
+
504 Gateway Timeout + |
+Gateway times out. + |
+