Modifies the attributes of a KVCacheStore.
Operation description
Supports modifying Name, Description, and Capacity. The cluster number (HpnZone) cannot be modified after creation.
Modifying Capacity triggers a specification change order, and the operation returns an OrderId. Modifying only Name or Description does not generate an order.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID, such as cn-hangzhou. |
cn-hangzhou |
| KvcsId |
string |
Yes |
The KVCacheStore instance ID. |
kvcs-your-id |
| Name |
string |
No |
The new KVCacheStore name. The name must be 2 to 128 characters in length and can contain characters that are categorized as letter in Unicode (including English and Chinese characters) and digits. The name can contain colons (:), underscores (_), periods (.), and hyphens (-). If this parameter is not specified, the default value is the KVCacheStore ID. |
1633730290118313-HD-m3u8 |
| Capacity |
integer |
No |
The new storage capacity in GiB. The value must be a multiple of 300 TiB and greater than the current capacity. |
4096 |
| Description |
string |
No |
The new KVCacheStore description. The description must be 2 to 256 characters in length and can contain English and Chinese characters. The description cannot start with http:// or https://. Default value: empty. |
project name pass the check |
| Tag |
array<object> |
No |
The list of resource tag key-value pairs. A maximum of 20 tags are supported. |
|
|
object |
No |
|||
| TagKey |
string |
No |
The tag key of the resource. |
projectId |
| TagValue |
string |
No |
The tag value of the resource. |
projectName |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can be up to 64 ASCII characters in length. |
YOUR_CLIENT_TOKEN |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
UpdateKvCacheStoreResponse |
||
| KvcsId |
string |
The ID of the modified KVCacheStore. |
kvs-xxxxx |
| OrderId |
string |
The specification change order ID. Returned only when Capacity is modified. |
order-xxxxx |
| RequestId |
string |
The request ID. The request ID is returned regardless of whether the operation is successful. |
6AA27F1A-A62C-59C3-BCC7-D1DFA4E7EEA0 |
Examples
Success response
JSON format
{
"KvcsId": "kvs-xxxxx",
"OrderId": "order-xxxxx",
"RequestId": "6AA27F1A-A62C-59C3-BCC7-D1DFA4E7EEA0"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter.Conflict | The specified parameter %s and %s are not blank at the same time. | |
| 400 | InvalidParameter.Format | Specified parameter format is not valid. | |
| 400 | MissingParameter | The input parameter %s that is mandatory for processing this request is not supplied. | |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | |
| 403 | Forbidden | User is not authorized to operate. | |
| 403 | Forbidden.Action | User is not authorized to operate this action. | |
| 403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | |
| 403 | LastTokenProcessing | The last token request is processing. | |
| 403 | OperationDenied | The operation is not allowed. | |
| 404 | InvalidApi.NotFound | Specified api is not found, please check your url and method. | |
| 504 | RequestTimeout | The request is timeout, please try again later. | |
| 429 | BLOCK.LimitedRequest | Request was denied due to user flow control. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.