Batch Modifying Vaults
Function
This API is used to batch modify all vaults in a project.
Debugging
You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.
URI
PUT /v3/{project_id}/vaults/batch-update
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. Default value: N/A For details about how to obtain the project ID, see Obtaining a Project ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. You can obtain it by calling the IAM API for obtaining a user token. The user token is the value of X-Subject-Token in the response header. Default value: N/A |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
vault |
Yes |
VaultBatchUpdate object |
Parameters for modifying a vault. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
smn_notify |
No |
Boolean |
Whether to send SMN notifications. The default value is true. The options are as follows: |
threshold |
No |
Integer |
Vault capacity threshold. If the vault usage exceeds this threshold and smn_notify is true, a notification will be sent. Range: 1 to 100. The default value is 80. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
updated_vaults_id |
Array of strings |
IDs of the vaults that have been modified in one batch. Range: N/A |
Example Requests
Batch modifying capacities of vaults to 60 GB
PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/batch-update { "vault" : { "smn_notify" : true, "threshold" : 60 } }
Example Responses
Status code: 200
OK
{ "updated_vaults_id" : [ "79bd9daa-884f-4f84-b8fe-235d58cd927d" ] }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot