Requests - Create Requests Request Id Debug Entries

Referencia

Servicio:: Symbol

Versión de la API:: 7.1

Cree entradas de depuración para una solicitud de símbolos, tal y como especifica su identificador.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	Nombre de la organización de Azure DevOps.
requestId	path	True	string	Identificador de solicitud de símbolo.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1" para usar esta versión de la API.
collection	query	True	string	Un nombre de colección de entradas de depuración válido. Debe ser "debugentries".

Cuerpo de la solicitud

Nombre	Tipo	Description
createBehavior	DebugEntryCreateBehavior	Define qué hacer cuando ya existe una entrada de depuración en el lote.
debugEntries	DebugEntry[]	Entradas de depuración.
proofNodes	string[]	Nodos de prueba serializados, que se usan para comprobar las cargas en el lado servidor para Chunk Dedup DebugEntry

Respuestas

Nombre	Tipo	Description
200 OK	DebugEntry[]	Se crearon correctamente entradas de depuración para la solicitud especificada.
400 Bad Request	DebugEntry[]	No se pudieron crear entradas de depuración, ya que no se reconoce el comportamiento de creación especificado.
Other Status Codes	DebugEntry[]	No se pudieron crear entradas de depuración, ya que ya existe al menos una entrada y el comportamiento de creación especificado es ThrowIfExists.

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre	Description
vso.symbols_write	Concede la capacidad de leer y escribir símbolos.

Ejemplos

Solicitud de ejemplo

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"
}

Respuesta de muestra

status code:: 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"
}

Definiciones

Nombre	Description
DebugEntry	Un objeto de datos de doble propósito, el cliente usa la entrada de depuración para publicar el archivo de símbolos (con el identificador de blob del archivo, que se puede calcular a partir del algoritmo hash de VSTS) o consultar el archivo (con una clave de cliente). Dado que el servidor de símbolos intenta devolver un archivo de símbolos coincidente con el nivel de información más rico, es posible que no siempre apunte al mismo archivo de símbolos para consultas diferentes con la misma clave de cliente.
DebugEntryCreateBatch	Lote de entrada de depuración que se va a crear.
DebugEntryCreateBehavior	Define qué hacer cuando ya existe una entrada de depuración en el lote.
DebugEntryStatus	Estado de la entrada de depuración.
DebugInformationLevel	El nivel de información que contiene esta entrada de depuración.
IDomainId
JsonBlobBlockHash	Hash de BlobBlock con formato que se va a deserializar para el servicio de símbolos.
JsonBlobIdentifier
JsonBlobIdentifierWithBlocks	BlobIdentifier con hash de bloques con formato de deserializado para el servicio de símbolos.

DebugEntry

Object

Un objeto de datos de doble propósito, el cliente usa la entrada de depuración para publicar el archivo de símbolos (con el identificador de blob del archivo, que se puede calcular a partir del algoritmo hash de VSTS) o consultar el archivo (con una clave de cliente). Dado que el servidor de símbolos intenta devolver un archivo de símbolos coincidente con el nivel de información más rico, es posible que no siempre apunte al mismo archivo de símbolos para consultas diferentes con la misma clave de cliente.

Nombre	Tipo	Description
blobDetails	JsonBlobIdentifierWithBlocks	Detalles del blob con formato que se va a deserializar para el servicio de símbolos.
blobIdentifier	JsonBlobIdentifier	Identificador de blob del archivo de símbolos que se va a cargar en esta entrada de depuración. Esta propiedad se usa principalmente durante la creación de la entrada de depuración (a.k.a. publicación de símbolos) para permitir que el servidor consulte la existencia del blob.
blobUri	string	Identificador URI para obtener el archivo de símbolos. Proporcionado por el servidor, el URI contiene información de autenticación y es fácilmente accesible mediante solicitud HTTP GET sin formato. Se recomienda que el cliente recupere el archivo tan pronto como pueda, ya que el URI expirará en un breve período.
clientKey	string	Una clave que usa el cliente (depurador, por ejemplo) para buscar la entrada de depuración. Tenga en cuenta que no es único para cada archivo de símbolos diferente, ya que no distingue entre los que solo difieren según el nivel de información.
createdBy	string (uuid)	Identificador del usuario que creó este elemento. Opcional.
createdDate	string (date-time)	Fecha y hora en que se crea este elemento. Opcional.
domainId	IDomainId	Identificador de dominio donde reside este elemento debugEntry. Esta propiedad no debe ser null.
id	string	Identificador de este elemento. Opcional.
informationLevel	DebugInformationLevel	El nivel de información que contiene esta entrada de depuración.
requestId	string	Identificador de la solicitud de símbolo a la que pertenece esta entrada de depuración.
size	integer (int64)	Tamaño de la entrada de depuración.
status	DebugEntryStatus	Estado de la entrada de depuración.
storageETag	string	ETag opaco que se usa para sincronizar con la versión almacenada al final del servidor. Opcional.
url	string	Un URI que se puede usar para recuperar este elemento en su formato sin formato. Opcional. Tenga en cuenta que se distingue de otros URI que están presentes en un recurso derivado.

DebugEntryCreateBatch

Object

Lote de entrada de depuración que se va a crear.

Nombre	Tipo	Description
createBehavior	DebugEntryCreateBehavior	Define qué hacer cuando ya existe una entrada de depuración en el lote.
debugEntries	DebugEntry[]	Entradas de depuración.
proofNodes	string[]	Nodos de prueba serializados, que se usan para comprobar las cargas en el lado servidor para Chunk Dedup DebugEntry

DebugEntryCreateBehavior

Enumeración

Define qué hacer cuando ya existe una entrada de depuración en el lote.

Valor	Description
overwriteIfExists	Sobrescriba la entrada de depuración existente.
skipIfExists	No agregue esta entrada de depuración. El resto del lote, si existe, no se ve afectado.
throwIfExists	Inicie excepciones al final del servidor. Esto se traducirá a 409 (conflicto) código de estado HTTP.

DebugEntryStatus

Enumeración

Estado de la entrada de depuración.

Valor	Description
blobMissing	Falta el archivo de símbolos de la entrada de depuración solicitada.
created	La entrada de depuración se crea y lee para usarla.
none	El estado de esta entrada de depuración es indefinido o irrelevante en el contexto actual.

DebugInformationLevel

Enumeración

El nivel de información que contiene esta entrada de depuración.

Valor	Description
binary	Si se establece, el archivo .pdb contiene información de depuración que es binaria.
globalSymbols	Si se establece, el archivo .pdb contiene información de símbolos.
lineNumbers	Si se establece, el archivo .pdb contiene información de número de línea.
none	Si se establece, el archivo .pdb no contiene información de depuración.
private	Si se establece, el archivo .pdb contiene símbolos públicos y tiene información de tipo, número de línea e símbolo.
publics	Si se establece, el archivo .pdb contiene símbolos públicos.
sourceIndexed	Si se establece, el archivo .pdb admite el servidor de origen.
traceFormatPresent	Si se establece, el archivo .pdb contiene el formato de seguimiento.
typeInfo	Si se establece, el archivo .pdb contiene información de tipo.

IDomainId

Object

JsonBlobBlockHash

Object

Hash de BlobBlock con formato que se va a deserializar para el servicio de símbolos.

Nombre	Tipo	Description
hashBytes	string[] (byte)	Matriz de bytes hash.

JsonBlobIdentifier

Object

Nombre	Tipo	Description
identifierValue	string[] (byte)

JsonBlobIdentifierWithBlocks

Object

BlobIdentifier con hash de bloques con formato de deserializado para el servicio de símbolos.

Nombre	Tipo	Description
blockHashes	JsonBlobBlockHash[]	Lista de hashes de bloques de blobs.
identifierValue	string[] (byte)	Matriz de bytes blobId.

Compartir a través de

Requests - Create Requests Request Id Debug Entries

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Solicitud de ejemplo

Respuesta de muestra

Definiciones

DebugEntry

DebugEntryCreateBatch

DebugEntryCreateBehavior

DebugEntryStatus

DebugInformationLevel

IDomainId

JsonBlobBlockHash

JsonBlobIdentifier

JsonBlobIdentifierWithBlocks