华为云用户手册

共享磁盘的规格性能 磁盘性能的主要指标有IO读写时延、IOPS和吞吐量。 IOPS：磁盘每秒进行读写的操作次数。 吞吐量：磁盘每秒成功传送的数据量，即读取和写入的数据量。 IO读写时延：磁盘连续两次进行读写操作所需要的最小时间间隔。 不同类型磁盘的单队列访问时延（4KiB数据块大小情况下）如下： 普通IO：5 ms ~ 10 ms 高IO：1 ms ~ 3 ms 超高IO：1 ms 表1 磁盘性能数据表 参数 普通IO 高IO 超高IO 磁盘最大容量 系统盘：1024 GB 数据盘：32768 GB 系统盘：1024 GB 数据盘：32768 GB 系统盘：1024 GB 数据盘：32768 GB 最大IOPS 2200 5000 33000 最大吞吐量 90 MB/s 150 MB/s 350 MB/s IOPS突发上限 2200 5000 16000 磁盘IOPS性能计算公式 说明： 以单块超高IO磁盘为例，基线为1500 IOPS，每GB增加50 IOPS，最高为33000 IOPS。 IOPS = min (2200, 500 +2 × 容量) IOPS = min (5000, 1200 + 6 × 容量) IOPS = min (33000, 1500 + 50 × 容量) API名称 说明： 此处API名称为磁盘API接口中“volume_type”参数的取值，不代表底层存储设备的硬件类型。 SATA SAS SSD 数据持久性 99.9999999% 挂载云服务器数量 最大可同时挂载至16台云服务器

S CS I磁盘的常见使用场景和建议 SCSI磁盘：BMS仅支持使用SCSI磁盘，用作系统盘和数据盘。 SCSI共享盘：当您使用共享盘时，需要结合分布式文件系统或者集群软件使用。由于多数常见集群需要使用SCSI锁，例如Windows MSCS集群、Veritas VCS集群和CFS集群，因此建议您结合SCSI使用共享盘。 如果将SCSI共享盘挂载至ECS时，需要结合云服务器组的反亲和性一同使用，SCSI锁才会生效。

什么是磁盘模式 根据是否支持高级的SCSI命令来划分磁盘模式，分为VBD(虚拟块存储设备 , Virtual Block Device)类型和SCSI (小型计算机系统接口, Small Computer System Interface) 类型。 VBD类型：磁盘模式默认为VBD类型。VBD类型的磁盘只支持简单的SCSI读写命令。 SCSI类型：SCSI类型的磁盘支持SCSI指令透传，允许云服务器操作系统直接访问底层存储介质。除了简单的SCSI读写命令，SCSI类型的磁盘还可以支持更高级的SCSI命令。 磁盘模式在购买磁盘时配置，购买完成后无法修改。

ECS支持的磁盘模式 ECS支持的磁盘模式由规格类型决定，同时，还与ECS所属的操作场景相关。 表1 ECS支持的磁盘模式 操作场景 磁盘模式（系统盘） 磁盘模式（数据盘） 购买ECS时 通用计算增强型C7：SCSI。 内存优化型M7：SCSI。 含“physical” 附加标识的裸金属类型：SCSI。 其余规格类型：VBD。 通用计算增强型C7：SCSI。 内存优化型M7：SCSI。 含“physical” 附加标识的裸金属类型：SCSI。 其余规格类型：VBD或SCSI。 为已购买ECS挂载磁盘时 不涉及 通用计算增强型C7：VBD或SCSI。 内存优化型M7：VBD或SCSI。 含“physical” 附加标识的裸金属类型：SCSI。 其余规格类型：VBD或SCSI。

功能特点 规格丰富 高IO：高性能、高扩展、高可靠，适用于性能相对较高，读写速率要求高，有实时数据存储需求的应用场景。 超高IO：低时延、高性能，适用于低时延，高读写速率要求，数据密集型应用场景。 弹性扩展 按需扩容：可根据业务需求扩容存储池。 性能线性增长：支持在线扩容DSS下的磁盘，并且性能线性增长，满足业务需求。 安全可靠 三副本冗余：数据持久性高达99.9999999%。 数据加密 ：系统盘和数据盘均支持数据加密，保护数据安全。 备份恢复 云备份服务：可为专属分布式存储下的磁盘创建备份，利用备份数据回滚磁盘，最大限度保障您数据的安全性和正确性，确保业务安全。

专属分布式存储服务与云硬盘的区别 表1 DSS与EVS的区别 服务名称 总体介绍 存储类别 典型应用场景 性能规格 专属分布式存储服务 专属分布式存储服务为用户提供独享的物理存储资源，存储池资源物理隔离，数据持久性高达99.9999999%，可同时对接多种不同类型的计算服务，如ECS、BMS、DCC等，功能丰富、安全可靠。 存储池物理隔离，资源独享，专属存储。 对接专属云中的ECS、BMS等计算服务 对接非专属云中的ECS、BMS等计算服务 混合负载，专属分布式存储可同时支持HPC、数据库、Email、OA办公、Web等多个应用混合部署 高性能计算 OLAP应用 高IO： 起步规格13.6TB，扩容步长13.6TB，最大可扩容至435.2TB，最大IOPS为1500 IOPS/TB。 超高IO： 起步规格7.225TB，扩容步长7.225TB，最大可扩容至289TB，最大IOPS为8000 IOPS/TB。 云硬盘 云硬盘可以为云服务器提供高可靠、高性能、规格丰富并且可弹性扩展的块存储服务。 共享存储池资源 企业日常办公应用 开发测试 企业应用，例如SAP、Microsoft Exchange和Microsoft SharePoint等 分布式文件系统 各类数据库，例如：MongoDB、Oracle、SQL Server、MySQL和PostgreSQL等 云硬盘支持按需扩容，最小扩容步长为1GB，单个磁盘可由10GB扩展至32TB。 图2 DSS与EVS的区别

修订记录 发布日期 修订记录 2019-03-30 第五次发布。 新增权限管理章节。 2018-12-30 第四次发布。 增加专属分布式存储服务功能特点介绍。 增加专属分布式存储服务与其他服务的关系示意图。 2018-05-30 第三次发布。 该服务名称变更为“专属分布式存储服务”。 2018-02-03 第二次发布。 更新存储池类型及性能介绍中的存储池性能数据。 2017-11-30 第一次发布。

DSS权限 默认情况下，管理员创建的 IAM 用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 DSS部署时通过物理区域划分，为项目级服务，需要在各区域（如华北-北京四）对应的项目（cn-north-4）中设置策略，并且该策略仅对此项目生效，如果需要所有区域都生效，则需要在所有项目都设置策略。访问DSS时，需要先切换至授权区域。 权限根据授权精程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对ECS服务，管理员能够控制IAM用户仅能对某一类云服务器资源进行指定的管理操作。多数细粒度策略以API接口为粒度进行权限拆分，DSS支持的API授权项请参见策略及授权项说明。 如表1所示，包括了DSS的所有系统权限。 表1 DSS系统权限 策略名称 描述 策略类别 依赖关系 DSS FullAccess 专属分布式存储的所有权限，具有专属分布式存储资源的创建、扩容、查询等操作权限。 系统策略 无 DSS ReadOnlyAccess 专属分布式存储的只读权限，只有专属分布式存储资源的查询权限。 系统策略 无 表2列出了专属分布式存储服务（DSS）常用操作与系统策略的授权关系，您可以参照该表选择合适的系统策略。 表2 常用操作与系统策略的关系 操作 DSS FullAccess DSS ReadOnlyAccess 创建存储池 √ × 查询存储池 √ √ 扩容存储池 √ × 扩容磁盘 √ × 创建磁盘 √ × 查询磁盘 √ √ 卸载磁盘 √ × 删除磁盘 √ ×

与其他服务的关系 专属分布式存储服务与其他服务的关系，具体如图1所示。 图1 专属分布式存储服务与其他服务的关系示意图 表1 与其他服务的关系 交互功能 相关服务 位置 相关服务可以使用专属分布式存储服务下的磁盘以及对磁盘进行相关操作 弹性云服务器（ECS，Elastic Cloud Server） 购买并登录Linux弹性云服务器 裸金属服务器（BMS，Bare Metal Server） 创建裸金属服务器、挂载磁盘 云备份（CBR，Cloud Backup and Recovery） 创建云备份 数据加密服务（DEW，Data Encryption Workshop） 创建密钥 《数据加密服务用户指南》中的“创建密钥”章节。

约束与限制 本章节介绍磁盘的约束与限制。 表1 磁盘使用约束限制 场景 限制项 限制说明 创建磁盘 磁盘模式 磁盘的磁盘模式在创建完成后不支持更改。 共享盘 磁盘的共享属性在创建完成后不支持更改。 加密磁盘 磁盘的加密属性在创建完成后不支持更改。 挂载磁盘 非共享盘可同时挂载的云服务器数量 1台 共享盘可同时挂载的云服务器数量 16台 扩容磁盘 扩容磁盘 支持扩大磁盘容量，不支持缩小磁盘容量。 扩容非共享盘 部分云服务器操作系统支持非共享盘处于“正在使用”状态扩容。 扩容共享盘 扩容时必须从云服务器卸载，共享盘处于“可用”状态扩容。 扩容步长 1GB 卸载磁盘 卸载系统盘 系统盘目前支持离线卸载，即云服务器处于“关机”状态，才可以卸载系统盘。 卸载数据盘 数据盘支持离线或者在线卸载，即云服务器处于“关机”或“运行中”状态进行卸载。 删除磁盘 - 当磁盘状态为“可用”、“错误”、“扩容失败”和“恢复数据失败”时，才可以删除磁盘。 对于共享盘，必须卸载所有的挂载点之后才可以删除。 磁盘容量 单个系统盘最大支持容量 高IO：1024 GB 超高IO：1024 GB 单个数据盘最大支持容量 高IO：32768 GB 超高IO：32768 GB MBR磁盘分区形式支持的磁盘最大容量 2 TB GPT磁盘分区形式支持的磁盘最大容量 18 EB

三副本技术怎样实现数据快速重建？ 存储系统的每个物理磁盘上都保存了多个数据块，这些数据块的副本按照一定的策略分散存储在集群中的不同节点上。当存储系统检测到硬件（服务器或者物理磁盘）发生故障时，会自动启动数据修复。由于数据块的副本分散存储在不同的节点上，数据修复时，将会在不同的节点上同时启动数据重建，每个节点上只需重建一小部分数据，多个节点并行工作，有效避免了单个节点重建大量数据所产生的性能瓶颈，将对上层业务的影响做到最小化。 数据重建流程如图2所示。 图2 数据自动重建流程 数据重建原理如图3所示，例如当集群中的服务器F硬件发生故障时，物理磁盘上的数据块会在其他节点的磁盘上并行重建恢复。 图3 数据重建原理

三副本技术怎样确保数据一致性？ 数据一致性表示当应用成功写入一份数据到存储系统时，存储系统中的3个数据副本必须一致。当应用无论通过哪个副本再次读取这些数据时，该副本上的数据和之前写入的数据都是一致的。 专属分布式存储三副本技术主要通过以下机制确保数据一致性： 写入数据时，同时在3个副本执行写入操作 当应用写入数据时，存储系统会同步对3个副本执行写入数据的操作，并且只有当多个副本的数据都写入完成时，才会向应用返回数据写入成功的响应。 读取数据失败时，自动修复损坏的副本 当应用读数据失败时，存储系统会判断错误类型。如果是物理磁盘扇区读取错误，则存储系统会自动从其他节点保存的副本中读取数据，然后在物理磁盘扇区错误的节点上重新写入数据，从而保证数据副本总数不减少以及副本数据一致性。

什么是三副本技术？ 专属分布式存储的存储系统采用三副本机制来保证数据的可靠性，即针对某份数据，默认将数据分为1 MB大小的数据块，每一个数据块被复制为3个副本，然后按照一定的分布式存储算法将这些副本保存在集群中的不同节点上。 专属分布式存储三副本技术的主要特点如下： 存储系统自动确保3个数据副本分布在不同机柜的不同服务器的不同物理磁盘上，单个硬件设备的故障不会影响业务。 存储系统确保3个数据副本之间的数据强一致性。 例如，对于服务器A的物理磁盘A上的数据块P1，系统将它的数据备份为服务器B的物理磁盘B上的P1''和服务器C的物理磁盘C上的P1'，P1、P1'和P1''共同构成了同一个数据块的三个副本。若P1所在的物理磁盘发生故障，则P1'和P1''可以继续提供存储服务，确保业务不受影响。 图1 数据块存储示意图

什么是区域、可用区？ 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

如何选择区域？ 选择区域时，您需要考虑以下几个因素： 地理位置 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。 在除中国大陆以外的亚太地区有业务的用户，可以选择“中国-香港”、“亚太-曼谷”或“亚太-新加坡”区域。 在非洲地区有业务的用户，可以选择“非洲-约翰内斯堡”区域。 在拉丁美洲地区有业务的用户，可以选择“拉美-圣地亚哥”区域。 “拉美-圣地亚哥”区域位于智利。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。

请求示例 PUT https://{endpoint}/v1/planservice/projects/526cefde62004de2b62b5e8dd2c2b3af/plans/123456789012345678/status { "operate" : "move", "move_to_sprint_id" : "12345678901234567890123456789012" }

URI PUT /v1/planservice/projects/{project_id}/plans/{plan_id}/status 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释：项目的32位uuid，项目唯一标识，可以通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID 约束限制：正则表达式，^[A-Za-z0-9]{32}$ 默认取值：不涉及 plan_id 是 String 参数解释：发布/迭代唯一Id。可以通过IPD项目计划管理章节中的发布/迭代计划列表查询接口获取，响应消息体中的id字段的值就是发布/迭代Id 约束限制：正则表达式，^([0-9]{18,19})$ 默认取值：不涉及

响应示例 状态码：200 OK { "status" : "success", "message" : "查询成功", "result" : [ { "id" : "956200745322848257", "title" : "IR-01", "category" : "PI", "description" : "描述", "state" : "正在工作", "status" : "ended", "children" : [ { "id" : "956239067176935424", "title" : "子迭代", "category" : "Iteration", "description" : "子迭代描述", "state" : "正在工作", "status" : "going", "children" : [ ], "created_by" : "a360371833bf4c558f796fd707b44daf", "modified_by" : "a360371833bf4c558f796fd707b44daf", "plan_start_date" : 1706845715000, "plan_end_date" : 1706845715000, "created_date" : 1706845715000, "parent_id" : "956200745322848257", "baseline" : "baselined", "workload" : "10h", "owner" : "a360371833bf4c558f796fd707b44daf" } ], "created_by" : "a360371833bf4c558f796fd707b44daf", "modified_by" : "a360371833bf4c558f796fd707b44daf", "plan_start_date" : 1706845715000, "plan_end_date" : 1706845715000, "created_date" : 1706845715000, "parent_id" : "", "baseline" : "baselined", "workload" : "20h", "owner" : "a360371833bf4c558f796fd707b44daf" } ] } 状态码：400 Bad Request { "status" : "error", "message" : "错误信息描述，例如参数错误等", "error_code" : "具体错误码，可根据业务定义", "error_description" : "更详细的错误说明" }

请求示例 POST https://{endpoint}/v1/ipdprojectservice/projects/gdbdf969b32694524a949b5ef6b3e124a/issues/956239067176935400/attachments/upload ------WebKitFormBoundary1kuNerRnRVVybt65 Content-Disposition: form-data; name="attachment"; filename="demo.PNG" Content-Type: image/png

URI POST /v1/ipdprojectservice/projects/{project_id}/issues/{issue_id}/attachments/upload 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID 约束限制： 正则表达式，[A-Za-z0-9]{32} 取值范围： 不涉及 默认取值： 不涉及 issue_id 是 String 参数解释：工作项唯一Id。可以通过[查询工作项列表]或者[查询树状工作]接口获取，响应消息体中的id字段的值就是工作项ID 约束限制：正则表达式，^([0-9]{18,19})$ 默认取值：不涉及

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 status String 参数解释： 状态 取值范围： 不涉及 message String 参数解释： 失败信息 取值范围： 不涉及 result Array of AttachmentVoExt objects 参数解释： 附件上传信息 表4 AttachmentVoExt 参数 参数类型 描述 progress Integer 参数解释： 上传进度 取值范围： 不涉及 id String 参数解释： 附件Id 取值范围： 不涉及 workitem_id String 参数解释： 工作项Id 取值范围： 不涉及 filesize Long 参数解释： 文件大小 取值范围： 不涉及 store_filename String 参数解释： 文件存储名 取值范围： 不涉及 title String 参数解释： 文件名 取值范围： 不涉及

响应示例 状态码：200 OK { "status" : "success", "message" : "计划创建成功", "result" : { "id" : "123e4567e89b12d3a456426614174000", "title" : "项目里程碑1", "category" : "PlanMilestone", "description" : "这是项目的一个重要里程碑", "state" : "正在工作", "status" : "planned", "children" : [ { "id" : "123e4567e89b12d3a456426614174000", "title" : "迭代1", "category" : "Iteration", "description" : "迭代1的描述", "state" : "正在工作", "status" : "planned", "children" : [ ], "created_by" : "user1", "modified_by" : "user1", "plan_start_date" : 1633072800000, "plan_end_date" : 1635751200000, "created_date" : 1633072800000, "parent_id" : "123e4567e89b12d3a456426614174000", "baseline" : "unbaseline", "workload" : "10人天", "owner" : "user2" } ], "created_by" : "admin", "modified_by" : "admin", "plan_start_date" : 1630466400000, "plan_end_date" : 1633072800000, "created_date" : 1630466400000, "parent_id" : null, "baseline" : "unbaseline", "workload" : "20人天", "owner" : "user1" } } 状态码：400 错误信息 { "error_msg" : "Invalid project_id or other parameters", "error_code" : "AS.0001" }

请求示例 新建发布 POST https://{endpoint}/v1/planservice/projects/2a0d6799fe0d48b29ab8710be556d461/plans { "title" : "plan_0731_1", "category" : "PI", "plan_end_date" : "2025-01-20", "plan_start_date" : "2025-02-01" } 新建迭代 https://{endpoint}/v1/planservice/projects/2a0d6799fe0d48b29ab8710be556d461/plans { "title" : "iteration_0731_1", "category" : "Iteration", "plan_end_date" : "2025-01-20", "plan_start_date" : "2025-02-01", "parent_id" : "1088833093706829825" }

URI POST /v1/planservice/projects/{project_id}/plans 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释：项目的32位uuid，项目唯一标识，可以通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID 约束限制：正则表达式，^[A-Za-z0-9]{32}$ 默认取值：不涉及

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String 状态信息 message String 提示信息 result PlanVO object 创建的计划返回值 表5 PlanVO 参数 参数类型 描述 id String 参数解释： id（发布、迭代、里程碑的id） 取值范围： 不涉及 title String 参数解释： 标题 取值范围： 不涉及 category String 参数解释： 分类，枚举 PI（发布） Iteration（迭代） PlanMilestone（里程碑） 取值范围： PI，Iteration，PlanMilestone description String 参数解释： 描述 取值范围： 不涉及 state String 参数解释： 作废标识（可选值有：正在工作、作废、删除） 取值范围： 正在工作、作废、删除 status String 参数解释： 状态，枚举 planned（未开始） going（进行中） ended（已完成） 取值范围： planned，going，ended children Array of PlanVO objects 参数解释： 子项目迭代信息 created_by String 参数解释： 创建人 取值范围： 不涉及 modified_by String 参数解释： 更新人 取值范围： 不涉及 plan_start_date Long 参数解释： 计划开始时间，unix时间戳，单位：毫秒 取值范围： 不涉及 plan_end_date Long 参数解释： 计划完成时间，unix时间戳，单位：毫秒 取值范围： 不涉及 created_date Long 参数解释： 创建时间，unix时间戳，单位：毫秒 取值范围： 不涉及 parent_id String 参数解释： 父工作项id 取值范围： 不涉及 baseline String 参数解释： 基线状态，枚举 baselined（已基线） unbaseline（未基线） baseline-reviewing（基线评审中） 取值范围： baselined，unbaseline，baseline-reviewing workload String 参数解释： 预估工作量 取值范围： 不涉及 owner String 参数解释： 责任人ID 取值范围： 不涉及 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 x-auth-token 是 String 参数解释：用户token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) 约束限制：不涉及 取值范围：最小长度10，最大长度：32768 默认取值：不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 id 否 String 参数解释： id（发布、迭代、里程碑的id） 取值范围： 不涉及 title 否 String 参数解释： 标题 取值范围： 不涉及 category 否 String 参数解释： 分类，枚举 PI（发布） Iteration（迭代） PlanMilestone（里程碑） 取值范围： PI，Iteration，PlanMilestone description 否 String 参数解释： 描述 取值范围： 不涉及 status 否 String 参数解释： 状态，枚举 planned（未开始） going（进行中） ended（已完成） 取值范围： planned，going，ended children 否 Array of PlanVO objects 参数解释： 子项目迭代信息 modified_by 否 String 参数解释： 更新人 取值范围： 不涉及 plan_start_date 否 Long 参数解释： 计划开始时间，unix时间戳，单位：毫秒 取值范围： 不涉及 plan_end_date 否 Long 参数解释： 计划完成时间，unix时间戳，单位：毫秒 取值范围： 不涉及 created_date 否 Long 参数解释： 创建时间，unix时间戳，单位：毫秒 取值范围： 不涉及 parent_id 否 String 参数解释： 父工作项id 取值范围： 不涉及 baseline 否 String 参数解释： 基线状态，枚举 baselined（已基线） unbaseline（未基线） baseline-reviewing（基线评审中） 取值范围： baselined，unbaseline，baseline-reviewing workload 否 String 参数解释： 预估工作量 取值范围： 不涉及 owner 否 String 参数解释： 责任人ID 取值范围： 不涉及

URI POST /v1/ipdprojectservice/projects/{project_id}/issues 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释： 项目的32位uuid，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID 约束限制： 正则表达式，[A-Za-z0-9]{32} 取值范围： 不涉及 默认取值： 不涉及

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 title 是 String 工作项名称 description 是 String 描述信息 status 否 String 状态["Committed", "Analyse", "ToBeConfirmed", "Plan", "Doing", "Delivered", "Checking"] src_domain 否 String 提出项目domainId submitted_by 否 String 提交人Id domain_id 否 String 归属项目domainId recipient 否 Array of strings 承接人id expect_delivery_time 否 Long 期望完成时间 priority 否 String 优先级 assigned_cc 否 Array of strings 抄送人id category 是 String 工作项分类：[Epic,FE,IR,RR,SR,US,AR,Bug,Task] assignee 是 String 责任人 plan_pi 否 String 发布计划id plan_iteration 否 String 迭代计划id plan_start_date 否 Long 计划开始时间 plan_end_date 否 Long 计划结束时间 workload_man_day 否 Integer 计划工时 business_domain 否 String 领域 need_break 否 String 是否需要分解

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 status String 参数解释： 状态信息 取值范围： 不涉及 message String 参数解释： 提示信息 取值范围： 不涉及 result Array of PlanVO objects 参数解释： 计划列表 page page object 参数解释： 计划列表页表 表5 PlanVO 参数 参数类型 描述 id String 参数解释： id（发布、迭代、里程碑的id） 取值范围： 不涉及 title String 参数解释： 标题 取值范围： 不涉及 category String 参数解释： 分类，枚举 PI（发布） Iteration（迭代） PlanMilestone（里程碑） 取值范围： PI，Iteration，PlanMilestone description String 参数解释： 描述 取值范围： 不涉及 state String 参数解释： 作废标识（可选值有：正在工作、作废、删除） 取值范围： 正在工作、作废、删除 status String 参数解释： 状态，枚举 planned（未开始） going（进行中） ended（已完成） 取值范围： planned，going，ended children Array of PlanVO objects 参数解释： 子项目迭代信息 created_by String 参数解释： 创建人 取值范围： 不涉及 modified_by String 参数解释： 更新人 取值范围： 不涉及 plan_start_date Long 参数解释： 计划开始时间，unix时间戳，单位：毫秒 取值范围： 不涉及 plan_end_date Long 参数解释： 计划完成时间，unix时间戳，单位：毫秒 取值范围： 不涉及 created_date Long 参数解释： 创建时间，unix时间戳，单位：毫秒 取值范围： 不涉及 parent_id String 参数解释： 父工作项id 取值范围： 不涉及 baseline String 参数解释： 基线状态，枚举 baselined（已基线） unbaseline（未基线） baseline-reviewing（基线评审中） 取值范围： baselined，unbaseline，baseline-reviewing workload String 参数解释： 预估工作量 取值范围： 不涉及 owner String 参数解释： 责任人ID 取值范围： 不涉及 表6 page 参数 参数类型 描述 page Integer 参数解释： 页码 取值范围： 不涉及 size Integer 参数解释： 分页数量 取值范围： 不涉及 count Integer 参数解释： 当前页数量 取值范围： 不涉及 状态码：400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

URI GET /v1/planservice/projects/{project_id}/plans/query 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释：项目的32位uuid，项目唯一标识，可以通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID 约束限制：正则表达式，^[A-Za-z0-9]{32}$ 默认取值：不涉及 表2 Query参数 参数 是否必选 参数类型 描述 key_word 是 String 参数解释： 发布/迭代名称 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 updated_time_interval 是 String 参数解释： 更新发布/迭代时间，unix时间戳，单位：毫秒 样例：1576114296000,1576114396000 约束限制： 正则表达式，([1-9][0-9]{0,12})?(,)?([1-9][0-9]{0,12})? 取值范围： 不涉及 默认取值： 不涉及