# 根据快照版本查询特性集 - ShowBaselineSnapshots #### 功能介绍 根据快照版本查询特性集 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-projectman/projectman_03_Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | codeartsreq:featureSet:list | List | - | - codeartsreq:Model - codeartsreq:ProjectId | - | - | #### URI GET /v1/ipdprojectservice/projects/{project_id}/feature-set/query 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | snapshot_version_id | 否 | String | 特性集快照版本ID，不传则查询当前版本特性集，传值则查询对应版本的特性集 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**： 返回状态。 **取值范围**： - success：响应成功 - error：响应失败 | | message | String | 消息 | | result | Array of [FeatureSetOpenApiVO] objects | 返回结果 | 表4FeatureSetOpenApiVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 特性集ID | | number | String | 编号 | | parent_id | String | 父特性集ID | | title | String | 标题 | | position_float | String | 位置信息 | | created_by | [UserEntity] object | 创建人信息 | | modified_by | [UserEntity] object | 修改人信息 | | created_date | String | **参数解释**： 特性集创建时间的时间戳。 **取值范围**： 不涉及。 | | modified_date | String | **参数解释**： 特性集修改时间的时间戳。 **取值范围**： 不涉及。 | | child_fs | Array of [FeatureSetOpenApiVO] objects | 子特性集 | 表5UserEntity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 用户ID，可通过[查询项目成员列表](https://support.huaweicloud.com/api-projectman/ListProjectUsers.html)接口获取，响应消息体中的**id**字段的值就是用户ID。 **取值范围**： 不涉及。 | | name | String | **参数解释**： 用户名称。 **取值范围**： 2\~64个字符。 | | nick_name | String | **参数解释**： 用户昵称。 **取值范围**： 2\~30个字符。 | #### 请求示例 - 查询项目b7262b36cfa84b09a27f7896e1fdefc6下快照版本981644868612829184的特性集数据 ``` GET https://{endpoint}/v1/ipdprojectservice/projects/b7262b36cfa84b09a27f7896e1fdefc6/feature-set/query?snapshot_version_id=981644868612829184 ``` - 查询项目b7262b36cfa84b09a27f7896e1fdefc6当前版本的特性集数据 ``` GET https://{endpoint}/v1/ipdprojectservice/projects/b7262b36cfa84b09a27f7896e1fdefc6/feature-set/query ``` #### 响应示例 **状态码：200** ``` { "status" : "success", "message" : null, "result" : [ { "id" : "981644262727655424", "number" : "FS20240401737948", "parent_id" : null, "title" : "mod1-min-0325-1特性树", "position_float" : 2, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711971830000", "modified_date" : "1711971830000", "child_fs" : [ { "id" : "978983008897904641", "number" : "FS20240325720621", "parent_id" : "981644262727655424", "title" : "mod1-min-0325-1 特性树", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711337337000", "modified_date" : "1711971830000", "child_fs" : [ { "id" : "981644718250041344", "number" : "FS20240401737949", "parent_id" : "978983008897904641", "title" : "1-1", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711971938000", "modified_date" : "1711971938000", "child_fs" : [ { "id" : "981847412113842176", "number" : "FS20240402738983", "parent_id" : "981644718250041344", "title" : "11", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1712020264000", "modified_date" : "1712020264000", "child_fs" : null } ] }, { "id" : "981644750294523904", "number" : "FS20240401737950", "parent_id" : "978983008897904641", "title" : "1-2", "position_float" : 2, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711971946000", "modified_date" : "1711971946000", "child_fs" : [ { "id" : "981644805718056960", "number" : "FS20240401737951", "parent_id" : "981644750294523904", "title" : "1-2-1", "position_float" : 1, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711971959000", "modified_date" : "1711971959000", "child_fs" : null }, { "id" : "981644911709302785", "number" : "FS20240401738018", "parent_id" : "981644750294523904", "title" : "1-2-2", "position_float" : 2, "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711971985000", "modified_date" : "1711972027000", "child_fs" : null } ] } ] } ] } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 根据快照版本查询特性集返回体 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。