帮助文档 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
帮助文档 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 百度云
  3. 云服务器 BCC
  4. API参考
  5. 实例相关接口
  6. 修改实例描述

修改实例描述

  • 实例相关接口
  • 发布于 2025-04-02
  • 0 次阅读
文档编辑
文档编辑

该接口用于修改指定BCC实例的描述信息;

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

请求结构

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

请求头域

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

请求参数

参数名称 类型 是否必需 参数位置 描述
version String 是 URL参数 API版本号
instanceId String 是 URL参数 指定的实例ID
desc String 是 Request Body参数 实例描述信息

返回头域

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

返回参数

无特殊返回参数

错误码

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

请求示例

PUT /v2/instance/i-YufwpQAe?modifyDesc HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "desc": "example"
}

返回示例

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
相关文章

创建实例(通过指定实例套餐规格) 2025-04-02 17:55

前提条件 创建实例需要实名认证,没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的个人认证或企业认证中进行认证。 BCC实例 计费注意事项: 创建计费方式为后付费的实例需要账户现金余额+通用代金券大于100;预付费方式的实例则需要账户现金余额大于等于实例费用。 指定公网IP带宽创建,计费

创建实例 2025-04-02 17:55

前提条件 创建实例需要实名认证,没有通过实名认证的可以前往百度智能云官网控制台中的安全认证下的个人认证或企业认证中进行认证。 BCC实例 计费注意事项: 创建计费方式为后付费的实例需要账户现金余额+通用代金券大于100;预付费方式的实例则需要账户现金余额大于等于实例费用。 指定公网IP带宽创建,计费

查询实例列表 2025-04-02 17:55

该接口用于查询所有实例的详细信息。 注意事项:不同查询字段之间是and关系,同一查询字段传入的多个值之间是or关系。 请求结构 GET /v{version}/instance?marker={marker}&maxKeys={maxKeys}&internalIp={internalIp}&ded

查询指定实例详情 2025-04-02 17:55

该接口用于查询指定实例的详细信息。 请求结构 GET /v{version}/instance/{instanceId} HTTP/1.1 Host: bcc.bj.baidubce.com Authorization: authorization string<

启动实例 2025-04-02 17:55

该接口用于启动指定实例。 实例状态必须为Stopped,调用此接口才可以成功返回,否则提示409错误。 接口调用成功后实例进入Starting状态。 请求结构 PUT /v{version}/instance/{instanceId}?{action} HTTP/1.1 Host: bcc.bj.b

启动实例(批量启动) 2025-04-02 17:55

该接口用于批量启动实例。 实例状态必须全部为Stopped,调用此接口才可以成功返回,否则提示409错误。 接口调用成功后实例进入Starting状态。 请求结构 PUT /v{version}/instance/batchAction?{action} HTTP/1.1 Host: bcc.bj.

目录
Copyright © 2025 your company All Rights Reserved. Powered by 博智数字服务平台.
闽ICP备08105208号-1