Anforderungen für Videoaufzeichnungen

API-Anforderungen zum Abrufen von Download-URLs für und zum Löschen von Ausführungsvideoaufzeichnungen von Aufträgen und Warteschlangenelementen.

Wenn die Videoaufzeichnung aktiviert ist, können Unattended-Ausführungen Videoaufzeichnungen erstellen, die in Systemspeicher-Buckets gespeichert werden. Mit diesen Anforderungen können Sie zeitlich begrenzte Download-URLs für die Aufzeichnungen eines Auftrags oder Warteschlangenelements abrufen und löschen.

Wichtig:

Für diese Endpunkte muss die Videoaufzeichnung für den Mandanten aktiviert sein und die Speicher-Buckets werden konfiguriert. Wenn die Videoaufzeichnung nicht aktiviert ist, geben die Anforderungen einen Fehler zurück.

Die Download-URLs, die von den read -Anforderungen zurückgegeben werden, sind zeitbegrenzte SAS-URLs (Shared Access Signature), die direkt auf jede Aufzeichnungsdatei verweisen. Sie müssen die Dateinamen nicht kennen, die Antwort enthält eine gebrauchsfertige URL pro Aufzeichnung. Laden Sie die Aufzeichnung herunter, indem Sie eine GET-Anforderung an jeden zurückgegebenen Uri senden.

Erforderliche Berechtigungen

Request	Berechtigungen
Rufen Sie Download-URLs für Auftragsaufzeichnungen ab	Jobs.View und ExecutionMedia.View
Auftragsaufzeichnungen löschen	Jobs.Delete und ExecutionMedia.Delete
Rufen Sie Download-URLs für Warteschlangenelementaufzeichnungen ab	Jobs.View, Queues.View und ExecutionMedia.View
Aufzeichnungen von Warteschlangenelementen löschen	Queues.Delete und ExecutionMedia.Delete

Abrufen der Download-URLs für die Aufzeichnungen eines Auftrags

Diese GET-Anforderung gibt die Download-URLs für alle Aufzeichnungen zurück, die mit einem Auftrag verknüpft sind. Der Auftrag wird durch sein {jobKey} identifiziert, das das GUID-Feld Key des Auftrags ist (nicht das numerische Id). Sie können das Key eines Auftrags aus den Auftragsanforderungen abrufen, z. B. gibt GET /odata/Jobs?$filter=Id eq 125161 Key zurück.

API-Endpunkt

Abrufen

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

Anforderungsheader

Schlüssel	Wert
Autorisierung	Bearer {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Antwortcode

200 OK

Antworttext

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

Hinweis:

Ein Auftrag kann höchstens 10 Aufzeichnungsdateien haben. Jedes Uri ist für eine begrenzte Zeit gültig; Fordern Sie die URLs erneut an, wenn sie ablaufen. Bei Aufzeichnungen, die über den integrierten SAS-Mechanismus des Orchestrators bereitgestellt werden, wird die Dateierweiterung als &type= -Abfrageparameter an die URL angehängt, damit Sie den Dateityp bestimmen können.

Löschen der Aufzeichnungen eines Auftrags

Diese DELETE-Anforderung entfernt alle Aufzeichnungsdateien, die mit einem Auftrag verknüpft sind, der durch seine GUID {jobKey} identifiziert wird.

API-Endpunkt

Löschen

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

Anforderungsheader

Schlüssel	Wert
Autorisierung	Bearer {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Antwortcode

204 Kein Inhalt

Abrufen der Download-URLs für die Aufzeichnungen eines Warteschlangenelements

Diese GET-Anforderung gibt die Download-URLs für alle Aufzeichnungen zurück, die mit einem Warteschlangenelement verknüpft sind, das durch seine numerische {queueItemId} identifiziert wird.

API-Endpunkt

Abrufen

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

Anforderungsheader

Schlüssel	Wert
Autorisierung	Bearer {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Antwortcode

200 OK

Antworttext

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

Löschen der Aufzeichnungen eines Warteschlangenelements

Diese DELETE-Anforderung entfernt alle Aufzeichnungsdateien, die mit einem Warteschlangenelement verknüpft sind, das durch seine numerische {queueItemId} identifiziert wird.

API-Endpunkt

Löschen

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

Anforderungsheader

Schlüssel	Wert
Autorisierung	Bearer {access_token}
X-UIPATH-OrganizationUnitId	{folder_Id}

Antwortcode

204 Kein Inhalt