# 查询特性集快照版本 - ShowSnapshotsVersion #### 功能介绍 查询项目下所有的特性集快照版本列表。 #### 调用方法 请参见[如何调用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:getBaseline | Read | - | - codeartsreq:Model - codeartsreq:ProjectId | - | - | #### URI GET /v1/ipdprojectservice/projects/{project_id}/snapshots/version 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 用户Token。通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制**： 不涉及。 **取值范围**： 10\~32768个字符。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**： 返回状态。 **取值范围**： - success：查询特性集快照版本成功 - error：查询特性集快照版本失败 | | message | String | **参数解释**： 返回消息。 **取值范围**： 不涉及。 | | result | Array of [SnapshotsTitleVO] objects | **参数解释**： 特性集快照版本列表数据。 | 表4SnapshotsTitleVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 特性集快照版本ID。可以通过[查询特性集快照版本](https://support.huaweicloud.com/api-projectman/ShowSnapshotsVersion.html)获取，响应消息体中的**id**字段的值就是快照版本ID。 **取值范围**： 18\~19个字符的数字字符串。 | | title | String | **参数解释**： 特性集快照版本标题，用于标识和区分不同快照版本。 **取值范围**： 0\~512个字符。 | | created_by | [UserEntity] object | **参数解释**： 快照版本创建人信息，包含用户ID、用户名称和昵称。 | | modified_by | [UserEntity] object | **参数解释**： 快照版本最近修改人信息，包含用户ID、用户名称和昵称。 | | created_date | String | **参数解释**： 快照版本创建时间戳。 **取值范围**： 13\~14个字符的数字字符串。 | | modified_date | String | **参数解释**： 快照版本最新修改时间戳。 **取值范围**： 13\~14个字符的数字字符串。 | 表5UserEntity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释**： 用户ID，可通过[查询项目成员列表](https://support.huaweicloud.com/api-projectman/ListProjectUsers.html)接口获取，响应消息体中的**id**字段的值就是用户ID。 **取值范围**： 不涉及。 | | name | String | **参数解释**： 用户名称。 **取值范围**： 2\~64个字符。 | | nick_name | String | **参数解释**： 用户昵称。 **取值范围**： 2\~30个字符。 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 | #### 请求示例 查询项目下所有的特性集版本快照版本 ``` GET https://{endpoint}/v1/ipdprojectservice/projects/b7262b36cfa84b09a27f7896e1fdefc6/snapshots/version ``` #### 响应示例 **状态码：200** 查询特性集快照版本成功 ``` { "status" : "success", "message" : null, "result" : [ { "id" : "981644868612829184", "title" : "1-2-1快照", "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711971974000", "modified_date" : "1711971974000" }, { "id" : "981645326705139713", "title" : "1-2-2快照", "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1711972083000", "modified_date" : "1711972083000" }, { "id" : "982005155140513792", "title" : "等同于当前版本", "created_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "modified_by" : { "id" : "a360371833bf4c558f796fd707b44daf", "name" : "devcloud_devcloud_01", "nick_name" : "测试账号" }, "created_date" : "1712057873000", "modified_date" : "1712057873000" } ] } ``` **状态码：400** 请求失败的响应。例如无操作权限、项目不存在。 ``` { "error_code" : "PM.02174103", "error_msg" : "无操作权限" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询特性集快照版本成功 | | 400 | 请求失败的响应。例如无操作权限、项目不存在。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。