Compartir a través de

Logs - Create

  • Referencia
Servicio:
Distributed Task
Versión de la API:
7.1

Cree un registro y conéctelo al plan de ejecución de una canalización.

POST https://dev.azure.com/{organization}/{scopeIdentifier}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/logs?api-version=7.1

Parámetros de identificador URI

Nombre En Requerido Tipo Description
hubName
 path True

string

Nombre del centro de servidores. Ejemplos comunes: "build", "rm", "checks"
organization
 path True

string

Nombre de la organización de Azure DevOps.
planId
 path True

string (uuid)

Identificador del plan.
scopeIdentifier
 path True

string (uuid)

GUID del proyecto para definir el ámbito de la solicitud
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.

Cuerpo de la solicitud

Nombre Tipo Description
createdOn

string (date-time)

Hora de creación del registro de tareas.
id

integer (int32)

Identificador del registro de tareas.
indexLocation

string

Dirección URL de REST del registro de tareas cuando se indizará.
lastChangedOn

string (date-time)

Hora de la última modificación del registro de tareas.
lineCount

integer (int64)

Número de líneas de registro de tareas.
location

string

Dirección URL de REST del registro de tareas.
path

string

Ruta de acceso del registro de tareas.

Respuestas

Nombre Tipo Description
200 OK

TaskLog

operación correcta

Seguridad

accessToken

Token de acceso personal. Use cualquier valor para el nombre de usuario y el token como contraseña.

Tipo: basic

Ejemplos

Create a log

Solicitud de ejemplo

POST https://dev.azure.com/{organization}/{scopeIdentifier}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/logs?api-version=7.1

{
  "path": "logs\\5e6d5dbf-ac69-5f56-8b85-8e9038703a8b",
  "createdOn": "0001-01-01T00:00:00",
  "lastChangedOn": "0001-01-01T00:00:00",
  "id": 0,
  "location": null
}

Respuesta de muestra

status code:
200 
{
  "path": "logs\\5e6d5dbf-ac69-5f56-8b85-8e9038703a8b",
  "lineCount": 49,
  "createdOn": "2022-12-02T09:33:14.873Z",
  "lastChangedOn": "2022-12-02T09:50:19.033Z",
  "id": 3,
  "location": null
}

Definiciones

TaskLog

Object

Un registro de tareas conectado a un registro de escala de tiempo.

Nombre Tipo Description
createdOn

string (date-time)

Hora de creación del registro de tareas.
id

integer (int32)

Identificador del registro de tareas.
indexLocation

string

Dirección URL de REST del registro de tareas cuando se indizará.
lastChangedOn

string (date-time)

Hora de la última modificación del registro de tareas.
lineCount

integer (int64)

Número de líneas de registro de tareas.
location

string

Dirección URL de REST del registro de tareas.
path

string

Ruta de acceso del registro de tareas.