Solicitudes de grabaciones de vídeo

Solicitudes de API para recuperar las URL de descarga y eliminar las grabaciones de vídeo de ejecución de trabajos y elementos de cola.

Cuando la grabación de vídeo está habilitada, las ejecuciones unattended pueden producir grabaciones de vídeo que se almacenan en depósitos de almacenamiento del sistema. Estas solicitudes te permiten recuperar las URL de descarga de tiempo limitado para las grabaciones de un trabajo o elemento de cola y eliminarlas.

Importante:

Estos puntos finales requieren que la grabación de vídeo esté habilitada para que se configuren los depósitos de tenant y almacenamiento. Si la grabación de vídeo no está habilitada, las solicitudes devuelven un error.

Las URL de descarga devueltas por las solicitudes read son URL SAS (firma de acceso compartido) de tiempo limitado que apuntan directamente a cada archivo de grabación. No es necesario conocer los nombres de los archivos, la respuesta contiene una URL lista para usar por grabación. Descarga la grabación emitiendo una solicitud GET a cada Uri devuelto.

Permisos necesarios

Solicitud	Permisos
Obtener URL de descarga de grabación de trabajos	Jobs.View y ExecutionMedia.View
Eliminar grabaciones de trabajos	Jobs.Delete y ExecutionMedia.Delete
Obtener las URL de descarga de grabación de artículos en cola	Jobs.View, Queues.View y ExecutionMedia.View
Eliminar grabaciones de artículos en cola	Queues.Delete y ExecutionMedia.Delete

Obtener las URL de descarga para las grabaciones de un trabajo

Esta solicitud GET devuelve las URL de descarga de todas las grabaciones asociadas a un trabajo. El trabajo se identifica por su {jobKey}, que es el campo GUID Key del trabajo (no el numérico Id). Puedes recuperar el Key de un trabajo de las solicitudes de trabajos, por ejemplo, GET /odata/Jobs?$filter=Id eq 125161 devuelve el Key.

Punto final de API

Obtener

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/api/VideoRecording/jobs/{jobKey}/read

Solicitar encabezados.

Clave	Valor
Autorización	Portador {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Código de respuesta

200 OK

Cuerpo de respuesta

[
    {
        "Uri": "https://{storage-account}.blob.core.windows.net/orchestrator/.../recording_1.mp4?sv=2023-01-03&se=2026-06-24T12%3A30%3A00Z&sr=b&sp=r&sig=...",
        "Verb": "GET",
        "RequiresAuth": false,
        "Headers": null
    }
]

Nota:

Un trabajo puede tener como máximo 10 archivos de grabación. Cada Uri es válido durante un tiempo limitado; solicitar las URL de nuevo si caducan. Para las grabaciones servidas a través del mecanismo SAS integrado de Orchestrator, la extensión del archivo se adjunta a la URL como un parámetro de consulta &type= para que puedas determinar el tipo de archivo.

Eliminar las grabaciones de un trabajo

Esta solicitud DELETE elimina todos los archivos de grabación asociados a un trabajo, identificado por su GUID {jobKey}.

Punto final de API

Eliminar

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/api/VideoRecording/jobs/{jobKey}

Solicitar encabezados.

Clave	Valor
Autorización	Portador {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Código de respuesta

209 Sin contenido

Obtener las URL de descarga para las grabaciones de un elemento de cola

Esta solicitud GET devuelve las URL de descarga de todas las grabaciones asociadas a un elemento de cola, identificado por su número {queueItemId}.

Punto final de API

Obtener

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/api/VideoRecording/QueueItems/{queueItemId}/Read

Solicitar encabezados.

Clave	Valor
Autorización	Portador {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Código de respuesta

200 OK

Cuerpo de respuesta

[
    {
        "Uri": "https://{storage-account}.blob.core.windows.net/orchestrator/.../recording_1.mp4?sv=2023-01-03&se=2026-06-24T12%3A30%3A00Z&sr=b&sp=r&sig=...",
        "Verb": "GET",
        "RequiresAuth": false,
        "Headers": null
    }
]

Eliminar las grabaciones de un elemento de la cola

Esta solicitud DELETE elimina todos los archivos de grabación asociados con un elemento de cola, identificado por su número {queueItemId}.

Punto final de API

Eliminar

{AutomationCloudURL}/{organizationName}/{tenantName}/orchestrator_/api/VideoRecording/QueueItems/{queueItemId}

Solicitar encabezados.

Clave	Valor
Autorización	Portador {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Código de respuesta

209 Sin contenido