更新时间:2025-07-25 GMT+08:00
分享

更改目录信息

功能介绍

更改目录信息

调用方法

请参见如何调用API

URI

PUT /v4/features/{feature_uri}

表1 路径参数

参数

是否必选

参数类型

描述

feature_uri

String

目录URI

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

comment

String

备注

name

String

名称

number

String

编号

owner

String

责任人

is_feature

String

是否为特性,1:特性 2:目录

project_id

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

status

String

success|error; ok|failed

result

ResultValueTestItemVo object

请求返回的数据

error

ApiError object

错误信息

request_id

String

由接口调用方传入,建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址

表4 ResultValueTestItemVo

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值

value

TestItemVo object

返回的数据

reason

String

业务失败的提示内容

page_size

Integer

每页展示条数

page_no

Integer

页码

has_more

Boolean

是否有更多

表5 TestItemVo

参数

参数类型

描述

uri

String

参数解释:

资源URI

取值范围:

不涉及

type

String

参数解释:

资源类型

取值范围:

不涉及

author

String

参数解释:

创建人

取值范围:

不涉及

name

String

参数解释:

名称

取值范围:

不涉及

rank

Integer

参数解释:

级别

取值范围:

不涉及

owner

String

参数解释:

责任人

取值范围:

不涉及

frequence

String

参数解释:

frequence值

取值范围:

不涉及

region

String

参数解释:

区域

取值范围:

不涉及

last_modifier

String

参数解释:

最后修改人

取值范围:

不涉及

last_modified

String

参数解释:

最后修改时间

取值范围:

不涉及

last_modified_timestamp

Long

参数解释:

修改时间时间戳

取值范围:

不涉及

last_change_time

String

参数解释:

最后变更时间

取值范围:

不涉及

version_uri

String

参数解释:

版本URI

取值范围:

不涉及

origin_uri

String

参数解释:

源资源URI

取值范围:

不涉及

parent_uri

String

参数解释:

父资源URI

取值范围:

不涉及

parent_path

String

参数解释:

父资源路径

取值范围:

不涉及

creation_version_uri

String

参数解释:

创建版本URI

取值范围:

不涉及

creation_date

String

参数解释:

创建时间

取值范围:

不涉及

creation_date_timestamp

Long

参数解释:

创建时间时间戳

取值范围:

不涉及

author_name

String

参数解释:

创建人名称

取值范围:

不涉及

comment

String

参数解释:

备注

取值范围:

不涉及

number

String

参数解释:

编号

取值范围:

不涉及

is_feature

String

参数解释:

是否特性

取值范围:

不涉及

relate_htsm

String

参数解释:

是否关联特性

取值范围:

不涉及

aw_unique_id

String

参数解释:

aw id

取值范围:

不涉及

test_mind_id

String

参数解释:

脑图id

取值范围:

不涉及

test_mind_url

String

参数解释:

脑图url

取值范围:

不涉及

project_uuid

String

参数解释:

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

取值范围:

不涉及

case_total

Integer

参数解释:

用例总数

取值范围:

不涉及

execd_total

Integer

参数解释:

执行总数

取值范围:

不涉及

is_direct_relation

Boolean

参数解释:

is_direct_relation

取值范围:

不涉及

has_child

Boolean

参数解释:

是否有子特性

取值范围:

true:是 false:否

表6 ApiError

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

put https://{endpoint}/v4/features/2dopbu6aaf

{
  "comment" : "评论2222",
  "name" : "新建目录1"
}

响应示例

状态码:200

更改目录信息返回体

{
  "status" : "success",
  "result" : {
    "value" : {
      "uri" : "2dopbu6aaf",
      "type" : "1",
      "version_uri" : "2dopbu6aaf112",
      "is_feature" : "fasle"
    }
  }
}

状态码

状态码

描述

200

更改目录信息返回体

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档