云服务器BCC

    修改实例属性

    修改指定虚机的属性,目前仅支持修改实例名称;

    只有 Running 和 Stopped 状态的实例才可以调用该接口,否则提示 409 错误。

    请求结构

    PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1
    Host: bcc.bj.baidubce.com
    Authorization: authorization string
    
    {
        "name": InstanceName
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    version String URL参数 API版本号
    instanceId String URL参数 指定的实例ID
    action String Query参数 对实例执行的动作,当前取值modifyAttribute。
    name String Request Body参数 实例名称,支持大小写字母、数字
    以及-_ /.特殊字符,必须以字母开头,长度1-65个字符。

    返回头域

    除公共头域,无其它特殊头域。

    返回参数

    无特殊返回参数

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    BadRequest Bad request parameters or illegal request. 400 请求参数无效
    Instance.NameInvalid Instance name is invalid. 400 name无效
    NoSuchObject The specified object is not found or resource do not exist. 404 资源不存在
    OperationDenied Operation not available. 409 不可操作

    请求示例

    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"
    }

    返回示例

    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
    上一篇
    修改实例密码
    下一篇
    重装实例