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。

requestName
query True

string

符号请求名称。

请求正文

名称 类型 说明
createdBy

string (uuid)

创建此项的用户的 ID。 自选。

createdDate

string (date-time)

创建此项的日期时间。 自选。

description

string

一个面向人的可选描述。

domainId

IDomainId

此请求所在的域 ID。 此属性不应为 null。

expirationDate

string (date-time)

请求的可选到期日期。 无论请求的状态如何,请求都将变得不可访问,并在日期后被删除。 在 HTTP POST 上,如果过期日期为 null/缺失,服务器将分配默认过期数据(除非在帐户级别在注册表中重写 30 天)。 在 PATCH 上,如果到期日期为 null/缺失,则行为是不更改请求的当前到期日期。

id

string

此项的标识符。 自选。

isChunked

boolean

指示请求是否应为区块删除

name

string

请求的面向人类的名称。 POST 上必需,在 PATCH 上被忽略。

size

integer (int64)

此请求的总大小。

status

RequestStatus

此请求的状态。

storageETag

string

用于与服务器端存储的版本同步的不透明 ETag。 自选。

url

string

可用于以原始格式检索此项目的 URI。 自选。 请注意,这与派生资源中存在的其他 URI 不同。

响应

名称 类型 说明
200 OK

Request

已成功更新由请求名称指定的符号请求。

404 Not Found

Request

找不到请求名称指定的符号请求。

Other Status Codes

Request

由于服务器端冲突(对于 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 授予读取和写入符号的能力。

定义

名称 说明
IDomainId
Request

符号请求。

RequestStatus

此请求的状态。

IDomainId

Request

符号请求。

名称 类型 说明
createdBy

string (uuid)

创建此项的用户的 ID。 自选。

createdDate

string (date-time)

创建此项的日期时间。 自选。

description

string

一个面向人的可选描述。

domainId

IDomainId

此请求所在的域 ID。 此属性不应为 null。

expirationDate

string (date-time)

请求的可选到期日期。 无论请求的状态如何,请求都将变得不可访问,并在日期后被删除。 在 HTTP POST 上,如果过期日期为 null/缺失,服务器将分配默认过期数据(除非在帐户级别在注册表中重写 30 天)。 在 PATCH 上,如果到期日期为 null/缺失,则行为是不更改请求的当前到期日期。

id

string

此项的标识符。 自选。

isChunked

boolean

指示请求是否应为区块删除

name

string

请求的面向人类的名称。 POST 上必需,在 PATCH 上被忽略。

size

integer (int64)

此请求的总大小。

status

RequestStatus

此请求的状态。

storageETag

string

用于与服务器端存储的版本同步的不透明 ETag。 自选。

url

string

可用于以原始格式检索此项目的 URI。 自选。 请注意,这与派生资源中存在的其他 URI 不同。

RequestStatus

此请求的状态。

说明
created

请求已创建,并且已打开以接受调试条目。

none

此请求的状态在当前上下文中未定义或无关。

sealed

请求已密封。 无法再向其中添加调试条目。

unavailable

请求不再可用,可能已删除。