Requests - Create Requests Request Id Debug Entries

参考

服务:: Symbol

API 版本:: 7.1

为其标识符指定的符号请求创建调试条目。

POST https://artifacts.dev.azure.com/{organization}/_apis/symbol/requests/{requestId}?collection={collection}&api-version=7.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
requestId	path	True	string	符号请求标识符。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1”才能使用此版本的 API。
collection	query	True	string	有效的调试项集合名称。必须是“debugentries”。

请求正文

名称	类型	说明
createBehavior	DebugEntryCreateBehavior	定义当批处理中的调试条目已存在时要执行的作。
debugEntries	DebugEntry[]	调试条目。
proofNodes	string[]	序列化的 Proof 节点，用于验证区块 Dedup DebugEntry 的服务器端上传

响应

名称	类型	说明
200 OK	DebugEntry[]	已成功为指定的请求创建调试条目。
400 Bad Request	DebugEntry[]	无法创建调试条目，因为无法识别指定的创建行为。
Other Status Codes	DebugEntry[]	无法创建调试条目，因为至少有一个条目已存在，指定的创建行为为 ThrowIfExists。

安全性

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	授予读取和写入符号的能力。

示例

示例请求

HTTP

POST https://artifacts.dev.azure.com/fabrikam/_apis/symbol/requests/9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37?api-version=7.1

{
  "blobIdentifier": {
    "identifierValue": "cZSUgWLJKRZmXuaLhvXo9NRdb2Be9Ek64KVv2qsz8jYA"
  },
  "clientKey": "symbol.exe/557a1d8ee000/symbol.exe",
  "informationLevel": "binary"
}

示例响应

状态代码:: 201

{
  "blobIdentifier": {
    "identifierValue": "cZSUgWLJKRZmXuaLhvXo9NRdb2Be9Ek64KVv2qsz8jYA"
  },
  "blobUri": "https://fabrikam.blob.core.windows.net/b-22ed989c337948c0a3e3ab4910ff3c94/7194948162C92916665EE68B86F5E8F4D45D6F605EF4493AE0A56FDAAB33F23600.blob?sas",
  "clientKey": "symbol.exe/557a1d8ee000/symbol.exe",
  "informationLevel": "binary",
  "requestId": "9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37",
  "status": "created",
  "createdBy": "00030000CA16C4DA@Live.com",
  "createdDate": "2015-07-17T20:14:52",
  "id": "symbol.exe/557a1d8ee000/symbol.exe/00000001",
  "storageETag": "W/\"datetime'2015-07-17T20%3A14%3A52.4410239Z'\"",
  "url": "https://artifacts.dev.azure.com/fabrikam/_apis/Symbol/requests/9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37/debugentries/symbol.exe/557a1d8ee000/symbol.exe/00000001"
}

定义

名称	说明
DebugEntry	客户端使用双用途数据对象发布符号文件（使用文件的 Blob 标识符（可从 VSTS 哈希算法计算）或查询文件（使用客户端密钥）。由于符号服务器尝试返回具有最丰富信息级别的匹配符号文件，因此对于具有相同客户端密钥的不同查询，它可能不会始终指向相同的符号文件。
DebugEntryCreateBatch	要创建的一批调试条目。
DebugEntryCreateBehavior	定义当批处理中的调试条目已存在时要执行的作。
DebugEntryStatus	调试条目的状态。
DebugInformationLevel	此调试项包含的信息级别。
IDomainId
JsonBlobBlockHash	BlobBlock 哈希格式设置为对符号服务进行反序列化。
JsonBlobIdentifier
JsonBlobIdentifierWithBlocks	BlobIdentifier，其块哈希格式设置为对符号服务进行反序列化。

DebugEntry

Object

客户端使用双用途数据对象发布符号文件（使用文件的 Blob 标识符（可从 VSTS 哈希算法计算）或查询文件（使用客户端密钥）。由于符号服务器尝试返回具有最丰富信息级别的匹配符号文件，因此对于具有相同客户端密钥的不同查询，它可能不会始终指向相同的符号文件。

名称	类型	说明
blobDetails	JsonBlobIdentifierWithBlocks	为符号服务反序列化的 blob 的详细信息。
blobIdentifier	JsonBlobIdentifier	要上传到此调试条目的符号文件的 blob 标识符。此属性主要用于在创建调试项（a.k.a.符号发布）期间使用，以允许服务器查询 blob 是否存在。
blobUri	string	用于获取符号文件的 URI。由服务器提供，URI 包含身份验证信息，可通过普通 HTTP GET 请求轻松访问。建议客户端尽快检索文件，因为 URI 将在短时间内过期。
clientKey	string	客户端（例如调试器）用于查找调试项的密钥。请注意，它对于每个不同的符号文件并不唯一，因为它不区分仅因信息级别而异的符号文件。
createdBy	string (uuid)	创建此项的用户的 ID。自选。
createdDate	string (date-time)	创建此项的日期时间。自选。
domainId	IDomainId	此 debugEntry 所在的域 ID。此属性不应为 null。
id	string	此项的标识符。自选。
informationLevel	DebugInformationLevel	此调试项包含的信息级别。
requestId	string	此调试项所属的符号请求的标识符。
size	integer (int64)	调试项的大小。
status	DebugEntryStatus	调试条目的状态。
storageETag	string	用于与服务器端存储的版本同步的不透明 ETag。自选。
url	string	可用于以原始格式检索此项目的 URI。自选。请注意，这与派生资源中存在的其他 URI 不同。

DebugEntryCreateBatch

Object

要创建的一批调试条目。

名称	类型	说明
createBehavior	DebugEntryCreateBehavior	定义当批处理中的调试条目已存在时要执行的作。
debugEntries	DebugEntry[]	调试条目。
proofNodes	string[]	序列化的 Proof 节点，用于验证区块 Dedup DebugEntry 的服务器端上传

DebugEntryCreateBehavior

枚举

定义当批处理中的调试条目已存在时要执行的作。

值	说明
overwriteIfExists	覆盖现有的调试条目。
skipIfExists	不要添加此调试项。批处理的其余部分（如果有）不会受到影响。
throwIfExists	在服务器端引发异常。这将转换为 409 （冲突） HTTP 状态代码。

DebugEntryStatus

枚举

调试条目的状态。

值	说明
blobMissing	缺少所请求的调试条目的符号文件。
created	将创建并读取要使用的调试项。
none	此调试条目的状态在当前上下文中未定义或无关。

DebugInformationLevel

枚举

此调试项包含的信息级别。

值	说明
binary	如果设置，.pdb 文件包含二进制的调试信息。
globalSymbols	如果设置，.pdb 文件包含符号信息。
lineNumbers	如果设置，.pdb 文件包含行号信息。
none	如果已设置，.pdb 文件不包含调试信息。
private	如果设置，.pdb 文件包含公共符号，并且具有类型、行号和符号信息。
publics	如果设置，.pdb 文件包含公共符号。
sourceIndexed	如果已设置，.pdb 文件支持源服务器。
traceFormatPresent	如果设置，.pdb 文件包含跟踪格式。
typeInfo	如果设置，.pdb 文件包含类型信息。

IDomainId

Object

JsonBlobBlockHash

Object

BlobBlock 哈希格式设置为对符号服务进行反序列化。

名称	类型	说明
hashBytes	string[] (byte)	哈希字节数组。

JsonBlobIdentifier

Object

名称	类型	说明
identifierValue	string[] (byte)

JsonBlobIdentifierWithBlocks

Object

BlobIdentifier，其块哈希格式设置为对符号服务进行反序列化。

名称	类型	说明
blockHashes	JsonBlobBlockHash[]	Blob 块哈希的列表。
identifierValue	string[] (byte)	blobId 字节数组。

通过

Requests - Create Requests Request Id Debug Entries

URI 参数

请求正文

响应

安全性

oauth2

作用域

示例

示例请求

示例响应

定义

DebugEntry

DebugEntryCreateBatch

DebugEntryCreateBehavior

DebugEntryStatus

DebugInformationLevel

IDomainId

JsonBlobBlockHash

JsonBlobIdentifier

JsonBlobIdentifierWithBlocks

其他资源