Compartir a través de


Requests - Get Requests Request Id

Obtenga una solicitud de símbolo por identificador de solicitud.

GET https://artifacts.dev.azure.com/{organization}/_apis/symbol/requests/{requestId}?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.

Respuestas

Nombre Tipo Description
200 OK

Request

Recuperó correctamente la solicitud de símbolo según lo especificado por el identificador de solicitud.

404 Not Found

Request

No se encontró la solicitud de símbolo especificada por el identificador de solicitud.

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 Concede la capacidad de leer símbolos.

Ejemplos

Solicitud de ejemplo

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

Respuesta de muestra

{
  "description": "A sample request to demonstrate the Symbol Experience",
  "expirationDate": "2015-08-16T20:14:39",
  "name": "My Sample Request",
  "status": "sealed",
  "createdBy": "00030000CA16C4DA@Live.com",
  "createdDate": "2015-07-17T20:14:39",
  "id": "9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37",
  "storageETag": "W/\"datetime'2015-07-17T20%3A15%3A24.7522129Z'\"",
  "url": "https://artifacts.dev.azure.com/fabrikam/_apis/Symbol/requests/9dc380b5c295c03188108014a73574987cdef9a4edce00b01c9ec2d05fa97c37"
}

Definiciones

Nombre Description
IDomainId
Request

Solicitud de símbolo.

RequestStatus

Estado de esta solicitud.

IDomainId

Request

Solicitud de símbolo.

Nombre Tipo Description
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.

description

string

Descripción opcional orientada a personas.

domainId

IDomainId

Identificador de dominio donde reside esta solicitud. Esta propiedad no debe ser null.

expirationDate

string (date-time)

Una fecha de expiración opcional para la solicitud. La solicitud será inaccesible y se eliminará después de la fecha, independientemente de su estado. En un HTTP POST, si la fecha de expiración es nula o falta, el servidor asignará los datos de expiración predeterminados (30 días a menos que se invalide en el registro en el nivel de cuenta). En PATCH, si la fecha de expiración es nula o falta, el comportamiento es no cambiar la fecha de expiración actual de la solicitud.

id

string

Identificador de este elemento. Opcional.

isChunked

boolean

Indica si la solicitud debe desaplicarse por fragmentos.

name

string

Nombre orientado a personas para la solicitud. Obligatorio en POST, omitido en PATCH.

size

integer (int64)

Tamaño total de esta solicitud.

status

RequestStatus

Estado de esta solicitud.

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.

RequestStatus

Estado de esta solicitud.

Valor Description
created

La solicitud se crea y está abierta para aceptar entradas de depuración.

none

El estado de esta solicitud es indefinido o irrelevante en el contexto actual.

sealed

La solicitud está sellada. No se pueden agregar más entradas de depuración.

unavailable

La solicitud ya no está disponible, posiblemente eliminada.