Modify the Instance Property
Last Updated:2020-07-20
Modify the attribute of specified virtual machine. At present, it supports to change the instance name only.
This API can be called only when the instance is in the Running or Stopped status. Otherwise, it prompts an error 409.
Request Structure
PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"name": InstanceName
}
Request Header Field
There are no other special header fields except the public header field.
Request Parameters
Parameter Name | Type | Required | Parameter Position | Description |
---|---|---|---|---|
version | String | Yes | URL parameter | API version number |
instanceId | String | Yes | URL parameter | Specified instance ID |
action | String | Yes | Query Parameter | Action on instance, whose current value is modifyAttribute. |
name | String | Yes | Request Body Parameter | Instance name, which supports uppercase and lowercase letters, numbersand special character -_ / . and /. It must begin with the letter, and its length is 1-65 characters. |
Return Header Field
There are no other special header fields except the common header field.
Return Parameter
No specific parameters are returned.
Request Instance
PUT /v2/instance/i-YufwpQAe?modifyAttribute HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"name": "new_instance_name"
}
Return Instance
HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS