From 61f4bfc2efc29578531cde8dedc494f7ea984e56 Mon Sep 17 00:00:00 2001 From: "Wei, Hongmin" Date: Tue, 18 Oct 2022 16:36:56 +0000 Subject: [PATCH] SFS API initial version Reviewed-by: gtema Co-authored-by: Wei, Hongmin Co-committed-by: Wei, Hongmin --- docs/sfs/api-ref/ALL_META.TXT.json | 542 ++++++++++++++++++ docs/sfs/api-ref/CLASS.TXT.json | 488 ++++++++++++++++ docs/sfs/api-ref/ErrorCode.html | 258 +++++++++ docs/sfs/api-ref/PARAMETERS.txt | 3 + .../public_sys-resources/ExpandCollapse.js | 1 + .../caution_3.0-en-us.png | Bin 0 -> 2752 bytes .../public_sys-resources/commonltr.css | 1 + .../public_sys-resources/commonltr_print.css | 1 + .../public_sys-resources/commonrtl.css | 2 + .../public_sys-resources/danger_3.0-en-us.png | Bin 0 -> 2771 bytes .../api-ref/public_sys-resources/delta.gif | Bin 0 -> 836 bytes .../api-ref/public_sys-resources/deltaend.gif | Bin 0 -> 834 bytes .../public_sys-resources/icon-arrowdn.gif | Bin 0 -> 68 bytes .../public_sys-resources/icon-arrowrt.gif | Bin 0 -> 70 bytes .../public_sys-resources/icon-caution.gif | Bin 0 -> 1086 bytes .../public_sys-resources/icon-danger.gif | Bin 0 -> 1086 bytes .../public_sys-resources/icon-huawei.gif | Bin 0 -> 2767 bytes .../public_sys-resources/icon-note.gif | Bin 0 -> 983 bytes .../public_sys-resources/icon-notice.gif | Bin 0 -> 962 bytes .../api-ref/public_sys-resources/icon-tip.gif | Bin 0 -> 879 bytes .../public_sys-resources/icon-warning.gif | Bin 0 -> 1086 bytes .../public_sys-resources/note_3.0-en-us.png | Bin 0 -> 1080 bytes .../public_sys-resources/notice_3.0-en-us.png | Bin 0 -> 1672 bytes .../sfs/api-ref/public_sys-resources/popup.js | 1 + .../warning_3.0-en-us.png | Bin 0 -> 3164 bytes docs/sfs/api-ref/sfs_02_0001.html | 8 + docs/sfs/api-ref/sfs_02_0016.html | 21 + docs/sfs/api-ref/sfs_02_0017.html | 17 + docs/sfs/api-ref/sfs_02_0018.html | 289 ++++++++++ docs/sfs/api-ref/sfs_02_0019.html | 306 ++++++++++ docs/sfs/api-ref/sfs_02_0020.html | 27 + docs/sfs/api-ref/sfs_02_0021.html | 525 +++++++++++++++++ docs/sfs/api-ref/sfs_02_0022.html | 333 +++++++++++ docs/sfs/api-ref/sfs_02_0023.html | 537 +++++++++++++++++ docs/sfs/api-ref/sfs_02_0024.html | 437 ++++++++++++++ docs/sfs/api-ref/sfs_02_0025.html | 174 ++++++ docs/sfs/api-ref/sfs_02_0026.html | 506 ++++++++++++++++ docs/sfs/api-ref/sfs_02_0027.html | 138 +++++ docs/sfs/api-ref/sfs_02_0028.html | 19 + docs/sfs/api-ref/sfs_02_0029.html | 398 +++++++++++++ docs/sfs/api-ref/sfs_02_0030.html | 192 +++++++ docs/sfs/api-ref/sfs_02_0031.html | 273 +++++++++ docs/sfs/api-ref/sfs_02_0032.html | 263 +++++++++ docs/sfs/api-ref/sfs_02_0033.html | 17 + docs/sfs/api-ref/sfs_02_0034.html | 200 +++++++ docs/sfs/api-ref/sfs_02_0035.html | 190 ++++++ docs/sfs/api-ref/sfs_02_0036.html | 29 + docs/sfs/api-ref/sfs_02_0037.html | 155 +++++ docs/sfs/api-ref/sfs_02_0038.html | 106 ++++ docs/sfs/api-ref/sfs_02_0039.html | 158 +++++ docs/sfs/api-ref/sfs_02_0040.html | 136 +++++ docs/sfs/api-ref/sfs_02_0041.html | 184 ++++++ docs/sfs/api-ref/sfs_02_0042.html | 174 ++++++ docs/sfs/api-ref/sfs_02_0043.html | 445 ++++++++++++++ docs/sfs/api-ref/sfs_02_0044.html | 305 ++++++++++ docs/sfs/api-ref/sfs_02_0049.html | 17 + docs/sfs/api-ref/sfs_02_0050.html | 21 + docs/sfs/api-ref/sfs_02_0051.html | 275 +++++++++ docs/sfs/api-ref/sfs_02_0052.html | 56 ++ docs/sfs/api-ref/sfs_02_0053.html | 321 +++++++++++ docs/sfs/api-ref/sfs_02_0054.html | 258 +++++++++ docs/sfs/api-ref/sfs_02_0055.html | 15 + docs/sfs/api-ref/sfs_02_0056.html | 142 +++++ docs/sfs/api-ref/sfs_02_0074.html | 26 + docs/sfs/api-ref/sfs_02_0075.html | 156 +++++ docs/sfs/api-ref/sfs_02_0076.html | 105 ++++ docs/sfs/api-ref/sfs_02_0077.html | 160 ++++++ docs/sfs/api-ref/sfs_02_0078.html | 188 ++++++ docs/sfs/api-ref/sfs_02_0084.html | 13 + docs/sfs/api-ref/sfs_02_0085.html | 51 ++ docs/sfs/api-ref/sfs_02_0086.html | 36 ++ docs/sfs/api-ref/sfs_02_0088.html | 17 + docs/sfs/api-ref/sfs_02_0089.html | 121 ++++ docs/sfs/api-ref/sfs_02_0092.html | 193 +++++++ docs/sfs/api-ref/sfs_02_0094.html | 137 +++++ docs/sfs/api-ref/sfs_02_0095.html | 445 ++++++++++++++ docs/sfs/api-ref/sfs_02_0096.html | 19 + docs/sfs/api-ref/sfs_02_0097.html | 132 +++++ 78 files changed, 10763 insertions(+) create mode 100644 docs/sfs/api-ref/ALL_META.TXT.json create mode 100644 docs/sfs/api-ref/CLASS.TXT.json create mode 100644 docs/sfs/api-ref/ErrorCode.html create mode 100644 docs/sfs/api-ref/PARAMETERS.txt create mode 100644 docs/sfs/api-ref/public_sys-resources/ExpandCollapse.js create mode 100644 docs/sfs/api-ref/public_sys-resources/caution_3.0-en-us.png create mode 100644 docs/sfs/api-ref/public_sys-resources/commonltr.css create mode 100644 docs/sfs/api-ref/public_sys-resources/commonltr_print.css create mode 100644 docs/sfs/api-ref/public_sys-resources/commonrtl.css create mode 100644 docs/sfs/api-ref/public_sys-resources/danger_3.0-en-us.png create mode 100644 docs/sfs/api-ref/public_sys-resources/delta.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/deltaend.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-arrowdn.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-arrowrt.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-caution.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-danger.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-huawei.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-note.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-notice.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-tip.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/icon-warning.gif create mode 100644 docs/sfs/api-ref/public_sys-resources/note_3.0-en-us.png create mode 100644 docs/sfs/api-ref/public_sys-resources/notice_3.0-en-us.png create mode 100644 docs/sfs/api-ref/public_sys-resources/popup.js create mode 100644 docs/sfs/api-ref/public_sys-resources/warning_3.0-en-us.png create mode 100644 docs/sfs/api-ref/sfs_02_0001.html create mode 100644 docs/sfs/api-ref/sfs_02_0016.html create mode 100644 docs/sfs/api-ref/sfs_02_0017.html create mode 100644 docs/sfs/api-ref/sfs_02_0018.html create mode 100644 docs/sfs/api-ref/sfs_02_0019.html create mode 100644 docs/sfs/api-ref/sfs_02_0020.html create mode 100644 docs/sfs/api-ref/sfs_02_0021.html create mode 100644 docs/sfs/api-ref/sfs_02_0022.html create mode 100644 docs/sfs/api-ref/sfs_02_0023.html create mode 100644 docs/sfs/api-ref/sfs_02_0024.html create mode 100644 docs/sfs/api-ref/sfs_02_0025.html create mode 100644 docs/sfs/api-ref/sfs_02_0026.html create mode 100644 docs/sfs/api-ref/sfs_02_0027.html create mode 100644 docs/sfs/api-ref/sfs_02_0028.html create mode 100644 docs/sfs/api-ref/sfs_02_0029.html create mode 100644 docs/sfs/api-ref/sfs_02_0030.html create mode 100644 docs/sfs/api-ref/sfs_02_0031.html create mode 100644 docs/sfs/api-ref/sfs_02_0032.html create mode 100644 docs/sfs/api-ref/sfs_02_0033.html create mode 100644 docs/sfs/api-ref/sfs_02_0034.html create mode 100644 docs/sfs/api-ref/sfs_02_0035.html create mode 100644 docs/sfs/api-ref/sfs_02_0036.html create mode 100644 docs/sfs/api-ref/sfs_02_0037.html create mode 100644 docs/sfs/api-ref/sfs_02_0038.html create mode 100644 docs/sfs/api-ref/sfs_02_0039.html create mode 100644 docs/sfs/api-ref/sfs_02_0040.html create mode 100644 docs/sfs/api-ref/sfs_02_0041.html create mode 100644 docs/sfs/api-ref/sfs_02_0042.html create mode 100644 docs/sfs/api-ref/sfs_02_0043.html create mode 100644 docs/sfs/api-ref/sfs_02_0044.html create mode 100644 docs/sfs/api-ref/sfs_02_0049.html create mode 100644 docs/sfs/api-ref/sfs_02_0050.html create mode 100644 docs/sfs/api-ref/sfs_02_0051.html create mode 100644 docs/sfs/api-ref/sfs_02_0052.html create mode 100644 docs/sfs/api-ref/sfs_02_0053.html create mode 100644 docs/sfs/api-ref/sfs_02_0054.html create mode 100644 docs/sfs/api-ref/sfs_02_0055.html create mode 100644 docs/sfs/api-ref/sfs_02_0056.html create mode 100644 docs/sfs/api-ref/sfs_02_0074.html create mode 100644 docs/sfs/api-ref/sfs_02_0075.html create mode 100644 docs/sfs/api-ref/sfs_02_0076.html create mode 100644 docs/sfs/api-ref/sfs_02_0077.html create mode 100644 docs/sfs/api-ref/sfs_02_0078.html create mode 100644 docs/sfs/api-ref/sfs_02_0084.html create mode 100644 docs/sfs/api-ref/sfs_02_0085.html create mode 100644 docs/sfs/api-ref/sfs_02_0086.html create mode 100644 docs/sfs/api-ref/sfs_02_0088.html create mode 100644 docs/sfs/api-ref/sfs_02_0089.html create mode 100644 docs/sfs/api-ref/sfs_02_0092.html create mode 100644 docs/sfs/api-ref/sfs_02_0094.html create mode 100644 docs/sfs/api-ref/sfs_02_0095.html create mode 100644 docs/sfs/api-ref/sfs_02_0096.html create mode 100644 docs/sfs/api-ref/sfs_02_0097.html diff --git a/docs/sfs/api-ref/ALL_META.TXT.json b/docs/sfs/api-ref/ALL_META.TXT.json new file mode 100644 index 00000000..5d07494f --- /dev/null +++ b/docs/sfs/api-ref/ALL_META.TXT.json @@ -0,0 +1,542 @@ +[ + { + "uri":"sfs_02_0001.html", + "product_code":"sfs", + "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":"sfs_02_0016.html", + "product_code":"sfs", + "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":"SFS APIs", + "title":"SFS APIs", + "githuburl":"" + }, + { + "uri":"sfs_02_0017.html", + "product_code":"sfs", + "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":"API Version Querying", + "title":"API Version Querying", + "githuburl":"" + }, + { + "uri":"sfs_02_0018.html", + "product_code":"sfs", + "code":"4", + "des":"This API is used to query all available versions of APIs provided by SFS.To support function extension, SFS APIs can be distinguished by version. SFS has two types API ve", + "doc_type":"api", + "kw":"Querying All API Versions,API Version Querying,API Reference", + "title":"Querying All API Versions", + "githuburl":"" + }, + { + "uri":"sfs_02_0019.html", + "product_code":"sfs", + "code":"5", + "des":"This API is used for querying details about API versions.GET /{api_version}/Parameter descriptionParameterMandatoryTypeDescriptionapi_versionYesStringSpecifies the API ve", + "doc_type":"api", + "kw":"Querying Details About API Versions,API Version Querying,API Reference", + "title":"Querying Details About API Versions", + "githuburl":"" + }, + { + "uri":"sfs_02_0020.html", + "product_code":"sfs", + "code":"6", + "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":"File Sharing", + "title":"File Sharing", + "githuburl":"" + }, + { + "uri":"sfs_02_0021.html", + "product_code":"sfs", + "code":"7", + "des":"This API is used to create a shared file system. After the file system is created, you need to mount the file system to ECSs to achieve shared file storage.This API is an", + "doc_type":"api", + "kw":"Creating a Shared File System,File Sharing,API Reference", + "title":"Creating a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0022.html", + "product_code":"sfs", + "code":"8", + "des":"This API is used to list the basic information of all shared file systems.GET /v2/{project_id}/shares?all_tenants={all_tenants}&status={status}&limit={limit}&offset={offs", + "doc_type":"api", + "kw":"Querying All Shared File Systems,File Sharing,API Reference", + "title":"Querying All Shared File Systems", + "githuburl":"" + }, + { + "uri":"sfs_02_0023.html", + "product_code":"sfs", + "code":"9", + "des":"This API is used to query the details about all shared file systems.GET /v2/{project_id}/shares/detail?all_tenants={all_tenants}&project_id={project_id}&status={status}&l", + "doc_type":"api", + "kw":"Querying Details About All Shared File Systems,File Sharing,API Reference", + "title":"Querying Details About All Shared File Systems", + "githuburl":"" + }, + { + "uri":"sfs_02_0024.html", + "product_code":"sfs", + "code":"10", + "des":"This API is used to query the details about a shared file system.GET /v2/{project_id}/shares/{share_id}Parameter descriptionParameterMandatoryTypeDescriptionshare_idYesSt", + "doc_type":"api", + "kw":"Querying Details About a Shared File System,File Sharing,API Reference", + "title":"Querying Details About a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0025.html", + "product_code":"sfs", + "code":"11", + "des":"This API is used to query mount locations of a shared file system.This API exists only when X-Openstack-Manila-Api-Version in the request header is greater than or equal ", + "doc_type":"api", + "kw":"Querying Mount Locations of a Shared File System,File Sharing,API Reference", + "title":"Querying Mount Locations of a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0026.html", + "product_code":"sfs", + "code":"12", + "des":"This API is used to modify the name and description of a shared file system.PUT /v2/{project_id}/shares/{share_id}Parameter descriptionParameterMandatoryTypeDescriptionsh", + "doc_type":"api", + "kw":"Modifying a Shared File System,File Sharing,API Reference", + "title":"Modifying a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0027.html", + "product_code":"sfs", + "code":"13", + "des":"This API is used to delete a shared file system.This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and receive", + "doc_type":"api", + "kw":"Deleting a Shared File System,File Sharing,API Reference", + "title":"Deleting a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0028.html", + "product_code":"sfs", + "code":"14", + "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":"Share Access Rules", + "title":"Share Access Rules", + "githuburl":"" + }, + { + "uri":"sfs_02_0029.html", + "product_code":"sfs", + "code":"15", + "des":"This API is used to add share access rules.This API is an asynchronous API. If the returned status code is 200, the API request is successfully delivered and received. La", + "doc_type":"api", + "kw":"Adding Share Access Rules,Share Access Rules,API Reference", + "title":"Adding Share Access Rules", + "githuburl":"" + }, + { + "uri":"sfs_02_0030.html", + "product_code":"sfs", + "code":"16", + "des":"This API is used to delete a share access rule.This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and received", + "doc_type":"api", + "kw":"Deleting Share Access Rules,Share Access Rules,API Reference", + "title":"Deleting Share Access Rules", + "githuburl":"" + }, + { + "uri":"sfs_02_0031.html", + "product_code":"sfs", + "code":"17", + "des":"This API is used to query a share access rule.POST /v2/{project_id}/shares/{share_id}/actionParameter descriptionParameterMandatoryTypeDescriptionshare_idYesStringSpecifi", + "doc_type":"api", + "kw":"Querying Share Access Rules,Share Access Rules,API Reference", + "title":"Querying Share Access Rules", + "githuburl":"" + }, + { + "uri":"sfs_02_0032.html", + "product_code":"sfs", + "code":"18", + "des":"This API is used to query quota information.GET /v2/{project_id}/os-quota-sets/{project_id}Parameter descriptionParameterMandatoryTypeDescriptionproject_idYesStringSpecif", + "doc_type":"api", + "kw":"Quota Management,SFS APIs,API Reference", + "title":"Quota Management", + "githuburl":"" + }, + { + "uri":"sfs_02_0033.html", + "product_code":"sfs", + "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":"Expansion and Shrinking", + "title":"Expansion and Shrinking", + "githuburl":"" + }, + { + "uri":"sfs_02_0034.html", + "product_code":"sfs", + "code":"20", + "des":"This API is used to expand the capacity of a shared file system.This API is an asynchronous API. If the returned status code is 202, the API request is successfully deliv", + "doc_type":"api", + "kw":"Expanding a Shared File System,Expansion and Shrinking,API Reference", + "title":"Expanding a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0035.html", + "product_code":"sfs", + "code":"21", + "des":"This API is used to shrink the capacity of a shared file system.This API is an asynchronous API. If the returned status code is 202, the API request is successfully deliv", + "doc_type":"api", + "kw":"Shrinking a Shared File System,Expansion and Shrinking,API Reference", + "title":"Shrinking a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0036.html", + "product_code":"sfs", + "code":"22", + "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":"Share Tag", + "title":"Share Tag", + "githuburl":"" + }, + { + "uri":"sfs_02_0037.html", + "product_code":"sfs", + "code":"23", + "des":"This API is used to add a tag to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file system", + "doc_type":"api", + "kw":"Adding a Tag to a Shared File System,Share Tag,API Reference", + "title":"Adding a Tag to a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0038.html", + "product_code":"sfs", + "code":"24", + "des":"This API is used to delete a tag from a specified shared file system.If the key to be deleted does not exist in the shared file system, error 404 is returned after API ca", + "doc_type":"api", + "kw":"Deleting a Tag from a Shared File System,Share Tag,API Reference", + "title":"Deleting a Tag from a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0039.html", + "product_code":"sfs", + "code":"25", + "des":"This API is used to query all tag information about the specified shared file system.GET /v2/{project_id}/sfs/{share_id}/tagsParameter descriptionParameterMandatoryTypeDe", + "doc_type":"api", + "kw":"Querying Tag Information About a Shared File System,Share Tag,API Reference", + "title":"Querying Tag Information About a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0040.html", + "product_code":"sfs", + "code":"26", + "des":"This API is used to query the tag set of a tenant's all shared file systems.GET /v2/{project_id}/sfs/tagsParameter descriptionParameterMandatoryTypeDescriptionproject_idY", + "doc_type":"api", + "kw":"Querying Tags of a Tenant's All Shared File Systems,Share Tag,API Reference", + "title":"Querying Tags of a Tenant's All Shared File Systems", + "githuburl":"" + }, + { + "uri":"sfs_02_0041.html", + "product_code":"sfs", + "code":"27", + "des":"This API is used to batch add tags to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file s", + "doc_type":"api", + "kw":"Batch Adding Tags to a Shared File System,Share Tag,API Reference", + "title":"Batch Adding Tags to a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0042.html", + "product_code":"sfs", + "code":"28", + "des":"This API is used to batch delete tags from a specified shared file system.This API is idempotent. If the tags to be deleted do not exist on the shared file system, the de", + "doc_type":"api", + "kw":"Batch Deleting Tags from a Shared File System,Share Tag,API Reference", + "title":"Batch Deleting Tags from a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0043.html", + "product_code":"sfs", + "code":"29", + "des":"This API is used to query details about a shared file system based on tags.POST /v2/{project_id}/sfs/resource_instances/actionParameter descriptionParameterMandatoryTypeD", + "doc_type":"api", + "kw":"Querying Details About a Shared File System Based on Tags,Share Tag,API Reference", + "title":"Querying Details About a Shared File System Based on Tags", + "githuburl":"" + }, + { + "uri":"sfs_02_0044.html", + "product_code":"sfs", + "code":"30", + "des":"This API is used to query the number of shared file systems based on tags.POST /v2/{project_id}/sfs/resource_instances/actionParameter descriptionParameterMandatoryTypeDe", + "doc_type":"api", + "kw":"Querying the Number of Shared File Systems Based on Tags,Share Tag,API Reference", + "title":"Querying the Number of Shared File Systems Based on Tags", + "githuburl":"" + }, + { + "uri":"sfs_02_0049.html", + "product_code":"sfs", + "code":"31", + "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":"SFS Turbo APIs", + "title":"SFS Turbo APIs", + "githuburl":"" + }, + { + "uri":"sfs_02_0050.html", + "product_code":"sfs", + "code":"32", + "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":"Life Cycle Management", + "title":"Life Cycle Management", + "githuburl":"" + }, + { + "uri":"sfs_02_0051.html", + "product_code":"sfs", + "code":"33", + "des":"This API is used to create an SFS Turbo file system.URI formatPOST /v1/{project_id}/sfs-turbo/sharesPOST /v1/{project_id}/sfs-turbo/sharesParameter descriptionParameterMa", + "doc_type":"api", + "kw":"Creating a File System,Life Cycle Management,API Reference", + "title":"Creating a File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0052.html", + "product_code":"sfs", + "code":"34", + "des":"This API is used to delete an SFS Turbo file system.URI formatDELETE /v1/{project_id}/sfs-turbo/shares/{share_id}DELETE /v1/{project_id}/sfs-turbo/shares/{share_id}Parame", + "doc_type":"api", + "kw":"Deleting a File System,Life Cycle Management,API Reference", + "title":"Deleting a File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0053.html", + "product_code":"sfs", + "code":"35", + "des":"This API is used to query details about all SFS Turbo file systems.URI formatGET /v1/{project_id}/sfs-turbo/shares/detail?limit={limit}&offset={offset}GET /v1/{project_id", + "doc_type":"api", + "kw":"Querying Details About All File Systems,Life Cycle Management,API Reference", + "title":"Querying Details About All File Systems", + "githuburl":"" + }, + { + "uri":"sfs_02_0054.html", + "product_code":"sfs", + "code":"36", + "des":"This API is used to query details about an SFS Turbo file system.URI formatGET /v1/{project_id}/sfs-turbo/shares/{share_id}GET /v1/{project_id}/sfs-turbo/shares/{share_id", + "doc_type":"api", + "kw":"Querying Details About a Single File System,Life Cycle Management,API Reference", + "title":"Querying Details About a Single File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0055.html", + "product_code":"sfs", + "code":"37", + "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":"Storage Capacity Management", + "title":"Storage Capacity Management", + "githuburl":"" + }, + { + "uri":"sfs_02_0056.html", + "product_code":"sfs", + "code":"38", + "des":"This API is used to expand the capacity of an SFS Turbo file system. Capacity expansion is an asynchronous operation. You can check whether the expansion is successful by", + "doc_type":"api", + "kw":"Expanding the Capacity of a File System,Storage Capacity Management,API Reference", + "title":"Expanding the Capacity of a File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0096.html", + "product_code":"sfs", + "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":"Connection Management", + "title":"Connection Management", + "githuburl":"" + }, + { + "uri":"sfs_02_0097.html", + "product_code":"sfs", + "code":"40", + "des":"This API is used to change the security group bound to an SFS Turbo file system. Security group change is an asynchronous task. You can determine whether the security gro", + "doc_type":"api", + "kw":"Changing a Security Group,Connection Management,API Reference", + "title":"Changing a Security Group", + "githuburl":"" + }, + { + "uri":"sfs_02_0074.html", + "product_code":"sfs", + "code":"41", + "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":"Share Tag", + "title":"Share Tag", + "githuburl":"" + }, + { + "uri":"sfs_02_0075.html", + "product_code":"sfs", + "code":"42", + "des":"This API is used to add a tag to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file system", + "doc_type":"api", + "kw":"Creating a Tag,Share Tag,API Reference", + "title":"Creating a Tag", + "githuburl":"" + }, + { + "uri":"sfs_02_0076.html", + "product_code":"sfs", + "code":"43", + "des":"This API is used to delete a tag from a specified shared file system.If the key to be deleted does not exist in the shared file system, error 404 is returned after API ca", + "doc_type":"api", + "kw":"Deleting a Tag from a Shared File System,Share Tag,API Reference", + "title":"Deleting a Tag from a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0077.html", + "product_code":"sfs", + "code":"44", + "des":"This API is used to query information of all tags about the specified shared file system.GET /v1/{project_id}/sfs-turbo/{share_id}/tagsParameter descriptionParameterManda", + "doc_type":"api", + "kw":"Querying Tag Information About a Shared File System,Share Tag,API Reference", + "title":"Querying Tag Information About a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0078.html", + "product_code":"sfs", + "code":"45", + "des":"This API is used to batch add tags to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file s", + "doc_type":"api", + "kw":"Batch Adding Tags to a Shared File System,Share Tag,API Reference", + "title":"Batch Adding Tags to a Shared File System", + "githuburl":"" + }, + { + "uri":"sfs_02_0094.html", + "product_code":"sfs", + "code":"46", + "des":"This API is used to query the tag set of a tenant's all shared file systems.GET /v1/{project_id}/sfs-turbo/tagsParameter descriptionParameterMandatoryTypeDescriptionproje", + "doc_type":"api", + "kw":"Querying All Tags of a Tenant's Shared File Systems,Share Tag,API Reference", + "title":"Querying All Tags of a Tenant's Shared File Systems", + "githuburl":"" + }, + { + "uri":"sfs_02_0095.html", + "product_code":"sfs", + "code":"47", + "des":"This API is used to query details about a shared file system based on tags.POST /v1/{project_id}/sfs-turbo/resource_instances/actionParameter descriptionParameterMandator", + "doc_type":"api", + "kw":"Querying Details About a Shared File System Based on Tags,Share Tag,API Reference", + "title":"Querying Details About a Shared File System Based on Tags", + "githuburl":"" + }, + { + "uri":"sfs_02_0084.html", + "product_code":"sfs", + "code":"48", + "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":"Common Parameters", + "title":"Common Parameters", + "githuburl":"" + }, + { + "uri":"sfs_02_0085.html", + "product_code":"sfs", + "code":"49", + "des":"SFS Turbo file system status elementsReturned ValueDescription100CREATING: The file system is being created.200ACTIVE: The file system is active. An SFS Turbo file system", + "doc_type":"api", + "kw":"SFS Turbo File System Statuses,Common Parameters,API Reference", + "title":"SFS Turbo File System Statuses", + "githuburl":"" + }, + { + "uri":"sfs_02_0086.html", + "product_code":"sfs", + "code":"50", + "des":"SFS Turbo file system substatus elementsReturned ValueDescription121Expanding the capacity online.221Online capacity expansion succeeded.321Failed to perform online capac", + "doc_type":"api", + "kw":"SFS Turbo File System Substatuses,Common Parameters,API Reference", + "title":"SFS Turbo File System Substatuses", + "githuburl":"" + }, + { + "uri":"sfs_02_0088.html", + "product_code":"sfs", + "code":"51", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Appendix", + "title":"Appendix", + "githuburl":"" + }, + { + "uri":"sfs_02_0089.html", + "product_code":"sfs", + "code":"52", + "des":"NormalReturned ValueDescription200 OKSpecifies the normal response for the GET and PUT operations.201 CreatedSpecifies the normal response for the POST operation.202 Acce", + "doc_type":"api", + "kw":"Status Codes,Appendix,API Reference", + "title":"Status Codes", + "githuburl":"" + }, + { + "uri":"ErrorCode.html", + "product_code":"sfs", + "code":"53", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Error Codes,Appendix,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"sfs_02_0092.html", + "product_code":"sfs", + "code":"54", + "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/sfs/api-ref/CLASS.TXT.json b/docs/sfs/api-ref/CLASS.TXT.json new file mode 100644 index 00000000..1a5c34ce --- /dev/null +++ b/docs/sfs/api-ref/CLASS.TXT.json @@ -0,0 +1,488 @@ +[ + { + "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":"sfs", + "title":"API Usage Guidelines", + "uri":"sfs_02_0001.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":"sfs", + "title":"SFS APIs", + "uri":"sfs_02_0016.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":"sfs", + "title":"API Version Querying", + "uri":"sfs_02_0017.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"This API is used to query all available versions of APIs provided by SFS.To support function extension, SFS APIs can be distinguished by version. SFS has two types API ve", + "product_code":"sfs", + "title":"Querying All API Versions", + "uri":"sfs_02_0018.html", + "doc_type":"api", + "p_code":"3", + "code":"4" + }, + { + "desc":"This API is used for querying details about API versions.GET /{api_version}/Parameter descriptionParameterMandatoryTypeDescriptionapi_versionYesStringSpecifies the API ve", + "product_code":"sfs", + "title":"Querying Details About API Versions", + "uri":"sfs_02_0019.html", + "doc_type":"api", + "p_code":"3", + "code":"5" + }, + { + "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":"sfs", + "title":"File Sharing", + "uri":"sfs_02_0020.html", + "doc_type":"api", + "p_code":"2", + "code":"6" + }, + { + "desc":"This API is used to create a shared file system. After the file system is created, you need to mount the file system to ECSs to achieve shared file storage.This API is an", + "product_code":"sfs", + "title":"Creating a Shared File System", + "uri":"sfs_02_0021.html", + "doc_type":"api", + "p_code":"6", + "code":"7" + }, + { + "desc":"This API is used to list the basic information of all shared file systems.GET /v2/{project_id}/shares?all_tenants={all_tenants}&status={status}&limit={limit}&offset={offs", + "product_code":"sfs", + "title":"Querying All Shared File Systems", + "uri":"sfs_02_0022.html", + "doc_type":"api", + "p_code":"6", + "code":"8" + }, + { + "desc":"This API is used to query the details about all shared file systems.GET /v2/{project_id}/shares/detail?all_tenants={all_tenants}&project_id={project_id}&status={status}&l", + "product_code":"sfs", + "title":"Querying Details About All Shared File Systems", + "uri":"sfs_02_0023.html", + "doc_type":"api", + "p_code":"6", + "code":"9" + }, + { + "desc":"This API is used to query the details about a shared file system.GET /v2/{project_id}/shares/{share_id}Parameter descriptionParameterMandatoryTypeDescriptionshare_idYesSt", + "product_code":"sfs", + "title":"Querying Details About a Shared File System", + "uri":"sfs_02_0024.html", + "doc_type":"api", + "p_code":"6", + "code":"10" + }, + { + "desc":"This API is used to query mount locations of a shared file system.This API exists only when X-Openstack-Manila-Api-Version in the request header is greater than or equal ", + "product_code":"sfs", + "title":"Querying Mount Locations of a Shared File System", + "uri":"sfs_02_0025.html", + "doc_type":"api", + "p_code":"6", + "code":"11" + }, + { + "desc":"This API is used to modify the name and description of a shared file system.PUT /v2/{project_id}/shares/{share_id}Parameter descriptionParameterMandatoryTypeDescriptionsh", + "product_code":"sfs", + "title":"Modifying a Shared File System", + "uri":"sfs_02_0026.html", + "doc_type":"api", + "p_code":"6", + "code":"12" + }, + { + "desc":"This API is used to delete a shared file system.This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and receive", + "product_code":"sfs", + "title":"Deleting a Shared File System", + "uri":"sfs_02_0027.html", + "doc_type":"api", + "p_code":"6", + "code":"13" + }, + { + "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":"sfs", + "title":"Share Access Rules", + "uri":"sfs_02_0028.html", + "doc_type":"api", + "p_code":"2", + "code":"14" + }, + { + "desc":"This API is used to add share access rules.This API is an asynchronous API. If the returned status code is 200, the API request is successfully delivered and received. La", + "product_code":"sfs", + "title":"Adding Share Access Rules", + "uri":"sfs_02_0029.html", + "doc_type":"api", + "p_code":"14", + "code":"15" + }, + { + "desc":"This API is used to delete a share access rule.This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and received", + "product_code":"sfs", + "title":"Deleting Share Access Rules", + "uri":"sfs_02_0030.html", + "doc_type":"api", + "p_code":"14", + "code":"16" + }, + { + "desc":"This API is used to query a share access rule.POST /v2/{project_id}/shares/{share_id}/actionParameter descriptionParameterMandatoryTypeDescriptionshare_idYesStringSpecifi", + "product_code":"sfs", + "title":"Querying Share Access Rules", + "uri":"sfs_02_0031.html", + "doc_type":"api", + "p_code":"14", + "code":"17" + }, + { + "desc":"This API is used to query quota information.GET /v2/{project_id}/os-quota-sets/{project_id}Parameter descriptionParameterMandatoryTypeDescriptionproject_idYesStringSpecif", + "product_code":"sfs", + "title":"Quota Management", + "uri":"sfs_02_0032.html", + "doc_type":"api", + "p_code":"2", + "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":"sfs", + "title":"Expansion and Shrinking", + "uri":"sfs_02_0033.html", + "doc_type":"api", + "p_code":"2", + "code":"19" + }, + { + "desc":"This API is used to expand the capacity of a shared file system.This API is an asynchronous API. If the returned status code is 202, the API request is successfully deliv", + "product_code":"sfs", + "title":"Expanding a Shared File System", + "uri":"sfs_02_0034.html", + "doc_type":"api", + "p_code":"19", + "code":"20" + }, + { + "desc":"This API is used to shrink the capacity of a shared file system.This API is an asynchronous API. If the returned status code is 202, the API request is successfully deliv", + "product_code":"sfs", + "title":"Shrinking a Shared File System", + "uri":"sfs_02_0035.html", + "doc_type":"api", + "p_code":"19", + "code":"21" + }, + { + "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":"sfs", + "title":"Share Tag", + "uri":"sfs_02_0036.html", + "doc_type":"api", + "p_code":"2", + "code":"22" + }, + { + "desc":"This API is used to add a tag to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file system", + "product_code":"sfs", + "title":"Adding a Tag to a Shared File System", + "uri":"sfs_02_0037.html", + "doc_type":"api", + "p_code":"22", + "code":"23" + }, + { + "desc":"This API is used to delete a tag from a specified shared file system.If the key to be deleted does not exist in the shared file system, error 404 is returned after API ca", + "product_code":"sfs", + "title":"Deleting a Tag from a Shared File System", + "uri":"sfs_02_0038.html", + "doc_type":"api", + "p_code":"22", + "code":"24" + }, + { + "desc":"This API is used to query all tag information about the specified shared file system.GET /v2/{project_id}/sfs/{share_id}/tagsParameter descriptionParameterMandatoryTypeDe", + "product_code":"sfs", + "title":"Querying Tag Information About a Shared File System", + "uri":"sfs_02_0039.html", + "doc_type":"api", + "p_code":"22", + "code":"25" + }, + { + "desc":"This API is used to query the tag set of a tenant's all shared file systems.GET /v2/{project_id}/sfs/tagsParameter descriptionParameterMandatoryTypeDescriptionproject_idY", + "product_code":"sfs", + "title":"Querying Tags of a Tenant's All Shared File Systems", + "uri":"sfs_02_0040.html", + "doc_type":"api", + "p_code":"22", + "code":"26" + }, + { + "desc":"This API is used to batch add tags to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file s", + "product_code":"sfs", + "title":"Batch Adding Tags to a Shared File System", + "uri":"sfs_02_0041.html", + "doc_type":"api", + "p_code":"22", + "code":"27" + }, + { + "desc":"This API is used to batch delete tags from a specified shared file system.This API is idempotent. If the tags to be deleted do not exist on the shared file system, the de", + "product_code":"sfs", + "title":"Batch Deleting Tags from a Shared File System", + "uri":"sfs_02_0042.html", + "doc_type":"api", + "p_code":"22", + "code":"28" + }, + { + "desc":"This API is used to query details about a shared file system based on tags.POST /v2/{project_id}/sfs/resource_instances/actionParameter descriptionParameterMandatoryTypeD", + "product_code":"sfs", + "title":"Querying Details About a Shared File System Based on Tags", + "uri":"sfs_02_0043.html", + "doc_type":"api", + "p_code":"22", + "code":"29" + }, + { + "desc":"This API is used to query the number of shared file systems based on tags.POST /v2/{project_id}/sfs/resource_instances/actionParameter descriptionParameterMandatoryTypeDe", + "product_code":"sfs", + "title":"Querying the Number of Shared File Systems Based on Tags", + "uri":"sfs_02_0044.html", + "doc_type":"api", + "p_code":"22", + "code":"30" + }, + { + "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":"sfs", + "title":"SFS Turbo APIs", + "uri":"sfs_02_0049.html", + "doc_type":"api", + "p_code":"", + "code":"31" + }, + { + "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":"sfs", + "title":"Life Cycle Management", + "uri":"sfs_02_0050.html", + "doc_type":"api", + "p_code":"31", + "code":"32" + }, + { + "desc":"This API is used to create an SFS Turbo file system.URI formatPOST /v1/{project_id}/sfs-turbo/sharesPOST /v1/{project_id}/sfs-turbo/sharesParameter descriptionParameterMa", + "product_code":"sfs", + "title":"Creating a File System", + "uri":"sfs_02_0051.html", + "doc_type":"api", + "p_code":"32", + "code":"33" + }, + { + "desc":"This API is used to delete an SFS Turbo file system.URI formatDELETE /v1/{project_id}/sfs-turbo/shares/{share_id}DELETE /v1/{project_id}/sfs-turbo/shares/{share_id}Parame", + "product_code":"sfs", + "title":"Deleting a File System", + "uri":"sfs_02_0052.html", + "doc_type":"api", + "p_code":"32", + "code":"34" + }, + { + "desc":"This API is used to query details about all SFS Turbo file systems.URI formatGET /v1/{project_id}/sfs-turbo/shares/detail?limit={limit}&offset={offset}GET /v1/{project_id", + "product_code":"sfs", + "title":"Querying Details About All File Systems", + "uri":"sfs_02_0053.html", + "doc_type":"api", + "p_code":"32", + "code":"35" + }, + { + "desc":"This API is used to query details about an SFS Turbo file system.URI formatGET /v1/{project_id}/sfs-turbo/shares/{share_id}GET /v1/{project_id}/sfs-turbo/shares/{share_id", + "product_code":"sfs", + "title":"Querying Details About a Single File System", + "uri":"sfs_02_0054.html", + "doc_type":"api", + "p_code":"32", + "code":"36" + }, + { + "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":"sfs", + "title":"Storage Capacity Management", + "uri":"sfs_02_0055.html", + "doc_type":"api", + "p_code":"31", + "code":"37" + }, + { + "desc":"This API is used to expand the capacity of an SFS Turbo file system. Capacity expansion is an asynchronous operation. You can check whether the expansion is successful by", + "product_code":"sfs", + "title":"Expanding the Capacity of a File System", + "uri":"sfs_02_0056.html", + "doc_type":"api", + "p_code":"37", + "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":"sfs", + "title":"Connection Management", + "uri":"sfs_02_0096.html", + "doc_type":"api", + "p_code":"31", + "code":"39" + }, + { + "desc":"This API is used to change the security group bound to an SFS Turbo file system. Security group change is an asynchronous task. You can determine whether the security gro", + "product_code":"sfs", + "title":"Changing a Security Group", + "uri":"sfs_02_0097.html", + "doc_type":"api", + "p_code":"39", + "code":"40" + }, + { + "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":"sfs", + "title":"Share Tag", + "uri":"sfs_02_0074.html", + "doc_type":"api", + "p_code":"31", + "code":"41" + }, + { + "desc":"This API is used to add a tag to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file system", + "product_code":"sfs", + "title":"Creating a Tag", + "uri":"sfs_02_0075.html", + "doc_type":"api", + "p_code":"41", + "code":"42" + }, + { + "desc":"This API is used to delete a tag from a specified shared file system.If the key to be deleted does not exist in the shared file system, error 404 is returned after API ca", + "product_code":"sfs", + "title":"Deleting a Tag from a Shared File System", + "uri":"sfs_02_0076.html", + "doc_type":"api", + "p_code":"41", + "code":"43" + }, + { + "desc":"This API is used to query information of all tags about the specified shared file system.GET /v1/{project_id}/sfs-turbo/{share_id}/tagsParameter descriptionParameterManda", + "product_code":"sfs", + "title":"Querying Tag Information About a Shared File System", + "uri":"sfs_02_0077.html", + "doc_type":"api", + "p_code":"41", + "code":"44" + }, + { + "desc":"This API is used to batch add tags to a specified shared file system.A shared file system can have a maximum of 10 tags.The keys of multiple tags added to a shared file s", + "product_code":"sfs", + "title":"Batch Adding Tags to a Shared File System", + "uri":"sfs_02_0078.html", + "doc_type":"api", + "p_code":"41", + "code":"45" + }, + { + "desc":"This API is used to query the tag set of a tenant's all shared file systems.GET /v1/{project_id}/sfs-turbo/tagsParameter descriptionParameterMandatoryTypeDescriptionproje", + "product_code":"sfs", + "title":"Querying All Tags of a Tenant's Shared File Systems", + "uri":"sfs_02_0094.html", + "doc_type":"api", + "p_code":"41", + "code":"46" + }, + { + "desc":"This API is used to query details about a shared file system based on tags.POST /v1/{project_id}/sfs-turbo/resource_instances/actionParameter descriptionParameterMandator", + "product_code":"sfs", + "title":"Querying Details About a Shared File System Based on Tags", + "uri":"sfs_02_0095.html", + "doc_type":"api", + "p_code":"41", + "code":"47" + }, + { + "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":"sfs", + "title":"Common Parameters", + "uri":"sfs_02_0084.html", + "doc_type":"api", + "p_code":"", + "code":"48" + }, + { + "desc":"SFS Turbo file system status elementsReturned ValueDescription100CREATING: The file system is being created.200ACTIVE: The file system is active. An SFS Turbo file system", + "product_code":"sfs", + "title":"SFS Turbo File System Statuses", + "uri":"sfs_02_0085.html", + "doc_type":"api", + "p_code":"48", + "code":"49" + }, + { + "desc":"SFS Turbo file system substatus elementsReturned ValueDescription121Expanding the capacity online.221Online capacity expansion succeeded.321Failed to perform online capac", + "product_code":"sfs", + "title":"SFS Turbo File System Substatuses", + "uri":"sfs_02_0086.html", + "doc_type":"api", + "p_code":"48", + "code":"50" + }, + { + "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":"sfs", + "title":"Appendix", + "uri":"sfs_02_0088.html", + "doc_type":"api", + "p_code":"", + "code":"51" + }, + { + "desc":"NormalReturned ValueDescription200 OKSpecifies the normal response for the GET and PUT operations.201 CreatedSpecifies the normal response for the POST operation.202 Acce", + "product_code":"sfs", + "title":"Status Codes", + "uri":"sfs_02_0089.html", + "doc_type":"api", + "p_code":"51", + "code":"52" + }, + { + "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":"sfs", + "title":"Error Codes", + "uri":"ErrorCode.html", + "doc_type":"api", + "p_code":"51", + "code":"53" + }, + { + "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":"sfs", + "title":"Change History", + "uri":"sfs_02_0092.html", + "doc_type":"api", + "p_code":"", + "code":"54" + } +] \ No newline at end of file diff --git a/docs/sfs/api-ref/ErrorCode.html b/docs/sfs/api-ref/ErrorCode.html new file mode 100644 index 00000000..71b0ac1d --- /dev/null +++ b/docs/sfs/api-ref/ErrorCode.html @@ -0,0 +1,258 @@ + + +

Error Codes

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Status Code

+

Error Code

+

Error Message

+

Description

+

Solution

+

400

+

SFS.TURBO.0001

+

Parameter error

+

Invalid parameters.

+

Use valid parameters and try again.

+

404

+

SFS.TURBO.0002

+

Cluster not found

+

The requested object does not exist or you do not have permissions to access it.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0003

+

Invalid name

+

Invalid name.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0004

+

Invalid vpc

+

Invalid VPC.

+

Use valid parameters and try again.

+

500

+

SFS.TURBO.0005

+

Internal server error

+

Internal error.

+

Contact technical support.

+

400

+

SFS.TURBO.0006

+

Invalid subnet

+

Invalid subnet.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0007

+

Invalid share type

+

Invalid file system type.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0008

+

Invalid size

+

Unsupported file system size.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0009

+

Name has existed

+

The file system name already exists.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0010

+

Quota exceeds

+

Insufficient quota.

+

Submit a service order to increase quota.

+

400

+

SFS.TURBO.0011

+

Cluster is doing something

+

Another operation is being performed on the file system.

+

Wait until that operation is complete and try again.

+

400

+

SFS.TURBO.0016

+

Res tag count already reach max value

+

The maximum number of tags has been reached for the resource.

+

Delete unnecessary tags.

+

400

+

SFS.TURBO.0017

+

Invalid tag key param

+

The length of the resource tag key is invalid.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0018

+

Invalid tag value param

+

The length of the resource tag value is invalid.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0024

+

Operation is not allowed

+

Unsupported operation.

+

Contact technical support.

+

400

+

SFS.TURBO.0025

+

Invalid tag key param

+

The resource tag key contains invalid characters.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0026

+

Invalid tag value param

+

The resource tag value contains invalid characters.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0027

+

Invalid security group

+

Invalid security group.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0028

+

Invalid crypt key

+

Invalid KMS key.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0029

+

Subnet has not enough ips

+

Insufficient IP addresses in the subnet.

+

Use valid parameters and try again.

+

400

+

SFS.TURBO.0030

+

Ecs resource not enough

+

The ECS specification is sold out in the selected AZ.

+

Change the AZ and try again.

+
+
+

+
+
+
+
Parent topic: Appendix
+
+
+ diff --git a/docs/sfs/api-ref/PARAMETERS.txt b/docs/sfs/api-ref/PARAMETERS.txt new file mode 100644 index 00000000..6da8d5f0 --- /dev/null +++ b/docs/sfs/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/sfs/api-ref/public_sys-resources/ExpandCollapse.js b/docs/sfs/api-ref/public_sys-resources/ExpandCollapse.js new file mode 100644 index 00000000..3f1b7db0 --- /dev/null +++ b/docs/sfs/api-ref/public_sys-resources/ExpandCollapse.js @@ -0,0 +1 @@ +var expandClassName="dropdownexpand";var collapseClassName="dropdowncollapse";var collapseTableClassName="dropdowncollapsetable";var href="";function ExpandorCollapseNode(a){a=a.parentNode;if(a.className==expandClassName){a.className=collapseClassName}else{a.className=expandClassName}}function ExpandorCollapseTableNode(a){a=a.parentNode;if(a.className==expandClassName){a.className=collapseTableClassName}else{a.className=expandClassName}}function ExpandorCollapseAllNodes(g,h,c){var a=g.getAttribute("title");var b=g.parentNode;if(a=="collapse"){g.setAttribute("title","expand");g.className="dropdownAllButtonexpand";g.innerHTML=h}else{g.setAttribute("title","collapse");g.className="dropdownAllButtoncollapse";g.innerHTML=c}var f=b.getElementsByTagName("*");for(var d=0;d-1){ExpandForHref(href.substring(href.lastIndexOf("#")+1))}}catch(a){}}; \ No newline at end of file diff --git a/docs/sfs/api-ref/public_sys-resources/caution_3.0-en-us.png b/docs/sfs/api-ref/public_sys-resources/caution_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..60f60762138fe7d98fa081415cf26a4943897779 GIT binary patch literal 2752 zcmV;x3P1IUP)pPa!Eu%RCwC$n`u~-F-BFk{0Y@>jH&Wt02T)4n7aXBssVicB` zOX`JaF2{q_2~&#?rkP8$id|Xfs23G(+0lTGT0tnFxgZFMIx;xG$R>Lr2ng2sFhB=q zSd{Td_5QEx{V+WDJooe7@Bg{)|8u`XpV~`~ZvvYTAfN{@5<(zAAd&!qNCE^R2@oI< zNq|5k0e^NPrRGdyW8`F%MH7XH|3P8=s2${2dg49z003YAM?%tm1!4=85P2aZJs3WS zG6CT8kCv0C(eT;v!9vu9jP&3oZEw^8HmnQ6+clMCL4mv(zK?)Ob8&M#`$%sr@v0v& z@zoUHs-n619H>uFER~Aj==ntk06q~XtAWrX`-(7l=)GLjQP?!@q z{@ZTZw0`amLgo~4vvd&0Pxryp)QHy>ob2%4P9)V*SX4zr!(BuoQ>IK9!d&k>z1cqI z{8L;})njUE#LIJj>h%6Q^ZVF{wB;i;Qi+5h9}NJn%x@raKm6;fW+Fl#T`67idLh|4 zu~b$4-1hhHTVfMtV@>p)0G=3ns@?Zq+;oGKv z*YE#+n>`1!`TpdYF4yhs&w)&meoVo}#+v$ur`WVKNyq<%YnFsZMC$eXSc!Bf$)AMeNOrxm z98up?0IbZ4d1uoLyuSG}0{xcY?H+G%68SDpqp0{6ZmtR(?ChBNKk$ZxK&chd%Fub9B!C3$z*oSdfKP$^R+Au*=jW--Q5@}8T8wOFz(A> z+jPJi0CSN!@M}8~J+m~H+qJd0$mL8L?}^W38D?fiTvJtZ_QG{CGOx1j!^2co2eNIY zE_th}e&*28WCEs4)4Ngh`F*TJs&5jrEg}J*$>Ry|NTs@Q5S4XS*jiLGYupV!l}OmJ zCkyWg!}|T(8zmGK-@ggmTpXX4Lzd^H6d8Ibpk8+o_km$bMW>TS}&FY)P96F+{d%+84 z0FbR#^Wj0eUL$0WrHtk7-A3#N4!~oiv))WDwoq|!rza!b-MC#_%g6i5bZq+f?}v+A z&dvOM*6oz`?o(Suoq{*R_pvM}5O;^mT)Ww?Z7fftAwAED0FP9BCXZ)ZL<03qVuSdN zP8xtRONCq}V{LHL13e@F7rC5Q7nL%1)>HuEPG%TvZ9T=8(JF40lp-DCMCkm>9oo4$ zp2gbI0)X_(**fDB#*QLr-bCyM4&cnWE2QR3>%BzUvd0>L#Q|n|$1Tk60kC$33wat1 zyP`b|;`hpR?G6;%TDEA7?qPdG5~XG3DCEwFEmXV^*atUP1r?Q*Z6tf#C@HG~z|7R7 z%W^bSHmKdEz8|Y+XCNKoj5;@$;5Eqx+bjkplCo$bd!u65ur3Iht+xK#S>J1CGr+PQ z0C$JWZS8>kO3xnquB&Tk(E(-;v|eN5zDOk!LKaKgc6D>}Jxa^U*&dP9D~M#(l4Wdd zEW5NF>oE`jQ&SV}G+O8_@4Ge+!`aD+oB8?teVaq?BU0GA1xO_l=1nQrAx&+WdOB8S#d?X;+5%{W zL%$q0tP5gqR7{WS^|&#ETLM_$tqfODr{F@Wvh7$L9&xbkIv%IZL`G<~%z?=et2Z8l(~lTRu|vXblrbH{CQq;M*jC6P7 zAFJjO7P_e26);09x-VYJYSS8{M>uNB=$!_=`UBu*VJQICR{ab{qy@7TIM~}!cc+es zuSRv+yK8E024LzW_fF?DH>qIv7JK9}8Okgb+deq(_=yx1KZZPwhLE7)i2By(j4ulc zZ0X+G=!}W_*0i+)j$M5C6#K-`Q^PI#NC$_uZf2|)Q-QCDmtJxjn1b~m%uQ)q7k*!v<@zee~^S^yy8n;SIv9h!z@F~L` zuV;E)#MIP`TP3BWq~-E)te=ie;#EKP>`x<4qruHp!K;f(yPS8hZ8~d0reR}ajZ`A( z(HeW)kgTXvuy(`eEDH)`tWfsw@ySLcm z71)pX#Is~7?MOOfjY2*gfad0Vq-SPfE=p#UyBs4UBW!G}*%&$+h}RorbCI@}bUZGD z(D`DX7<2A;EnO+wSMkI5S3ZiysJKOPz zXHjNr`1+U~!-i@z2TQevhO_F+9anqo4qDp6*s z{^#^#iMhy}=wm-XjcU;ayd~S zjKa+^{((2(%#||Kxw$%iyNf&$A}5<97d+PwF{vJcqF5t}K17 zWA47SPe$ba7&NE7d;EGLztWTQN_%qi?{fFvpbejgc;mTn%wk=QtX`o_PVsJli{margin-top:0}*[compact="no"]>li{margin-top:.53em}.liexpand{margin-top:1em;margin-bottom:1em}.sliexpand{margin-top:1em;margin-bottom:1em}.dlexpand{margin-top:1em;margin-bottom:1em}.ddexpand{margin-top:1em;margin-bottom:1em}.stepexpand{margin-top:.3em;margin-bottom:.3em}.substepexpand{margin-top:.3em;margin-bottom:.3em}div.imageleft{text-align:left}div.imagecenter{text-align:center}div.imageright{text-align:right}div.imagejustify{text-align:justify}div.noblankline{text-align:center}div.noblankline img{margin-top:0}pre.screen{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;background-color:#ddd;white-space:pre}pre.codeblock{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;background-color:#ddd;white-space:pre}.hrcopyright{color:#3f4e5d;margin-top:18pt}.hwcopyright{text-align:center}.comment{margin:2px 2px 2px 2px;font-family:Arial;font-size:10pt;background-color:#bfb;color:#000}.dropdownAllButtonexpand{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdownAllButtoncollapse{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;text-decoration:underline;color:#007af4}.dropdowntitle{background-repeat:no-repeat;background-position:0 4px;padding-left:15px;cursor:pointer;text-decoration:underline;color:#007af4}.dropdownexpand .dropdowntitle{background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapse .dropdowncontext{display:none}.dropdowncollapse .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdowncollapsetable{border:0}.dropdowncollapsetable .dropdowncontext{display:none}.dropdowncollapsetable .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}pre{font-size:10pt;font-weight:normal;margin-left:9;margin-top:2;margin-bottom:2}.termcolor{color:blue;cursor:pointer}#dhtmlgoodies_tooltip{background-color:#f0f0d2;border:1px solid #000;position:absolute;display:none;z-index:20000;padding:2px;font-size:.9em;-moz-border-radius:6px;font-family:"Trebuchet MS","Lucida Sans Unicode",Arial,sans-serif}#dhtmlgoodies_tooltipShadow{position:absolute;background-color:#555;display:none;z-index:10000;opacity:.7;filter:alpha(opacity=70);-khtml-opacity:.7;-moz-opacity:.7;-moz-border-radius:6px}.freeze{position:fixed;_position:absolute;_top:expression(eval(document.documentElement.scrollTop));left:10;top:0} \ No newline at end of file diff --git a/docs/sfs/api-ref/public_sys-resources/commonltr_print.css b/docs/sfs/api-ref/public_sys-resources/commonltr_print.css new file mode 100644 index 00000000..a5982314 --- /dev/null +++ b/docs/sfs/api-ref/public_sys-resources/commonltr_print.css @@ -0,0 +1 @@ +body{font-size:12.0pt;margin:1.5em;margin-left:1.6cm}.msgph{font-family:Courier New}.rowlinecopyright{color:red;margin-top:10pt}.unresolved{background-color:skyblue}.noTemplate{background-color:yellow}.base{background-color:#fff}.nested0{margin-top:1em}.p{margin-top:1em}p{margin-top:.5em;margin-bottom:.5em}.note p{margin-top:.5em;margin-bottom:.5em}.tip p{margin-top:.5em;margin-bottom:.5em}.danger p{margin-top:.5em;margin-bottom:.5em}.warning p{margin-top:.5em;margin-bottom:.5em}.notice p{margin-top:.5em;margin-bottom:.5em}.caution p{margin-top:.5em;margin-bottom:.5em}.attention p{margin-top:.5em;margin-bottom:.5em}table p{margin-top:.2em;margin-bottom:.2em}table .p{margin-top:.4em;margin-bottom:.2em}.covertable{border:0;width:100% cellpadding:8pt;cellspacing:8pt}.cover_productname{font-size:15.0pt;font-family:"Arial"}.cover_manualtitle{font-size:24.0pt;font-weight:bold;font-family:"Arial"}.cover_manualsubtitle{font-size:18.0pt;font-weight:bold;font-family:"Arial"}.cover_heading{font-size:12.0pt;font-weight:bold;font-family:"Arial"}.cover_text{font-size:9.0pt;font-family:"Arial"}.tocheading,.heading1,.topictitle1{margin-top:40.0pt;margin-right:0;margin-bottom:20.0pt;margin-left:-1cm;text-align:left;border:0;border-bottom:solid windowtext .5pt;font-size:22.0pt;font-family:"Arial";font-weight:bold}.topictitlenumber1{font-size:72.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle2{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:-1cm;text-indent:0;font-size:18.0pt;font-family:"Arial";font-weight:bold}.topictitle3{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:16.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle4{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:14.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle5{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.blocklabel,.topictitle6{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.sectiontitle{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:-1cm;text-indent:0;font-size:13.0pt;font-family:"Arial";font-weight:bold}.tocentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:12.0pt;font-family:"Book Antiqua";font-weight:bold}.tocentry2{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry3{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry4{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry5{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tofentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman";font-weight:normal}.totentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman";font-weight:normal}.indexheading{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.indexentry1{margin-top:4pt;margin-right:0;margin-bottom:0;margin-left:0;line-height:12.0pt;font-size:12.0pt;font-family:"Times New Roman"}.indexentry2{margin-top:0;margin-right:0;margin-bottom:0;margin-left:24.0pt;line-height:12.0pt;font-size:12.0pt}.indexentry3{margin-top:0;margin-right:0;margin-bottom:0;margin-left:48pt;line-height:12.0pt;font-size:12.0pt}.figurenumber{font-weight:bold}.tablenumber{font-weight:bold}.familylinks{margin-top:1.5em;margin-bottom:1em}.figcap{font-size:11.0pt}.tablecap{font-size:11.0pt}.figdesc{font-style:normal}.fignone{margin-top:8.0pt}.figborder{border-style:solid;padding-left:3px;border-width:2px;padding-right:3px;margin-top:1em;border-color:Silver}.figsides{border-left:2px solid;padding-left:3px;border-right:2px solid;padding-right:3px;margin-top:1em;border-color:Silver}.figtop{border-top:2px solid;margin-top:1em;border-color:Silver}.figbottom{border-bottom:2px solid;border-color:Silver}.figtopbot{border-top:2px solid;border-bottom:2px solid;margin-top:1em;border-color:Silver}.ullinks{margin-left:0;list-style-type:none}.ulchildlink{margin-top:1em;margin-bottom:1em}.olchildlink{margin-top:1em;margin-bottom:1em;margin-left:1em}.linklist{margin-bottom:1em}.linklistwithchild{margin-left:1.5em;margin-bottom:1em}.sublinklist{margin-left:1.5em;margin-bottom:1em}.relconcepts{margin-left:1cm;margin-top:1em;margin-bottom:1em}.reltasks{margin-left:1cm;margin-top:1em;margin-bottom:1em}.relref{margin-left:1cm;margin-top:1em;margin-bottom:1em}.relinfo{margin-top:1em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-left:0}.parentlink{margin-top:.6em;margin-bottom:.6em}.nextlink{margin-top:.6em;margin-bottom:.6em}.previouslink{margin-top:.6em;margin-bottom:.6em}.section{margin-top:1em;margin-bottom:1em}.example{margin-top:1em;margin-bottom:1em}table .note{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.note{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.notetitle{font-weight:bold;font-size:11.0pt}.notelisttitle{font-weight:bold}table .tip{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.tip{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.tiptitle{font-weight:bold;font-size:11.0pt}table .fastpath{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.fastpath{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.fastpathtitle{font-weight:bold;font-size:11.0pt}table .important{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.important{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.importanttitle{font-weight:bold;font-size:11.0pt}table .remember{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.remember{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.remembertitle{font-weight:bold;font-size:11.0pt}table .restriction{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.restriction{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.restrictiontitle{font-weight:bold;font-size:11.0pt}table .attention{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.attention{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}.attentiontitle{font-weight:bold}table .danger{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.dangertitle{font-weight:bold}.danger{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .notice{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.noticetitle{font-weight:bold}.notice{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .warning{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.warningtitle{font-weight:bold}.warning{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .caution{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}table caption{margin-top:8pt;text-align:left;font-weight:bold}.tablenoborder{margin-top:8pt}.cautiontitle{font-weight:bold}.caution{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}ul.simple{list-style-type:none}li ul{margin-top:.6em}li{margin-top:.6em;margin-bottom:.6em}.note li{margin-top:.2em;margin-bottom:.2em}.tip li{margin-top:.2em;margin-bottom:.2em}.danger li{margin-top:.2em;margin-bottom:.2em}.warning li{margin-top:.2em;margin-bottom:.2em}.notice li{margin-top:.2em;margin-bottom:.2em}.caution li{margin-top:.2em;margin-bottom:.2em}.attention li{margin-top:.2em;margin-bottom:.2em}table li{margin-top:.2em;margin-bottom:.2em}.firstcol{font-weight:bold}th{background-color:#cfcfcf}.bold{font-weight:bold}.boldItalic{font-weight:bold;font-style:italic}.italic{font-style:italic}.underlined{text-decoration:underline}.var{font-style:italic}.shortcut{text-decoration:underline}.dlterm{font-weight:bold}dd{margin-top:.5em;margin-bottom:.5em}.dltermexpand{font-weight:bold;margin-top:1em}*[compact="yes"]>li{margin-top:0}*[compact="no"]>li{margin-top:.53em}.liexpand{margin-top:1em;margin-bottom:1em}.sliexpand{margin-top:1em;margin-bottom:1em}.dlexpand{margin-top:1em;margin-bottom:1em}.ddexpand{margin-top:1em;margin-bottom:1em}.stepexpand{margin-top:1em;margin-bottom:1em}.substepexpand{margin-top:1em;margin-bottom:1em}table{margin-top:8pt;margin-bottom:10.0pt;width:100%}thead{font-size:10.0pt;font-family:"Book Antiqua";font-weight:bold}tbody{font-size:11.0pt}ol{margin-top:1em;margin-bottom:1em;margin-left:1.7em;-webkit-padding-start:0}ul{margin-top:1em;margin-bottom:1em;margin-left:1.2em;-webkit-padding-start:0}ol ul{list-style:disc}ul ul{list-style:square}ol ol{list-style-type:lower-alpha}table ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}table ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ul{margin-top:.4em;margin-bottom:.4em;list-style:square}table ol ol{margin-top:.4em;margin-bottom:.4em;list-style:lower-alpha}table ol ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}.substepthirdol{list-style-type:lower-roman}div.imageleft{text-align:left}div.imagecenter{text-align:center}div.imageright{text-align:right}div.imagejustify{text-align:justify}div.noblankline{text-align:center}div.noblankline img{margin-top:0}pre{font-size:10.0pt;border-width:2px;padding:2px;margin-top:5px;margin-bottom:5px;white-space:pre-wrap;white-space:-moz-pre-wrap;white-space:-pre-wrap;white-space:-o-pre-wrap;word-wrap:break-word}pre.screen{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;white-space:pre}pre.codeblock{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;white-space:pre}.dropdownAllButtonexpand{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdownAllButtoncollapse{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;text-decoration:underline;color:#007af4}.dropdowntitle{background-repeat:no-repeat;background-position:0 4px;padding-left:15px;cursor:pointer;text-decoration:underline;color:#007af4}.dropdownexpand .dropdowntitle{background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapse .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapsetable .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.prefacesectiontitle1{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:-1cm;text-indent:0;font-size:18.0pt;font-family:"Book Antiqua";font-weight:bold;overflow:auto}.termcolor{color:blue;cursor:pointer}#dhtmlgoodies_tooltip{background-color:#f0f0d2;border:1px solid #000;position:absolute;display:none;z-index:20000;padding:2px;font-size:.9em;-moz-border-radius:6px;font-family:"Trebuchet MS","Lucida Sans Unicode",Arial,sans-serif}#dhtmlgoodies_tooltipShadow{position:absolute;background-color:#555;display:none;z-index:10000;opacity:.7;filter:alpha(opacity=70);-khtml-opacity:.7;-moz-opacity:.7;-moz-border-radius:6px}.freeze{position:fixed;_position:absolute;_top:expression(eval(document.documentElement.scrollTop));left:10;top:0}.hrcopyright{color:#3f4e5d;margin-top:18pt;margin-left:-1cm}.hwcopyright{text-align:center;font-family:Arial;margin-left:-1cm} \ No newline at end of file diff --git a/docs/sfs/api-ref/public_sys-resources/commonrtl.css b/docs/sfs/api-ref/public_sys-resources/commonrtl.css new file mode 100644 index 00000000..947a9a03 --- /dev/null +++ b/docs/sfs/api-ref/public_sys-resources/commonrtl.css @@ -0,0 +1,2 @@ +.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with
. Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式 +*//*! Default of bold for definition list terms *//*! Use CSS to expand lists with @compact="no" */.dltermexpand{font-weight:700;margin-top:1em}[compact="yes"]>li{margin-top:0}[compact="no"]>li{margin-top:.53em}/*! Align images based on @align on topic/image */div.imageleft,.text-align-left{text-align:left}div.imagecenter,.text-align-center{text-align:center}div.imageright,.text-align-right{text-align:right}div.imagejustify,.text-align-justify{text-align:justify}.cellrowborder{border-right:0;border-top:0;border-left:1px solid;border-bottom:1px solid}.row-nocellborder{border-left:hidden;border-right:0;border-top:0;border-bottom:1px solid}.cell-norowborder{border-top:0;border-bottom:hidden;border-right:0;border-left:1px solid}.nocellnorowborder{border:0;border-left:hidden;border-bottom:hidden}pre.codeblock,pre.screen{padding:5px;border:outset;background-color:#ccc;margin-top:2px;margin-bottom:2px;white-space:pre} \ No newline at end of file diff --git a/docs/sfs/api-ref/public_sys-resources/danger_3.0-en-us.png b/docs/sfs/api-ref/public_sys-resources/danger_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..47a9c723532a0ac410285e5152684262127922bf GIT binary patch literal 2771 zcmV;^3M}=BP)pPg-Jv~RCwC$oO@7HS02Ydnp$REOA{(Mow8*Mm>A3h9MeO=6 zYU>mmT}9emv9DQm*RJeXc5T5Q!v0 zB$5b`NFqdtL=w?OklwC|&JB*_kR*g*P1STeQY~6uB+{*;B2i1mw!HxCh>m7?uX_kB zZW668hPGS7cBvYGjjLu-T2{ta(MHkoqDQ**khXqXE?M&}B*qkwZb{|!wVV0PLl1U( zh|@k2Pt@e8KI2W7%cc| zO7%;oh!GEaKI?~$MKHY5t{0Ps=^60OI`;KR@k?HRh+XkChOueL!}QpzFXL=(zz|LUxf|B{Fmxd{EXn6tyV1mZmG!*PMf2b20p#%- z`o8%ZVfQ~su(20?SHHrs3D0@S-1|flxSZIlFT0HsqCq!dAXirJ4@lTnmkYTz0`t-t zoL%_-P1mIvW2W1<$B}7tG*?~Z^s+@a=y&VTO-%?Gh7Jy#@{?>}D?H+5hs1sBQ0R>W z$rPxPB0JS9by>2#BO!*;vNGmn#B$c!n|>2>7?JiN4?lg9=9Ul^WTvn;zkmZNJ#I@f zXfLYayW|WUHCNr9F<}t$c#W4#+=3U8s&%wF9keEQnyx}+}N<*(D-{;R$ zaL&lM{`n*i9mMK`CvfP6+g4qiUbYCAy$P8{NBGDGJ>#mRNP+|zE_)NFmo4(hwYIv@ zj4}Jw)#_@YXz^U^wkl+5Ed$yU@(x$pVxcJ-ZmXBjPZHcyBPNTQ@jT3znFTMzB|S?h0gxfpz6m)AA4I1f{{Z$&2y zk3ciVjBaWI{dcTHs?p)HH*sm#raQmUz>fucJ<0Wt1$&7Yo{Gv8hdf^6w-o?Tw&YWcsTM+dBoLi8 zm#bgrQM3K5ud%~av^tvIiFi|^-&R4OlHQ{uGz@8In6F1rD1F94&As{c8*2bi=#8{A z)KIlQhtnC$?tCJxvO0({nRs+qm1oR!Z=IKnF2v^f{N$t{)~t1Vv2?ngNK$nuGEKO< zzf@ihKvc#!1ci#0h8lzrHSz1+9!LmL<7})$rq&Yk)GWTA^F~0u-~E0TNjvu-Q)}t} z)&}+s8s@*>B2&1%Q%tPac=st8NJG2{;%siGF;7#NJH;& zhtmrs6i)v0ou4BeO^#u2egO+IQwUR3_$5wT3!n{#&@*Jsx3K<;Tq+W^T~4H!KR$~@ zu5|Zlat{Mw&iD(0QiW8dAv|#;hS6ylMyC;;I1(Y)o!@mEZ@FnQU-ZJ$IBKhr$d&Y3 z@~n?c&GxedN!C@{=B92P%iuKA4P5P zF?T5M7UQl=?_?r5^a9HdpCWnaAVwy9ACNdxCO+iz-A9L25o0p3%IfG+5=G4$jjDT3 z_rX_P#9mZ`W{jEERu|5u25kR1=sC=`>*|qQT57FGWQv;}!j;wgsVgZ&P^ySbnS#<_ z@{wsQcZWQgM(3rkuisR2@ddhKm zm>y`QU}}cvFx#%9zncRR0f}5m+=3T>`k`rb(CYH78vp)0Ee*BEwGqTVll7BY1|4qD zR@y0eaw?7*EAlWsiJLyTGjpW6UP@ltw4HQIDv2=#er2YNQnNeHL|TgfF7e2O?@1my zh~&SD2{!g(;QB4N?2Xi&J%utn0;xtv zkRbctK7@An=2gu(9Ra)bZS!9G@?)aLPe-neAnxr2otkuaibwkB-UtAuk5dGci8mbQ zpHD?%2tDKXzEY@Rj-@xHWo6{`Gk44bDS}ZNOehT|CG6gP2Ggpt~a%lW$PyZ(R zi8N$tEzX8o&aMocNSD04oR)@K6nZ1(%xk%iRHX^nOsp#j+)(^s?wgdX$fl*dQ#vN{kQBLN_&` z(}>jJm$ns&TBh$jOxAo08KVLl?;k50S@-!F7S4`i=H$SR@bCXNvu5pPHYX!BHAMhH=PbZLgf2GrXYPBlYfJrz}; z)`4zn0@|b`lo3(5nj87CARk+Pp-;mw(B7`!W7{6u*6MHG>-993S9MlnGP}b>T0X$Q z*4=p=+dA4SslE}Gg;&WhtYpG)6U!Ea29!H%?ahd^54+^o0V28#9s2{xQ^UKnb$1>s zUY^}9i2&9v4QJu(xOPbdVAh?wt?d92zi^J^&vgoySb1+qmmi0B}` Z`Y-il7nw201!5QImN;7^FeRDuvlieQm$nqSgH2#ST^0cx)=Dn zcnY!FJo_HPt-fVW+YdiB+UT#;6V;vF(d}+cR@IeV(d8~pF{?8>qtl(5 z-l&f3hz@sXMqTY}N84?I)T&mtqU9C|*g%8DFx{Fx6Im5iuF|X}%dCt_S87;LjI4+X zS7=Dl>numvWx_9&xPzYqFMxz!h@dKJnV+WiNj6zrg25Bat1rHX34YcM&(@mM25EsKp^s$!A zn#VD|u6s{$op5YkSDD^r^tisfo6%**9APOOq(ypevUm*eg627JCCoz;t2Wm=9wHzA zIZpn)d?D?0K6~e%(5n+Y{``IW_383vZ~ype`|Z!iyVvi|9^OBm{E(}2>Xh(M9J1dY2CIYT07X)PL*D{uoU3SWSe zM5)Z@cZj(9E!*Rn@%yj8UtL_@?zGcisVAyCyQACPnyjiTyQ0fonqpRGc1EW=HN8j060m^=i($GodnU3fs$8X6OO{y~m9EsVpcq*Z6|T^b zqSslDvde-aqopiG$tAYJ8Zb!15?a()3^veUF{}|ZIT4x8)aYX^Swx02G;(1<(UEpq zsD~82sYp46Jp6zr)7XK2NT3kbfI%9Tw8DeMU;_=7#;04Wd;7XW>CRXi!yzvnE_|I|r wZ*w5M>1_7SKcT}DJ@4vn|M>OS_UPly>%-H_{r>p;)5Xs}-+pgDf7s~DJ6{D>Q~&?~ literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/icon-arrowdn.gif b/docs/sfs/api-ref/public_sys-resources/icon-arrowdn.gif new file mode 100644 index 0000000000000000000000000000000000000000..84eec9be2f2ce458e888f8a9b803f9387247726a GIT binary patch literal 68 zcmZ?wbhEHbzkByxQ$u Mo$o?7J5~m305MV#!~g&Q literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/icon-arrowrt.gif b/docs/sfs/api-ref/public_sys-resources/icon-arrowrt.gif new file mode 100644 index 0000000000000000000000000000000000000000..39583d168d6db303b366b5b8c1780698a6bb6017 GIT binary patch literal 70 zcmZ?wbhEHbEMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/icon-danger.gif b/docs/sfs/api-ref/public_sys-resources/icon-danger.gif new file mode 100644 index 0000000000000000000000000000000000000000..079c79b263f4b48089f3b3256154c73e7699593f GIT binary patch literal 1086 zcmW+#YfRQ<6hA3LZMyP?V}KhnEtF{Q4vGxS52AozEVM85nq$#%tv8gRF!3GhgM?_) zd5Luv3SKrXFTGCpn$y>EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/icon-huawei.gif b/docs/sfs/api-ref/public_sys-resources/icon-huawei.gif new file mode 100644 index 0000000000000000000000000000000000000000..a31d60f895af919d33855217ca02daf4093136d7 GIT binary patch literal 2767 zcmV;=3NZCYNk%w1VaEV40Oo%H*MEWRpQG)+!RUX6`tR@RDKg4%aM+KK_}}3B+S#H2 z0rt<*_Nl4!k%7|y4fwgY^uNNg00pZ61NzIz@q2NyEiLIHE%S?g^NEbfKt%9!YU?yQ z^qh&+U}WbD8{q&E?Mq9<013DN2H5})@N8$u01CkX3Fs9f^{bWHKuGLFOZ1kS)=*aD z01@p=RQ9r(>pemK^YiUeQPU6`>94W!hk53YleQ2Q>_SB7aCr2fj@; z@a|n&?qX^0W?<$J9`9pa@`8Bj9VzWnT-qQk!yqQl01W6ECF?mp=LHtlFgo|Iv-PHs z+HiFBprpVM7yReuz5od5zrUyu5$;)5@{gDATVup9HOgRO=U{2(0u;*t3-Hg-^OuGE z;N9vkH}7a--=Co1Fg#jPP{_r^k&B8kCM0%mZLFxL@$v9KH8SJk;?~sDy0^BTnwV%{ zUQ9zlgnfM9U}wHiP~xwz{`dCrZ*%7e7{X9d^{Afom69VE761SLA^8LW004ggEC2ui z0LK6@000O7fPaF6goTEOh>41ejE#|lU+C8$A-c{-jb1$W_sAqMbtN`+RZ#DGFR(dnrcRE3N%f+!F;*y7(oOv#1FPiAwy#YP$z^Q7U<_8BLs** zMSr>_(L`oBgxA?;z>x3<218xJ;14v)$l4!yG&Wrk_I1$$0*;vB$B=#`at4uppizkb zkVG1Zq>_oSkp_`a7SaZiZXiMjk!m2q29j+I!X%PpB5B5wO%5V}2qJRl1%NsHfxr&G z=|x^!dAKu_41Dql0y7LOA)N(0dcZ^rABfh-m_;ITB$a5UdB~$fR(S{-NTzYfmPE#Z z$dyBCddM0`(jjJQ3^=Hu0tmpW@WUTds1O^W zCv4aPqTVsWsFRSgiX^m^Dgr8zYZ&qdl5-rgEs}5?A_tOhoSJHxtD4)WAg_+-CV)r$ z0l^3=PP3O0e*huI221P;!@n>Lqi=>hZs_9&J75vyw2nR*>5$YWnFy(5hH1$EwSHt- z2&Y^c@+FZL3&QBRsy<8z0uiv;-+usJMIdJZ34w1G1pu?}1~|L$M-&7rk*ppEBV3oW z3{UE?w2~S^sl>(pGc6ETQUgwH}48uSiAJo0SA(QX~FrGzYvq#TC0!EGVmk{K=`YG64w z*^4Iq2N`U_YT26(@Ww;iA6V3a3V*n8!U;+!QN-&o;K;WJKrdVR4kI*6wC0H)Z8+gt z8&Y|wjA~4X(?lBohtwStGUbrnULHxSg=BE{y8s3-FXI^_2KJ7l* zPUi?^WVSHxgDj2s;6@ith~r!?-DM$hAerqT7$efv{s0FgQSEnvBN74j@P$DTKnvHC zONlTuy0+nk2Y*mO7rMX%Cg?#AOZY{0)h5f{2_S7&W;+3~xxv`varUz{DmpF%e^`f&wJ41t9(5fhwzv1mBc| z0U*EuBM2j%FvtTFnh*k5Fk|UZh`TZf2my8Qf){uKMUtgzel#qE{5o z`T+owlz=pEZ~#HrKnm`Pm2OzzgBhrem4EOJodD;_ahfxf-U+}Ak|4_v=x&*|EE67c z`G;K+;#whFp8pE*u^;}yhknQwAj5S;KNQlDsB)$xqbbb@AmI*w_<|O)xy2+vAOLDp z8yCVE${l#|oS_`S5dZ^$BP4;HUf`rVX&Fy4%@bn4W7;49dBA^~$q>dQOL?8kgXdnQvsYOnDfj24t0FVQ&GJsH);SXF0X(+eq z0|aFCq_QkQ2uwgnL@)|$U)!lnaS7A<-BO9Aav~Zq1~shtZ;*=2X&Qw1zoAY~flO_x zQ=i%a0w5p*o16;-5U|cJ{sE(En`{^}sx}@hzy~=vDN0qkRui}|sdcU4U8UAnL&&wT ze-NTA73oVe_41G0LefE{2Z>hMA+geI=u@QtfIkQT2`1nUZwBxt8^}v-apD4J9dHDm z*r2j$RqI-*fP_WBP>(V+WFp;)q}Cd-rO7KqPBT@AJ}!>D^n`Dbmde!NE;eOIpur!e zT2+HIfiCh&!V$`4~D_J+6+9nP?X4+~QQR3Nd6O>yUni+~O!R{(#Yf%|x3 zV=w6V57*_SoPYe_5lO*{ETyMCXS!kI{qmTJC@5?}tYs@Z`Gp%cnIOCjX8WdC#YjMN znOSg%0i?hn3uwZe>0DG@D8{!L9NVviU!0?6(AlZm;xWpa)Zb-c0Yf<`I615cvC$3@R|NPo+jf8PRu)%BB zhMd<%u5!4#ylXATHvtr$a54bk<~ZL%26n#lMX-S98Gr)LaZUq?L;OQXHv|E!0Ok|h zR|}ywHv~IJbrC%JsW+&2(zpJHJ2XAlm3#yMI(PL)OS76>Px~OC`E{mNAnK0zLI%qI z)ZlJG?RXaiuD@;tv`>NzH;90J?Vk56!rvj>leB^Xjy?$j0N@7pwE`ImPx(Jo;pSvu Vyd?-=a{xfJ@}LjB=qC{f06U7uGEOJ7jGVWt0R$WZ8s=je-u*DOe&kq9}!i z4KyN^y7WUtlMt&*F%bljtRbDEJamX6>@vOi{twMwE+=kqtJr%yLc-a1j}Z>-)`f9GBO%WDhy=L0>5=eLzUZCI?G``P_| zXl3c^-NL}=_M!Zh=FG7pU)shB58htr9~}O0uVbq2_rt-Fxv_(zmmdB7)lfOReyZ>D zrqum6#Z#+~moGM-oS4Ziby(A(@4L&ZrWcR4wV&_mTide#$G4kXKF-|cGp}2pJe$2t GE&l)<3Z_>8 literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/icon-notice.gif b/docs/sfs/api-ref/public_sys-resources/icon-notice.gif new file mode 100644 index 0000000000000000000000000000000000000000..409070650a49518feb1624c624d814c3bfa63d2e GIT binary patch literal 962 zcmb7D&r8&C5S<{wSd_qn6)U)w5LOaRh!N}_*49lD)S!dZp@M<3gPIX|@UR9-fz+X3 zAaT9)OY{xZtO-;RC85Vab;JEUNIMS5f^r$7-e%-XK`j{0+N$CsgpRd6B1wp z8dw-cH^rU^H4`&7qgabf)l^K`l!66{q9$U(CKRO5%W5pfY)s&YQ6n`HBR0ZTum%`N zgC%I8hQ+`JG_WvCAt-W$sIn@BKCDG1qQWW^a=`*c7G+i@s0S(ZDv1&+K_2`7O-#cM z=m!ZX1Z#kSG+3e)Jg^wpfCd(Yb5TZ)U=a!DwsG z)Z`|1ejMK4ap%CHj;%+>T6=D++5I=uBbQ$fZ48cf{hV1}9&Njl-I}i7e0#6Hdug@s zsr-57_=gLr&9Ros$k}}M>tJ77=hEJ}iPaZ%8|P+gUbS|Oj}5I{|5nZZc)C1$e*Rj` d`09hYXJ4M@PhCx)dHK8WZo1*|*q+^V@*ncduk8Q; literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/icon-tip.gif b/docs/sfs/api-ref/public_sys-resources/icon-tip.gif new file mode 100644 index 0000000000000000000000000000000000000000..c47bae05c9fd17c02a851d96cfac67bf194498d8 GIT binary patch literal 879 zcmchWKWmj?48@OdDOZPr)a61!OE4yGD)salg#|^Ix$qIEF#uk)V>D{95e^!2r`i+9t# zTMu5YtUcd+@#gp0tDE;9ug>oLIzL$6dOx4-t#2PKExu1KulwoYeD?Os#mVO%AMWih HO|EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/sfs/api-ref/public_sys-resources/note_3.0-en-us.png b/docs/sfs/api-ref/public_sys-resources/note_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..57a0e1f53377b28fd80ceb393b035f8d9b8b392a GIT binary patch literal 1080 zcmV-81jqY{P)pI>PbXFRA}Dqnq7z+RTRg6r`*v5D@IBmL~4s5$SN3-f`YICkrqS^ z3O*?4J{4psT?>Nv;P$DA4|YKmeJd1v=!+{-P(e)MT23E4 zfpM5g?!;YNyXOywggfWv-aG#}pA%7499KRz`7Lmw98Q!I<#3`LPLvbnaH1TQ5UMEG zlVk_b1{y%CK&5Na8Kh~iV1CQyHSIUD=$Ui|Y1(mW{t2nlnW!hpqTT3)%#9tQ2@Hwc z4!jG@4brq%Pm%+`OlEvYXy4{GY5awd{We?gCpulWuT{Z9`oN)jk~9ZtI#ba@Tm#IC$eXI#i?GB7 z@C|Siuxi7{ffK+jzyrW_z5t&id2Xi{7fGOZ7RUNhF z=`q(YYu4B2zr}fA1-My6UW~A&C(H`Z0J{sqLLYb>ST?)$UTJH~j4 z)U5D`kx~@HyTBjADBwh`9UcOHGnaO3gx+o=^sFTdqcDs&7cD!S1Y1R9DJQENmMBXi zUX68u7SqPL=oS0?tDydiCJNY=lMCxo@cxg;Iw&H0tZv&cB5#jSkGc8v45{4-xAi@+ zH#c^6Llb3aTk2cp0#8`%*2*ZSb3DivIwje71|rV*JnwHI2e{V0 z?L}VtT_k|}D>qFKHz^_)cUMxtxkDBWXzz2D1oirfKkqs5Z>m~O`i+$JJR1>-NN>fsG-Q5hHbmeou}1??2@ zp;^{uvz{qy3k557pH|h^|K(Paf~;?wS^K(J)S`9Ki+p;|vZBS3*BostG+QG&8PgN& z=@C2h$ubuxBJTs&=XH#%UFPZrh=oAMNN{DPG_uReuDWcPESRPGOKD;{Otwcu3X@*QY`k0+@}-e yxT4{IZgHXpLI!Q!9RCwC$n{8}UWfaGMW8J;IUE8&LY1fUhGLTVa3!QBW+ZA*L=y*M3rfr5il?z?dJZieJ#47>M$@*mD4$1ecadv1qsU1#wR$;qu4Bmh4yS`Hi)ReG=4*#e zajgEV5YlLPaKTMvrW)|6L6Y@JtlU|tX}9u@d<^;|8a!TJ`kRn8mKIZX-z)%<^+`jn z738I}>P{CwooQ#@mc8ItdHsQ6rsk%O$iLY)*x7Zcj%}lwEK@`-=;otzSyX+&p9{kzQYbgSF@Q=2Qy+?#VW0=Vy|cYT&lQ@%;A2YQ{hH z9%ov+34{hBa~SnWOw39F;7p5`9$z4G?cJ)An*I*rb~&khdI=d8h1SkK)If-j5C2TB z8p4%r<<^31tR|Tw4Xs1QHMjMk20}yD8f4p%dXd_$me9Z-SWPlj8%nUOe;>LpUUAI& z1+$nxI~Q3>q`9q!{1-nPlEMa4o@e_SGSdvCrzn))J%_ut?ipfIn4e4CD=Pq4zT@D? zqk$|@wV{L*qfBG7mtFghv-Lntl$pcnz~kwNI)BUSUuvgmQEXp5=UThz?DmmjlsW$V z@)3#dyh6UbBYa%QD%n4gom-Glu20@0My{Xs3VRpaU9=0QxbJP-J)Pz^`?kOW30Tn z@ufYqb@gL4$<)8N0%S?kG%v#(IqvH7UvcW1v+a@N8!}9Baks0-uUUYP1beE1+)Q)S zUobczB2ql)J>S90pM1~e2X4k70q-59;@Rj(Ixc6Ok_Z$V@dbE+GNTrV;HlFQ=lRMeN%CX^J*|inqrfX$fdWuECU& zYE~#M%8xCgqI||*N`--7Xw)BgEZ#bB0-qYhW>q--LhLmBU*r0E*5+4PP+l2n2}rtV z_qXh+#jl32SrvAyo2R)OD=o_BoyYIMW>x6y_Tety7r)3^eF8`TK$3KP{`eA2F}YpN zxa|~0YP$+*PB&3e-M~W&UFbFHknL5q%yVT?GB=Ox3?p^VEh7*N@$03nevU0%RA*Qe zy8Bd~e78Ejsl=~x+vYF$e)B!#In3BC3Kw>)rNi4F>6}lnndnzTghB(1f9&nZP({}9 z<_Y#X?@5R5*rUdbm zZ9zPQB)-@t_#f`t1VTsxAtZr72uUD>BoIOp2q6gsLP&yt3mvdY+y=oIIs7M?<}pwN SX0_=60000=0&&navigator.userAgent.indexOf("opera")==-1&&document.all)?true:false;var xPos;var yPos;window.document.onmousemove=function(a){a=a||window.event;if(a.pageX){xPos=a.pageX;yPos=a.pageY}else{if(document.body!==null&&typeof document.body!=="undefined"){xPos=a.clientX+document.body.scrollLeft-document.body.clientLeft;yPos=a.clientY+document.body.scrollTop-document.body.clientTop}}};function showTooltip(e){if(document.body===null||typeof document.body==="undefined"){return}if(i==0){return}clickFlag=true;var f=Json.parse("jsonData."+e);var a=Math.max(document.body.clientWidth,document.documentElement.clientWidth)-20;if(!dhtmlgoodies_tooltipFlag){dhtmlgoodies_tooltip=document.createElement("DIV");dhtmlgoodies_tooltip.id="dhtmlgoodies_tooltip";dhtmlgoodies_tooltipShadow=document.createElement("DIV");dhtmlgoodies_tooltipShadow.id="dhtmlgoodies_tooltipShadow";document.body.appendChild(dhtmlgoodies_tooltip);document.body.appendChild(dhtmlgoodies_tooltipShadow);if(tooltip_is_msie){dhtmlgoodies_iframe=document.createElement("IFRAME");dhtmlgoodies_iframe.frameborder="5";dhtmlgoodies_iframe.style.backgroundColor="#FFFFFF";dhtmlgoodies_iframe.src="#";dhtmlgoodies_iframe.style.zIndex=100;dhtmlgoodies_iframe.style.position="absolute";document.body.appendChild(dhtmlgoodies_iframe)}}dhtmlgoodies_tooltip.style.display="block";dhtmlgoodies_tooltipShadow.style.display="block";if(tooltip_is_msie){dhtmlgoodies_iframe.style.display="block"}var b=Math.max(document.body.scrollTop,document.documentElement.scrollTop);if(navigator.userAgent.toLowerCase().indexOf("safari")>=0){b=0}var c=xPos+10;dhtmlgoodies_tooltip.style.width=null;dhtmlgoodies_tooltip.innerHTML=f;dhtmlgoodies_tooltip.style.left=c+"px";if(tooltip_is_msie){dhtmlgoodies_tooltip.style.top=yPos+20+b+"px"}else{dhtmlgoodies_tooltip.style.top=yPos+20+"px"}dhtmlgoodies_tooltipShadow.style.left=c+dhtmlgoodies_shadowSize+"px";if(tooltip_is_msie){dhtmlgoodies_tooltipShadow.style.top=yPos+20+b+dhtmlgoodies_shadowSize+"px"}else{dhtmlgoodies_tooltipShadow.style.top=yPos+20+dhtmlgoodies_shadowSize+"px"}if(dhtmlgoodies_tooltip.offsetWidth>dhtmlgoodies_tooltipMaxWidth){dhtmlgoodies_tooltip.style.width=dhtmlgoodies_tooltipMaxWidth+"px"}var d=dhtmlgoodies_tooltip.offsetWidth;if(da){dhtmlgoodies_tooltip.style.left=(dhtmlgoodies_tooltipShadow.style.left.replace("px","")-((c+d)-a))+"px";dhtmlgoodies_tooltipShadow.style.left=(dhtmlgoodies_tooltipShadow.style.left.replace("px","")-((c+d)-a)+dhtmlgoodies_shadowSize)+"px"}if(tooltip_is_msie){dhtmlgoodies_iframe.style.left=dhtmlgoodies_tooltip.style.left;dhtmlgoodies_iframe.style.top=dhtmlgoodies_tooltip.style.top;dhtmlgoodies_iframe.style.width=dhtmlgoodies_tooltip.offsetWidth+"px";dhtmlgoodies_iframe.style.height=dhtmlgoodies_tooltip.offsetHeight+"px"}}function hideTooltip(){i=0;clickFlag=false;if((dhtmlgoodies_tooltip!==null&&typeof dhtmlgoodies_tooltip!=="undefined")&&+(dhtmlgoodies_tooltip.style!==null&&typeof dhtmlgoodies_tooltip.style!=="undefined")){dhtmlgoodies_tooltip.style.display="none";dhtmlgoodies_tooltipShadow.style.display="none";if(tooltip_is_msie){dhtmlgoodies_iframe.style.display="none"}}if(timeId!==null&&typeof timeId!=="undefined"&&timeId!=""){clearTimeout(timeId)}}function showText(a){i=1;timeId=setTimeout(function(){showTooltip(a)},500)}function showText2(a){if(!clickFlag){i=1;showTooltip(a);i=0;if(timeId!==null&&typeof timeId!=="undefined"&&timeId!=""){clearTimeout(timeId)}}}function anchorScroll(b){var d=document.getElementsByName(b);if(d!=null&&d.length>0){var c=d[0];var a=c.getBoundingClientRect().left+(document.body.scrollLeft||(document.documentElement&&document.documentElement.scrollLeft));var e=c.getBoundingClientRect().top+(document.body.scrollTop||(document.documentElement&&document.documentElement.scrollTop));window.scrollTo(a,e-30)}}; \ No newline at end of file diff --git a/docs/sfs/api-ref/public_sys-resources/warning_3.0-en-us.png b/docs/sfs/api-ref/public_sys-resources/warning_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..def5c3565da51684d78479f45904c0360844c243 GIT binary patch literal 3164 zcmV-i45RajP)pR4oO5oRCwC$oPSW0cb>;zfj~mSuLKN~5E4Ot2?$cVg1bfW*MgmP zwXW?r{^)GC>z&@*cI;fk*-bA_)*65J|u{1o1b~sY9&bgB!&FtPHC|>aqwkEf8t)sIV8a zy`l<$fv1-750WZjrUfER4&AbBw(qRs>9xxN*j}-pMOzA)VQ&y-TOiWJv9nVR=-IGB zL`2wi-rWtmJCwYrnwtLq8d^@54N{_E#qc2?d98FYUt9|#UM6CV$k!5{lNa$(kHW9K zOnWgQF}`S;)25`yKPRE0?;CL9SWtgolNa zrBRX}cY`9==aUXcrj$ru%8RMoU&9MOUrS=-S8j{+s~_?FOYc$kFAFFdtPOe${ncT1 z{rLzf8V%)-DtvDE-wqmRZ8xCPYAJtA<5`q3{Ob`bjZO9Fv|84D-@EVUj$Eg)=@6=E z@#L*7W|qCq*W!xRyz%}azq+NTrIL{{k5{wx9=$&5QFz+d73A@UdA>TE#nbrfC(X3B z8(6fZ$fI-Rsms(id`VH^EXwBij$f6Q%6pGy`z7a}PPWn1d>+=6lPmX*Un}gz{Ox!v z`WEl|IDGSOT%3|O*G+D{rZj7N?NbLjt(LV5jh=HqnA?U z8mrYxV|c!gMHxe<(a3REu1^wRwhaLAc*#s3m+W-80O+~e%iEuijH}D~<%`(7rkqDg z=TTZb2dmA-!DFZR&9(3NZQo)rQeiLlD~pmzCp{Of?FN2YE1pz;Th3*$^KYlnx3rR& zpyJ_&X0!Fj%Xs-G%lKj0eA3fW0mv9`|G!E9Ya~lJ`Po^X-Lx2KsErPD79Hj+q@gxm z{Mlkoes-3_qjQ5Er(oy{Vq#*j+H8D$A>2z=-J3vbyTSAQk0(04Sglr))oM!O z`@CekFQuSwX(c8)8igX37UN~i63tz8`Qdaso8^aiGyN2A&2A@2H4T81Uv&6wZ?)Oj zTifJC_?WSn~TqB!^hRw*Ad4e7J~3dFR=6G>_8NdnsMLm)G}au^{sd3m-1x^#e`g zF3xz6x-4W*PjVBduE|UGaf6#U1-aQM6tVOT40?@sz!ZhmW+Or>@p4-Zv4VXye+OW7 zc`+d&A#@sz?CP00DZSLHz!o=IttMHmrqgKTxg*zuw$4$Jkz99N$7-|j*1@mnmSvB7 zO=WExR-28GkWk(!3-#*~r7p`oB}P+1qz`Ts(`7QTajn||ZQHTiBYWfRy#Q?8q@~Mb zVxKK9=<$~3C;^C&N<0(TEz8Di8z5P&W>aZ0G0`z}8jaMCZ=XmZMWeykeJP-en=p}N zQr=uQi}bWqx=f~kF79@>Z|%3c-P>cc{E{db1WhEfM8nqKxzqiJbY}y$o33o;>9xz* zUQson-E%k07oQ_VqoK9kz%l!D08Tq~beT*pkf^ z4(PF1`pDEKqI8;gLeoonS}MI}GariryW_5*SlZ-;)XNs|tUjBo*UTssvHYZ9)NlJ) z_By_sKLd-UZ%SNTyvWApvWyA2xbs6QE?m4wVctygq*taq{STT*zcFP3uVFUm(>{fsnY2byQucdN-4PVNGGwlltbpW(qxPn=t@v%0g@(xlo8u|zNX$;Tj zL~B0)v5_*bKys%(iq>`m{r&x%z8c|~$V_b_07FC0fQu6zCMG;gOl!LV)wFmvmglg* zQ8R8V_1h;>NK8;+wORT1?%)IOmvT)cCaCB#nI=Te-qC2U(nDqS8QysRkk_a3)aCm} zq?bP(MW@xWs-)NJe1QW+nJCD~rsrxeyN)(b$ZgNE*Rg8RgYE+A=jS;+kQlUu{`Kmaq-Zo)ZC1bW*X)SP zB&*dleDyW$_FJ1<>AK4LvN>#CQ_ki!<><89`&-$rmo4DrXSKYw{l~;e&UndGvBREY zdBhz%GStSin-=p=&;OneA1vbs!`1gR{w#YP5zt^s>sevrzAfWX_)uEYBrfUeBv}`^qrW~HGWfKsmsDE zOQ*BGS9P4Wl`RF-yksh zy60FsZNNwVNWragKrk^ve!4rg7mMBdVO@#NOI{X#h4i#kMn*=saPcD79Zs)o<((?G z^^%CiJRf_Q&GJKDpRI*9vNO}^G#dG@zTAL%%&<4GWyKs~qN8as7&HHba-?wT_zK+{<0Kls4ZZI zwt3@|Ua`~d_}Me*beT*+rNNJ9iBKqFak*TiXf(`~bowmtSfv`EtT@NZqPks+{a z5!JMKPh8~>&n-znE|bw}==6Ccb0>biz(smmDwnVHu}ZPEji zzW45)-n*6<0^#-C^K4pKLR_4Zk&zJ&pEynB{*O3#>=aGS=dlkuD9FiX!}lillwCC0 z-?hEgU&dQ|syVhNu(h$+M6CR&JD%9FMMGhZ|GG+tIg8TOds)AHF)ylW?m2UG5RP)x z8t}<_w^)soA(EXPo(HDmU3a@1zaW|JX{#K%Oq;}A@|fXl@p%B-Ez8C%ib2W{N|$?g zkBuLwVmzkfoqdk=b-RuZv4S>9rqBJ{sq>hQNv?~2V>^dfL1TD6U)yB#J4cCkVw)_#|7FHwSFj&?I903+@}Q+?E}XNC3Nz=CN(ZZjK1= zEPb1Cd{SB4f1Go_kMMN4^{(v-b4ID$mhCyd8&;L{vU{JFmp>h)qCi-YZ!0DoBh||m zu>a`Eo9X_gaoZQ>jE+kpfEdXop55erJD^6gL|Bn;DJE=@t~lNAw+sx9aIkUClqxYW z=nj}aF^#ZTB`nJSYa&gTT1nApc>bmLzAo-6E0000 + +

API Usage Guidelines

+

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.

+
+ diff --git a/docs/sfs/api-ref/sfs_02_0016.html b/docs/sfs/api-ref/sfs_02_0016.html new file mode 100644 index 00000000..e5788610 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0016.html @@ -0,0 +1,21 @@ + + +

SFS APIs

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0017.html b/docs/sfs/api-ref/sfs_02_0017.html new file mode 100644 index 00000000..2aa93204 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0017.html @@ -0,0 +1,17 @@ + + +

API Version Querying

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0018.html b/docs/sfs/api-ref/sfs_02_0018.html new file mode 100644 index 00000000..a9c5c0c6 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0018.html @@ -0,0 +1,289 @@ + + +

Querying All API Versions

+

Function

This API is used to query all available versions of APIs provided by SFS.

+

To support function extension, SFS APIs can be distinguished by version. SFS has two types API version IDs:

+

Major version: Independent URL. For example: v1 and v2.

+

Microversion: with the HTTP request header X-Openstack-Manila-Api-Version: Microversion ID. For example: X-Openstack-Manila-Api-Version: 2.4.

+

This API does not require authentication.

+
+
+

URI

  • GET /
  • Parameter description
+

None

+
+

Request

  • Parameter description

    None

    +
  • Example request

    GET https://{endpoint}/

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    versions

    +

    Array of objects

    +

    Lists objects of all available API versions, including v1 and v2.

    +
    +
    +
+
  • Description of the version field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the common name of the version.

    +

    updated

    +

    String

    +

    Specifies the UTC time when the API is last modified. The format is YYYY-MM-DDTHH:MM:SSZ.

    +

    status

    +

    String

    +

    Specifies the API version status, including:

    +
    • CURRENT: indicates that the current API is the preferred version.
    • SUPPORTED: indicates that the current version is an earlier version which is still supported.
    • DEPRECATED: indicates that the current version is a deprecated version that may be deleted later.
    +

    links

    +

    Array of objects

    +

    Specifies the share links. For details, see the description of the links field.

    +

    media-types

    +

    Array of objects

    +

    Specifies the media types supported by the API. For details, see the description of the media-types field.

    +

    version

    +

    String

    +

    If the API in the current version supports microversions, this parameter is the latest microversion. If microversions are not supported, this parameter is an empty string.

    +

    min_version

    +

    String

    +

    If the API in the current version supports microversions, this parameter is the earliest microversion. If microversions are not supported, this parameter is an empty string.

    +
    +
    +
  • Description of the links field +
    + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    href

    +

    String

    +

    Specifies the API access path, which is used as a reference.

    +

    type

    +

    String

    +

    Specifies the type of the text returned by the reference API.

    +

    rel

    +

    String

    +

    Specifies the additional description on links.

    +
    +
    +
  • Description of the media-types field +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    base

    +

    String

    +

    Specifies the basic text type.

    +

    type

    +

    String

    +

    Specifies the text type.

    +
    +
    +
+
  • Example response
    {
+  "versions": [
+    {
+      "status": "CURRENT",
+      "updated": "2015-08-27T11:33:21Z",
+      "links": [
+        {
+          "href": "http://docs.openstack.org/",
+          "type": "text/html",
+          "rel": "describedby"
+        },
+        {
+          "href": "https://sfs.region.www.t-systems.com/v2/",
+          "rel": "self"
+        }
+      ],
+      "min_version": "2.0",
+      "version": "2.28",
+      "media-types": [
+        {
+          "base": "application/json",
+          "type": "application/vnd.openstack.share+json;version=1"
+        }
+      ],
+      "id": "v2.0"
+    }
+  ]
+}
    +
+
+

Status Codes

  • Normal

    300

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    400 Bad Request

    +

    Invalid input: The post-deduction capacity must be larger than 0 and smaller than the current capacity. (Current capacity: XX; post-deduction capacity: XX)

    +

    400 Bad Request

    +

    Invalid input: The post-expansion capacity must be larger than the current capacity. (Current capacity: XX; post-expansion capacity: XX)

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +

    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 service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: API Version Querying
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0019.html b/docs/sfs/api-ref/sfs_02_0019.html new file mode 100644 index 00000000..8722e449 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0019.html @@ -0,0 +1,306 @@ + + +

Querying Details About API Versions

+

Function

This API is used for querying details about API versions.

+
+

URI

  • GET /{api_version}/
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    api_version

    +

    Yes

    +

    String

    +

    Specifies the API version, which can be v1 or v2.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    GET https://{endpoint}/v2/

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    versions

    +

    Object

    +

    List objects of all available API versions

    +
    +
    +
    • Description of the version field +
      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

      Parameter

      +

      Type

      +

      Description

      +

      id

      +

      String

      +

      Specifies the common name of the version.

      +

      updated

      +

      String

      +

      Specifies the UTC time when the API is last modified. The format is YYYY-MM-DDTHH:MM:SSZ.

      +

      status

      +

      String

      +

      Specifies the API version status, including:

      +
      • CURRENT: indicates that the current API is the preferred version.
      • SUPPORTED: indicates that the current version is an earlier version which is still supported.
      • DEPRECATED: indicates that the current version is a deprecated version that may be deleted later.
      +

      links

      +

      Array of objects

      +

      Specifies the share links. For details, see the description of the links field.

      +

      media-types

      +

      Array of objects

      +

      Specifies the media types supported by the API. For details, see the description of the media-types field.

      +

      version

      +

      String

      +

      If the API in the current version supports microversions, this parameter is the latest microversion. If microversions are not supported, this parameter is an empty string.

      +

      min_version

      +

      String

      +

      If the API in the current version supports microversions, this parameter is the earliest microversion. If microversions are not supported, this parameter is an empty string.

      +
      +
      +
    • Description of the links field +
      + + + + + + + + + + + + + + + + + +

      Parameter

      +

      Type

      +

      Description

      +

      href

      +

      String

      +

      Specifies the API access path, which is used as a reference.

      +

      type

      +

      String

      +

      Specifies the type of the text returned by the reference API.

      +

      rel

      +

      String

      +

      Specifies the additional description on links.

      +
      +
      +
    • Description of the media-types field +
      + + + + + + + + + + + + + +

      Parameter

      +

      Type

      +

      Description

      +

      base

      +

      String

      +

      Specifies the basic text type.

      +

      type

      +

      String

      +

      Specifies the text type.

      +
      +
      +
    +
+
  • Example response
    {
+  "versions": [
+    {
+      "status": "CURRENT",
+      "updated": "2015-08-27T11:33:21Z",
+      "links": [
+        {
+          "href": "http://docs.openstack.org/",
+          "type": "text/html",
+          "rel": "describedby"
+        },
+        {
+          "href": "https://sfs.region.www.t-systems.com/v2/",
+          "rel": "self"
+        }
+      ],
+      "min_version": "2.0",
+      "version": "2.28",
+      "media-types": [
+        {
+          "base": "application/json",
+          "type": "application/vnd.openstack.share+json;version=1"
+        }
+      ],
+      "id": "v2.0"
+    }
+  ]
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    400 Bad Request

    +

    Invalid input: The post-deduction capacity must be larger than 0 and smaller than the current capacity. (Current capacity: XX; post-deduction capacity: XX)

    +

    400 Bad Request

    +

    Invalid input: The post-expansion capacity must be larger than the current capacity. (Current capacity: XX; post-expansion capacity: XX)

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +

    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 service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: API Version Querying
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0020.html b/docs/sfs/api-ref/sfs_02_0020.html new file mode 100644 index 00000000..a3cd35e3 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0020.html @@ -0,0 +1,27 @@ + + +

File Sharing

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0021.html b/docs/sfs/api-ref/sfs_02_0021.html new file mode 100644 index 00000000..9389fb83 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0021.html @@ -0,0 +1,525 @@ + + +

Creating a Shared File System

+

Function

This API is used to create a shared file system. After the file system is created, you need to mount the file system to ECSs to achieve shared file storage.

+

This API is an asynchronous API. If the returned status code is 200, the API request is successfully delivered and received. Later, you can query the status and path of the shared file system by referring to Querying Details About a Shared File System to identify whether the creation is complete and successful. If the status of the shared file system becomes available or the shared path is generated, the creation is successful.

+
+

After a shared file system is created successfully, it can be used only after you add share access rules by referring to Adding Share Access Rules.

+
+
+

URI

  • POST /v2/{project_id}/shares
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share

    +

    Yes

    +

    Object

    +

    For details, see the description of the share field.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_proto

    +

    Yes

    +

    String

    +

    Specifies the file system sharing protocol. The valid value can be NFS (for Linux OS) or CIFS (for Windows OS).

    +

    size

    +

    Yes

    +

    Integer

    +

    Specifies the size (GB) of the shared file system. The applied capacity of the shared file system cannot be larger than the allowed quota. To view the allowed quota, see Quota Management.

    +

    name

    +

    No

    +

    String

    +

    Specifies the name of the shared file system, which contains 0 to 255 characters and can contain only letters, digits, hyphens (-), and underscores (_).

    +

    description

    +

    No

    +

    String

    +

    Specifies the description of the shared file system, which contains 0 to 255 characters and can contain only letters, digits, hyphens (-), and underscores (_).

    +

    is_public

    +

    No

    +

    Boolean

    +

    (Supported by API versions from v2.8 to v2.42). Specifies whether a file system can be publicly seen. If it is set to true, the file system can be seen publicly. If it is set to false, the file system can be seen privately. The default value is false.

    +

    availability_zone

    +

    No

    +

    String

    +

    Specifies the availability zone name. If this parameter is left blank, the default availability zone will be used. If the default availability zone contains no storage resources, the creation of the shared file system fails. The value contains 0 to 255 characters.

    +

    metadata

    +

    No

    +

    Object

    +

    Specifies the metadata information used to create the shared file system. The value consists of one or more key and value pairs organized as a dictionary of strings. For details, see the description of the metadata field.

    +
    CAUTION:
    • For security concerns, the API for modifying the metadata field is not opened yet. Therefore, ensure that the parameters and values are correct when creating a shared file system with data encryption using the metadata field.
    • Unless otherwise specified (for example, #sfs_crypt_key_id), the keys that comply with the following rules in the metadata field are for internal use of the system. Do not customize the settings to avoid internal system errors caused by conflicts with system predefined keys.
      • Key share_used
      • Keys that start with #sfs
      +
    +
    +
    +
    +
  • Description of metadata fields (creating a shared file system with the encryption function)
    When creating a shared file system with the encryption function, obtain the key ID, domain ID, and key alias of the encryption key using the HTTPS request by referring to section Querying the List of CMKs in the Key Management Service API Reference. Then, in the metadata field, set the key-value pairs according to the following table. Ensure that the key-value pairs in the metadata field are correct. +
    + + + + + + + + + + + + + + + + + + + + + +

    Key

    +

    Value Type

    +

    Mandatory

    +

    Description

    +

    #sfs_crypt_key_id

    +

    String

    +

    Yes

    +

    Specifies the encryption key ID.

    +

    If this field, #sfs_crypt_domain_id, and #sfs_crypt_alias exist at the same time, the data encryption function is enabled.

    +

    #sfs_crypt_domain_id

    +

    String

    +

    Yes

    +

    Specifies the tenant domain ID.

    +

    If this field, #sfs_crypt_key_id, and #sfs_crypt_alias exist at the same time, the data encryption function is enabled.

    +

    #sfs_crypt_alias

    +

    String

    +

    Yes

    +

    Specifies the encryption key alias.

    +

    If this field, #sfs_crypt_key_id, and #sfs_crypt_domain_id exist at the same time, the data encryption function is enabled.

    +
    +
    +
    • You are advised to use the default primary key sfs/default to create an encrypted shared file system. For details, see section "File System Encryption" and "Encryption" in the Scalable File Service User Guide.
    +
    +
    +
+
  • Example request: POST https://{endpoint}/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares
    {
+   "share": {
+       "share_type": null,
+       "name": "test",
+       "snapshot_id": null,
+       "description": "test description",
+       "share_proto": "NFS",
+       "share_network_id": null,
+       "size": 1,
+       "is_public": false
+   }
+}
    +
+
+
  • Example request (creating a shared file system with data encryption function): POST https://{endpoint}/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares
    {
+   "share": {
+       "share_type": null,
+       "name": "test",
+       "snapshot_id": null,
+       "description": "test description",
+       "metadata": {
+           "#sfs_crypt_key_id": "9130c90d-73b8-4203-b790-d49f98d503df",
+           "#sfs_crypt_domain_id": "3b2d9670690444c582942801ed7d457b",
+           "#sfs_crypt_alias": "sfs/default"
+       },
+       "share_proto": "NFS",
+       "share_network_id": null,
+       "size": 1,
+       "is_public": false
+   }
+}
    +
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    share

    +

    Object

    +

    For details, see the description of the share field.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    links

    +

    Array

    +

    Specifies the links of shared file systems.

    +

    availability_zone

    +

    String

    +

    Specifies the availability zone.

    +

    share_server_id

    +

    String

    +

    Specifies the ID for managing share services.

    +

    id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    size

    +

    Integer

    +

    Specifies the size (GB) of the shared file system.

    +

    project_id

    +

    String

    +

    Specifies the ID of the project to which the shared file system belongs.

    +

    metadata

    +

    Object

    +

    Sets one or more metadata key and value pairs as a dictionary of strings. share_used is the key, and the corresponding value is the used capacity of the shared file system in the unit of Bytes.

    +

    status

    +

    String

    +

    Specifies the status of the shared file system.

    +

    description

    +

    String

    +

    Describes the shared file system.

    +

    host

    +

    String

    +

    Specifies the name of the host. This field is visible only to the administrator.

    +

    name

    +

    String

    +

    Specifies the name of the shared file system.

    +

    created_at

    +

    String

    +

    Specifies the date and time stamp when the shared file system was created.

    +

    access_rules_status

    +

    String

    +

    Specifies the configuration status of the access rule. Possible values are active (effective), error (configuration failed), and syncing (configuration in progress). This field is supported by API v2.10 and later versions.

    +

    share_proto

    +

    String

    +

    Specifies the protocol for sharing file systems.

    +

    share_type_name

    +

    String

    +

    Specifies the storage service type assigned for the shared file system, such as high-performance storage (composed of SSDs) and large-capacity storage (composed of SATA disks). This field is supported by API v2.6 and later versions.

    +

    share_type

    +

    String

    +

    Specifies the ID of the share type.

    +

    volume_type

    +

    String

    +

    Specifies the volume type. The definition of this parameter is the same as that of share_type.

    +

    export_locations

    +

    Array

    +

    Lists the mount locations. Currently, only a single mount location is supported. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.9.

    +

    export_location

    +

    String

    +

    Specifies the mount location. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.9.

    +

    is_public

    +

    Boolean

    +

    Specifies the visibility level of the shared file system. If it is set to true, the file system can be seen publicly. If it is set to false, the file system can be seen privately. The default value is false.

    +

    user_id

    +

    String

    +

    Specifies the user ID. This field is supported by API v2.16 and later versions.

    +
    +
    +
+
  • Example response
    {
+    "share": {
+        "status": "creating",
+        "project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
+        "name": "share_London",
+        "share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
+        "availability_zone": "az1.dc1",
+        "created_at": "2015-09-18T10:25:24.533287",
+        "export_location": null,
+        "links": [
+            {
+                "href": "http://192.168.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
+                "rel": "self"
+            },
+            {
+                "href": "http://192.168.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
+                "rel": "bookmark"
+            }
+        ],
+        "share_network_id": null,
+        "export_locations": [],
+        "share_proto": "NFS",
+        "host": null,
+        "volume_type": "default",
+        "snapshot_id": null,
+        "is_public": true,
+        "metadata": {
+            "project": "my_app",
+            "aim": "doc"
+        },
+        "id": "011d21e2-fbc3-4e4a-9993-9ea223f73264",
+        "size": 1,
+        "description": "My custom share London"
+    }
+}
    +

    When the client receives the system response, the shared file system is still being created. For this reason, the shared path cannot be queried immediately. You can use the API of Querying Mount Locations of a Shared File System to query the shared path after the creation is complete.

    +
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0022.html b/docs/sfs/api-ref/sfs_02_0022.html new file mode 100644 index 00000000..796946a8 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0022.html @@ -0,0 +1,333 @@ + + +

Querying All Shared File Systems

+

Function

This API is used to list the basic information of all shared file systems.

+
+

URI

  • GET /v2/{project_id}/shares?all_tenants={all_tenants}&status={status}&limit={limit}&offset={offset}&sort_key={sort_key}&sort_dir={sort_dir}&project_id={project_id}&is_public={is_public}&metadata={metadata}& export_location_id={export_location_id}& export_location_path={export_location_path}& name~={name}& description~={description}& with_count={with_count}
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    all_tenants

    +

    No (query parameter)

    +

    Boolean

    +

    This parameter is available only to users with administrator permissions. Specifies whether to list shared file systems of all tenants. To list shared file systems of all tenants, set it to 1. To list shared file systems only of the current tenant, set it to 0.

    +

    project_id

    +

    No (query parameter)

    +

    String

    +

    This parameter is available only to users with administrator permissions. Specifies the ID of the project to which the shared file system belongs. This parameter needs to be used together with all_tenants.

    +

    status

    +

    No (query parameter)

    +

    String

    +

    Filters shared file systems by status. Possible values are:

    +
    • creating: The shared file system is being created.
    • error: The shared file system fails to be created.
    • available: The shared file system is available.
    • deleting: The shared file system is being deleted.
    • error_deleting: The shared file system fails to be deleted.
    • extending: The shared file system is being expanded.
    • extending_error: The shared file system fails to be expanded.
    • shrinking: The shared file system is being shrunk.
    • shrinking_error: The shared file system fails to be shrunk.
    • shrinking_possible_data_loss_error: The shared file system fails to be shrunk due to data loss.
    • manage_starting: Shared file system management starts.
    • manage_error: The shared file system fails to be managed.
    • unmanage_starting: Canceling shared file system management starts.
    • unmanage_error: Failed to cancel shared file system management.
    • unmanaged: The shared file system is not managed.
    +

    limit

    +

    No (query parameter)

    +

    Integer

    +

    Specifies the maximum number of shared file systems that can be returned. If this parameter is not specified, all the shared file systems are returned by default.

    +

    offset

    +

    No (query parameter)

    +

    Integer

    +

    Specifies the offset to define the start point from 0 of shared file system listing. The value must be greater than or equal to 0.

    +

    sort_key

    +

    No (query parameter)

    +

    String

    +

    Specifies the keyword for sorting the queried shared file systems. Possible values are id, status, size, host, share_proto, availability_zone_id, user_id, project_id, created_at, updated_at, display_name, name, share_type_id, share_network_id, and snapshot_id. By default, the value is sorted by created_at.

    +

    sort_dir

    +

    No (query parameter)

    +

    String

    +

    Specifies the direction to sort shared file systems. Possible values are asc (ascending) and desc (descending).

    +

    is_public

    +

    No (query parameter)

    +

    String

    +

    When this parameter is set to true, the current tenant can query all its own shared file systems and other tenants' shared file systems whose is_public is set to true. When this parameter is set to false, the current tenant can query only the shared file systems owned by the tenant.

    +

    metadata

    +

    No (query parameter)

    +

    String

    +

    Specifies the metadata information used to query the shared file systems. The value consists of one or more key and value pairs organized as a dictionary of strings.

    +

    export_location_id

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for filtering based on the ID of the mount path. This field is supported by API v2.35 and later versions.

    +

    export_location_path

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for filtering based on the mount path. This field is supported by API v2.35 and later versions.

    +

    name~

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for fuzzy filtering based on the name of a shared file system. This field is supported by API v2.36 and later versions.

    +

    description~

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for fuzzy filtering based on the description of a shared file system. This field is supported by API v2.36 and later versions.

    +

    with_count

    +

    No (query parameter)

    +

    String

    +

    Specifies whether the number of queried shared file systems is returned. This field is supported by API v2.42 and later versions. This parameter is specified by ?with_count=true in the URI. The default value is false.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
+
+
  • Example request

    GET https://{endpoint}/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares

    +
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    shares

    +

    Array of objects

    +

    For details, see the description of the share field.

    +

    count

    +

    String

    +

    Specifies the number of returned shared file systems.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    links

    +

    Array of objects

    +

    Specifies the request link information of the shared file system.

    +

    name

    +

    String

    +

    Specifies the name of the shared file system.

    +
    +
    +
+
  • Example response
    {
+    "count": 1,
+    "shares": [
+    {
+        "id": "1390cb29-539b-4926-8953-d8d6b106071a",
+        "links": [
+        {
+            "href": "https://192.168.196.47:8796/v2/f24555bfcf3146ca936d21bcb548687e/shares/1390cb29-539b-4926-8953-d8d6b106071a",
+            "rel": "self"
+        },
+        {
+            "href": "https://192.168.196.47:8796/f24555bfcf3146ca936d21bcb548687e/shares/1390cb29-539b-4926-8953-d8d6b106071a",
+            "rel": "bookmark"
+        }
+        ],
+        "name": null
+    }
+]
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0023.html b/docs/sfs/api-ref/sfs_02_0023.html new file mode 100644 index 00000000..36b349a7 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0023.html @@ -0,0 +1,537 @@ + + +

Querying Details About All Shared File Systems

+

Function

This API is used to query the details about all shared file systems.

+
+

URI

  • GET /v2/{project_id}/shares/detail?all_tenants={all_tenants}&project_id={project_id}&status={status}&limit={limit}&offset={offset}&sort_key={sort_key}&sort_dir={sort_dir}&is_public={is_public}&metadata={metadata}& export_location_id={export_location_id}& export_location_path={export_location_path}& description~={description}&name={name}
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    all_tenants

    +

    No (query parameter)

    +

    Integer

    +

    (Administrators only) Specifies whether to list shared file systems of all tenants. To list shared file systems of all tenants, set it to 1. To list shared file systems only of the current tenant, set it to 0.

    +

    project_id

    +

    No (query parameter)

    +

    String

    +

    Specifies the ID of the tenant who creates the shared file system. This parameter is used together with all_tenants.

    +

    status

    +

    No (query parameter)

    +

    String

    +

    Filters shared file systems by status. Possible values are creating, error, available, deleting, error_deleting, manage_starting, manage_error, unmanage_starting, unmanage_error, unmanaged, extending, extending_error, shrinking, shrinking_error, and shrinking_possible_data_loss_error.

    +

    limit

    +

    No (query parameter)

    +

    Integer

    +

    Specifies the maximum number of shared file systems that can be returned.

    +

    offset

    +

    No (query parameter)

    +

    Integer

    +

    Specifies the offset to define the start point of shared file system listing.

    +

    sort_key

    +

    No (query parameter)

    +

    String

    +

    Specifies the keyword for sorting the queried shared file systems. Possible values are id, status, size, host, share_proto, availability_zone_id, user_id, project_id, created_at, updated_at, display_name, name, share_type_id, share_network_id, and snapshot_id.

    +

    sort_dir

    +

    No (query parameter)

    +

    String

    +

    Specifies the direction to sort shared file systems. Possible values are asc (ascending) and desc (descending).

    +

    is_public

    +

    No (query parameter)

    +

    String

    +

    When this parameter is set to true, the current tenant can query all its own shared file systems and other tenants' shared file systems whose is_public is set to true. When this parameter is set to false, the current tenant can query only the shared file systems owned by the tenant.

    +

    metadata

    +

    No (query parameter)

    +

    String

    +

    Specifies the metadata information used to query the shared file systems. The value consists of one or more key and value pairs organized as a dictionary of strings.

    +

    export_location_id

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for filtering based on the ID of the mount path. This field is supported by API v2.35 and later versions.

    +

    export_location_path

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for filtering based on the mount path. This field is supported by API v2.35 and later versions.

    +

    name

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for fuzzy filtering based on the name of a shared file system. This field is supported by API v2.36 and later versions.

    +

    description~

    +

    No (query parameter)

    +

    String

    +

    Specifies the field used for fuzzy filtering based on the description of a shared file system. This field is supported by API v2.36 and later versions.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    shares

    +

    Array of objects

    +

    Specifies the list of share objects.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    links

    +

    Array

    +

    Specifies the links of shared file systems.

    +

    availability_zone

    +

    String

    +

    Specifies the availability zone.

    +

    share_server_id

    +

    String

    +

    Specifies the ID for managing share services.

    +

    share_network_id

    +

    String

    +

    Specifies the ID of the share network. This parameter is reserved, because share network management is not supported currently.

    +

    snapshot_id

    +

    String

    +

    Specifies the ID of the source snapshot that is used to create the shared file system. This parameter is reserved, because snapshots are not supported currently.

    +

    snapshot_support

    +

    Boolean

    +

    Specifies whether snapshots are supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.2 and later versions.

    +

    id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    size

    +

    Integer

    +

    Specifies the size (GB) of the shared file system.

    +

    share_group_id

    +

    String

    +

    Specifies the ID of the consistency group. This parameter is reserved, because consistency groups are not supported currently. This field is supported by API versions from v2.31 to v2.42.

    +

    project_id

    +

    String

    +

    Specifies the ID of the project to which the shared file system belongs.

    +

    metadata

    +

    Object

    +

    Sets one or more metadata key and value pairs as a dictionary of strings. share_used is the key, and the corresponding value is the used capacity of the shared file system in the unit of Bytes.

    +

    status

    +

    String

    +

    Specifies the status of the shared file system.

    +

    task_state

    +

    String

    +

    Specifies the data migration status. This parameter is reserved, because data migration is not supported currently. This field is supported by API v2.5 and later versions.

    +

    has_replicas

    +

    Boolean

    +

    Specifies whether replicas exist. This parameter is reserved, because replication is not supported currently. This field is supported by API versions from v2.11 to v2.42.

    +

    replication_type

    +

    String

    +

    Specifies the replication type. This parameter is reserved, because replication is not supported currently. This field is supported by API versions from v2.11 to v2.42.

    +

    description

    +

    String

    +

    Describes the shared file system.

    +

    host

    +

    String

    +

    Specifies the name of the host. This field is visible only to the administrator.

    +

    name

    +

    String

    +

    Specifies the name of the shared file system.

    +

    created_at

    +

    String

    +

    Specifies the date and time stamp when the shared file system was created.

    +

    access_rules_status

    +

    String

    +

    Specifies the configuration status of the access rule. Possible values are active (effective), error (configuration failed), and syncing (configuration in progress). This field is supported by API v2.10 and later versions.

    +

    share_proto

    +

    String

    +

    Specifies the protocol for sharing file systems.

    +

    share_type_name

    +

    String

    +

    Specifies the storage service type assigned for the shared file system, such as high-performance storage (composed of SSDs) and large-capacity storage (composed of SATA disks). This field is supported by API v2.6 and later versions.

    +

    share_type

    +

    String

    +

    Specifies the ID of the share type.

    +

    volume_type

    +

    String

    +

    Specifies the volume type. The definition of this parameter is the same as that of share_type.

    +

    export_locations

    +

    Array

    +

    Lists the mount locations. Currently, only a single mount location is supported. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.9.

    +

    export_location

    +

    String

    +

    Specifies the mount location. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.9.

    +

    is_public

    +

    Boolean

    +

    Specifies the visibility level of the shared file system. If it is set to true, the file system can be seen publicly. If it is set to false, the file system can be seen privately. The default value is false.

    +

    source_share_group_snapshot_member_id

    +

    String

    +

    Specifies the ID of the snapshot's source. This parameter is reserved, because consistency snapshots are not supported currently. This field is supported by API v2.31 and later versions.

    +

    revert_to_snapshot_support

    +

    Boolean

    +

    Specifies whether rollback from snapshot is supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.27 and later versions.

    +

    create_share_from_snapshot_support

    +

    Boolean

    +

    Specifies whether creation of shared file systems from snapshot is supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.24 and later versions.

    +

    mount_snapshot_support

    +

    Boolean

    +

    Specifies whether snapshot mount is supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.32 and later versions.

    +

    user_id

    +

    String

    +

    Specifies the user ID. This field is supported by API v2.16 and later versions.

    +
    +
    +
+
  • Example response
    {
+    "shares": [
+        {
+            "links": [
+                {
+                    "href": "https://192.168.170.97:8796/v2/61b01a94b84448cfac2424e46553d7e7/shares/54d0bac6-45c8-471c-bf0d-16ffd81ef88a",
+                    "rel": "self"
+                },
+                {
+                    "href": "https://192.168.170.97:8796/61b01a94b84448cfac2424e46553d7e7/shares/54d0bac6-45c8-471c-bf0d-16ffd81ef88a",
+                    "rel": "bookmark"
+                }
+            ],
+            "export_location": "sfs.dong.com:/share-e1c2d35e",
+            "availability_zone": "az1.dc1",
+            "share_network_id": null,
+            "snapshot_id": null,
+            "id": "54d0bac6-45c8-471c-bf0d-16ffd81ef88a",
+            "size": 1,
+            "share_type": "default",
+            "share_group_id": null,
+            "project_id": "da0f615c35eb4d72812d1547a77b5394",
+            "metadata": { 
+                          
+                         "share_used": "1048576000000"
+             },
+            "status": "available",
+            "description": "test description",
+            "export_locations": ["sfs.dong.com:/share-e1c2d35e"],
+            "host": "DJ01@9656beb1-7ce2-4c46-9911-ecd51ab632bf#9656beb1-7ce2-4c46-9911-ecd51ab632bf",
+            "is_public": false,
+            "name": "cl01",
+            "created_at": "2017-07-07T03:15:06.858662",
+            "share_proto": "NFS",
+            "volume_type": "default"
+        }
+]
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0024.html b/docs/sfs/api-ref/sfs_02_0024.html new file mode 100644 index 00000000..b324a115 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0024.html @@ -0,0 +1,437 @@ + + +

Querying Details About a Shared File System

+

Function

This API is used to query the details about a shared file system.

+
+

URI

  • GET /v2/{project_id}/shares/{share_id}
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    share

    +

    Object

    +

    Specifies the share object.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    links

    +

    Array

    +

    Specifies the links of shared file systems.

    +

    availability_zone

    +

    String

    +

    Specifies the availability zone.

    +

    share_server_id

    +

    String

    +

    Specifies the ID for managing share services.

    +

    share_network_id

    +

    String

    +

    Specifies the ID of the share network. This parameter is reserved, because share network management is not supported currently.

    +

    snapshot_id

    +

    String

    +

    Specifies the ID of the source snapshot that is used to create the shared file system. This parameter is reserved, because snapshots are not supported currently.

    +

    snapshot_support

    +

    Boolean

    +

    Specifies whether snapshots are supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.2 and later versions.

    +

    id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    size

    +

    Integer

    +

    Specifies the size (GB) of the shared file system.

    +

    share_group_id

    +

    String

    +

    Specifies the ID of the consistency group. This parameter is reserved, because consistency groups are not supported currently. This field is supported by API versions from v2.31 to v2.42.

    +

    project_id

    +

    String

    +

    Specifies the ID of the project to which the shared file system belongs.

    +

    metadata

    +

    Object

    +

    Sets one or more metadata key and value pairs as a dictionary of strings. share_used is the key, and the corresponding value is the used capacity of the shared file system in the unit of Bytes.

    +

    status

    +

    String

    +

    Specifies the status of the shared file system.

    +

    task_state

    +

    String

    +

    Specifies the data migration status. This parameter is reserved, because data migration is not supported currently. This field is supported by API v2.5 and later versions.

    +

    has_replicas

    +

    Boolean

    +

    Specifies whether replicas exist. This parameter is reserved, because replication is not supported currently. This field is supported by API versions from v2.11 to v2.42.

    +

    replication_type

    +

    String

    +

    Specifies the replication type. This parameter is reserved, because replication is not supported currently. This field is supported by API versions from v2.11 to v2.42.

    +

    description

    +

    String

    +

    Describes the shared file system.

    +

    host

    +

    String

    +

    Specifies the name of the host. This field is visible only to the administrator.

    +

    name

    +

    String

    +

    Specifies the name of the shared file system.

    +

    created_at

    +

    String

    +

    Specifies the date and time stamp when the shared file system was created.

    +

    access_rules_status

    +

    String

    +

    Specifies the configuration status of the access rule. Possible values are active (effective), error (configuration failed), and syncing (configuration in progress). This field is supported by API v2.10 and later versions.

    +

    share_proto

    +

    String

    +

    Specifies the protocol for sharing file systems.

    +

    share_type_name

    +

    String

    +

    Specifies the storage service type assigned for the shared file system, such as high-performance storage (composed of SSDs) and large-capacity storage (composed of SATA disks). This field is supported by API v2.6 and later versions.

    +

    share_type

    +

    String

    +

    Specifies the ID of the share type.

    +

    volume_type

    +

    String

    +

    Specifies the volume type. The definition of this parameter is the same as that of share_type.

    +

    export_locations

    +

    Array

    +

    Lists the mount locations. Currently, only a single mount location is supported. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.9.

    +

    export_location

    +

    String

    +

    Specifies the mount location. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.9.

    +

    is_public

    +

    Boolean

    +

    Specifies the visibility level of the shared file system. If it is set to true, the file system can be seen publicly. If it is set to false, the file system can be seen privately. The default value is false.

    +

    source_share_group_snapshot_member_id

    +

    String

    +

    Specifies the ID of the snapshot's source. This parameter is reserved, because consistency snapshots are not supported currently. This field is supported by API v2.31 and later versions.

    +

    revert_to_snapshot_support

    +

    Boolean

    +

    Specifies whether rollback from snapshot is supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.27 and later versions.

    +

    create_share_from_snapshot_support

    +

    Boolean

    +

    Specifies whether creation of shared file systems from snapshot is supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.24 and later versions.

    +

    mount_snapshot_support

    +

    Boolean

    +

    Specifies whether snapshot mount is supported. This parameter is reserved, because snapshots are not supported currently. This field is supported by API v2.32 and later versions.

    +

    user_id

    +

    String

    +

    Specifies the user ID. This field is supported by API v2.16 and later versions.

    +
    +
    +
+
  • Example response
    {
+  "share": {
+    "status": "available",
+    "share_type_name": "sla",
+    "description": "My custom share London",
+    "links": [
+      {
+        "href": "https://192.168.196.47:8796/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
+        "rel": "self"
+      },
+      {
+        "href": "https://192.168.196.47:8796/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
+        "rel": "bookmark"
+      }
+    ],
+    "availability_zone": "az1.dc1",
+    "share_network_id": null,
+    "share_server_id": null,
+    "share_group_id": null,
+    "host": "DJ38@a4588256-3880-4136-b3c9-4c3aade8a84b#a4588256-3880-4136-b3c9-4c3aade8a84b",
+    "revert_to_snapshot_support": null,
+    "access_rules_status": "active",
+    "snapshot_id": null,
+    "create_share_from_snapshot_support": null,
+    "is_public": false,
+    "task_state": null,
+    "snapshot_support": true,
+    "id": "f26d867f-9876-433d-8db2-25d210f29309",
+    "size": 1,
+    "source_share_group_snapshot_member_id": null,
+    "user_id": "daa3f8f8d7254465841da769298a76f6",
+    "name": "luzhongguo_1",
+    "share_type": "8ae4e74e-83f4-4980-8ab8-e637f9294e0b",
+    "has_replicas": false,
+    "replication_type": null,
+    "created_at": "2018-12-25T08:45:22.525899",
+    "share_proto": "NFS",
+    "volume_type": "sla",
+    "mount_snapshot_support": null,
+    "project_id": "07412155bf474db9a2f697fd978593d7",
+    "metadata": {
+      "share_key": "test",
+      "share_used": "1",
+    }
+  }
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0025.html b/docs/sfs/api-ref/sfs_02_0025.html new file mode 100644 index 00000000..65ff1198 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0025.html @@ -0,0 +1,174 @@ + + +

Querying Mount Locations of a Shared File System

+

Function

This API is used to query mount locations of a shared file system.

+

This API exists only when X-Openstack-Manila-Api-Version in the request header is greater than or equal to 2.9. The following is an example request sent by the curl command: curl -k -i -X GET https://192.168.196.47:8786/v2/13c7ff9a479c4e3599f4331d9e4a1835/shares/2a8c5470-d5d9-4fe1-b9fc-66a15a162e41/export_locations -H "X-Openstack-Manila-Api-Version: 2.9" -H "X-Auth-Token: $token" -H "Accept: application/json"

+
+
+

URI

  • GET /v2/{project_id}/shares/{share_id}/export_locations
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    export_locations

    +

    Array of strings

    +

    Specifies the list of export locations.

    +
    +
    +
  • Description of field export_location +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of the mount location of the shared file system.

    +

    share_instance_id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    path

    +

    String

    +

    Specifies the path to which the shared file system will be mounted.

    +

    is_admin_only

    +

    Boolean

    +

    Specifies whether the shared file system is only visible to administrators and its owner. Possible values are true (only visible to administrators and its owner) and false (visible to all users).

    +

    preferred

    +

    Boolean

    +

    Identifies which mount locations are most efficient and are used preferentially when multiple mount locations exist.

    +
    +
    +
+
  • Example response
    NFS share:
    {
+  "export_locations": [
+    {
+      "path": "sfs-nas1.dong.com:/share-236b936a",
+      "id": "b03d2aac-aeed-409a-af07-5d1b9024241c",
+      "preferred": false
+    }
+  ]
+}
    +
    +
    CIFS share:
    {
+  "export_locations": [
+    {
+      "path": "\\\\sfs-nas1.dong.com\\share-4e76e627",
+      "id": "85eb5849-1a89-43ae-99ac-2e781514a228",
+      "preferred": false
+    }
+  ]
+}
    +
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0026.html b/docs/sfs/api-ref/sfs_02_0026.html new file mode 100644 index 00000000..d8231d7a --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0026.html @@ -0,0 +1,506 @@ + + +

Modifying a Shared File System

+

Function

This API is used to modify the name and description of a shared file system.

+
+

URI

  • PUT /v2/{project_id}/shares/{share_id}
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share

    +

    Yes

    +

    Object

    +

    Specifies the share object.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    display_name

    +

    No

    +

    String

    +

    Specifies the new name of the shared file system. The value consists of 0 to 255 characters.

    +

    display_description

    +

    No

    +

    String

    +

    Describes the shared file system. The value contains 0 to 255 characters.

    +

    is_public

    +

    No

    +

    Boolean

    +

    (Supported by API v2.8 and later versions.) Specifies whether a file system can be publicly seen. If it is set to true, the file system can be seen publicly. If it is set to false, the file system can be seen privately. The default value is false.

    +
    +
    +
+
  • Example request
    {
+    "share": {
+        "display_name": "testshare",
+        "display_description": "test"
+    }
+}
    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    share

    +

    Object

    +

    Specifies the share object.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    links

    +

    Array

    +

    Specifies the links of shared file systems.

    +

    availability_zone

    +

    String

    +

    Specifies the availability zone.

    +

    share_server_id

    +

    String

    +

    Specifies the ID for managing share services.

    +

    share_network_id

    +

    String

    +

    Specifies the ID of the share network. This parameter is reserved, because share network management is not supported currently.

    +

    snapshot_id

    +

    String

    +

    Specifies the ID of the source snapshot that is used to create the shared file system. This parameter is reserved, because snapshots are not supported currently.

    +

    snapshot_support

    +

    Boolean

    +

    Specifies whether snapshots are supported. This parameter is reserved, because snapshots are not supported currently.

    +

    id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    size

    +

    Integer

    +

    Specifies the size (GB) of the shared file system.

    +

    share_group_id

    +

    String

    +

    (Supported by API versions from v2.31 to v2.42) Specifies the ID of a consistency group. This parameter is reserved, because consistency groups are not supported currently.

    +

    project_id

    +

    String

    +

    Specifies the ID of the project to which the shared file system belongs.

    +

    metadata

    +

    Object

    +

    Sets one or more metadata key and value pairs as a dictionary of strings. share_used is the key, and the corresponding value is the used capacity of the shared file system in the unit of Bytes.

    +

    status

    +

    String

    +

    Specifies the status of the shared file system.

    +

    task_state

    +

    String

    +

    Specifies the data migration status. This parameter is reserved, because data migration is not supported currently.

    +

    has_replicas

    +

    Boolean

    +

    (Supported by API versions from v2.11 to v2.42) Specifies whether any replication exists. This parameter is reserved, because replication is not supported currently.

    +

    replication_type

    +

    String

    +

    (Supported by API versions from v2.11 to v2.42) Specifies the replication type. This parameter is reserved, because replication is not supported currently.

    +

    description

    +

    String

    +

    Describes the shared file system.

    +

    host

    +

    String

    +

    Specifies the name of the host. This field is visible only to the administrator.

    +

    name

    +

    String

    +

    Specifies the name of the shared file system.

    +

    created_at

    +

    String

    +

    Specifies the date and time stamp when the shared file system was created.

    +

    access_rules_status

    +

    String

    +

    (Supported by API versions from v2.10 to v2.27.) Specifies the configuration status of the access rule. Possible values are active (effective), error (configuration failed), and syncing (configuration in progress).

    +

    share_proto

    +

    String

    +

    Specifies the protocol for sharing file systems.

    +

    volume_type

    +

    String

    +

    Specifies the volume type. The definition of this parameter is the same as that of share_type.

    +

    share_type_name

    +

    String

    +

    Specifies the storage service type assigned for the shared file system, such as high-performance storage (composed of SSDs) and large-capacity storage (composed of SATA disks).

    +

    share_type

    +

    String

    +

    Specifies the ID of the share type.

    +

    export_locations

    +

    Array

    +

    Lists the mount locations. Currently, only a single mount location is supported. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.8.

    +

    export_location

    +

    String

    +

    Specifies the mount location. This parameter exists only when X-Openstack-Manila-Api-Version specified in the request header is smaller than 2.8.

    +

    is_public

    +

    Boolean

    +

    (Supported by API versions from v2.8 to v2.42). Specifies whether a file system can be publicly seen. If it is set to true, the file system can be seen publicly. If it is set to false, the file system can be seen privately. The default value is false.

    +

    source_share_group_snapshot_member_id

    +

    String

    +

    (Supported by API v2.31 and later versions.) Specifies the ID of a consistency snapshot source. Currently, the consistency group is not supported. This field is reserved.

    +

    revert_to_snapshot_support

    +

    Boolean

    +

    (Supported by API v2.27 and later versions.) Specifies whether reversion to snapshot is supported. Currently, snapshot is not supported. This field is reserved.

    +

    create_share_from_snapshot_support

    +

    Boolean

    +

    (Supported by API v2.24 and later versions.) Specifies whether creating file systems from snapshot is supported. Currently, snapshot is not supported. This field is reserved.

    +

    mount_snapshot_support

    +

    Boolean

    +

    (Supported by API v2.32 and later versions.) Specifies whether snapshot mounting is supported. Currently, snapshot is not supported. This field is reserved.

    +

    user_id

    +

    String

    +

    (Supported by API v2.16 and later versions.) Specifies the user ID.

    +
    +
    +
+
  • Example response
    {
+  "share": {
+    "status": "available",
+    "share_type_name": "sla",
+    "description": "test",
+    "links": [
+      {
+        "href": "https://192.168.196.47:8796/v2/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
+        "rel": "self"
+      },
+      {
+        "href": "https://192.168.196.47:8796/07412155bf474db9a2f697fd978593d7/shares/f26d867f-9876-433d-8db2-25d210f29309",
+        "rel": "bookmark"
+      }
+    ],
+    "availability_zone": "az1.dc1",
+    "share_network_id": null,
+    "share_server_id": null,
+    "share_group_id": null,
+    "host": "DJ38@a4588256-3880-4136-b3c9-4c3aade8a84b#a4588256-3880-4136-b3c9-4c3aade8a84b",
+    "revert_to_snapshot_support": null,
+    "access_rules_status": "active",
+    "snapshot_id": null,
+    "create_share_from_snapshot_support": null,
+    "is_public": true,
+    "task_state": null,
+    "snapshot_support": true,
+    "id": "f26d867f-9876-433d-8db2-25d210f29309",
+    "size": 1,
+    "source_share_group_snapshot_member_id": null,
+    "user_id": "daa3f8f8d7254465841da769298a76f6",
+    "name": "manila share",
+    "share_type": "8ae4e74e-83f4-4980-8ab8-e637f9294e0b",
+    "has_replicas": false,
+    "replication_type": null,
+    "created_at": "2018-12-25T08:45:22.525899",
+    "share_proto": "NFS",
+    "volume_type": "sla",
+    "mount_snapshot_support": null,
+    "project_id": "07412155bf474db9a2f697fd978593d7",
+    "metadata": {
+      "share_key": "test",
+      "share_used": "1",
+    }
+  }
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0027.html b/docs/sfs/api-ref/sfs_02_0027.html new file mode 100644 index 00000000..a055785e --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0027.html @@ -0,0 +1,138 @@ + + +

Deleting a Shared File System

+

Function

This API is used to delete a shared file system.

+

This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and received. Later, you can query the shared file system by referring to Querying Details About a Shared File System to identify whether the deletion is complete and successful.

+
+
+

URI

  • DELETE /v2/{project_id}/shares/{share_id}
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Example response

    None

    +
+
+

Status Codes

  • Normal

    202

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: File Sharing
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0028.html b/docs/sfs/api-ref/sfs_02_0028.html new file mode 100644 index 00000000..09ccce65 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0028.html @@ -0,0 +1,19 @@ + + +

Share Access Rules

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0029.html b/docs/sfs/api-ref/sfs_02_0029.html new file mode 100644 index 00000000..a6f81fec --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0029.html @@ -0,0 +1,398 @@ + + +

Adding Share Access Rules

+

Function

This API is used to add share access rules.

+
  • This API is an asynchronous API. If the returned status code is 200, the API request is successfully delivered and received. Later, you can refer to Querying Share Access Rules to check whether the share access rule is added successfully.
  • APIs whose microversions are from 2.28 to 2.42 can ignore error statuses of existing share access rules during rule adding. The microversions of APIs are specified by using the X-Openstack-Manila-Api-Version parameter in the request headers.
+
+
+

URI

  • POST /v2/{project_id}/shares/{share_id}/action?vpc_ip_base_acl={vpc_ip_base_acl}
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    vpc_ip_base_acl

    +

    No

    +

    String

    +

    Specifies the identifier of the IP address-based authorization scenario. Currently, only enable is available. The value enable indicates creating a share access rule for the IP address-based authorization scenario.

    +
    NOTICE:

    To ensure compatibility, even though this parameter is left blank or set to another value other than enable, you can use the API to create a share access rule for the IP address-based authorization scenario. However, this method of creation has been discarded and will not be maintained in the future.

    +
    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    os-allow_access

    +

    Yes

    +

    Object

    +

    Specifies the os-allow_access object.

    +
    +
    +

    If the API version ranges from 1.0 to 2.6, the top-layer parameters of the request body in the JSON format use prefix os-. If the API version is later than 2.6, prefix os- must be removed.

    +
    +
  • Description of field os-allow_access +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    access_level

    +

    No

    +

    String

    +

    Specifies the access level of the shared file system. Possible values are ro (read-only) and rw (read-write). The default value is rw (read/write).

    +

    access_type

    +

    Yes

    +

    String

    +

    Specifies the storage access mode. For an SFS Capacity-Oriented file system, the value is cert indicating that the certificate is used to access storage.

    +

    access_to

    +

    Yes

    +

    String

    +

    Specifies the value that defines the access rule. The value contains 1 to 255 characters. The value varies according to the scenario:

    +
    • Enter the VPC ID in VPC authorization scenarios.
    +
    • Set this parameter in IP address authorization scenario.
      • Enter the value in the format of VPC ID#IP address#priority#user permission for an NFS shared file system, for example, 0157b53f-4974-4e80-91c9-098532bcaf00#2.2.2.2/16#100#all_squash,root_squash.
      +
    +
    NOTE:

    Description of and restrictions on the VPC ID, IP address, priority, and user permission:

    +
    • VPC ID: ID of the VPC.
    • IP address: Tenant IPv4 address or address segment of the ECS's active network port. Each rule only supports one IPv4 address or address segment. The mask format is used to represent an address segment. For example, 192.168.1.0/24 represents the IP address segment of 192.168.1.0 to 192.168.1.255. Other address segment formats, such as 192.168.1.0-255, are not supported. The entered IPv4 address or address segment must be valid and cannot be an IP address or address segment starting with 0 except 0.0.0.0/0. The value 0.0.0.0/0 indicates any IP address in the VPC. In addition, the IP address or address segment cannot start with 127 or 224 to 255, for example, 127.0.0.1, 224.0.0.1, or 255.255.255.255. This is because IP addresses or address segments starting with 224 to 239 are class D addresses and they are used for multicast. IP addresses or address segments starting with 240 to 255 are class E addresses and they are used for research. If an invalid IP address or address segment is used, the access rule may fail to be added or the added access rule cannot take effect.
    • Priority: Priority of a share access rule. It must be an integer ranging from 0 to 100. 0 indicates the highest priority, and 100 indicates the lowest priority. In the same VPC, the permission of the IP address or address segment with the highest priority is preferentially used. For example, if your IP address for mounting is 10.1.1.32, and the authorized 10.1.1.32 (read/write) and 10.1.1.0/24 (read-only) both meet the requirements, the permission of the IP address or segment with the higher priority is used first. If some IP addresses or address segments are of the same priority, one permission of them is randomly chosen.
    • User permission: Set the user permission in the format of allSquash,rootSquash. That is, allSquash is separated from rootSquash using a comma (,). The value of allSquash can be all_squash or no_all_squash. The value of rootSquash can be root_squash or no_root_squash.
    +
    +
    NOTICE:
    • When creating a shared access rule for the IP address-based authorization scenario, the microversions of the APIs must be 2.28 or later and the vpc_ip_base_acl parameter must be added to the request URL. For details, see the following request example (which varies with the IP address-based authorization scenario).
    • For an ECS in VPC A, its IP addresses can be successfully added to the authorized IP addresses of VPC B, but the file system of VPC B cannot be mounted to this ECS. The VPC used by the ECS and the file system must be the same one.
    +
    +
    +
    +
+
  • Example request (VPC-based authorization)
    When the specified API version ranges from 1.0 to 2.6, the request example is as follows:
    { 
+    "os-allow_access": { 
+        "access_to": "59cd070d-9c4c-462e-9dcc-b6bb716225bc", 
+        "access_type": "cert", 
+        "access_level": "rw" 
+    } 
+}
    +
    +

    When the specified API version is later than 2.6, the request example is as follows:

    +
    { 
+    "allow_access": { 
+        "access_to": "59cd070d-9c4c-462e-9dcc-b6bb716225bc", 
+        "access_type": "cert", 
+        "access_level": "rw" 
+    } 
+}
    +
+
+
  • Example request (IP address-based authorization)

    POST /v2/{project_id}/shares/{share_id}/action?vpc_ip_base_acl=enable

    +

    NFS share:

    +
    { 
+    "allow_access": { 
+        "access_to": "0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#1#all_squash,root_squash", 
+        "access_type": "cert", 
+        "access_level": "rw" 
+    } 
+}
    +

    CIFS share:

    +
    { 
+    "allow_access": { 
+        "access_to": "0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#0", 
+        "access_type": "cert", 
+        "access_level": "rw" 
+    } 
+}
    +

    When creating the share access rule for an IP address-based authorization scenario.

    +

    1. The X-Openstack-Manila-Api-Version parameter must be specified for the request header, and the value of X-Openstack-Manila-Api-Version must be from 2.28 to 2.42.

    +

    2. The vpc_ip_base_acl parameter must be added in the request URL and the value of vpc_ip_base_acl must be set to enable. To ensure compatibility, even though this parameter is left blank or set to another value other than enable, you can use the API to create a share access rule for the IP address-based authorization scenario. However, this method of creation has been discarded and will not be maintained in the future.

    +
    +
    +
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    access

    +

    Object

    +

    Specifies the access object. If the share access rule is not updated, this value is null.

    +
    +
    +
  • Description of the access field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    share_id

    +

    String

    +

    Specifies the ID of the shared file system to which the access rule is added.

    +

    access_type

    +

    String

    +

    Specifies the type of the share access rule.

    +

    access_to

    +

    String

    +

    Specifies the access that the back end grants or denies.

    +

    access_level

    +

    String

    +

    Specifies the access level of the shared file system.

    +

    id

    +

    String

    +

    Specifies the ID of the share access rule.

    +

    state

    +

    String

    +

    Specifies the status of the share access rule. If the API version is earlier than 2.28, the status of the share access rule is new, active, or error. In versions from 2.28 to 2.42, the status of the share access rule is queued_to_apply, applying, active, error, queued_to_deny, or denying.

    +

    access_key

    +

    String

    +

    Specifies the access credential of the access rule. This parameter exists only when the value of X-Openstack-Manila-Api-Version in the request header is from 2.21 to 2.42.

    +

    created_at

    +

    String

    +

    Specifies the time when a shared access rule is created. This parameter exists only when the value of X-Openstack-Manila-Api-Version in the request header is greater than or equal to 2.33.

    +

    updated_at

    +

    String

    +

    Specifies the time when a shared access rule is updated. This parameter exists only when the value of X-Openstack-Manila-Api-Version in the request header is greater than or equal to 2.33.

    +
    +
    +
+
  • Example response
    {
+  "access": {
+    "share_id": "15940c49-789f-476a-b099-a3be7d311854",
+    "access_type": "cert",
+    "access_to": "59cd070d-9c4c-462e-9dcc-b6bb716225bc",
+    "access_level": "rw",
+    "state": "new",
+    "id": "418e3cf4-08c3-4ed2-a29a-ceffa346b3b8",
+    "access_key":null,
+    "created_at": "2017-07-07T03:15:06.858662",
+    "updated_at": "2018-07-07T03:15:06.858662"
+  }
+}
    +
+
+
  • Example response (IP address-based authorization)

    NFS share:

    +
    {
+    "access":{
+        "access_key":null,
+        "share_id":"7ec1115f-518b-40ff-a998-5599ce2da332",
+        "access_type":"cert",
+        "access_to":"0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#1#all_squash,root_squash",
+        "access_level":"rw",
+        "state":"queued_to_apply",
+        "id":"24615391-d58d-4a74-ac5a-520233c9c396",
+        "created_at": "2017-07-07T03:15:06.858662",
+        "updated_at": "2018-07-07T03:15:06.858662"
+    }
+}
    +
    CIFS share:
    {
+    "access":{
+        "access_key":null,
+        "share_id":"7ec1115f-518b-40ff-a998-5599ce2da332",
+        "access_type":"cert",
+        "access_to":"0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#0",
+        "access_level":"rw",
+        "state":"queued_to_apply",
+        "id":"24615391-d58d-4a74-ac5a-520233c9c396",
+        "created_at": "2017-07-07T03:15:06.858662",
+        "updated_at": "2018-07-07T03:15:06.858662"
+    }
+}
    +
    +
+

+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Access Rules
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0030.html b/docs/sfs/api-ref/sfs_02_0030.html new file mode 100644 index 00000000..0af4338d --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0030.html @@ -0,0 +1,192 @@ + + +

Deleting Share Access Rules

+

Function

This API is used to delete a share access rule.

+

This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and received. Later, you can refer to Querying Share Access Rules to identify whether the deletion of the share access rule is complete and successful.

+
+
+

URI

  • POST /v2/{project_id}/shares/{share_id}/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    os-deny_access

    +

    Yes

    +

    Object

    +

    Specifies the os-deny_access object.

    +
    +
    +

    If the API version ranges from 1.0 to 2.6, the top-layer parameters of the request body in the JSON format use prefix os-. If the API version is later than 2.6, prefix os- must be removed.

    +
    +
  • Description of field os-deny_access +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    access_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the share access rule of the shared file system. The value contains 1 to 36 characters.

    +
    +
    +
+
  • Example request
    {
+    "os-deny_access": {
+        "access_id": "418e3cf4-08c3-4ed2-a29a-ceffa346b3b8"
+    }
+}
    +
+
+

Response

  • Parameter description
+

None

+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    202

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Access Rules
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0031.html b/docs/sfs/api-ref/sfs_02_0031.html new file mode 100644 index 00000000..ba445159 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0031.html @@ -0,0 +1,273 @@ + + +

Querying Share Access Rules

+

Function

This API is used to query a share access rule.

+
+

URI

  • POST /v2/{project_id}/shares/{share_id}/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    os-access_list

    +

    Yes

    +

    Object

    +

    Specifies the os-access_list object. To view access rules, set this value to null.

    +
    +
    +

    If the API version ranges from 1.0 to 2.6, the top-layer parameters of the request body in the JSON format use prefix os-. If the API version is later than 2.6, prefix os- must be removed.

    +
    +
  • Example request
    {
+    "os-access_list": null
+}
    +
+
+

Response

  • Description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    access_list

    +

    Array of objects

    +

    Lists the access rules.

    +
    +
    +
  • Description of field access_list +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    access_type

    +

    String

    +

    Specifies the type of the share access rule.

    +

    access_to

    +

    String

    +

    Specifies the access that the back end grants or denies.

    +

    access_level

    +

    String

    +

    Specifies the level of the access rule.

    +

    state

    +

    String

    +

    Specifies the status of the share access rule. If the API version is earlier than 2.28, the status of the share access rule is new, active, or error. In versions from 2.28 to 2.42, the status of the share access rule is queued_to_apply, applying, active, error, queued_to_deny, or denying.

    +

    id

    +

    String

    +

    Specifies the ID of the share access rule.

    +

    created_at

    +

    String

    +

    Specifies the time when a shared access rule is created. This parameter exists only when the value of X-Openstack-Manila-Api-Version in the request header is greater than or equal to 2.33.

    +

    updated_at

    +

    String

    +

    Specifies the time when a shared access rule is updated. This parameter exists only when the value of X-Openstack-Manila-Api-Version in the request header is greater than or equal to 2.33.

    +
    +
    +
+
  • Example response
    {
+  "access_list": [
+    {
+      "access_level": "rw",
+      "state": "active",
+      "id": "85417bed-5e26-4c99-8c0c-92c95b5c640e",
+      "access_type": "cert",
+      "access_to": "a91556b7-c7c8-4273-915e-2729e04cdb01",
+      "created_at": "2017-07-07T03:15:06.858662",
+      "updated_at": "2018-07-07T03:15:06.858662"
+    },
+    {
+      "access_level": "rw",
+      "state": "active",
+      "id": "2ecbeb0b-b2ba-41f1-ba63-0666548925b9",
+      "access_type": "cert",
+      "access_to": "0560a527-0e77-40a6-aa3b-110beecad368#0.0.0.0/0#0#all_squash,root_squash",
+      "created_at": "2017-07-07T03:15:06.858662",
+      "updated_at": "2018-07-07T03:15:06.858662"
+    },
+    {
+      "access_level": "rw",
+      "state": "active",
+      "id": "24615391-d58d-4a74-ac5a-520233c9c396",
+      "access_type": "cert",
+      "access_to": "0560a527-0e77-40a6-aa3b-110beecad368#192.168.196.47#1#all_squash,root_squash",
+      "created_at": "2017-07-07T03:15:06.858662",
+      "updated_at": "2018-07-07T03:15:06.858662"
+    }
+  ]
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Access Rules
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0032.html b/docs/sfs/api-ref/sfs_02_0032.html new file mode 100644 index 00000000..2663fdc2 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0032.html @@ -0,0 +1,263 @@ + + +

Quota Management

+

Function

This API is used to query quota information.

+
+

URI

  • GET /v2/{project_id}/os-quota-sets/{project_id}
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the tenant whose quotas are to be queried, updated, or deleted. This ID differs from the first project ID (the administrative tenant ID) contained in the URI.

    +
    +
    +
  • Query parameters +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    usage

    +

    No

    +

    String

    +

    If the parameter is set to true, the current in_use and reserved counts will also be returned.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request
    GET /v2/{project_id}/os-quota-sets/{project_id_1}?usage=true
    +
    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    quota_set

    +

    Object

    +

    Specifies the quota_set object.

    +
    +
    +
  • Description of field quota_set +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    gigabytes

    +

    Integer

    +

    Specifies the capacity in gigabytes allowed for each tenant.

    +

    snapshots

    +

    Integer

    +

    Specifies the number of snapshots allowed for each tenant.

    +

    shares

    +

    Integer

    +

    Specifies the number of shared file systems allowed for each tenant.

    +

    snapshot_gigabytes

    +

    Integer

    +

    Specifies the snapshot capacity in gigabytes allowed for each tenant.

    +

    id

    +

    String

    +

    Specifies the ID of the tenant for which you manage quotas.

    +

    share_networks

    +

    Integer

    +

    Specifies the number of share networks allowed for each tenant.

    +
    +
    +
+
  • Example response
    {
+  "quota_set": {
+    "gigabytes": {
+      "reserved": 0,
+      "limit": 512000,
+      "in_use": 645
+    },
+    "snapshots": {
+      "reserved": 0,
+      "limit": -1,
+      "in_use": 0
+    },
+    "snapshot_gigabytes": {
+      "reserved": 0,
+      "limit": -1,
+      "in_use": 0
+    },
+    "shares": {
+      "reserved": 0,
+      "limit": 10,
+      "in_use": 4
+    },
+    "id": "da0f615c35eb4d72812d1547a77b5394",
+    "share_networks": {
+      "reserved": 0,
+      "limit": 10,
+      "in_use": 0
+    }
+  }
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: SFS APIs
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0033.html b/docs/sfs/api-ref/sfs_02_0033.html new file mode 100644 index 00000000..0b5413ce --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0033.html @@ -0,0 +1,17 @@ + + +

Expansion and Shrinking

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0034.html b/docs/sfs/api-ref/sfs_02_0034.html new file mode 100644 index 00000000..eeb7a86f --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0034.html @@ -0,0 +1,200 @@ + + +

Expanding a Shared File System

+

Function

This API is used to expand the capacity of a shared file system.

+

This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and received. Later, you can refer to Querying Details About a Shared File System to identify whether the shared file system is expanded successfully.

+
+
+

URI

  • POST /v2/{project_id}/shares/{share_id}/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    os-extend

    +

    Yes

    +

    Object

    +

    Specifies the os-extend object.

    +
    +
    +
  • Description of field os-extend +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    new_size

    +

    Yes

    +

    Integer

    +

    Specifies the post-expansion capacity (GB) of the shared file system.

    +
    +
    +
+
  • Example request
    {
+    "os-extend": {
+        "new_size": 2
+    }
+}
    +
+
+

Response

  • Parameter description

    None

    +
+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    202

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    400 Bad Request

    +

    Invalid input: The post-deduction capacity must be larger than 0 and smaller than the current capacity. (Current capacity: XX; post-deduction capacity: XX)

    +

    400 Bad Request

    +

    Invalid input: The post-expansion capacity must be larger than the current capacity. (Current capacity: XX; post-expansion capacity: XX)

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: Expansion and Shrinking
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0035.html b/docs/sfs/api-ref/sfs_02_0035.html new file mode 100644 index 00000000..355937cb --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0035.html @@ -0,0 +1,190 @@ + + +

Shrinking a Shared File System

+

Function

This API is used to shrink the capacity of a shared file system.

+

This API is an asynchronous API. If the returned status code is 202, the API request is successfully delivered and received. Later, you can refer to Querying Details About a Shared File System to identify whether the shared file system is shrunk successfully.

+
+
+

URI

  • POST /v2/{project_id}/shares/{share_id}/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    os-shrink

    +

    Yes

    +

    Object

    +

    Specifies the os-shrink object.

    +
    +
    +
  • Description of field os-shrink +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    new_size

    +

    Yes

    +

    Integer

    +

    Specifies the post-shrinking capacity (GB) of the shared file system.

    +
    +
    +
+
  • Example request
    {
+    "os-shrink": {
+        "new_size": 1
+    }
+}
    +
+
+

Response

  • Parameter description

    None

    +
+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    202

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    501 Not Implemented

    +

    Failed to complete the request because the server does not support the requested function.

    +

    502 Bad Gateway

    +

    Failed to complete the request because the request is invalid.

    +

    503 Service Unavailable

    +

    Failed to complete the request because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
+
Parent topic: Expansion and Shrinking
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0036.html b/docs/sfs/api-ref/sfs_02_0036.html new file mode 100644 index 00000000..426c7a5b --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0036.html @@ -0,0 +1,29 @@ + + +

Share Tag

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0037.html b/docs/sfs/api-ref/sfs_02_0037.html new file mode 100644 index 00000000..edd34e77 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0037.html @@ -0,0 +1,155 @@ + + +

Adding a Tag to a Shared File System

+

Function

This API is used to add a tag to a specified shared file system.

+

A shared file system can have a maximum of 10 tags.

+

The keys of multiple tags added to a shared file system must be unique.

+

This API is idempotent. If the key to be added has already been added to the shared file system, the tag is updated.

+
+

URI

  • POST /v2/{project_id}/sfs/{share_id}/tags
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the share ID.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    tag

    +

    Yes

    +

    Resource_tag

    +

    Specifies the tag.

    +
    +
    +
  • Description of field resource_tag +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. The key cannot be left blank and can only contain letters, digits, hyphens (-), and underscores (_).

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the value of the tag. The value contains a maximum of 43 characters and can be an empty string. It can only contain letters, digits, hyphens (-), and underscores (_).

    +
    +
    +
  • Example request
    {
+  "tag" : {
+    "key" : "key1",
+    "value" : "value1"
+  }
+}
    +
+
+

Response

  • Parameter description

    None

    +
+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0038.html b/docs/sfs/api-ref/sfs_02_0038.html new file mode 100644 index 00000000..dc5c8895 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0038.html @@ -0,0 +1,106 @@ + + +

Deleting a Tag from a Shared File System

+

Function

This API is used to delete a tag from a specified shared file system.

+

If the key to be deleted does not exist in the shared file system, error 404 is returned after API calling.

+
+
+

URI

  • DELETE /v2/{project_id}/sfs/{share_id}/tags/{key}
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the share ID.

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. The key cannot be left blank and can only contain letters, digits, hyphens (-), and underscores (_).

    +
    NOTICE:

    When calling this API to delete a tag, if the tag key contains special characters that are not directly resolved by the URL, the key needs to be escaped.

    +
    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description

    None

    +
+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0039.html b/docs/sfs/api-ref/sfs_02_0039.html new file mode 100644 index 00000000..776e23c8 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0039.html @@ -0,0 +1,158 @@ + + +

Querying Tag Information About a Shared File System

+

Function

This API is used to query all tag information about the specified shared file system.

+
+

URI

  • GET /v2/{project_id}/sfs/{share_id}/tags
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the share ID.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    tags

    +

    Array of resource_tags

    +

    Specifies the list of tags.

    +

    sys_tags

    +

    Array of resource_tags

    +

    Only the op_service permission can obtain this field.

    +
    1. Currently, only one resource_tag structure key is used, _sys_enterprise_project_id.
    2. Currently, key contains only one value.
    +

    This field cannot be returned in non-op_service scenarios.

    +
    +
    +
  • Description of field resource_tag +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    key

    +

    String

    +

    Specifies the key of the tag.

    +

    value

    +

    String

    +

    Specifies the value of the tag.

    +
    +
    +
+
  • Example response
    {
+       "tags": [
+        {
+            "key": "key1",
+            "value": "value1"
+        },
+        {
+            "key": "key2",
+            "value": ""
+        }
+    ]
+}
    +

    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0040.html b/docs/sfs/api-ref/sfs_02_0040.html new file mode 100644 index 00000000..2b3d4267 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0040.html @@ -0,0 +1,136 @@ + + +

Querying Tags of a Tenant's All Shared File Systems

+

Function

This API is used to query the tag set of a tenant's all shared file systems.

+
+

URI

  • GET /v2/{project_id}/sfs/tags
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    tags

    +

    Array of tags

    +

    Specifies the list of tags.

    +
    +
    +
  • Description of the tag field +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    key

    +

    String

    +

    Specifies the key of the tag.

    +

    values

    +

    Array of strings

    +

    Lists the values of the tag. The value is a list of a tenant's all tag values of shared file systems. Only one of the same tag values is displayed.

    +
    +
    +
+
  • Example response
    {
+  "tags" : [ {
+    "key" : "key1",
+    "values" : [ "value1", "" ]
+  }, {
+    "key" : "key2",
+    "values" : [ "value1", "value2" ]
+  } ]
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0041.html b/docs/sfs/api-ref/sfs_02_0041.html new file mode 100644 index 00000000..b69945c3 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0041.html @@ -0,0 +1,184 @@ + + +

Batch Adding Tags to a Shared File System

+

Function

This API is used to batch add tags to a specified shared file system.

+

A shared file system can have a maximum of 10 tags.

+

The keys of multiple tags added to a shared file system must be unique.

+

This API is idempotent. If the key to be added has already been added to the shared file system, the tag is updated.

+
+

URI

  • POST /v2/{project_id}/sfs/{share_id}/tags/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the share ID.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    action

    +

    Yes

    +

    String

    +

    Specifies the operation identifier. Possible values are create and delete. Use create to batch add tags to a specified shared file system.

    +

    tags

    +

    No

    +

    Array of resource_tags

    +

    Specifies the tag list.

    +

    This parameter is mandatory when the tenant permission is used. For the op_service permission, choose either this field or sys_tags.

    +

    sys_tags

    +

    No

    +

    Array of resource_tags

    +

    Specifies the system tag list.

    +

    This field is available only to the op_service permission. Choose either this field or tags.

    +

    Currently, TMS invokes only one resource_tag structure. The key is fixed as _sys_enterprise_project_id.

    +

    The value is ID or 0.

    +
    +
    +
  • Description of field resource_tag +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. The key cannot be left blank and can only contain letters, digits, hyphens (-), and underscores (_).

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the value of the tag. The value contains a maximum of 43 characters and can be an empty string. It can only contain letters, digits, hyphens (-), and underscores (_).

    +
    +
    +
  • Example request
    {
+    "action": "create",
+    "tags": [
+        {
+            "key": "key1",
+            "value": "value1"
+        },
+        {
+            "key": "key2",
+            "value": "value2"
+        }
+    ]
+}
    +
+
+

Response

  • Parameter description

    None

    +
+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0042.html b/docs/sfs/api-ref/sfs_02_0042.html new file mode 100644 index 00000000..04f0b616 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0042.html @@ -0,0 +1,174 @@ + + +

Batch Deleting Tags from a Shared File System

+

Function

This API is used to batch delete tags from a specified shared file system.

+

This API is idempotent. If the tags to be deleted do not exist on the shared file system, the deletion is regarded as successful by default.

+
+

URI

  • POST /v2/{project_id}/sfs/{share_id}/tags/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the share ID.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    action

    +

    Yes

    +

    String

    +

    Specifies the operation identifier. Possible values are create and delete. Use delete to batch delete tags from a specified shared file system.

    +

    tags

    +

    Yes

    +

    Array of resource_tags

    +

    Specifies the tag list.

    +
    +
    +
  • Description of field resource_tag +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag.

    +

    The value can contain a maximum of 36 characters. This parameter cannot be left blank.

    +

    value

    +

    No

    +

    String

    +

    Specifies the value of the tag.

    +

    The value contains a maximum of 43 characters and can be an empty string. If the value is not an empty string, the tag is located and deleted based on the key and value. If the value is an empty string, the tag is located and deleted based on the key.

    +
    +
    +
  • Example request
    {
+    "action": "delete",
+    "tags": [
+        {
+            "key": "key1",
+            "value": "value1"
+        },
+        {
+            "key": "key2"
+        },
+        {
+            "key": "key3",
+            "value": ""
+        }
+    ]
+}
    +
+
+

Response

  • Parameter description

    None

    +
+
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0043.html b/docs/sfs/api-ref/sfs_02_0043.html new file mode 100644 index 00000000..b90aca49 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0043.html @@ -0,0 +1,445 @@ + + +

Querying Details About a Shared File System Based on Tags

+

Function

This API is used to query details about a shared file system based on tags.

+
+

URI

  • POST /v2/{project_id}/sfs/resource_instances/action
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    offset

    +

    No

    +

    String

    +

    Specifies the index location. The value is a character string consisting of 0 and positive integers. The default value is 0. The first record in the query result is the offset+1 record that meets the query criteria.

    +

    limit

    +

    No

    +

    String

    +

    Specifies the maximum number of query records. The value is a character string consisting of integers. The default value is 1000. The value ranges from 1 to 1000.

    +

    The number of returned records does not exceed the value of limit.

    +

    action

    +

    Yes

    +

    String

    +

    Specifies the operation identifier. Possible values are filter and count.

    +

    Use filter to query details of a shared file system using tags.

    +

    matches

    +

    No

    +

    Array of matches

    +

    Specifies the share resource query field. If this parameter is left null, all shared file systems of the tenant are searched by default.

    +

    tags

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Only shared file systems containing all the listed tags can be returned. Tags in this search criteria are in the AND relationship. Specifically, a shared file system can be searched only when it meets all the tag search criteria. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of tags is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    tags_any

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Shared file systems that contain any listed tag will be returned. Tags in this search criteria are in the OR relationship. Specifically, a shared file system can be searched as long as it meets one tag search condition. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of tags_any is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    not_tags

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Only shared file systems that contain none of the listed tags will be returned. Tags in this search criteria are in the NOR relationship. Specifically, a shared file system can be searched only when it does not meet any tag search criteria. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of not_tags is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    not_tags_any

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Shared file systems that do not contain any of the listed tags will be returned. Tags in this search criteria are in the NAND relationship. Specifically, a shared file system can be searched as long as it does not meet one tag search condition. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of not_tags_any is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    sys_tags

    +

    No

    +

    Array of tags

    +

    Only the op_service permission can use this field to filter resources.

    +
    1. Currently, TMS can invoke only one tag structure key, _sys_enterprise_project_id.
    2. Currently, key contains only one value.
    3. sys_tags and tenant tag filtering conditions (tags, tags_any, not_tags, and not_tags_any) cannot be used at the same time.
    +
    +
    +

    In the request parameters, tag search fields tags, tags_any, not_tags, and not_tags_any are optional and can be combined with each other. Such tag search fields are in the AND relationship.

    +
    +
  • Description of the match field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key. The value is fixed to resource_name.

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the value. value indicates the name of a shared file system. An empty string specifies an exact match and only shared file systems whose names are empty can be queried. A non-empty string specifies a fuzzy query (case insensitive). The value can contain a maximum of 255 characters.

    +
    +
    +
  • Description of the tag field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. A tag key can contain a maximum of 127 characters. This parameter cannot be left blank.

    +

    values

    +

    Yes

    +

    Array of strings

    +

    Lists the values. Each value can contain a maximum of 255 characters. If the value is left empty, any value is matched. The values are in the OR relationship.

    +
    +
    +
  • Example request
    {
+    "offset": "0",
+    "limit": "100",
+    "action": "filter",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }],
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }],
+    "tags_any": [{
+        "key": "key3",
+        "values": ["value3"]
+    }, {
+        "key": "key4",
+        "values": []
+    }],
+    "not_tags": [{
+        "key": "key5",
+        "values": ["value5"]
+    }, {
+        "key": "key6",
+        "values": []
+    }],
+    "not_tags_any": [{
+        "key": "key7",
+        "values": ["value7", "value8"]
+    }, {
+        "key": "key9",
+        "values": []
+    }]
+}
    +
+
+
  • Example request (without passing matches)
    {
+    "offset": "0",
+    "limit": "100",
+    "action": "filter",
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }]
+}
    +
  • Example request (without passing limit and offset)
    {
+    "action": "filter",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }],
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }]
+}
    +
+
  • Example request (without passing tags, not_tags, tags_any, and not_tags_any)
    {
+    "offset": "0",
+    "limit": "100",
+    "action": "filter",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }]
+}
    +
+
  • Example request (with the action field only)
    {
+    "action": "filter"
+}
    +
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    resources

    +

    Array of resources

    +

    Specifies the list of shared file systems that meet the query criteria.

    +

    total_count

    +

    Integer

    +

    Specifies the total number of shared file systems that meet the query criteria.

    +
    NOTE:

    total_count specifies the total number of shared file systems that meet the query criteria, instead of the number returned after you set offset and limit.

    +
    +
    +
    +
  • Data structure of the resource field +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    resource_id

    +

    String

    +

    Specifies the share ID.

    +

    resource_detail

    +

    Object

    +

    Specifies the share details. The value is a resource object, used for extension. This value is left empty by default.

    +

    tags

    +

    Array of resource_tags

    +

    Specifies the list of tags. If no tags exist, the value is an empty array by default.

    +

    sys_tags

    +

    Array of tags

    +

    Only the op_service permission can obtain this field.

    +
    1. Currently, only one tag structure key is used, _sys_enterprise_project_id.
    2. Currently, key contains only one value.
    +

    This field cannot be returned in non-op_service scenarios.

    +

    resource_name

    +

    String

    +

    Specifies the resource name.

    +
    +
    +
  • Data structure of the resource_tag field +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    key

    +

    String

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. This parameter cannot be left blank. It can only contain letters, digits, hyphens (-), and underscores (_).

    +

    value

    +

    String

    +

    Specifies the value of the tag. The value contains a maximum of 43 characters and can be an empty string. It can only contain letters, digits, hyphens (-), and underscores (_).

    +
    +
    +
+
  • Example response
    {
+    "resources":[
+        {
+            "resource_detail":{},
+            "resource_id":"b1f3f06f-344d-446b-a4bf-647a225debae",
+            "resource_name":"share_name",
+            "tags":[
+                {
+                    "key":"key1", 
+                    "value": "value1"
+                },
+                {
+                    "key":"key2", 
+                    "value": "value2"
+                }
+            ]
+        }
+    ],
+    "total_count":1
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0044.html b/docs/sfs/api-ref/sfs_02_0044.html new file mode 100644 index 00000000..9c96a11c --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0044.html @@ -0,0 +1,305 @@ + + +

Querying the Number of Shared File Systems Based on Tags

+

Function

This API is used to query the number of shared file systems based on tags.

+
+

URI

  • POST /v2/{project_id}/sfs/resource_instances/action
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    action

    +

    Yes

    +

    String

    +

    Specifies the operation identifier. Possible values are filter and count.

    +

    Use count to query the number of share instances based on tags.

    +

    matches

    +

    No

    +

    Array of matches

    +

    Specifies the share resource query field. If this parameter is left null, all shared file systems of the tenant are searched by default.

    +

    tags

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Only shared file systems containing all the listed tags can be returned. Tags in this search criteria are in the AND relationship. Specifically, a shared file system can be searched only when it meets all the tag search criteria. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of tags is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    tags_any

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Shared file systems that contain any listed tag will be returned. Tags in this search criteria are in the OR relationship. Specifically, a shared file system can be searched as long as it meets one tag search condition. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of tags_any is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    not_tags

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Only shared file systems that contain none of the listed tags will be returned. Tags in this search criteria are in the NOR relationship. Specifically, a shared file system can be searched only when it does not meet any tag search criteria. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of not_tags is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    not_tags_any

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Shared file systems that do not contain any of the listed tags will be returned. Tags in this search criteria are in the NAND relationship. Specifically, a shared file system can be searched as long as it does not meet one tag search condition. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of not_tags_any is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    sys_tags

    +

    No

    +

    Array of tags

    +

    Only the op_service permission can use this field to filter resources.

    +
    1. Currently, TMS can invoke only one tag structure key, _sys_enterprise_project_id.
    2. Currently, key contains only one value.
    3. sys_tags and tenant tag filtering conditions (tags, tags_any, not_tags, and not_tags_any) cannot be used at the same time.
    +
    +
    +

    In the request parameters, tag search fields tags, tags_any, not_tags, and not_tags_any are optional and can be combined with each other. Such tag search fields are in the AND relationship.

    +
    +

    +
  • Description of the match field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key. The value is fixed to resource_name.

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the value. value indicates the name of a shared file system. An empty string specifies an exact match and only shared file systems whose names are empty can be queried. A non-empty string specifies a fuzzy query (case insensitive). The value can contain a maximum of 255 characters.

    +
    +
    +
  • Description of the tag field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. A tag key can contain a maximum of 127 characters. This parameter cannot be left blank.

    +

    values

    +

    Yes

    +

    Array of strings

    +

    Lists the values. Each value can contain a maximum of 255 characters. If the value is left empty, any value is matched. The values are in the OR relationship.

    +
    +
    +
  • Example request
    {
+    "action": "count",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }],
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }],
+    "tags_any": [{
+        "key": "key3",
+        "values": ["value3"]
+    }, {
+        "key": "key4",
+        "values": []
+    }],
+    "not_tags": [{
+        "key": "key5",
+        "values": ["value5"]
+    }, {
+        "key": "key6",
+        "values": []
+    }],
+    "not_tags_any": [{
+        "key": "key7",
+        "values": ["value7", "value8"]
+    }, {
+        "key": "key9",
+        "values": []
+    }]
+}
    +
+
+
  • Example request (without passing matches)
    {
+    "action": "count",
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2", 
+        "values": []
+    }]
+}
    +
  • Example request (without passing tags, not_tags, tags_any, and not_tags_any)
    {
+    "action": "count",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }]
+}
    +
+
  • Example request (with the action field only)
    {
+    "action": "count"
+}
    +
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    total_count

    +

    Integer

    +

    Specifies the total number of shared file systems that meet the query criteria.

    +
    +
    +
+
  • Example response
    {
+    "total_count":1
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0049.html b/docs/sfs/api-ref/sfs_02_0049.html new file mode 100644 index 00000000..8bf2f6f1 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0049.html @@ -0,0 +1,17 @@ + + +

SFS Turbo APIs

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0050.html b/docs/sfs/api-ref/sfs_02_0050.html new file mode 100644 index 00000000..037604e2 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0050.html @@ -0,0 +1,21 @@ + + +

Life Cycle Management

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0051.html b/docs/sfs/api-ref/sfs_02_0051.html new file mode 100644 index 00000000..76dbea15 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0051.html @@ -0,0 +1,275 @@ + + +

Creating a File System

+

Function

This API is used to create an SFS Turbo file system.

+
+

URI

  • URI format

    POST /v1/{project_id}/sfs-turbo/shares

    +
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID. For details about how to obtain the project ID, see API Usage Guidelines.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    share

    +

    Yes

    +

    Object

    +

    Specifies information about an SFS Turbo file system. For details about the parameters, see the description of the share field.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    name

    +

    Yes

    +

    String

    +

    Specifies the name of an SFS Turbo file system. The value contains 4 to 64 characters and must start with a letter. This value can contain letters (case insensitive), digits, hyphens (-), and underscores (_), and cannot contain other special characters.

    +

    share_proto

    +

    Yes

    +

    String

    +

    Specifies the protocol for sharing file systems. The valid value is NFS. Network File System (NFS) is a distributed file system protocol that allows different computers and operating systems to share data over a network.

    +

    share_type

    +

    Yes

    +

    String

    +

    Specifies the file system type. The valid values are STANDARD and PERFORMANCE

    +

    STANDARD: Standard file system, corresponding to the media of SAS disks.

    +

    PERFORMANCE: Performance file system, corresponding to the media of SSD disks.

    +

    size

    +

    Yes

    +

    Int

    +

    For a common file system, the value of capacity ranges from 500 to 32768 (in the unit of GB).

    +

    For an enhanced file system where the expand_type field is specified for metadata, the capacity ranges from 10240 to 327680. For details about metadata, see Description of the metadata field.

    +

    availability_zone

    +

    Yes

    +

    String

    +

    Specifies the code of the AZ where the file system is located. For details about the code, see Regions and Endpoints.

    +

    vpc_id

    +

    Yes

    +

    String

    +

    Specifies the VPC ID of a tenant in a region. You can obtain the VPC ID from the console or by following the instructions provided in "Querying VPCs" in Virtual Private Cloud API Reference.

    +

    subnet_id

    +

    Yes

    +

    String

    +

    Specifies the network ID of the subnet of a tenant in a VPC. You can obtain the network ID from the VPC console or by following the instructions provided in "Querying Subnets" in Virtual Private Cloud API Reference.

    +

    security_group_id

    +

    Yes

    +

    String

    +

    Specifies the security group ID of a tenant in a region. You can obtain the security group ID from the console or by following the instructions provided in "Querying Security Groups" in Virtual Private Cloud API Reference.

    +

    backup_id

    +

    No

    +

    String

    +

    Specifies the backup ID. This parameter is mandatory when you create a file system from a backup. This is not supported by the current version.

    +

    description

    +

    No

    +

    String

    +

    Specifies the file system description. The length is 0-255 characters. This is not supported by the current version.

    +

    metadata

    +

    No

    +

    Object

    +

    Specifies the metadata information used to create the file system. The value consists of one or more key and value pairs organized as a dictionary of strings. For details about the parameters, see the description of field metadata.

    +
    +
    +
  • Description of the metadata field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    expand_type

    +

    No

    +

    String

    +

    Specifies the extension type. The current valid value is bandwidth, indicating that an enhanced file system is created. For details about the differences between different types of SFS Turbo file systems, see "Recommended Configurations".

    +

    crypt_key_id

    +

    No

    +

    String

    +

    Specifies the ID of a KMS professional key when an encrypted file system is created. The key ID can be obtained from the console of Data Encryption Workshop (DEW) or by referring to section "Querying the Information About a CMK" in the Data Encryption Workshop API Reference.

    +
    +
    +
+
  • The regions mentioned above are the same region. Currently, cross-region configuration is not supported.
  • SFS Turbo will create two private IP addresses and one virtual IP address under the subnet you specified.
  • To ensure normal use, SFS Turbo will enable the inbound rules for ports 111, 445, 2049, 2051, 2052, and 20048 in the security group you specified.
  • An ECS cannot access file systems on VPCs other than the one where the ECS resides. Make sure that you enter the ID of the VPC when creating a file system to be the VPC where the ECS resides for mounting the file system.
+
+
  • Example request
    {
+  "share": {
+    "name": "sfs-turbo-test", 
+    "share_proto": "NFS",
+    "share_type": "STANDARD",
+    "size": 100,
+    "availability_zone": "az1", 
+    "vpc_id": "d651ea2b-2b20-4c6d-8bbf-2adcec18dac9", 
+    "subnet_id": "b8884abe-f47b-4917-9f6c-f64825c365db",
+    "security_group_id": "8c4ebbd0-6edf-4aae-8353-81ce6d06e1f4", 
+    "metadata": {
+      "crypt_key_id": "015bf4b8-73cc-4235-8595-46931de7dfd0" 
+    }
+  }
+}
    +
+
+

Response

  • Parameter description +
    + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +

    name

    +

    String

    +

    Specifies the name of an SFS Turbo file system.

    +

    status

    +

    String

    +

    Specifies the status of an SFS Turbo file system. For details, see SFS Turbo File System Statuses.

    +
    +
    +
+
  • Example response
    {
+    "id": "708c017c-54b5-429a-a098-7692e23fa518",
+    "name": "sfs-turbo-test",
+    "status": "100"
+}
    +
+
+

Status Codes

  • Normal
+

202

+
  • Abnormal
+

For details, see Status Codes.

+
+
+
+
+
Parent topic: Life Cycle Management
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0052.html b/docs/sfs/api-ref/sfs_02_0052.html new file mode 100644 index 00000000..e38d904b --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0052.html @@ -0,0 +1,56 @@ + + +

Deleting a File System

+

Function

This API is used to delete an SFS Turbo file system.

+
+

URI

  • URI format

    DELETE /v1/{project_id}/sfs-turbo/shares/{share_id}

    +
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID. For details about how to obtain the project ID, see API Usage Guidelines.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +
    +
    +
+
+

Request

  • None
+
+

Response

  • None
+
+

Status Codes

  • Normal
+

202

+
  • Abnormal
+

For details, see Status Codes.

+
+
+
+
+
Parent topic: Life Cycle Management
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0053.html b/docs/sfs/api-ref/sfs_02_0053.html new file mode 100644 index 00000000..baaffa3b --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0053.html @@ -0,0 +1,321 @@ + + +

Querying Details About All File Systems

+

Function

This API is used to query details about all SFS Turbo file systems.

+
+

URI

  • URI format

    GET /v1/{project_id}/sfs-turbo/shares/detail?limit={limit}&offset={offset}

    +
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID. For details about how to obtain the project ID, see API Usage Guidelines.

    +

    limit

    +

    No (query parameter)

    +

    Int

    +

    Specifies the number of returned file systems.

    +

    This parameter takes effect when both limit and offset are used.

    +

    offset

    +

    No (query parameter)

    +

    Int

    +

    Specifies the offset of the number of queried file systems.

    +

    This parameter takes effect when both limit and offset are used.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    shares

    +

    Array of objects

    +

    Specifies the list of SFS Turbo file systems. For details, see the description of the share field.

    +

    count

    +

    Int

    +

    Specifies the number of SFS Turbo file systems.

    +
    +
    +
  • Description of the share field +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +

    name

    +

    String

    +

    Specifies the name of the SFS Turbo file system.

    +

    status

    +

    String

    +

    Specifies the SFS Turbo file system status. For details, see SFS Turbo File System Statuses.

    +

    sub_status

    +

    String

    +

    Specifies the SFS Turbo sub-status. For details, see SFS Turbo File System Substatuses.

    +

    version

    +

    String

    +

    Specifies the version ID of an SFS Turbo file system.

    +

    created_at

    +

    String

    +

    Specifies the creation time. UTC time, for example: 2018-11-19T04:02:03

    +

    export_location

    +

    String

    +

    Specifies the mount point of the SFS Turbo file system.

    +

    action_progress

    +

    Object

    +

    Specifies the creation progress of the SFS Turbo file system. For details, see Description of field action_progress.

    +

    share_type

    +

    String

    +

    Specifies the type of the SFS Turbo file system. The value can be STANDARD or PERFORMANCE.

    +

    region

    +

    String

    +

    Specifies the region of the SFS Turbo file system.

    +

    availability_zone

    +

    String

    +

    Specifies the code of the AZ where the SFS Turbo file system is located.

    +

    az_name

    +

    String

    +

    Specifies the name of the AZ where the SFS Turbo file system is located.

    +

    vpc_id

    +

    String

    +

    Specifies the VPC ID specified by the user.

    +

    subnet_id

    +

    String

    +

    Specifies the network ID of the subnet specified by the user.

    +

    security_group_id

    +

    String

    +

    Specifies the ID of a security group specified by the user.

    +

    crypt_key_id

    +

    String

    +

    Specifies the ID of the encryption key specified by the user. This parameter is not returned for non-encrypted disks.

    +

    size

    +

    String

    +

    Specifies the total capacity of the SFS Turbo file system in the unit of GB.

    +

    pay_model

    +

    String

    +

    Billing mode of the SFS Turbo file system.

    +

    avail_capacity

    +

    String

    +

    Specifies the available capacity of the SFS Turbo file system in the unit of GB.

    +

    share_proto

    +

    String

    +

    Specifies the protocol type of the SFS Turbo file system. The current value is NFS.

    +

    expand_type

    +

    String

    +

    For an enhanced file system, bandwidth is returned for this field. Otherwise, bandwidth is not returned.

    +
    +
    +
  • Description of field action_progress
+ +
+ + + + + + + + + +

Parameter

+

Type

+

Description

+

CREATING

+

string

+

Specifies the file system creation progress.

+
+
+
  • Example response
    {
+    "shares": [
+        {
+            "id": "8fba8253-c914-439d-ae8b-d5c89d0bf5e8",
+            "name": "sfs-turbo-8468",
+            "status": "200",
+            "version": "1.0.0",
+            "region": "north-1",
+            "created_at": "2018-11-19T04:02:03",
+            "export_location": "192.168.0.90:/",
+            "action_progress": {},
+            "share_type": "STANDARD",
+            "sub_status": "230",
+            "availability_zone": "az1.dc1",
+            "az_name": "az1",
+            "vpc_id": "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
+            "subnet_id": "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
+            "security_group_id": "50586458-aec9-442c-bb13-e08ddc6f1b7a",
+            "size": "500.00",
+            "pay_model": "0",
+            "avail_capacity": "500.00",
+            "share_proto": "NFS"
+        },
+        {
+            "id": "65f2d30b-7b4e-4786-9608-4324faef6646",
+            "name": "sfs-turbo-df12",
+            "status": "200",
+            "version": "1.0.0",
+            "actions": [],
+            "region": "north-1",
+            "created_at": "2018-11-15T02:32:10",
+            "export_location": "192.168.0.197:/",
+            "action_progress": {},
+            "share_type": "STANDARD",
+            "availability_zone": "az1.dc1",
+            "az_name": "az1",
+            "vpc_id": "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
+            "subnet_id": "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
+            "security_group_id": "50586458-aec9-442c-bb13-e08ddc6f1b7a",
+            "size": "500.00",
+            "pay_model": "0",
+            "avail_capacity": "500.00",
+            "share_proto": "NFS"
+        }
+    ]
+    "count": 2
+}
    +
+
+

Status Codes

  • Normal
+

200

+
  • Abnormal
+

For details, see Status Codes.

+
+
+
+
+
Parent topic: Life Cycle Management
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0054.html b/docs/sfs/api-ref/sfs_02_0054.html new file mode 100644 index 00000000..abf352a1 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0054.html @@ -0,0 +1,258 @@ + + +

Querying Details About a Single File System

+

Function

This API is used to query details about an SFS Turbo file system.

+
+

URI

  • URI format

    GET /v1/{project_id}/sfs-turbo/shares/{share_id}

    +
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID. For details about how to obtain the project ID, see API Usage Guidelines.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +

    name

    +

    String

    +

    Specifies the name of the SFS Turbo file system.

    +

    status

    +

    String

    +

    Specifies the SFS Turbo file system status. For details, see SFS Turbo File System Statuses.

    +

    sub_status

    +

    String

    +

    Specifies the SFS Turbo sub-status. For details, see SFS Turbo File System Substatuses.

    +

    version

    +

    String

    +

    Specifies the version ID of an SFS Turbo file system.

    +

    created_at

    +

    String

    +

    Specifies the creation time. UTC time, for example: 2018-11-19T04:02:03

    +

    export_location

    +

    String

    +

    Specifies the mount point of the SFS Turbo file system.

    +

    action_progress

    +

    Object

    +

    Specifies the creation progress of the SFS Turbo file system. For details, see Description of field action_progress.

    +

    share_type

    +

    String

    +

    Specifies the type of the SFS Turbo file system. The value can be STANDARD or PERFORMANCE.

    +

    region

    +

    String

    +

    Specifies the region of the SFS Turbo file system.

    +

    availability_zone

    +

    String

    +

    Specifies the code of the AZ where the SFS Turbo file system is located.

    +

    az_name

    +

    String

    +

    Specifies the name of the AZ where the SFS Turbo file system is located.

    +

    vpc_id

    +

    String

    +

    Specifies the VPC ID specified by the user.

    +

    subnet_id

    +

    String

    +

    Specifies the network ID of the subnet specified by the user.

    +

    security_group_id

    +

    String

    +

    Specifies the ID of a security group specified by the user.

    +

    crypt_key_id

    +

    String

    +

    Specifies the ID of the encryption key specified by the user. This parameter is not returned for non-encrypted disks.

    +

    size

    +

    String

    +

    Specifies the total capacity of the SFS Turbo file system in the unit of GB.

    +

    avail_capacity

    +

    String

    +

    Specifies the available capacity of the SFS Turbo file system in the unit of GB.

    +

    pay_model

    +

    String

    +

    Billing mode of the SFS Turbo file system.

    +

    share_proto

    +

    String

    +

    Specifies the protocol type of the SFS Turbo file system. The current value is NFS.

    +

    expand_type

    +

    String

    +

    For an enhanced file system, bandwidth is returned for this field. Otherwise, bandwidth is not returned.

    +
    +
    +
  • Description of field action_progress +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    CREATING

    +

    string

    +

    Specifies the file system creation progress.

    +
    +
    +
+
  • Example response
    {
+    "id": "8fba8253-c914-439d-ae8b-d5c89d0bf5e8",
+    "name": "sfs-turbo-8468",
+    "status": "200",
+    "version": "1.0.0",
+    "region": "north-1",
+    "created_at": "2018-11-19T04:02:03",
+    "export_location": "192.168.0.90:/",
+    "action_progress": {},
+    "share_type": "STANDARD",
+    "sub_status": "330",
+    "availability_zone": "az1.dc1",
+    "az_name": "az1",
+    "vpc_id": "b24e39e1-bc0c-475b-ae0c-aef9cf240af3",
+    "subnet_id": "86fc01ea-8ec8-409d-ba7a-e0ea16d4fd97",
+    "security_group_id": "50586458-aec9-442c-bb13-e08ddc6f1b7a",
+    "size": "500.00",
+    "avail_capacity": "500.00",
+   
+    "share_proto": "NFS"
+}
    +
+
+

Status Codes

  • Normal
+

200

+
  • Abnormal
+

For details, see Status Codes.

+
+
+
+
+
Parent topic: Life Cycle Management
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0055.html b/docs/sfs/api-ref/sfs_02_0055.html new file mode 100644 index 00000000..98496a9a --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0055.html @@ -0,0 +1,15 @@ + + +

Storage Capacity Management

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0056.html b/docs/sfs/api-ref/sfs_02_0056.html new file mode 100644 index 00000000..69269c5c --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0056.html @@ -0,0 +1,142 @@ + + +

Expanding the Capacity of a File System

+

Function

This API is used to expand the capacity of an SFS Turbo file system. Capacity expansion is an asynchronous operation. You can check whether the expansion is successful by checking field sub_status returned by Querying Details About a Single File System. If the value of the sub-status is 221, the expansion is successful.

+
+

URI

  • URI format

    POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action

    +
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID. For details about how to obtain the project ID, see API Usage Guidelines.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    extend

    +

    Yes

    +

    Object

    +

    Specifies the extend object. For details, see the parameter in the extend field.

    +
    +
    +
  • Parameter in the extend field +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    new_size

    +

    Yes

    +

    Int

    +

    Specifies the post-expansion capacity (GB) of the shared file system. The capacity expansion step is greater than or equal to 100 GB.

    +

    For a common file system, the value of capacity ranges from 500 to 32768.

    +

    For an enhanced file system, the value of capacity ranges from 10240 to 327680.

    +
    +
    +
+
  • Example request
    {
+    "extend": { 
+       "new_size": 500    
+    }
+}
    +
+
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +

    name

    +

    String

    +

    Specifies the name of an SFS Turbo file system.

    +
    +
    +
+
  • Example response
    {
+    "id": "67d4bd5e-7b2f-4c24-9a0b-c0038940c6f8",
+    "name": "sfs-turbo-cts"
+}
    +

    +
+
+

Status Codes

  • Normal
+

202

+
  • Abnormal
+

For details, see Status Codes.

+
+
+
+
+
Parent topic: Storage Capacity Management
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0074.html b/docs/sfs/api-ref/sfs_02_0074.html new file mode 100644 index 00000000..60928eff --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0074.html @@ -0,0 +1,26 @@ + + +

Share Tag

+

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0075.html b/docs/sfs/api-ref/sfs_02_0075.html new file mode 100644 index 00000000..5793ab04 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0075.html @@ -0,0 +1,156 @@ + + +

Creating a Tag

+

Function

This API is used to add a tag to a specified shared file system.

+

A shared file system can have a maximum of 10 tags.

+

The keys of multiple tags added to a shared file system must be unique.

+

This API is idempotent. If the key to be added has already been added to the shared file system, the tag is updated.

+
+

URI

  • POST /v1/{project_id}/sfs-turbo/{share_id}/tags
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    string

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    string

    +

    Specifies the ID of the shared file system.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    tag

    +

    Yes

    +

    Object

    +

    Specifies the tag. For details, see Description of field resource_tag.

    +
    +
    +
+
  • Description of field resource_tag +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    string

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. This parameter cannot be left empty. It cannot contain the following characters: ASCII (0-31), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), equal signs (=), commas (,), vertical bars (|), and slashes (/). It can contain only letters, digits, hyphens (-), and underscores (_).

    +

    value

    +

    Yes

    +

    string

    +

    Specifies the value of the tag. The value contains a maximum of 43 characters and can be an empty string. It cannot contain ASCII (0-31) or the following characters: =*<>\,|/ It can contain only letters, digits, hyphens (-), and underscores (_).

    +
    +
    +
+
  • Example request
    {
+    "tag":{
+        "key":"key1",
+        "value":"value1"
+    }
+}
    +
+
+

Response

  • Parameter description

    None

    +
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    Failed to complete the request, because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0076.html b/docs/sfs/api-ref/sfs_02_0076.html new file mode 100644 index 00000000..43485578 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0076.html @@ -0,0 +1,105 @@ + + +

Deleting a Tag from a Shared File System

+

Function

This API is used to delete a tag from a specified shared file system.

+

If the key to be deleted does not exist in the shared file system, error 404 is returned after API calling.

+
+
+

URI

  • DELETE /v1/{project_id}/sfs-turbo/{share_id}/tags/{key}
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    string

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    string

    +

    Specifies the ID of the shared file system.

    +

    key

    +

    Yes

    +

    string

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. This parameter cannot be left empty. It cannot contain the following characters: ASCII (0-31), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), equal signs (=), commas (,), vertical bars (|), and slashes (/). It can contain only letters, digits, hyphens (-), and underscores (_).

    +
    NOTE:

    When calling this API to delete a tag, if the tag key contains special characters that are not directly resolved by the URL, the key needs to be escaped.

    +
    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description

    None

    +
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    Failed to complete the request, because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0077.html b/docs/sfs/api-ref/sfs_02_0077.html new file mode 100644 index 00000000..8ec9f107 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0077.html @@ -0,0 +1,160 @@ + + +

Querying Tag Information About a Shared File System

+

Function

This API is used to query information of all tags about the specified shared file system.

+
+

URI

  • GET /v1/{project_id}/sfs-turbo/{share_id}/tags
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    string

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    string

    +

    Specifies the ID of the shared file system.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    tags

    +

    List<resource_tag>

    +

    Specifies the tag list. For details, see Description of field resource_tag.

    +

    sys_tags

    +

    List<resource_tag>

    +

    Only the op_service permission can obtain this field.

    +
    1. Currently, only one resource_tag structure key is used, _sys_enterprise_project_id.
    2. Currently, key contains only one value. 0 indicates the default enterprise project.
    +

    This field cannot be returned in non-op_service scenarios.

    +

    For details, see Description of field resource_tag.

    +
    +
    +
+
  • Description of field resource_tag +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    key

    +

    string

    +

    Specifies the key of the tag.

    +

    value

    +

    string

    +

    Specifies the value of the tag.

    +
    +
    +
+

+
  • Example response
    { 
+        "tags": [ 
+         { 
+             "key": "key1", 
+             "value": "value1" 
+         }, 
+         { 
+             "key": "key2", 
+             "value": "" 
+         } 
+     ] 
+ }
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    Failed to complete the request, because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0078.html b/docs/sfs/api-ref/sfs_02_0078.html new file mode 100644 index 00000000..452a5fa7 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0078.html @@ -0,0 +1,188 @@ + + +

Batch Adding Tags to a Shared File System

+

Function

This API is used to batch add tags to a specified shared file system.

+

A shared file system can have a maximum of 10 tags.

+

The keys of multiple tags added to a shared file system must be unique.

+

This API is idempotent. If the key to be added has already been added to the shared file system, the tag is updated.

+
+

URI

  • POST /v1/{project_id}/sfs-turbo/{share_id}/tags/action
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the shared file system.

    +
    +
    +
+

+
+

Request

  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    action

    +

    Yes

    +

    String

    +

    Specifies the operation identifier. Possible values are create and delete. Use create to batch add tags to a specified shared file system.

    +

    tags

    +

    No

    +

    list<resource_tag>

    +

    Specifies the tag list.

    +

    This parameter is mandatory when the tenant permission is used. For the op_service permission, choose either this field or sys_tags. For details, see Description of field resource_tag.

    +

    sys_tags

    +

    No

    +

    List<resource_tag>

    +

    Specifies the system tag list.

    +

    This field is available only to the op_service permission. Choose either this field or tags.

    +

    Currently, TMS invokes only one resource_tag structure. The key is fixed as _sys_enterprise_project_id.

    +

    The value is ID or 0. 0 indicates the enterprise project by default.

    +

    For details, see Description of field resource_tag.

    +
    +
    +
+

+
  • Description of field resource_tag +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. This parameter cannot be left empty. It cannot contain the following characters: ASCII (0-31), asterisks (*), left angle brackets (<), right angle brackets (>), backslashes (\), equal signs (=), commas (,), vertical bars (|), and slashes (/). It can contain only letters, digits, hyphens (-), and underscores (_).

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the value of the tag. The value contains a maximum of 43 characters and can be an empty string. It cannot contain ASCII (0-31) or the following characters: =*<>\,|/ It can contain only letters, digits, hyphens (-), and underscores (_).

    +
    +
    +
+
  • Example request
    { 
+     "action": "create", 
+     "tags": [ 
+         { 
+             "key": "key1", 
+             "value": "value1" 
+         }, 
+         { 
+             "key": "key2", 
+             "value": "value2" 
+         } 
+     ] 
+ }
    +
+
+

Response

  • Parameter description

    None

    +
  • Example response

    None

    +
+
+

Status Codes

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    Failed to complete the request, because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0084.html b/docs/sfs/api-ref/sfs_02_0084.html new file mode 100644 index 00000000..b17ea25c --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0084.html @@ -0,0 +1,13 @@ + + +

Common Parameters

+
+ + diff --git a/docs/sfs/api-ref/sfs_02_0085.html b/docs/sfs/api-ref/sfs_02_0085.html new file mode 100644 index 00000000..e9234d7a --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0085.html @@ -0,0 +1,51 @@ + + +

SFS Turbo File System Statuses

+
  • SFS Turbo file system status elements +
    + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    100

    +

    CREATING: The file system is being created.

    +

    200

    +

    ACTIVE: The file system is active. An SFS Turbo file system can be mounted in this status.

    +

    300

    +

    FAILED: The job failed.

    +

    303

    +

    CREATE_FAILED: The cluster failed to be created.

    +

    400

    +

    DELETED: The cluster has been deleted.

    +

    800

    +

    FROZEN: The cluster has been frozen.

    +
    +
    +
+
+
+
+
Parent topic: Common Parameters
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0086.html b/docs/sfs/api-ref/sfs_02_0086.html new file mode 100644 index 00000000..a41f33af --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0086.html @@ -0,0 +1,36 @@ + + +

SFS Turbo File System Substatuses

+
  • SFS Turbo file system substatus elements +
    + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    121

    +

    Expanding the capacity online.

    +

    221

    +

    Online capacity expansion succeeded.

    +

    321

    +

    Failed to perform online capacity expansion.

    +
    +
    +
+
+
+
+
Parent topic: Common Parameters
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0088.html b/docs/sfs/api-ref/sfs_02_0088.html new file mode 100644 index 00000000..9959c1ed --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0088.html @@ -0,0 +1,17 @@ + + + +

Appendix

+ +

+
+ + + diff --git a/docs/sfs/api-ref/sfs_02_0089.html b/docs/sfs/api-ref/sfs_02_0089.html new file mode 100644 index 00000000..459c7ced --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0089.html @@ -0,0 +1,121 @@ + + +

Status Codes

+
  • Normal +
    + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    200 OK

    +

    Specifies the normal response for the GET and PUT operations.

    +

    201 Created

    +

    Specifies the normal response for the POST operation.

    +

    202 Accepted

    +

    The request has been accepted for processing.

    +

    204 No Content

    +

    Specifies the normal response for the DELETE operation.

    +
    +
    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and the password to access the requested page.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested page was not found.

    +

    405 Method Not Allowed

    +

    You are not allowed to use the method specified in the request.

    +

    406 Not Acceptable

    +

    The response generated by the server could not be accepted by the client.

    +

    407 Proxy Authentication Required

    +

    You must use the proxy server for authentication. Then the request can be processed.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    409 Conflict

    +

    The request could not be processed due to a conflict.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +

    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 server receives an invalid response from an upstream server.

    +

    503 Service Unavailable

    +

    The request is not completed because the service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
Parent topic: Appendix
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0092.html b/docs/sfs/api-ref/sfs_02_0092.html new file mode 100644 index 00000000..cf519f05 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0092.html @@ -0,0 +1,193 @@ + + +

Change History

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Released On

+

Description

+

2021-05-17

+

Updated the following content:

+

Deleted the useless parameters in section "Creating a Shared File System."

+

2021-04-30

+

Updated the following content:

+

Added description of the expand_type field in section "Creating a File System."

+

2021-03-16

+

Updated the following content:

+

Deleted the capacity range description of file systems created by OBT users in section "Creating a File System."

+

2020-12-18

+

Updated the following content:

+

Updated the examples in section "Querying Details About All File Systems."

+

2020-12-15

+

Updated the following content:

+
  • Added the description of the count and pay_model parameters.
  • Deleted the description of the actions parameter.
+

2020-12-02

+

Updated the following content:

+

Modified the description of parameter access_type in section "Adding Share Access Rules."

+

2020-11-27

+

Updated the following content:

+

Modified the example value in section "Adding Share Access Rules."

+

2020-10-10

+

Updated the following content:

+

Added the description of APIs related to tags for shared SFS Turbo file systems.

+

2020-06-18

+

Updated the following content:

+

Modified the response example in section "Quota Management."

+

2020-06-16

+

Updated the following content:

+

Added the description and request example of the usage parameter in section "Quota Management."

+

2020-05-27

+

Updated the following content:

+
  • Changed the type of the share_proto parameter from mandatory to optional in section "Creating a File System."
  • Modified the description of the size parameter in section "Creating a File System."
  • Deleted the pay_model parameter from the response example in section "Querying Details About a Single File System."
+

2020-05-06

+

Updated the following content:

+

Added parameter description in section "Creating a File System."

+

2019-10-24

+

Updated the following content:

+

Fixed the links in section "Querying Details About All File Systems" and section "Expanding the Capacity of a File System."

+

2019-09-30

+

First time that SFS Turbo file systems go online

+

2019-05-15

+

Updated the following content:

+

Modified the URI from v1 to v2 in section "Expanding a Shared File System."

+

2019-03-30

+

Updated the following content:

+

Added relevant parameters and code examples for the CIFS protocol in sections "Creating a Shared File System", "Querying Mount Locations of a Shared File System", and "Adding Share Access Rules."

+

2019-02-03

+

Updated the following content:

+

Accepted in OTC-4.0/Agile.

+

2019-01-25

+

Updated the following content:

+
  • Modified description of the access_to field of a request in the section "Adding Share Access Rules."
  • Modified description of the share_group_id field of a request and response in the section "Creating a Shared File System."
+

2018-12-30

+

Updated the following content:

+
  • Changed "consistency_group_id" in sections "Example", "Creating a Shared File System", "Querying Details About All Shared File Systems", and "Modifying a Shared File System" to "share_group_id."
  • Added the metadata, export_location_id, export_location_path, name~, description~, and with_count fields and descriptions in sections "Querying All Shared File Systems" and "Querying Details About All Shared File Systems."
  • Added the created_at and updated_at fields and descriptions to the response messages in sections "Adding Share Access Rules" and "Querying Shared Access Rules."
+

2018-05-28

+

Updated the following content:

+

Accepted in OTC 3.1.

+

2018-05-11

+

Updated the following content:

+
  • Added description of the parameters that cannot be set.
  • Added description of the IP address, priority, and status.
  • Updated the example in the section "Querying Share Access Rules."
+

2018-04-30

+

Updated the following content:

+
  • Added version description in the section "Querying API Versions."
  • Added description of parameter api_version.
  • Added description of the metadata field.
  • Added parameter metadata in the request example.
  • Updated the parameter description.
+

2018-03-30

+

Updated the following content:

+

Added chapter "Share Tag."

+

2018-01-25

+

Updated the following content:

+

Added an interface to query the API versions.

+

2017-09-30

+

Updated the following content:

+

Added an API for querying all shared file systems.

+

2017-09-26

+

Updated the following content:

+

Added the description about how to use the is_public parameter.

+

2017-09-25

+

Updated the following content:

+

For the consistency_group_id field of a request, added that SFS does not support consistency group so that the request field is invalid, and no need to configure this parameter.

+

2017-08-26

+

Updated the following content:

+
  • For the Share_type field of a request, added a description to explain that OTC supports only one storage class. Users do not need to manually enter a storage class, but the system background automatically provides the default value instead.
  • For the metadata field of a request, added a description to explain that no metadata key-value pair is needed for the creation.
  • For the metadata field of a response, added a description of the key-value pair for used capacity.
  • In the example response, added a tip to explain that it is an asynchronous task.
  • For the access_to field of a response, added a description to explain that only the VPC ID is allowed.
+

2017-08-21

+

Updated the following content:

+
  • Highlighted the last paragraph in the introduction in bold.
  • Changed "share" to "shared file system".
  • Deleted the CIFS description from "Example response".
  • Added the explanation of the share_ type field.
  • Modified the explanation of the is_public field.
  • Modified the explanation of the share_network_id field. Currently it is not supported.
  • Modified the explanation of snapshot. Currently it is not supported.
  • Deleted the CIFS description from "Example response".
  • Added the explanation of the share_ type field.
  • Modified the explanation of the is_public field.
  • Modified the explanation of the share_network_id field. Currently it is not supported.
  • Modified the explanation of snapshot. Currently it is not supported.
  • Added the descriptions of the following fields: has_replicas, replication_type, task_state, access_rules_status, share_type_name, and snapshot_support.
  • Deleted the CIFS description from "Example response".
  • Added the explanation of the share_ type field.
  • Modified the explanation of the is_public field.
  • Modified the explanation of the share_network_id field. Currently it is not supported.
  • Modified the explanation of snapshot. Currently it is not supported.
  • Added the whole section to describe the interface for querying the shared path.
  • Deleted the description of CIFS.
  • Changed os-allow_access to os-deny_access.
+

2017-07-29

+

This issue is the first official release.

+
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0094.html b/docs/sfs/api-ref/sfs_02_0094.html new file mode 100644 index 00000000..a930e87c --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0094.html @@ -0,0 +1,137 @@ + + +

Querying All Tags of a Tenant's Shared File Systems

+

Function

This API is used to query the tag set of a tenant's all shared file systems.

+
+

URI

  • GET /v1/{project_id}/sfs-turbo/tags
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description

    None

    +
  • Example request

    None

    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    tags

    +

    Array of tags

    +

    Specifies the tag list.

    +

    For details, see Description of field tag.

    +
    +
    +
  • Description of the tag field +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    key

    +

    String

    +

    Specifies the key of the tag.

    +

    values

    +

    Array of strings

    +

    Lists the values of the tag. The value is a list of a tenant's all tag values of shared file systems. Only one of the same tag values is displayed.

    +
    +
    +
+
  • Example response
    {
+  "tags" : [ {
+    "key" : "key1",
+    "values" : [ "value1", "" ]
+  }, {
+    "key" : "key2",
+    "values" : [ "value1", "value2" ]
+  } ]
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0095.html b/docs/sfs/api-ref/sfs_02_0095.html new file mode 100644 index 00000000..c372bae8 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0095.html @@ -0,0 +1,445 @@ + + +

Querying Details About a Shared File System Based on Tags

+

Function

This API is used to query details about a shared file system based on tags.

+
+

URI

  • POST /v1/{project_id}/sfs-turbo/resource_instances/action
  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID of the operator.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    offset

    +

    No

    +

    String

    +

    Specifies the index location. The value is a character string consisting of 0 and positive integers. The default value is 0. The first record in the query result is the offset+1 record that meets the query criteria.

    +

    limit

    +

    No

    +

    String

    +

    Specifies the maximum number of query records. The value is a character string consisting of integers. The default value is 1000. The value ranges from 1 to 1000.

    +

    The number of returned records cannot exceed the value of limit.

    +

    action

    +

    Yes

    +

    String

    +

    Specifies the operation identifier. Possible values are filter and count.

    +

    Use filter to query details of a shared file system using tags.

    +

    matches

    +

    No

    +

    Array of matches

    +

    Specifies the share resource query field. If this parameter is left null, all shared file systems of the tenant are searched by default.

    +

    tags

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Only shared file systems that contain all the listed tags can be returned. Tags in this search criteria are in the AND relationship. Specifically, a shared file system can be searched only when it meets all the tag search criteria. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of tags is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    tags_any

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Shared file systems that contain any listed tag will be returned. Tags in this search criteria are in the OR relationship. Specifically, a shared file system can be searched as long as it meets one tag search condition. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of tags_any is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    not_tags

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Only shared file systems that contain none of the listed tags will be returned. Tags in this search criteria are in the NOR relationship. Specifically, a shared file system can be searched only when it does not meet any tag search criteria. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of not_tags is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    not_tags_any

    +

    No

    +

    Array of tags

    +

    Specifies the tag search field, which is a list of tags. Shared file systems that do not contain any of the listed tags will be returned. Tags in this search criteria are in the NAND relationship. Specifically, a shared file system can be searched as long as it does not meet one tag search condition. In the key-values structure of each tag search condition, tag values are in the OR relationship. If the value of not_tags_any is not specified, all shared file systems meet the requirement of this tag search field. This field contains a maximum of 10 tag keys and each tag key has a maximum of 10 tag values. The tag value corresponding to each tag key can be an empty array but the structure cannot be missing. Tag keys must be unique. Tag values in a key-values structure must be unique.

    +

    sys_tags

    +

    No

    +

    Array of tags

    +

    Only the op_service permission can use this field to filter resources.

    +
    1. Currently, TMS can invoke only one tag structure key, _sys_enterprise_project_id.
    2. Currently, key contains only one value.
    3. sys_tags and tenant tag filtering conditions (tags, tags_any, not_tags, and not_tags_any) cannot be used at the same time.
    +
    +
    +

    In the request parameters, tag search fields tags, tags_any, not_tags, and not_tags_any are optional and can be combined with each other. Such tag search fields are in the AND relationship.

    +
    +
  • Description of the match field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key. The value is fixed to resource_name.

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the value. value indicates the name of a shared file system. An empty string specifies an exact match and only shared file systems whose names are empty can be queried. A non-empty string specifies a fuzzy query (case insensitive). The value can contain a maximum of 255 characters.

    +
    +
    +
  • Description of the tag field +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    key

    +

    Yes

    +

    String

    +

    Specifies the key of the tag. A tag key can contain a maximum of 127 characters. This parameter cannot be left blank.

    +

    values

    +

    Yes

    +

    Array of strings

    +

    Lists the values. Each value can contain a maximum of 255 characters. If the value is left empty, any value is matched. The values are in the OR relationship.

    +
    +
    +
  • Example request
    {
+    "offset": "0",
+    "limit": "100",
+    "action": "filter",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }],
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }],
+    "tags_any": [{
+        "key": "key3",
+        "values": ["value3"]
+    }, {
+        "key": "key4",
+        "values": []
+    }],
+    "not_tags": [{
+        "key": "key5",
+        "values": ["value5"]
+    }, {
+        "key": "key6",
+        "values": []
+    }],
+    "not_tags_any": [{
+        "key": "key7",
+        "values": ["value7", "value8"]
+    }, {
+        "key": "key9",
+        "values": []
+    }]
+}
    +
+
+
  • Example request (without passing matches)
    {
+    "offset": "0",
+    "limit": "100",
+    "action": "filter",
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }]
+}
    +
  • Example request (without passing limit and offset)
    {
+    "action": "filter",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }],
+    "tags": [{
+        "key": "key1",
+        "values": ["value2"]
+    }, {
+        "key": "key2",
+        "values": []
+    }]
+}
    +
+
  • Example request (without passing tags, not_tags, tags_any, and not_tags_any)
    {
+    "offset": "0",
+    "limit": "100",
+    "action": "filter",
+    "matches": [{
+        "key": "resource_name",
+        "value": "share_name"
+    }]
+}
    +
+
  • Example request (with the action field only)
    {
+    "action": "filter"
+}
    +
+

Response

  • Parameter description +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    resources

    +

    Array of resources

    +

    Specifies the list of shared file systems that meet the query criteria.

    +

    total_count

    +

    Integer

    +

    Specifies the total number of shared file systems that meet the query criteria.

    +
    NOTE:

    total_count specifies the total number of shared file systems that meet the query criteria, instead of the number returned after you set offset and limit.

    +
    +
    +
    +
  • Data structure of the resource field +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    resource_id

    +

    String

    +

    Specifies the ID of the shared file system.

    +

    resource_detail

    +

    Object

    +

    Specifies the resource details. The value is a resource object, used for extension. This value is left empty by default.

    +

    tags

    +

    Array of resource_tags

    +

    Specifies the list of tags. If no tags exist, the value is an empty array by default.

    +

    sys_tags

    +

    Array of tags

    +

    Only the op_service permission can obtain this field.

    +
    1. Currently, only one tag structure key is used, _sys_enterprise_project_id.
    2. Currently, key contains only one value.
    +

    This field cannot be returned in non-op_service scenarios.

    +

    resource_name

    +

    String

    +

    Specifies the resource name.

    +
    +
    +
  • Data structure of the resource_tag field +
    + + + + + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    key

    +

    String

    +

    Specifies the key of the tag. The value can contain a maximum of 36 characters. This parameter cannot be left blank. It can only contain letters, digits, hyphens (-), and underscores (_).

    +

    value

    +

    String

    +

    Specifies the value of the tag. The value contains a maximum of 43 characters and can be an empty string. It can only contain letters, digits, hyphens (-), and underscores (_).

    +
    +
    +
+
  • Example response
    {
+    "resources":[
+        {
+            "resource_detail":{},
+            "resource_id":"b1f3f06f-344d-446b-a4bf-647a225debae",
+            "resource_name":"share_name",
+            "tags":[
+                {
+                    "key":"key1", 
+                    "value": "value1"
+                },
+                {
+                    "key":"key2", 
+                    "value": "value2"
+                }
+            ]
+        }
+    ],
+    "total_count":1
+}
    +
+
+

Status Codes

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + +

    Status Code

    +

    Description

    +

    400 Bad Request

    +

    Invalid value.

    +

    401 Unauthorized

    +

    Authentication failed.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    404 Not Found

    +

    The requested resource was not found.

    +

    500 Internal Server Error

    +

    The request is not completed because of a service error.

    +
    +
    +
+
+
+
+
+
Parent topic: Share Tag
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0096.html b/docs/sfs/api-ref/sfs_02_0096.html new file mode 100644 index 00000000..6f0b1254 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0096.html @@ -0,0 +1,19 @@ + + + +

Connection Management

+ +

+
+ +
+ + +
+
Parent topic: SFS Turbo APIs
+
+
+ diff --git a/docs/sfs/api-ref/sfs_02_0097.html b/docs/sfs/api-ref/sfs_02_0097.html new file mode 100644 index 00000000..ac8444b8 --- /dev/null +++ b/docs/sfs/api-ref/sfs_02_0097.html @@ -0,0 +1,132 @@ + + +

Changing a Security Group

+

Function

This API is used to change the security group bound to an SFS Turbo file system. Security group change is an asynchronous task. You can determine whether the security group status is changed based on the sub_status field returned in Querying Details About a Single File System. If the sub_status field is 232, the security group has been successfully modified.

+
+

URI

  • URI format

    POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action

    +
  • Parameter description +
    + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    project_id

    +

    Yes

    +

    String

    +

    Specifies the project ID. For details about how to obtain the project ID, see API Usage Guidelines.

    +

    share_id

    +

    Yes

    +

    String

    +

    Specifies the ID of an SFS Turbo file system.

    +
    +
    +
+
+

Request

  • Parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    change_security_group

    +

    Yes

    +

    Object

    +

    Specifies the change_security_group object. For details, see the change_security_group parameter description.

    +
    +
    +
  • change_security_group parameter description +
    + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    security_group_id

    +

    Yes

    +

    String

    +

    Specifies the ID of the security group to be modified.

    +
    +
    +
+
  • Example request
    {
+    "change_security_group": { 
+       "security_group_id": "26f6b565-240e-43c3-8867-03f0bd975433"    
+    }
+}
    +
+
+

Response

  • Parameter description +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the ID of the SFS Turbo file system.

    +
    +
    +
+
  • Example response
    {
+    "id": "67d4bd5e-7b2f-4c24-9a0b-c0038940c6f8"
+}
    +

    +
+
+

Status Codes

  • Normal
+

202

+
  • Abnormal
+

For details, see Status Codes.

+
+
+
+
+
Parent topic: Connection Management
+
+
+