华为云用户手册

功能 目前，成本中心提供的主要功能如下。 功能模块 功能描述 相关文档链接 总览 快速找到成本中心常见功能的操作入口。 总览 成本助手 提供成熟度评分和洞察建议，提升客户成本管理成熟度。 成本助手 入门 了解 云财务管理 常见场景的最佳实践。 入门 成本洞察 成本分析 使用成本分析预置的场景化报告快速分析成本分布与趋势，预测未来成本，您也可以自定义分析并保存为报告。 成本分析 异常成本监控 检测异常成本增长并接受通知。 异常成本监控 成本明细导出 导出原始成本、摊销成本、用量明细文件或将明细数据转储至OBS（公测中）。 成本明细导出 云智能看板 提供年度消费趋势、项目分布与趋势等成本可视的一体化仪表盘。 方案咨询 成本组织 成本标签 您在使用标签标识和管理资源的同时，还可以将标签激活为成本标签来归集成本。成本标签可以应用在成本分析和预算管理中。 成本标签 激活成本标签 成本分组 使用成本分组创建自定义规则，将成本映射到华为云提供的成本组织方式（关联账号、企业项目、成本标签、成本分组）中，以便后续进行业务视角的成本管理。 成本分组概述 预算管理 预算 快速为产品类型、业务单元、免费场景创建预算，也可自定义更详细的预算信息，在超出或预计超出预算金额时，收到提醒。 预算 预算报告 为多个预算创建统一的提醒，按日、按周、按月收到预算报告。 预算报告 成本优化 优化概览 整体了解资源、计费模式优化机会和可节省成本。 成本优化 资源包 使用率&覆盖率分析 通过分析资源包使用率情况，了解资源包是否得到充分利用。 通过查看按需资源被资源包覆盖的情况，了解资源包是否购买足够。 查看使用率分析数据 查看覆盖率分析数据 购买建议 基于您OBS、SFS资源的按需资源消费情况，生成相应的资源包购买建议。 资源包购买建议 选项 启用共同成本分拆 当前仅支持部分CDN、全站加速WSA和 视频直播 Live的费用按 域名 用量占比分拆。 开通共同成本分拆功能 启用按需转包年包月成本优化评估 通过了解您的历史按需消费情况来识别成本优化的机会。 按需转包年包月建议 启用E CS 资源优化建议 帮助您跟踪发现空闲的资源，并给予您相关建议。 资源优化概述 启用小时粒度的成本分析 成本分析页面将最多提供过去14天按小时分折原始成本的数据。 查看成本分析 启用月粒度的多年数据 成本分析页面将最多提供最近38个月按月分析的历史数据。 查看成本分析 其他 IAM 您可以使用IAM对成本中心进行精细的权限管理，以达到不同员工之间的权限隔离。 权限管理 账单 账单是用户在华为云消费的汇总或明细数据，真实的反映了用户的历史消费记录，供用户对账使用。 费用账单

总览 成本中心的总览页面如下图所示。 序号 说明 1 通过左侧导航，可以根据成本洞察、成本组织、预算管理、成本优化的目标快速定位到相关功能。 2 将月初至今成本、月末成本预测、已超预算数/预测超预算数、近30天异常成本数、预计月度可节省成本进行信息聚合展示。 3 支持切换汇总维度查看当月成本数据。汇总维度支持：产品类型、企业项目、成本标签、成本分组、关联账号、区域。 4 查看当月成本、上月成本、预测成本趋势。 5 通过产品类型、企业项目、成本标签、成本分组和关联账号维度展示成本环比上月增长的Top5。 6 展示最近成本中心特性版本的功能发布情况。 7 提供成熟度评分和洞察建议，帮助客户提升成本管理成熟度。 8 按照企业项目、成本标签及成本分组三种成本分配方式统计您的成本分配情况，选取最优的分配情况进行来评分。

简介 近年来，伴随全球数字经济的高速发展以及企业数字化转型的深入推进，越来越多的企业将业务迁移上云。企业用云实现更高的业务敏捷性、灵活性和生产效率。但由于云的可变特点，云上消费模式与传统IT采购模式完全不同，云支出难以控制，企业的云财务管理面临诸多挑战： 如何将云支出完全分配到企业内部，从而明确成本责任，追溯成本变化的原因？ 如何准确的预测未来成本，提前做好预算准备？ 如何更有效的跟踪和控制消费来保持预算？ 目前消费方式是否合理，是否存在浪费？都有哪些优化成本的空间？ ...... 为帮助企业适应这一变化，更好的利用云的特点，完成云财务管理转型，华为云提供一整套解决方案，来帮助您以准确、高效的方式分配、控制和优化云成本。这些解决方案有助于树立注重成本的企业文化，在企业内部形成问责制，更高效的利用云的特点，在满足业务性能和创新速度的同时，不过度开支，确保投资实现预期的业务结果。 父主题： 华为云云财务管理解决方案

通用功能 顶部导航栏提供通用功能入口，如图10所示。 图10 通用功能 表1 通用功能说明 模块 子模块 说明 参考 备案 我的备案 了解备案 授权码管理 提供华为云备案系统入口及参考。 了解备案 资源 我的资源 我的配额 我的公测 我的云商店 提供华为云资源管理的入口。 我的资源 费用 待支付订单 续费管理 我的套餐 费用账单 发票管理 成本中心 提供查看订单、费用管理、套餐管理等操作的费用中心的入口。 费用中心 企业 组织与账号 项目管理 提供组织与账号管理和项目管理的入口。 企业中心 项目管理 工具 API Explorer CLI工具集 价格计算器 提供到API Explorer、CLI工具集、价格计算器的入口。 其中，单击“CLI工具集”后，会在当前页下方的拓展区域显示CLI工具客户端的下载地址。 API Explorer 价格计算器 工单 我的工单 新建工单 提供管理工单和创建工单的入口。 工单管理 CloudShell CloudShell 提供CloudShell工具使用入口。 单击“CloudShell”后，会在当前页下方的拓展区域显示CloudShell工具。 CloudShell相关操作 站内消息 站内消息 提供查看站内消息的入口。您可以通过“消息接收管理”设置消息接收人信息。 消息中心 帮助反馈 帮助中心 支持计划 专业服务 智能客服 建议反馈 提供华为云帮助与反馈的入口，您可以： 查看帮助中心文档 查询华为云支持计划详情 通过工单及智能客服寻求帮助 提交对华为云的反馈意见 帮助中心 支持计划详情 工单管理 智能客服 建议反馈 语言切换 简体中文 English 提供简体中文、English两种语言供您使用。 - 用户名 基本信息 安全设置 我的凭证 统一身份认证 切换角色 标签管理 操作日志 退出登录 提供对登录管理员帐号的查询、安全管理、IAM用户设置、角色切换、标签管理、操作日志查询以及退出登录等操作的入口。 账号中心 安全设置 我的凭证 统一身份认证服务 切换角色 标签管理 操作日志

全局搜索 全局搜索可以帮助您快速查到云服务、文档、资源（名称/ID/IP）、快捷操作、API。 全局搜索支持如下功能： 新手搜索引导：当点开搜索栏时，系统会自动展现搜索词让客户快速选择。 图6 新手搜索引导 搜索历史记录：显示最近搜索的资源名称、最近访问的搜索词。 图7 搜索历史记录 猜你想搜：每次搜索时，系统会按照搜索的关键词联想匹配。 图8 猜你想搜 搜索结果分类：搜索结果可实现控制台入口直达、快捷操作直达、资源详情直达、文档信息直达、API直达。 图9 搜索结果分类

安全监控 “安全监控”视图提供“一个中心、七层防线”的云资源安全监控。帮助用户提前规避安全风险。 图8 安全监控视图 各个模块的简介和功能如表2所示。 表2 模块概述和使用 模块 概述 如何使用 安全防护检查 授予 安全云脑 对资源的相关操作权限，允许安全云脑以您的身份进行安全检查相关操作。 在安全监控视图左上角单击“去授权”，授予安全云脑访问资源的权限。 说明： 权限授权范围包括： SecMaster FullAccess：安全云脑所有权限 Tenant Guest：全部云服务只读权限（除IAM权限） IAM ReadOnlyAccess：IAM的只读访问权限 ECS FullAccess：ECS的所有权限 单击“同意授权”，完成安全防护检查的授权。 更多关于安全云脑的信息，请参见安全云脑。 防护满足度评估 评估安全云脑对云资源的安全防护满足度，该满足度评估结果会体现在右侧区域的“七层防线”上。 安全防护满足度包含三级： R（红色，有风险） L（橙色，低覆盖） S（绿色，覆盖良好） 在安全监控视图区域左侧单击“重新评估”。 选择“等级云级别”。 安全云等级包括： S1：面向Internet提供的业务，无特殊合规要求，防普通攻击、入侵。 S2：面向企业生产类型相关的业务，需满足等保3级合规要求，防APT级入侵、窃取数据。 S3：面向研发环境/企业核心数据存储环境，需满足等保3级合规要求，防内部恶意员工泄露数据。 您可以通过安全等级云购买安全方案等级套餐。 单击“确定”，启动防护评估。 您可以在“一个中心”和“七层防线”处查看评估结果。 一个中心 安全监控的“一个中心”指安全云脑服务。 鼠标放置在“安全云脑”上，在右侧展开区域显示“安全云脑防护详情”，包含安全云脑满足度评估结果、防护资产配额、防护统计。 单击前往控制台，可跳转至安全云脑控制台进行更多操作。 七层防线 限制安全防护的物理防线、身份防线、网络防线、应用防线、主机防线、数据防线、运维防线等七层防线。 将鼠标放置在七层防线的图标上，可在右侧区域展示防线详情，包含具体防线满足度评估结果、防护资产配额、防护统计等信息。 说明： 如果不满足当前评估结果，可在对应防线详情中，单击提升防护，升级安全等级云。 物理防线：由云服务提供商提供线上负责。 身份防线：暂未上线，敬请期待。 网络防线：提供 云防火墙 ，例如CFW和AAD类型的防护。 在防线详情中，单击前往控制台，可跳转至云防火墙控制台进行更多操作。 应用防线：提供 Web应用防火墙 的防护。 在防线详情中，单击前往控制台，可跳转至Web应用防火墙控制台进行更多操作。 主机防线：提供主机/ 容器安全 类型的防护。 在防线详情中， 单击去配置，可跳转至主机管理页面，配置防护配额。 单击前往控制台，可跳转至主机/容器安全控制台进行更多操作。 数据防线：提供 数据安全中心 ，例如DSC、DBSS、DEW类型的防护。 在防线详情中，单击前往控制台，可跳转至数据安全中心控制台进行更多操作。 运维防线：提供 云堡垒机 的防护。 在防线详情中，单击前往控制台，可跳转至云 堡垒机 控制台进行更多操作。 资源 显示安全防护的资源。 鼠标放置在具体资源上，可显示当前资源的安全防护满足度、保有量、涉及安全防线的防护率。

成本管理 “成本管理”视图展示详细的成本信息，提高云上成本精细化管理水平。 图9 成本管理视图 各个模块的简介和功能如表3所示。 表3 模块概述和使用 模块 概述 如何使用 成本管理概览 展示当月成本信息，包括月初至今成本、月末成本预测、已超预算数/预测超预算数、近30天异常成本数、预计月度可节省成本。 创建预算：用于跟踪成本和使用量。及时了解实际和预测与预算的对比情况。 在“已超预算数/预测超预算数”区域，单击“去创建”，跳转至成本中心的“预算”页面。 详细信息，请参见预算。 创建成本监控：用于及时发现异常的按需、包年包月消费，避免不必要的支出。 在“近30天异常成本数”区域，单击“去创建”，跳转至成本中心的“成本监控”页面。 详细信息，请参见创建成本监控。 成本助手 展示成本成熟度评分。 成本成熟度评分来源于您的成本分配情况。 单击“去提高评分”，跳转至“成本助手”的“成熟度评分”页签，可查看建议项。 单击“”，跳转至“成本助手”的“成本洞察”页签，可查看成本管理优化项。 详细信息，请参见成本助手。 当月成本分布 按不同维度展示当月的成本及费用占比。 选择“汇总维度” 您可以通过下拉列表，选择当月成本分布的维度，包含产品类型、企业项目等。 单击该区域右上角的“”，跳转至“成本中心”查看更详细的成本报告。 详细内容，请参见成本分析。 当月成本趋势 通过图表展示当月成本趋势。 单击该区域右上角的“”，跳转至“成本中心”查看更详细的成本报告。 成本分配情况 通过切换不同的成本分配方式来显示成本分配情况。 单击该区域右上角的下拉框，可选择成本分配方式。 单击该区域右上角的“”，可设置成本分配方式的“成本标签”和“成本单元”。 成本增长 TOP5 显示各分类维度下环比上月增长的Top5。 单击该区域右上角的“自定义分类维度”，可打开/关闭分类维度页签，并且可以通过拖拽调整页签顺序。

运维监控 “运维监控”视图汇总监控信息、成本概况、费用和账单信息，帮助用户优化成本，规划费用。 图7 运维监控视图 各个模块的简介和功能如表1所示。 表1 模块概述和使用 模块 概述 如何使用 云监控 显示资源的监控信息，包括告警中和数据不足的资源数量，以及近7天告警总次数。 单击“”，跳转至告警记录，可查阅所有告警记录。 安全监控 实时监控最新威胁告警事件、最新漏洞风险事件和最新基线。 单击“”，跳转至安全看板，进行事件的查看和处理。 单击“升级”，可将基础版态势感知升级到更高版本，以获取更全面的安全监控体验。 单击“应急漏洞”，跳转至漏洞管理，可查看历史漏洞信息。 成本概览 显示当月成本和月末预测成本，与上月成本的环比情况，以及当月不同产品类型的成本分布。 单击“”进入成本中心，进行成本的查阅和管理。 费用概况 显示客户账户费用信息，包括：可用额度、现金余额、可开票金额、卡券信息。 单击“费用概况”右侧的“”，跳转至费用中心，可查看更多费用相关信息。 单击“充值”、“提现”、“汇款认领”“去开票”，进行相应操作。 单击“代金券”右侧的“”，查看卡券详情。 后付费账单 显示后付费账单信息。 单击“”，跳转至费用中心，可查看更多费用相关信息。 ECS资源监控 显示ECS资源CPU使用率、磁盘读取率和网络流入速率等信息。 - 公告 展示最新的3个华为云动态。 单击“”，可查看历史公告。

请求示例 POST https://{endpoint}/v1/{project_id}/servers/{server_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ]}

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 tags 是 Array of objects 标签列表 action 是 String 操作标识（仅支持小写）：create（创建） 表3 resource_tag 字段数据结构说明 参数 是否必选 参数类型 描述 key 是 String 键。 不能为空。 对于同一资源键值唯一。 长度不超过36个字符。 标签的键必须唯一且输入不能为空。 value 是 String 值。 长度不超过43个字符。

响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 instanceActions Array of Object 云服务器操作行为列表，详情请参见表4。 表4 instanceActions字段数据结构说明 参数 是否必选 参数类型 描述 action 是 String 行为动作 取值范围： create , delete , evacuate , restore , stop , start , reboot , rebuild , revertResize , confirmResize , detach_volume , attach_volume , attach_interface , detach_interface , lock , unlock , resize , migrate , pause , unpause , rescue , unrescue , changePassword , shelve ,unshelve , live-migration , trigger_crash_dump, extend_volume instance_uuid 是 String 弹性云服务器ID，UUID格式 message 是 String 行为完成状态信息 project_id 是 String 项目ID request_id 是 String 请求ID start_time 是 String 行为开始时间 user_id 是 String 用户ID

响应示例 { "instanceActions": [ { "instance_uuid": "e723eb40-f56e-40f9-8c8c-caa517fe06ba", "user_id": "752be40780484291a9cc7ae50fff3e6d", "start_time": "2014-12-16T10:58:14.000000", "request_id": "req-ee56c2b5-d33b-4749-ae83-09281dbbb716", "action": "resize", "message": "Error", "project_id": "89655fe61c4c4a08b9f3e7f9095441b8" }, { "instance_uuid": "e723eb40-f56e-40f9-8c8c-caa517fe06ba", "user_id": "752be40780484291a9cc7ae50fff3e6d", "start_time": "2014-12-16T10:57:56.000000", "request_id": "req-23cfd57f-c58a-45cd-86a6-eab3e38f3753", "action": "resize", "message": "Error", "project_id": "89655fe61c4c4a08b9f3e7f9095441b8" }, ]}

响应消息 响应参数如表3所示。 表3 响应参数 参数 是否必选 参数类型 描述 floating_ip 是 Object floating_ip对象，参见表4。 表4 floating_ip对象 参数 是否必选 参数类型 描述 fixed_ip 是 String 私有IP地址 id 是 String 浮动IP的ID，UUID格式 instance_id 是 String 被绑定主机的ID，UUID格式 ip 是 String 浮动IP的ip地址 pool 是 String 网络资源池名称，用于分配浮动IP

响应示例 { "limits": { "rate": [], "absolute": { "maxServerMeta": 128, "maxPersonality": 5, "totalServerGroupsUsed": 0, "maxImageMeta": 128, "maxPersonalitySize": 10240, "maxTotal RAM Size": 25165824, "maxTotalKeypairs": -1, "maxSecurityGroupRules": 20, "maxServerGroups": -1, "totalCoresUsed": 0, "totalRAMUsed": 0, "maxSecurityGroups": 10, "totalFloatingIpsUsed": 0, "totalInstancesUsed": 0, "totalSecurityGroupsUsed": 0, "maxTotalFloatingIps": 10, "maxTotalInstances": 2048, "maxTotalCores": 20480, "maxServerGroupMembers": -1 } }}

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 limits Object 租户限制，详情请参见表3。 表3 limits参数信息 参数 参数类型 描述 rate List 值为空列表 absolute Object 租户配额限制，详情请参见表4。 表4 absolute参数信息 参数 参数类型 描述 maxServerMeta String 云服务器元数据数量限制。 值为“-1”时，表示无数量限制。 maxPersonality String 注入文件数量限制。 值为“-1”时，表示无数量限制。 totalServerGroupsUsed String 已使用的云服务器组数量。 maxImageMeta String 镜像元数据数量限制。 值为“-1”时，表示无数量限制。 maxPersonalitySize String 注入文件大小限制。 值为“-1”时，表示无大小限制。 maxTotalRAMSize String 总内存大小限制。 值为“-1”时，表示无大小限制。 maxTotalKeypairs String keypair数量限制。 值为“-1”时，表示无数量限制。 maxSecurityGroupRules String 安全组规则数量限制。 值为“-1”时，表示无数量限制。 微版本2.35及以上版本不支持。 maxServerGroups String 云服务器组数量限制。 值为“-1”时，表示无数量限制。 totalCoresUsed String 已使用的核数。 totalRAMUsed String 已使用的内存大小。 maxSecurityGroups String 安全组数量限制。 值为“-1”时，表示无数量限制。 totalFloatingIpsUsed String 已使用的浮动IP数量。 totalInstancesUsed String 已使用的云服务器数量。 totalSecurityGroupsUsed String 已使用的安全组数量。 maxTotalFloatingIps String 浮动IP数量限制。 值为“-1”时，表示无数量限制。 maxTotalInstances String 云服务器数量限制。 值为“-1”时，表示无数量限制。 maxTotalCores String 总核数限制。 值为“-1”时，表示无数量限制。 maxServerGroupMembers String 云服务器组成员数量限制。 值为“-1”时，表示无数量限制。

云服务器状态 ECS API中云服务器实例存在三种状态： status，云服务器实例当前状态信息，由OS-EXT-STS:vm_state和OS-EXT-STS:task_state综合生成。 OS-EXT-STS:vm_state，云服务器扩展属性，标识云服务器实例当前处于完成某个操作的稳定状态。 OS-EXT-STS:task_state，云服务器扩展属性，标识当前云服务器实例的任务状态，即当前云服务器实例正在处理某个操作的中间状态。 表1 Status 列表 Status 状态 说明 BUILD 创建实例后，在实例状态进入运行中之前的状态。 REBOOT 实例正在进行重启操作。 HARD_REBOOT 实例正在进行强制重启操作。 REBUILD 实例正在重建中。 MIGRATING 实例正在热迁移中。 RESIZE 实例接收变更请求，开始进行变更操作。 ACTIVE 实例正常运行状态。 SHUTOFF 实例被正常停止。 REVERT_RESIZE 实例正在回退变更规格的配置。 VERIFY_RESIZE 实例正在校验变更完成后的配置。 ERROR 实例处于异常状态。 DELETED 实例已被正常删除。 SHELVED 镜像启动的实例处于搁置状态。 SHELVED_OFFLOADED 卷启动的实例处于搁置状态。 UNKNOWN 实例处于未知状态。 表2 OS-EXT-STS:vm_state 列表 vm_state 状态 说明 building 创建实例后，在实例状态进入运行中之前的状态。 active 实例正常运行状态。 stopped 实例被正常停止。 resized 实例完成变更规格的配置。 error 实例处于异常状态。 deleted 实例已被正常删除。 shelved 镜像启动的实例处于搁置状态。 shelved_offloaded 卷启动的实例处于搁置状态。 表3 OS-EXT-STS:task_state 列表 task_state 状态 说明 scheduling 实例处于创建中，正在进行调度。 block_device_mapping 实例处于创建中，正在准备磁盘。 networking 实例处于创建中，正在准备网络。 spawning 实例处于创建中，正在内部创建。 rebooting 实例处于重启中。 reboot_pending 实例处于重启中，正在下发重启。 reboot_started 实例处于重启中，开始内部重启。 rebooting_hard 实例处于强制重启中。 reboot_pending_hard 实例处于强制重启中，正在下发重启。 reboot_started_hard 实例处于强制重启中，开始内部重启。 rebuilding 实例处于重建中。 rebuild_block_device_mapping 实例处于重建中，正在准备磁盘。 rebuild_spawning 实例处于重建中，正在内部重建。 migrating 实例处于热迁移中。 resize_prep 实例处于调整规格中，正在准备阶段。 resize_migrating 实例处于调整规格中，正在迁移阶段。 resize_migrated 实例处于调整规格中，已经完成迁移。 resize_finish 实例处于调整规格中，正在完成调整。 resize_reverting 实例处于调整规格中，正在回退调整。 powering-off 实例处于停止中。 powering-on 实例处于启动中。 deleting 实例处于删除中。 shelving 镜像启动的实例处于搁置中。 shelving_offloading 卷启动的实例处于搁置中。 shelving_image_pending_upload 实例处于搁置中，正在下发上传镜像。 shelving_image_uploading 实例处于搁置中，上传镜像中。 unshelving 实例处于解除搁置中。 表4 三种状态对应关系表 vm_state task_state status building scheduling block_device_mapping networking spawning null BUILD active rebooting reboot_pending reboot_started REBOOT rebooting_hard reboot_pending_hard reboot_started_hard HARD_REBOOT rebuilding rebuild_block_device_mapping rebuild_spawning REBUILD migrating MIGRATING powering-off deleting null ACTIVE stopped resize_prep resize_migrating resize_migrated resize_finish RESIZE rebuilding rebuild_block_device_mapping rebuild_spawning REBUILD powering-on deleting null SHUTOFF resized resize_reverting REVERT_RESIZE null VERIFY_RESIZE error rebuilding rebuild_block_device_mapping rebuild_spawning REBUILD deleting null ERROR deleted null DELETED shelved shelving shelving_image_pending_upload shelving_image_uploading unshelving null SHELVED shelved_offloaded shelving_offloading unshelving null SHELVED_OFFLOADED 如果状态未包含在表4中，则为UNKNOWN状态。 父主题： 附录

SSH密钥管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 创建和导入SSH密钥（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-keypairs ecs:serverKeypairs:create - √ × × × 查询SSH密钥详情（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-keypairs/{keypair_name} ecs:serverKeypairs:get - √ × × × 查询SSH密钥列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-keypairs ecs:serverKeypairs:list - √ × × × 删除SSH密钥（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/os-keypairs/{keypair_name} ecs:serverKeypairs:delete - √ × × × 父主题： 权限和授权项

租户配额管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 查询租户配额 GET /v1/{project_id}/cloudservers/limits ecs:cloudServerQuotas:get - √ √ × × 查询租户配额（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-quota-sets/{project_id}?user_id={user_id} ecs:quotas:get - √ × × × 查询默认配额（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-quota-sets/{project_id}/defaults ecs:quotas:get - √ × × × 父主题： 权限和授权项

响应示例 { "volumeAttachment": { "pciAddress": "0000:02:01.0", "volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r", "device": "/dev/vda", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "id": "a26887c6-c47b-4654-abb5-asdf234r234r", "size": "40", "bootIndex": 0, "bus":"virtio" }}

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 volumeAttachment Object 云服务器挂载信息，更多信息请参见表3。 表3 volumeAttachment参数 参数 参数类型 描述 serverId String 弹性云服务器ID，UUID格式。 volumeId String 云硬盘ID，UUID格式。 id String 挂载ID，与云硬盘ID相同。 UUID格式。 size Integer 云硬盘大小，单位GB。 device String 云硬盘挂载盘符，即磁盘挂载点。 pciAddress String pci地址。 bootIndex Boolean 云硬盘启动顺序。 0为系统盘。 非0为数据盘 bus String 磁盘总线类型 。 取值范围：virtio、scsi

磁盘管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 卸载指定弹性云服务器的磁盘 DELETE /v1/{project_id}/cloudservers/{server_id}/detachvolume/{volume_id} ecs:cloudServers:detachVolume - √ √ √ √ 弹性云服务器挂载磁盘 POST /v1/{project_id}/cloudservers/{server_id}/attachvolume ecs:cloudServers:attach evs:volumes:use √ √ √ √ 查询弹性云服务器挂载磁盘列表详情信息 GET /v1/{project_id}/cloudservers/{server_id}/block_device ecs:cloudServers:listServerBlockDevices - √ √ √ √ 查询弹性云服务器挂载磁盘列表信息 GET /v1/{project_id}/cloudservers/{server_id}/os-volume_attachments ecs:cloudServers:listServerVolumeAttachments - √ √ √ √ 查询弹性云服务器单个磁盘挂载信息 GET /v1/cloudservers/{server_id}/block_device/{volume_id} ecs:cloudServers:showServerBlockDevice - √ √ √ √ 挂载弹性云服务器磁盘（OpenStack原生）（废弃） POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments ecs:serverVolumeAttachments:create ecs:servers:get ecs:flavors:get ecs:serverVolumes:use evs:volumes:list evs:volumes:get evs:volumes:update evs:volumes:attach evs:volumes:manage √ × × × 卸载云服务器磁盘（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id} ecs:serverVolumeAttachments:delete ecs:serverVolumes:use evs:volumes:list evs:volumes:get evs:volumes:update evs:volumes:detach evs:volumes:manage √ × × × 查询弹性云服务器挂载磁盘信息（OpenStack原生）（废弃） GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments ecs:serverVolumeAttachments:list ecs:serverVolumes:use ecs:servers:get √ × × × 查询弹性云服务器挂载的单个磁盘信息（OpenStack原生）（废弃） GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id} ecs:serverVolumeAttachments:get ecs:serverVolumes:use √ × × × 创建磁盘（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-volumes ecs:serverVolumes:use evs:volumes:create √ × × × 删除磁盘（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/os-volumes/{volume_id} ecs:serverVolumes:use evs:volumes:get evs:volumes:delete √ × × × 查询指定磁盘信息（OpenStack原生） GET /v2.1/{project_id}/os-volumes/{volume_id} ecs:serverVolumes:use evs:volumes:get √ × × × 查询磁盘列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-volumes ecs:serverVolumes:use evs:volumes:get evs:volumes:list √ × × × 查询磁盘列表详情（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-volumes/detail ecs:serverVolumes:use evs:volumes:get evs:volumes:list √ × × × 父主题： 权限和授权项

响应（批量操作类） 本节内容当前仅支持批量重置弹性云服务器密码、批量修改云服务器的响应。其他批量操作的请求结果请参见响应（任务类）。 正常响应要素说明 名称 参数类型 说明 response Array of objects 提交请求成功后返回的响应列表，详情请参见 response数据结构说明。 表1 response数据结构说明 名称 参数类型 说明 id String 操作成功的虚拟机id 异常响应要素说明 名称 参数类型 说明 error Object 批量请求异常时返回的整体异常信息，详情请参见 表2。 internalError Array of objects 批量请求处理中，每一个单个请求的具体异常信息，详情请参见 internalError 数据结构说明。 表2 error数据结构 名称 参数类型 说明 message String 批量操作整体异常错误信息描述。 code String 批量操作整体异常错误信息编码。 表3 internalEroCMM.0101r 数据结构说明 名称 参数类型 说明 id String 具体单个请求操作失败的虚拟机id error_message String 具体单个请求操作失败的错误信息描述。 error_code String 具体单个请求操作失败的错误信息编码。 响应示例 正常响应： { "response": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12" } ]} 异常响应： { "error": { "code": "Ecs.xxxx", "message": "xxxxxxxxxxxxxxx" }, "internalError": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19", "error_code": "ECS.XXXX", "error_message": "xxxxxxxxxxxxxxx" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12", "error_code": "ECS.XXXX", "error_message": "xxxxxxxxxxxxxxx" } ]} 父主题： 提交批量操作请求结果

响应示例 { "versions":[ { "min_version":"", "links":[ { "rel":"self", "href":"https://{endpoint}/v2/" } ], "id":"v2.0", "updated":"2011-01-21T11:33:21Z", "version":"", "status":"SUPPORTED" }, { "min_version":"2.1", "links":[ { "rel":"self", "href":"https://{endpoint}/v2.1/" } ], "id":"v2.1", "updated":"2013-07-23T11:33:21Z", "version":"2.60", "status":"CURRENT" } ]}

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 name 否 String 智能购买组名称。 取值范围：1-64个字符，只能包含中文、字母、数字、下划线和中划线。 guarantee_plan_id 否 String 算力保障计划ID。 target_capacity 否 Integer 智能购买组目标容量。 实例数量或者CPU个数目标容量大于等于stable_capacity。竞价实例的容量为满配容量减去stable_capacity。 stable_capacity 否 Integer 按需实例目标容量。 目标容量指实例数量或CPU个数，必须小于等于target_capacity，智能购买组中可以没有按需实例。 excess_fulfilled_capacity_behavior 否 String 超过目标容量或目标容量减少时的实例中断行为。 terminate：释放 noTermination：不释放 默认值：terminate instances_behavior_with_expiration 否 String 请求到期时正在运行实例的中断行为。 terminate：释放 noTermination：不释放 默认值：terminate spot_price 否 Double 用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格，可以使用该价格。

请求示例 修改指定智能购买组信息，包括名称、算力保障计划ID、目标容量、按需实例目标容量等。 PUT https://{endpoint}/v2/{domain_id}/auto_launch_groups/{auto_launch_group_id}{ "name": "autoLaunchGroup1", "guarantee_plan_id": "plan_id", "target_capacity": 10, "stable_capacity": 5, "excess_fulfilled_capacity_behavior": "terminate", "instances_behavior_with_expiration": "terminate", "spot_price": 0.5}

响应消息 响应参数如表1所示。 表1 响应参数 参数 参数类型 描述 versions Object API版本信息列表，详情请参见表2。 表2 versions字段数据结构说明 参数 参数类型 描述 id string 所讨论的版本的通用名称，仅是信息性的，它没有真正的语义。 links Object 版本相关标记快捷链接信息，详情请参见表3。 min_version string 如果API的这个版本支持微版本，则支持最小的微版本。 如果不支持微版本，这将是空字符串。 status string API版本的状态。 CURRENT，这是使用的API的首选版本 SUPPORTED，这是一个较老的，但仍然支持的API版本。 DEPRECATED，一个被废弃的API版本，该版本将被删除。 version string 如果API的这个版本支持微版本，则支持最大的微版本。 如果不支持微版本，这将是空字符串。 updated string 一个有特定值的字符串。 API版本为2.0时，值为2011-01-21T11:33:21Z，API版本是2.1时，值为 2013-07-23T11:33:21Z。 表3 links字段数据结构说明 参数 参数类型 描述 href string 相应资源的链接。 rel string self：自助链接包含版本链接的资源。立即链接后使用这些链接。 bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。 alternate：备用链接可以包含资源的替换表示形式。 例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。

响应示例 { "security_group": { "rules": [], "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "id": "81f1d23b-b1e2-42cd-bdee-359b4a065a42", "name": "test-sg", "description": "desc-sg" }}

响应示例 { "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19", "links": [ { "href": "http://openstack.example.com/v2/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19", "rel": "self" }, { "href": "http://openstack.example.com/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19", "rel": "bookmark" } ], "name": "new-server-test" } ]}

URI GET /v2.1/{project_id}/servers?changes-since={changes-since}&image={image}&flavor={flavor}&name={name}&status={status}&limit={limit}&marker={marker}¬-tags={not-tags}&reservation_id={reservation_id}&ip={ip} 参数说明请参见表1。 表1 路径参数 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。

响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 servers Array of objects 查询云服务器信息列表，请参见表4。 servers_links Array of objects 分页查询时，查询下一页数据链接，详情请参见表5 表4 servers字段数据结构说明 参数 参数类型 描述 name String 云服务器名称。 id String 云服务器唯一标识。 links Array of objects 云服务器相关快捷链接信息，详情请参见表5。 表5 servers_links，links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 href String 对应快捷链接。