更新时间：2026-09-01 GMT+08:00

查询特性集快照版本 - ShowSnapshotsVersion

功能介绍

查询项目下所有的特性集快照版本列表。

调用方法

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
codeartsreq:featureSet:getBaseline	Read	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

GET /v1/ipdprojectservice/projects/{project_id}/snapshots/version

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目32位ID，项目唯一标识。通过查询IPD项目列表获取，响应消息体中的id字段的值就是项目ID。约束限制：不涉及。取值范围： 32个字符，由英文字母和数字组成。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及。取值范围： 10~32768个字符。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
status	String	参数解释：返回状态。取值范围： success：查询特性集快照版本成功 error：查询特性集快照版本失败
message	String	参数解释：返回消息。取值范围：不涉及。
result	Array of SnapshotsTitleVO objects	参数解释：特性集快照版本列表数据。

表4 SnapshotsTitleVO
参数	参数类型	描述
id	String	参数解释：特性集快照版本ID。可以通过查询特性集快照版本获取，响应消息体中的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个字符的数字字符串。

表5 UserEntity
参数	参数类型	描述
id	String	参数解释：用户ID，可通过查询项目成员列表接口获取，响应消息体中的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	请求失败的响应。例如无操作权限、项目不存在。

错误码

请参见错误码。

父主题： IPD特性/特性集管理