Erstellen einer Dateiklassifizierungsanforderung

Erstellt eine Anforderung zur Klassifizierung einer oder mehrere Dateien unter Verwendung des angewendeten Dokumentverständnismodells. (Weitere Informationen finden Sie in diesem Beispiel.)

Der REST-Dienst von SharePoint Online (und lokalem SharePoint 2016 und höher) unterstützt das Kombinieren mehrerer Anforderungen. Anforderungen werden in einem einzelnen Dienstaufruf mithilfe der OData-Abfrageoption „$batch“ kombiniert. Diese Methode kann verwendet werden, um Arbeitselemente für Klassifizierungen für Hunderte von Dokumenten gleichzeitig in die Warteschlange zu stellen.

HTTP-Anforderung

POST /_api/machinelearning/workItems HTTP/1.1

URI-Parameter

Keine

Anforderungsheader

Kopfzeile	Wert
Annehmen	application/json;odata=verbose
Content-Type	application/json;odata=verbose;charset=utf-8
x-requestdigest	Die entsprechende Digest für die aktuelle Website

Anforderungstext

Name	Typ	Beschreibung
_metadata	Zeichenfolge	Festlegen der Objekt-Metadaten auf dem SPO. Verwenden Sie immer den Wert: {"type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"}.
TargetSiteId	GUID	Die ID der Website, auf der sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargetSiteUrl einen Wert aufweist.
TargetSiteUrl	Zeichenfolge	Die vollständige URL der Website, auf der sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargeSiteId einen Wert aufweist.
TargetWebId	GUID	Die ID des Web, auf der sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargetWebServerRelativeUrl einen Wert aufweist.
TargetWebServerRelativeUrl	Zeichenfolge	Die relative Server-URL des Webs, in dem sich die zu klassifizierende Datei befindet. Diese kann weggelassen werden, wenn TargetWebId einen Wert aufweist.
TargetUniqueId	GUID	Die ID des zu klassifizierenden Ordners. Diese kann weggelassen werden, wenn TargetServerRelativeUrl einen Wert aufweist.
TargetServerRelativeUrl	Zeichenfolge	Die relative Server-URL an der sich die zu klassifizierenden Datei befindet. Diese kann weggelassen werden, wenn TargetUniqueId einen Wert aufweist.

Antworten

Name	Typ	Beschreibung
201 Erstellt		Die Antwort ist benutzerdefiniert. Wenn ein Fehler auftritt, könnte trotzdem „201 Erstellt“ zurückgegeben werden. Der Aufrufer sollte den Antworttext weiter überprüfen, um das genaue Ergebnis zu ermitteln.

Beispiele

Eine Anforderung für die Klassifizierung einer Datei mit ID „e6cff8b7-c90c-4564-b5b8-033449090932“ in die Warteschlange stellen

Beispielanfrage

{
    "__metadata": {
        "type": "Microsoft.Office.Server.ContentCenter.SPMachineLearningWorkItemEntityData"
    },
    "TargetSiteId": "f686e63b-aba7-48e5-97c7-68c4c1df292f",
    "TargetWebId": "66d6b64d-6f88-4dd9-b3db-47e6f00c53e8",
    "TargetUniqueId": "e6cff8b7-c90c-4564-b5b8-033449090932"
}

Beispielantwort

Statuscode: 201

{
    "ErrorMessage":  null,
    "StatusCode":  201
}

{
    "ErrorMessage":  null,
    "StatusCode":  201
}

Siehe auch

Syntex-Dokumentverständnismodell-REST-API