检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
提交任务类请求结果 响应（任务类） 返回值 父主题： 公共参数
提交批量操作请求结果 响应（批量操作类） 父主题： 公共参数
云服务器状态 ECS API中云服务器实例存在三种状态： status，云服务器实例当前状态信息，由OS-EXT-STS:vm_state和OS-EXT-STS:task_state综合生成。 OS-EXT-STS:vm_state，云服务器扩展属性，标识云服务器实例当前处于完成某个操作的稳定状态。
通用请求返回值 正常 返回值 说明 200 请求成功。 201 请求处理成功。 202 任务提交成功，当前系统繁忙，下发的任务会延迟处理。 204 任务提交成功。 异常 返回值 说明 300 multiple choices 被请求的资源存在多个可供选择的响应。 400 Bad Request
B。 通过OBS Browser+和obsutil可以上传小于48.8TB的文件。 通过SDK或API的PUT上传、POST上传和追加写，可以上传小于5GB的文件。 通过SDK或API的多段上传以及SDK的断点续传，可以上传小于48.8TB的文件。 详细操作请参考上传对象。 步骤
可用区管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 查询可用区列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-availability-zone
安全组管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 创建安全组（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-security-groups
数据结构(查询规格详情) os_extra_specs（flavor）字段数据结构说明 该字段被如下接口使用： 查询规格详情和规格扩展信息列表 /v1/{project_id}/cloudservers/flavors 查询云服务器规格扩展字段详情 /v1/{project_id
生命周期管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 创建云服务器 POST /v1.1/{project_id}/cloudservers 创建云服务器时新创建弹性公网IP
FPGA逻辑文件管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 注册FPGA镜像 POST /v2/{project_id}/cloudservers/fpga_image
元数据管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 查询云服务器元数据列表（OpenStack原生）（废弃） GET /v2.1/{project_id}
用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来查询云服务器列表，那么这个IAM用户被授予的策略中必须包含允许“ecs:
返回值 正常 返回值 说明 200 任务提交成功。 202 任务提交成功，当前系统繁忙，下发的任务会延迟处理。 204 任务提交成功。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403
创建弹性云服务器 场景描述 本章节指导用户通过API创建云服务器。API的调用方法请参见如何调用API。 创建云服务器时，支持通过卷和镜像两种方式进行创建。本节以指定镜像的方式为例，介绍如何创建云服务器。 约束限制 该接口创建出来的是按需付费的实例。 涉及接口 创建云服务器时，需要进行规格查询
details Array of objects 任务异常时错误详情。 该信息主要包含任务异常时的细化错误编码和错误描述信息，便于使用本服务API的客户端应用代码处理错误。 该字段属于非必选字段。 表2 details数据结构 名称 参数类型 说明 message String 任务异常错误信息描述。
用创建云硬盘的接口创建新的磁盘，然后再挂载至弹性云服务器。挂载操作需要调用挂载云硬盘接口。 您可以在创建云服务器时，通过设置“data_volumes”参数值挂载数据盘，也可以在创建云服务器成功后挂载数据盘。本节主要介绍云服务器创建成功后挂载磁盘的场景。 涉及接口 挂载磁盘涉及的接口如下：
云服务器组管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 删除云服务器组 DELETE /v1/{project_id}/cloudservers/os-s
en离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。 针对用户调用接口中常常出现的Token过期导致的调用失败问题，本文将介绍获取Token并检验Token有效期的方法。 若Token即将超期（无法满足一次完整的API调用或者完整的一套组合的调用）则需
响应（批量操作类） 本节内容当前仅支持批量重置弹性云服务器密码、批量修改云服务器的响应。其他批量操作的请求结果请参见响应（任务类）。 正常响应要素说明 名称 参数类型 说明 response Array of objects 提交请求成功后返回的响应列表，详情请参见 response数据结构说明。
数据结构(创建云服务器) 使用须知 自研的创建云服务器接口支持有v1和v1.1两个版本，其中v1只能创建按需的云服务器，v1.1可以创建按需和包年/包月虚拟机。 下面数据结构中的字段，当选择包年/包月计费模式时（包年包月的），请选择使用v1.1的创建云服务器接口。 数据结构导航 publicip字段数据结构说明
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
