Requests - Update Requests Request Name
按请求名称更新符号请求。
PATCH https://artifacts.dev.azure.com/{organization}/_apis/symbol/requests?requestName={requestName}&api-version=7.1
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 组织的名称。 |
api-version
|
query | True |
string |
要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。 |
request
|
query | True |
string |
符号请求名称。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
createdBy |
string (uuid) |
创建此项的用户的 ID。 自选。 |
createdDate |
string (date-time) |
创建此项的日期时间。 自选。 |
description |
string |
一个面向人的可选描述。 |
domainId |
此请求所在的域 ID。 此属性不应为 null。 |
|
expirationDate |
string (date-time) |
请求的可选到期日期。 无论请求的状态如何,请求都将变得不可访问,并在日期后被删除。 在 HTTP POST 上,如果过期日期为 null/缺失,服务器将分配默认过期数据(除非在帐户级别在注册表中重写 30 天)。 在 PATCH 上,如果到期日期为 null/缺失,则行为是不更改请求的当前到期日期。 |
id |
string |
此项的标识符。 自选。 |
isChunked |
boolean |
指示请求是否应为区块删除 |
name |
string |
请求的面向人类的名称。 POST 上必需,在 PATCH 上被忽略。 |
size |
integer (int64) |
此请求的总大小。 |
status |
此请求的状态。 |
|
storageETag |
string |
用于与服务器端存储的版本同步的不透明 ETag。 自选。 |
url |
string |
可用于以原始格式检索此项目的 URI。 自选。 请注意,这与派生资源中存在的其他 URI 不同。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
已成功更新由请求名称指定的符号请求。 |
|
404 Not Found |
找不到请求名称指定的符号请求。 |
|
Other Status Codes |
由于服务器端冲突(对于 exmaple)不匹配的 etag,无法更新由请求名称指定的符号请求。 |
安全性
oauth2
类型:
oauth2
流向:
accessCode
授权 URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL:
https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
作用域
名称 | 说明 |
---|---|
vso.symbols_write | 授予读取和写入符号的能力。 |
定义
名称 | 说明 |
---|---|
IDomain |
|
Request |
符号请求。 |
Request |
此请求的状态。 |
IDomainId
Request
符号请求。
名称 | 类型 | 说明 |
---|---|---|
createdBy |
string (uuid) |
创建此项的用户的 ID。 自选。 |
createdDate |
string (date-time) |
创建此项的日期时间。 自选。 |
description |
string |
一个面向人的可选描述。 |
domainId |
此请求所在的域 ID。 此属性不应为 null。 |
|
expirationDate |
string (date-time) |
请求的可选到期日期。 无论请求的状态如何,请求都将变得不可访问,并在日期后被删除。 在 HTTP POST 上,如果过期日期为 null/缺失,服务器将分配默认过期数据(除非在帐户级别在注册表中重写 30 天)。 在 PATCH 上,如果到期日期为 null/缺失,则行为是不更改请求的当前到期日期。 |
id |
string |
此项的标识符。 自选。 |
isChunked |
boolean |
指示请求是否应为区块删除 |
name |
string |
请求的面向人类的名称。 POST 上必需,在 PATCH 上被忽略。 |
size |
integer (int64) |
此请求的总大小。 |
status |
此请求的状态。 |
|
storageETag |
string |
用于与服务器端存储的版本同步的不透明 ETag。 自选。 |
url |
string |
可用于以原始格式检索此项目的 URI。 自选。 请注意,这与派生资源中存在的其他 URI 不同。 |
RequestStatus
此请求的状态。
值 | 说明 |
---|---|
created |
请求已创建,并且已打开以接受调试条目。 |
none |
此请求的状态在当前上下文中未定义或无关。 |
sealed |
请求已密封。 无法再向其中添加调试条目。 |
unavailable |
请求不再可用,可能已删除。 |