华为云用户手册

参考文档 《Scrum精髓》，Kenneth S. Rubin 《用户故事与敏捷方法》，Mike Cohn 2019年中国DevOps行业现状报告：中国信息通信研究院、华为云DevCloud、南京大学联合发布 《用户故事实战》，Mike Cohn 《成为技术领导者》，杰拉尔德·温伯格 《复盘+：把经验转化为能力》，邱昭良 Scrum指南（2017-Scrum-Guide-Chinese-Simplified），2017年11月版 Kenneth S. Rubin. Scrum精髓[M].北京：清华大学出版社 Scrum指南2007版 Mark C. Layton. 敏捷项目管理[M].北京：人民邮电出版社 Should Team Member Sign Up for Tasks During Sprint Planning？ Lyssa Adkins. 如何构建敏捷项目管理团队[M].北京：电子工业出版社 父主题： 附录

方案概述 产品的核心资产就是系统特性，一旦上市系统特性就会不断的增长，Req提供产品全量系统特性管理，通过特性树可以更好管理系统特性，实现产品资产不丢失，让跨代的系统特性快速继承和发展。 某公司计划推出一款智能手表，涉及多部门、多团队的协作，需要保证不同部门（如市场营销、产品规划、研发等）都能对该款智能手表的功能特性有统一的认识，确保研发过程中的每个流程都与产品整体战略相符。本文介绍如何通过IPD系统设备类项目来模拟智能手表研发项目进行特性树管理。

操作流程 模拟案例的基本操作流程如下： 图1 基本操作流程 表1 CodeArts Req缺陷管理实践操作流程说明 流程 说明 步骤一：提交缺陷单 测试人员在环境中发现问题单后，需要在项目中进行创建并提交。 步骤二：根因定位与排期修复 开发人员接到问题单后需要对其进行根因定位和排期修复。 步骤三：回归测试与验收缺陷 开发人员将问题单修复完成后，测试人员需要对其进行回归测试，缺陷单创建人需要对其进行验收。

方案概述 在整个产品生命周期管理中，缺陷管理是非常关键的一环。无论是硬件系统还是软件开发，都难免遇到不计其数的缺陷，如果缺陷管理不善，产品质量势必大打折扣。华为基于多年沉淀的质量运营管理经验，打造出一套行之有效的缺陷管理优秀实践，为团队提供统一、高效、风险可视的缺陷跟踪平台，确保每一个缺陷都被高质高效闭环。 某公司计划推出一款智能手表，研发周期较长，研发过程涉及多个部门、多团队的协作，如何保证缺陷在多个组织间的流转、最终达到有效闭环呢？本文介绍如何通过IPD系统设备类项目来模拟智能手表研发项目进行缺陷管理。

跟踪项目状态 每日站立会议跟踪任务进度。 迭代开始后，项目组通过每日站立会议沟通每个工作项的当前进展，并对工作项状态进行更新。 使用卡片模式能够简单直观的查看迭代中各工作项的当前状态。 进入“迭代”页面，单击图标，切换到卡片模式。页面中展示了处于每种状态下的工作项卡片，通过拖拽工作项卡片即可更新其状态。 迭代评审会议验收迭代成果。 在到达迭代的预计结束时间前，项目组召开迭代评审会议，展示当前迭代的工作成果。 “迭代”页面提供了迭代统计图表，团队可以方便的统计当前迭代的进度情况，包括需求完成情况、迭代燃尽图、工作量等。 进入“迭代”页面，单击“统计”，即可展开迭代进度视图。

方案概述 成功产品的核心特征是满足客户需求，客户需求是企业发展的原动力。CodeArts Req打破了传统需求管理工具仅在研发阶段发挥作用的限制，将客户与市场需求也同步覆盖，提供了完整的客户需求采集、价值需求决策、交付与验收流程，让需求进展和动态客户实时透明，市场需求流动提速70%。 在CodeArts Req的原始需求管理中，用户可以将客户诉求提交至目标组织，目标组织对需求进行决策、分析、交付及后续验收流程全程实时透明化，可以加速客户诉求的交付速率，提升产品在市场上的竞争力。本文介绍如何通过IPD系统设备类项目来模拟智能手表研发项目进行原始需求管理。

操作流程 模拟案例的基本操作流程如下： 图1 基本操作流程 表1 CodeArts Req原始需求管理实践操作流程说明 流程 说明 步骤一：新建原始需求 将客户诉求转化成原始需求在项目中进行新建跟踪。 步骤二：决策原始需求 原始需求的分析责任人对需求进行分析决策。 步骤三：研发与交付原始需求 原始需求关联的子需求在开发交付时，也就是原始需求的在研和交付。 步骤四：验收原始需求 原始需求交付完成后，需要需求提出人对其进行验收。

解决措施 综合前面几种参考情况经分析后得出了根因，基于这些根因，可以将所要解决的问题重新描述如下： 如何进行需求结构化管理？ 如何进行需求优先级管理？ 如何避免重要需求遗漏？ 如何进行需求结构化管理？ 首先，并不是说任何情况下都需要进行需求的结构化管理。只有在需求较多、且需求之间存在关联，而且即便是已经实现的需求也需要进行一定的管理、维护的情况下，才需要去思考需求结构化管理的问题，此时，团队需要使用CodeArts提供的Scrum项目模板，因为里面有Epic-Feature-Story的需求结构，以及需求规划功能可以辅助团队进行需求的结构化管理。那么团队应该以什么为脉络来建立这个结构呢？这就意味着，团队的需求结构化管理，需要以产品或系统的功能特性的脉络为依据。而软件项目管理所需要关注的版本、客户、模块等信息，则可以通过需求的不同属性甚至标签等方式来实现。 简单来说，可以通过如下三个步骤来完成： 针对产品或系统建立CodeArts项目。 确立Epic-Feature-Story的需求结构。 对不同模块以及版本的管理，可以通过工作项的属性来进行管理。 更多详情请参考如何进行需求结构化管理。

什么是Epic、Feature、Story和Task？ Epic、Feature、Story和Task用来划分需求颗粒度的标签，可以看作需求占位符，分别代表需求颗粒度从大到小。每个层级的需求本身又承载着一些意义，在进行需求划分的时候可以进行参考。 Epic：史诗，是项目的愿景目标。通过Epic的落地达成，使公司可以获得相应的市场地位和回报，具有战略价值。通常需要数月完成。 Feature：可以带来价值的产品功能和特性。相比Epic，Feature更具体，更形象，客户可以感知，具有业务价值。通常需要数周，多个Sprint才能够完成。 Story：通常所说的用户故事，是User Story的简称。Story是从用户角度对产品功能的详细描述，承接Feature，并放入产品Backlog中，持续规划，滚动调整，始终让高优先级Story交付给客户，具有用户价值。Story要符合INVEST原则（Idependent、Negotiable、Valuable、Estimable、Small、Testable），通常需要数天，并在一个Sprint中完成。 Task：是团队成员要完成的具体任务。在Sprint计划会议上，将Story分配给成员，然后由成员分解为Task，并预估工时，通常在一天内完成。

如何灵活使用这些概念，让需求管理更为高效？ 为了加深对Epic、Feature、Story和Task的理解，本文对一个案例进行需求拆分，过程中会结合CodeArts需求管理服务进行展示。 案例： 某大型商超受互联网的冲击，营业额大幅下滑。 为了减少门店消费者流失，保有市场地位和份额，决定用6个月的时间建立自己的网上商城。 第一步：Epic确定和创建 根据前面的介绍，在进行需求确认的时候先看颗粒度，然后再考虑其承载意义。 此处需要考虑一个问题：一个产品是一个Epic吗？产品的每个业务模块是Epic还是Feature？ 产品通常具有战略意义，从这个角度看，产品适合作为一个Epic。但是不是所有的产品都适合，还要看产品是什么，它的颗粒度有多大。在本文的实例中，网上商城周期是6个月，目的是保有市场份额，从颗粒度和战略意义上，网上商城适合作为一个Epic。 每个业务模块具体是Epic还是Feature要分情况。比如：构建智慧城市是一个愿景目标，下面包括智慧交通、智慧政务、智慧社区等，这些每个业务模块都很大，用Epic进行需求占位合适一些。 在CodeArts创建一个Scrum项目，命名为“某大型商超网上商城”。进入“需求规划”界面，新建Epic： 图2 新建Epic 新建之后，单击进入到详细编辑界面。将描述信息填写完整，可以使用CodeArts提供的模板： 作为：对于这个Epic来说，用户角色是整个公司。 我想要：想要的结果就是建造网上商城。 以便于：目的是想要减少消费者流失，保有市场地位和份额。 同时在基本信息中设定这个Epic的起止时间、优先级、重要程度、预计工时等信息。这些信息对于团队理解产品、理解项目起到至关重要的作用，所以要进行详细填写。 图3 编写Epic 第二步：将Epic分解为Feature 客户要求在6个月内交付5个功能模块：促销管理、会员管理、订单管理、配送管理和客户端。团队的一个Sprint是2个星期，每个模块大概需要2-3个Sprint完成，从颗粒度和承载的意义，这5个模块适合作为Feature。 图4 Epic分解为Feature 创建之后，如需要填写详细信息，可以在详细页面进行编辑。界面信息项和前面Epic的相同，此处不再赘述。 第三步：Feature分解为Story 敏捷开发是渐进明细的，不要求所有需求在相同时间做到同样详细，只要求当前Sprint和未来的一个或两个Sprint的Story是详细的。将来Sprint的Story可以是一个大概的情况。进入到当前Sprint的Story要符合INVEST原则。开发团队要在Sprint结束时完成交付。 客户优先级中，会员管理Feature优先级高，会员管理这个Feature就要在需求梳理会议上详细分解为Story放入到产品Backlog中。经过分解后，需要包含和管理员相关的功能：积分管理、会员级别管理、用户分析、用户管理。这些具体的功能就可以作为Story。需要注意的是，分解出的Story要尽量在一个迭代内完成交付，如果无法完成就尝试继续分解。因为只有交付的Story才是有价值的，无法交付的Story对于当前Sprint来说就是浪费。分解后的Story如图5所示。 图5 Feature分解为Story 第四步：将Story划分为Task 在Sprint计划会议上，团队和PO要共同从产品Backlog中按照优先级顺序选择本次Sprint需要完成的Story，进入到冲刺Backlog中。团队成员认领后，将Story分解为Task，并进行估算。 此时面临一个问题：Story和Task如何区分？ Story聚焦价值，需要在Sprint中完成，要用数天的时间，要符合INVEST原则。Story的描述是一个名词，如积分管理这个Story的完整描述是：作为管理员，我能够进行会员的积分管理，以此来划分消费等级提供不同增值服务。 Task聚焦实现价值，通过过程性的任务来实现Story的功能。通常是1～8个小时。Task的描述是一个动作。如积分管理这个Story，功能的实现需要通过业务逻辑开发、积分规则设计和积分数据库设计这几个过程来完成，这些就是Task。如图6所示。 图6 Story分解为Task 这样，从Epic开始，到Task结束，完成了网上商城的需求拆分。

小结 使用Epic、Feature、Story、Task管理需求时，需要注意以下几个方面： 敏捷开发中需求是逐步细化的，遵循自上而下的方式去分解需求。 Epic和Feature都是颗粒度比较大的需求，是用户对于产品的期望和功能特性的描述。 分解为Story的时候，目前正在进行的Sprint需要分得更小更细，将来的Sprint需求（可能是3个及以上）就不需要那样细分。当进行到某个Sprint时，再进行分解，细分成一组更小、更细的条目。 Task是对当前Sprint的Story进行的分解。 所有这些粗略和详细的Story都放在产品Backlog中，整个列表要遵循DEEP（Detailed appropriately、Emergent、Estimated、Prioritized）原则，定期梳理和排序优化，保证高优先级的需求优先实现和交付。 在整个过程中需要和客户一直保持沟通合作，这样才能保证实现的功能是客户真正想要的。

方案概述 产品从规划到上市要经过复杂的研发过程，CodeArts Req提供了基线评审和变更管理能力，实现需求基线-受控变更-变更评审-变更管理的过程化管理，让基线变更如门禁一样，达到阈值才能启动下一步，确保产品研发“做正确的事”。 某公司计划推出一款智能手表，涉及多部门、多团队的协作，且已经过前期的多轮需求沟通与澄清，将研发需求分配到各产研团队。为保障产品如期保质交付，需要确保不同研发生产团队都忠实执行任务，按照既定的需求进行研发落地。这时就需要对需求进行基线管控，基线后的需求不允许随意更改。本文介绍如何通过IPD系统设备类项目来模拟智能手表研发项目进行基线评审管理。

方案架构 “凤凰商城”示例程序架构 “凤凰商城”示例程序的架构图如图2所示。 图2 凤凰商城技术架构图 示例程序由表1中的5个可以独立开发、测试和部署的微服务组件构成。 表1 凤凰商城微服务组件表 微服务组件 说明 Web用户端服务器（对应样例代码中的“Vote”功能） 业务逻辑：用户可以通过浏览器访问此服务的WebUI。当用户在特定商品上单击“Like”时，服务将用户所选择物品的记录保存在Redis缓存中。 技术栈：Python、Flask框架。 应用服务器：Gunicorn。 Web管理端服务器（对应样例代码中的“Result”功能） 业务逻辑：用户可以通过浏览器访问此服务的WebUI，会动态显示用户端UI上用户单击“Like”的统计数据，此数据来自PostgreSQL数据库。 技术栈：Node.js、express框架。 应用服务器：server.js。 后台订单批处理程序（对应样例代码中的“Worker”功能） 业务逻辑：此服务为后台进程，会监控Redis缓存中物品记录，并将新纪录取出并保存在PostgreSQL数据库中，以便管理端UI可以抽取数据进行统计显示。 技术栈：.net core或者Java（此服务提供两种技术栈实现了同样的功能，可根据需要修改配置选择其中一个作为运行时进程）。 订单缓存 业务逻辑：此服务作为用户端UI服务的数据持久化服务存在。 技术栈：Redis 订单数据库 业务逻辑：此服务作为管理端UI服务的数据源。 技术栈：PostgreSQL “DevOps全流程样例项目”构成 “DevOps全流程样例项目”是一个Scrum类型的模板项目，项目中预置了部分服务的使用模板。项目实践过程中涉及到的产品及服务如下表。 表2 实践涉及产品/服务列表 服务 说明 CodeArts 需求管理 预置3个已规划并已完成的迭代、项目的模块设置、以及若干统计报表。 代码托管 预置代码仓库“phoenix-sample”，存放项目示例代码。 代码检查 预置4个任务 编译构建 预置5个任务。 制品仓库 用于存储通过构建任务生成的软件包。 部署 预置3个应用。 测试计划 功能测试用例库，预置十余个测试用例。 流水线 预置5条流水线。 说明： 购买专业版或企业版CodeArts套餐的用户，创建示例项目后可见5条流水线；购买体验版或基础版CodeArts套餐的用户，创建示例项目后只可见流水线“phoenix-workflow”，升级套餐至专业版或企业版后，需重新创建示例项目才可见5条流水线。 其它组件和服务 统一身份认证 服务 用于管理账号。 容器镜像服务 用于存放构建任务生成的Docker镜像。 云容器引擎 用于软件包部署，与E CS 部署属于两种不同的部署方式。 弹性云服务器 用于软件包部署，与CCE部署属于两种不同的部署方式。

背景信息 CodeArts结合多年研发经验与业界先进的实践提出了一套可操作可落地的敏捷开发方法论：HE2E DevOps实施框架。 图1 HE2E DevOps实施框架 规划和设计 步骤①和②是业务（或者是客户）与技术之间进行产品规划，梳理产品整体脉络，以及进行产品规划实施设计，并控制需求粒度与拆分的过程。 软件开发的本质是为了解决问题，提供用户价值的，而不仅是为了提供功能。影响地图就是用来鉴别用户需求是什么，深层的根因是什么。 用户故事就是目标和需求的载体，以用户的场景来讲故事，便于在客户、业务与开发之间进行信息的传递。在这个过程中，独立的需求条目的堆积，很容易导致只能看到各个需求条目，不能从整个解决方案思考需求。用户故事以用户使用的场景为主线，将大的阶段点，及其细分的活动，以树状的结构进行梳理和展现，既可以看到独立的需求条目，又能够看到整体需求场景。 计划和跟踪、迭代开发 步骤③~⑩是Scrum框架过程，是主要的管理实践。 Scrum定义了一个相对完整的敏捷过程管理的框架。在CodeArts中，将Scrum的框架与团队日常的开发活动，很好的融合起来。主要的过程产物包括产品故事列表、迭代故事列表、潜在可交付的产品增量、以及过程中产生的问题列表；核心的团队活动包括Sprint计划会议、团队每日站会、Sprint演示会议、Sprint回顾会议等会议、以及团队的日常更新。 同时，将Kanban方法与Scrum框架进行了结合，团队借鉴Kanban方法中的精益思想，可视化价值流，发现并解决阻塞与瓶颈，加速价值流交付，并加快反馈回路，持续进行改进。 持续交付 从步骤⑪开始，进入到工程实践，也就是通常说的CI/CD过程。 持续交付以代码配置管理为基础，除了传统意义的代码资产安全与管控、多人并行开发、版本与基线管理外，也体现了团队的协作与沟通。 代码检查（即静态扫描）、自动化的构建、各阶段的自动化测试、以及相应的自动化部署过程，都被有机的串联在流水线上。 除了代码检查、构建、测试、部署等动态的阶段与活动，还有制品管理，以及各级的环境管理，包括开发环境、测试环境、准生产环境，以及生产环境。 持续交付流水线就是将整个持续交付中，都有哪些阶段，分别运行在什么环境，每个阶段执行什么活动，准入与准出的质量门禁，以及每个阶段的输入与输出的制品进行管理。

请求示例 修改ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器的名称为new-server-test。 1 PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd 12345 { "server": { "name": "new-server-test" }}

响应参数 表3 响应参数 参数 参数类型 描述 server Object 裸金属服务器信息，详情请参见表4 表4 server字段数据结构说明 参数 参数类型 描述 name String 裸金属服务器名称。 id String 裸金属服务器唯一标识。 status String 裸金属服务器当前状态。 ACTIVE：运行中/正在关机/删除中 BUILD：创建中 ERROR：故障 HARD_REBOOT：强制重启中 REBOOT：重启中 SHUTOFF：关机/正在开机/删除中/重建中/重装操作系统中/重装操作系统失败/冻结 created String 裸金属服务器创建时间。 时间戳格式为ISO 8601：YYYY-MM-DDTHH:MM:SSZ，例如：2019-05-22T03:30:52Z updated String 裸金属服务器上一次更新时间。 时间戳格式为ISO 8601：YYYY-MM-DDTHH:MM:SSZ，例如：2019-05-22T04:30:52Z flavor Object 裸金属服务器规格信息。详情请参见表5。 image Object 裸金属服务器镜像信息。详情请参见表6。 tenant_id String 裸金属服务器所属租户ID，UUID格式。 该参数和project_id表示相同的概念。 user_id String 裸金属服务器所属用户ID。 metadata Object 裸金属服务器元数据。详情请参见表7。 hostId String 裸金属服务器的主机ID。 addresses Array of address objects 裸金属服务器所属网络信息。 key：表示裸金属服务器使用的虚拟私有云的ID。 value：网络详细信息，具体请参见表9。 links Array of objects 裸金属服务器相关信息快捷链接。详情请参见表8。 accessIPv4 String 预留属性。 accessIPv6 String 预留属性。 OS-DCF:diskConfig String 扩展属性，磁盘配置方式，取值为以下两种： MANUAL：API使用镜像中的分区方案和文件系统创建裸金属服务器。如果目标flavor磁盘较大，则API不会对剩余磁盘空间进行分区。 AUTO：API使用与目标flavor磁盘大小相同的单个分区创建裸金属服务器，API会自动调整文件系统以适应整个分区。 progress Integer 预留属性。 表5 flavor字段数据结构说明 参数 参数类型 描述 id String 规格ID。 links Array of objects 规格相关信息快捷链接。详情请参见表8。 表6 image字段数据结构说明 参数 参数类型 描述 id String 裸金属服务器镜像ID。 links Array of objects 裸金属服务器镜像相关快捷链接信息。详情请参见表8。 表7 metadata字段数据结构说明 参数 参数类型 描述 用户自定义字段键值对 String metadata键、值。 键、值长度均不大于255字节。 表8 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。取值为： self：包含版本号的资源链接，需要立即跟踪时使用此类链接。 bookmark：提供了适合长期存储的资源链接。 href String 对应快捷链接。 表9 address字段数据结构说明 参数 参数类型 描述 addr String IP地址。 version String 地址对应的版本。

响应示例 1 2 3 4 5 6 7 8 9101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354 { "server": { "tenant_id": "c685484a8cc2416b97260938705deb65", "image": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319" } ], "id": "1a6635d8-afea-4f2b-abb6-27a202bad319" }, "accessIPv4": "", "addresses": { "08a7715f-7de6-4ff9-a343-95ba4209f24a": [ { "addr": "192.168.0.107", "version": 4 } ] }, "metadata": { }, "accessIPv6": "", "created": "2017-05-24T06:14:05Z", "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e", "flavor": { "links": [ { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium" } ], "id": "physical.83.medium" }, "OS-DCF:diskConfig": "MANUAL", "user_id": "1311c433dd9b408886f57d695c229cbe", "name": "new-server-test", "progress": 0, "links": [ { "rel": "self", "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" }, { "rel": "bookmark", "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd" } ], "id": "95bf2490-5428-432c-ad9b-5e3406f869dd", "updated": "2017-05-25T03:40:25Z", "status": "ACTIVE" }}

请求示例 强制重启ID为616fb98f-46ca-475e-917e-2563e5a8cd19和726fb98f-46ca-475e-917e-2563e5a8cd20的裸金属服务器。 1 POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/action 1 2 3 4 5 6 7 8 910111213 { "reboot": { "type": "HARD", "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "726fb98f-46ca-475e-917e-2563e5a8cd20" } ] }}

请求参数 重启裸金属服务器请求参数中，必须以“reboot”字段下发重启裸金属服务器请求，详见请求示例。 参数 是否必选 参数类型 描述 reboot 是 Object 标记为重启裸金属服务器操作，详情请参见表2。 表2 reboot字段数据结构说明 参数 是否必选 参数类型 描述 type 是 String 重启类型： SOFT：普通重启（不生效）。 HARD：强制重启（默认）。 servers 是 Array of objects 裸金属服务器ID列表，详情请参见表3。 表3 servers字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。

响应参数 正常响应要素 表4 正常响应要素说明 名称 参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 异常响应要素 表5 异常响应要素说明 名称 参数类型 说明 error 字典数据结构 提交任务异常时返回的异常信息，详情请参见表6。 表6 error数据结构 名称 参数类型 说明 message String 任务异常错误信息描述。 code String 任务异常错误信息编码。

响应示例 { "remote_console": { "type": "serial", "protocol": "serial", "url": "https://console.domainname.com:443/serial/pod05ironic.region-01/?token=2a794f06-15ec-4f3d-a55b-06aca8e3dcbc" }}

请求参数 参数 是否必选 参数类型 描述 remote_console 是 Object 标记为获取裸金属服务器远程登录地址。详情请参见表2。 表2 remote_console字段数据结构说明 参数 是否必选 参数类型 描述 protocol 是 String 远程登录协议，请将protocol配置为“serial”。 type 是 String 远程登录的类型，请将type配置为“serial”。

请求示例 获取ID为cf2a8b97-b5c6-47ef-9714-eb27adf26e5b的裸金属服务器的远程登录地址，远程登录协议和类型均为serial。 1 POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/remote_console { "remote_console": { "protocol": "serial", "type": "serial" }}

响应示例 1 2 3 4 5 6 7 8 9101112131415161718192021222324 { "flavor": { "name": "physical.o2.medium", "links": [ { "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium", "rel": "self" }, { "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium", "rel": "bookmark" } ], "ram": 192705, "OS-FLV-DISABLED:disabled": false, "vcpus": 24, "swap": "", "os-flavor-access:is_public": true, "rxtx_factor": 1, "OS-FLV-EXT-DATA:ephemeral": 0, "disk": 1862, "id": "physical.o2.medium" }}

响应参数 参数 参数类型 描述 flavor Object 裸金属服务器规格。详情请参见表2。 表2 flavor数据结构说明 参数 参数类型 描述 id String 裸金属服务器规格ID。 name String 裸金属服务器规格名称。 vcpus Integer 该裸金属服务器规格对应的CPU核数。 ram Integer 该裸金属服务器规格对应的内存大小，单位为MB。 disk Integer 该裸金属服务器规格对应要求磁盘大小，单位为GB。 swap String 未使用。 OS-FLV-EXT-DATA:ephemeral Integer 未使用。 OS-FLV-DISABLED:disabled Boolean 未使用。 rxtx_factor Float 未使用。 os-flavor-access:is_public Boolean 未使用。 links Array of objects 规格相关快捷链接地址。详情请参见表3。 表3 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 self：包含版本号的资源链接，需要立即跟踪时使用此类链接。 bookmark：提供了适合长期存储的资源链接。 href String 对应快捷链接。

请求示例 修改ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器的元数据，其中自定义metadata键值对为key和value。 1 PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key} 12345 { "meta": { "key": "value" }}

URI PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 key 是 待修改的裸金属服务器metadata键值。

响应示例 1 2 3 4 5 6 7 8 9101112131415 { "versions": [ { "links": [ { "rel": "self", "href": "https://192.168.82.231:443/v2/" } ], "id": "v2.0", "updated": "2018-09-21T12:33:21Z", "status": "SUPPORTED" } ]}

响应参数 参数 参数类型 描述 versions Array of objects 描述version对象的列表。 id String 版本ID（版本号），如v1。 links Array of objects API的URL地址。 href String 当前API版本的引用地址。 rel String 当前API版本和被引用地址的关系。 version String 若该版本API支持微版本，则为支持的最大微版本号；如果不支持微版本，则为空。 status String 版本状态，为如下3种： CURRENT：表示该版本为主推版本。 SUPPORTED：表示为老版本，但是现在还继续支持。 DEPRECATED：表示为废弃版本，存在后续删除的可能。 updated String 版本发布时间，要求用UTC时间表示。 例如v1发布的时间为：2014-06-28T12:20:21Z。 min_version String 若该版本API支持微版本，则为支持的最小微版本号；如果不支持微版本，则为空。

响应参数 参数 参数类型 描述 absolute Object 租户配额信息，详情请参见表2。 以下参数值为“-1”时，表示无数量限制。 表2 absolute数据结构说明 参数 参数类型 描述 maxTotalInstances Integer 裸金属服务器最大申请数量。 maxTotalCores Integer CPU核数最大申请数量。 maxTotal RAM Size Integer 内存最大申请容量（单位：MB）。 maxTotalKeypairs Integer 可以申请的SSH密钥对最大数量。 maxServerMeta Integer 可输入元数据的最大长度。 maxPersonality Integer 可注入文件的最大个数。 maxPersonalitySize Integer 注入文件内容的最大长度（单位：Byte）。 maxServerGroups Integer 服务器组的最大个数。 maxServerGroupMembers Integer 服务器组中的最大裸金属服务器数。 totalServerGroupsUsed Integer 已使用的服务器组个数。 maxSecurityGroups Integer 安全组最大使用个数。 说明： 具体配额限制请以VPC配额限制为准。 maxSecurityGroupRules Integer 安全组中安全组规则最大的配置个数。 说明： 具体配额限制请以VPC配额限制为准。 maxTotalFloatingIps Integer 最大的弹性IP使用个数。 maxImageMeta Integer 镜像元数据最大的长度。 totalInstancesUsed Integer 当前裸金属服务器使用个数。 totalCoresUsed Integer 当前已使用CPU核数。 totalRAMUsed Integer 当前内存使用容量（单位：MB）。 totalSecurityGroupsUsed Integer 当前安全组使用个数。 totalFloatingIpsUsed Integer 当前弹性IP使用个数。