Demandes d’enregistrements vidéo

Requêtes d'API permettant de récupérer les URL de téléchargement et de supprimer les enregistrements vidéo d'exécution de tâches et d'éléments de file d'attente.

Lorsque l'enregistrement vidéo est activé, les exécutions Unattended peuvent produire des enregistrements vidéo qui sont stockés dans des compartiments de stockage système. Ces requêtes vous permettent de récupérer des URL de téléchargement limitées dans le temps pour les enregistrements d'une tâche ou d'un élément de file d'attente, puis de les supprimer.

Important :

Ces points de terminaison nécessitent l'activation de l'enregistrement vidéo pour le locataire et la configuration des compartiments de stockage. Si l’enregistrement vidéo n’est pas activé, les requêtes renvoient une erreur.

Les URL de téléchargement renvoyées par les read requêtes sont des URL SAS (signées d'accès partagé) à durée limitée qui pointent directement vers chaque fichier d'enregistrement. Vous n’avez pas besoin de connaître les noms de fichier, la réponse contient une URL prête à l’emploi par enregistrement. Téléchargez l'enregistrement en envoyant une requête GET à chaque Uri renvoyé.

Autorisations requises

Requête (Request)	Autorisations
Obtenir les URL de téléchargement des enregistrements de tâches	Jobs.View et ExecutionMedia.View
Supprimer les enregistrements de tâches	Jobs.Delete et ExecutionMedia.Delete
Obtenir les URL de téléchargement des enregistrements d’éléments de file d’attente	Jobs.View, Queues.View et ExecutionMedia.View
Supprimer les enregistrements d’éléments de la file d’attente	Queues.Delete et ExecutionMedia.Delete

Obtenir les URL de téléchargement des enregistrements d’une tâche

Cette requête GET renvoie les URL de téléchargement de tous les enregistrements associés à une tâche. La tâche est identifiée par son {jobKey}, qui est le champ GUID Key de la tâche (et non le numérique Id). Vous pouvez récupérer la valeur Key d'une tâche à partir des requêtes Jobs (Tâches), par exemple, GET /odata/Jobs?$filter=Id eq 125161 renvoie la valeur Key.

Point de terminaison de l’API

Obtenir

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

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur {jeton_accès}
X-UIPATH-OrganizationUnitId	{Id_dossier}

Codes de réponse

200 OK

Corps de la réponse

[
    {
        "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
    }
]

Remarque :

Une tâche ne peut pas comporter plus de 10 fichiers d'enregistrement. Chaque Uri est valide pendant une durée limitée; demander à nouveau les URL si elles expirent. Pour les enregistrements servis via le mécanisme SAS intégré d'Orchestrator, l'extension de fichier est ajoutée à l'URL en tant que paramètre de requête &type= afin que vous puissiez déterminer le type de fichier.

Suppression des enregistrements d'une tâche

Cette requête DELETE supprime tous les fichiers d'enregistrement associés à une tâche, identifiés par son GUID {jobKey}.

Point de terminaison de l’API

Supprimer (Delete)

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

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur {jeton_accès}
X-UIPATH-OrganizationUnitId	{Id_dossier}

Codes de réponse

204 Aucun contenu

Récupération des URL de téléchargement des enregistrements d’un élément de file d’attente

Cette requête GET renvoie les URL de téléchargement de tous les enregistrements associés à un élément de la file d'attente, identifiés par son numérique {queueItemId}.

Point de terminaison de l’API

Obtenir

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

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur {jeton_accès}
X-UIPATH-OrganizationUnitId	{Id_dossier}

Codes de réponse

200 OK

Corps de la réponse

[
    {
        "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
    }
]

Supprimer les enregistrements d'un élément de file d'attente

Cette requête DELETE supprime tous les fichiers d'enregistrement associés à un élément de la file d'attente, identifiés par son numérique {queueItemId}.

Point de terminaison de l’API

Supprimer (Delete)

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

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur {jeton_accès}
X-UIPATH-OrganizationUnitId	{Id_dossier}

Codes de réponse

204 Aucun contenu