Miscellaneous Operations - List Operations

Dienst:: Azure AI Services

API-Version:: 2024-11-30

Listet alle Vorgänge auf.

GET {endpoint}/documentintelligence/operations?api-version=2024-11-30

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)	Der Document Intelligence-Dienstendpunkt.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-client-request-id		string (uuid)	Ein undurchsichtiger, global eindeutiger, clientgenerierter Zeichenfolgenbezeichner für die Anforderung.

Antworten

Name	Typ	Beschreibung
200 OK	PagedDocumentIntelligenceOperationDetails	Die Anforderung ist erfolgreich. Header x-ms-client-request-id: string
Other Status Codes	DocumentIntelligenceErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

PagedDocumentIntelligenceOperationDetails

Die Anforderung ist erfolgreich.

Header

x-ms-client-request-id: string

Other Status Codes

DocumentIntelligenceErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

OAuth2Auth

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/token

Bereiche

Name	Beschreibung
https://cognitiveservices.azure.com/.default

Beispiele

Get Operations

Beispielanforderung

HTTP

GET https://myendpoint.cognitiveservices.azure.com/documentintelligence/operations?api-version=2024-11-30

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "operationId": "b704bb00-d130-4f3f-a1d8-ca96de3eabb4",
      "status": "running",
      "percentCompleted": 0,
      "createdDateTime": "2021-09-23T09:12:57Z",
      "lastUpdatedDateTime": "2021-09-23T09:12:58Z",
      "kind": "documentModelBuild",
      "resourceLocation": "https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/myCustomModel",
      "apiVersion": "2024-11-30"
    }
  ],
  "nextLink": "https://myendpoint.cognitiveservices.azure.com/documentintelligence/operations?nextLink=nextLinkData"
}

Definitionen

Name	Beschreibung
AzureBlobContentSource	Azure Blob Storage-Inhalt.
AzureBlobFileListContentSource	Dateiliste in Azure Blob Storage.
ClassifierDocumentTypeDetails	Informationen zum Klassifiziererdokumenttyp.
ContentSourceKind	Typ der Inhaltsquelle.
DocumentAnalysisFeature	Dokumentanalysefeatures, die aktiviert werden sollen.
DocumentBuildMode	Benutzerdefinierter Dokumentmodell-Buildmodus.
DocumentClassifierBuildOperationDetails	Dient zum Abrufen des Operation-Antwortobjekts.
DocumentClassifierCopyToOperationDetails	Dient zum Abrufen des Operation-Antwortobjekts.
DocumentClassifierDetails	Dokumentklassifiziererinformationen.
DocumentFieldSchema	Beschreibung des Feldsemantikschemas mithilfe einer JSON-Schemaformatsyntax.
DocumentFieldType	Semantischer Datentyp des Feldwerts.
DocumentIntelligenceError	Das Fehlerobjekt.
DocumentIntelligenceErrorResponse	Fehlerantwortobjekt.
DocumentIntelligenceInnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält.
DocumentIntelligenceOperationStatus	Vorgangsstatus.
DocumentIntelligenceWarning	Das Fehlerobjekt.
DocumentModelBuildOperationDetails	Dient zum Abrufen des Operation-Antwortobjekts.
DocumentModelComposeOperationDetails	Dient zum Abrufen des Operation-Antwortobjekts.
DocumentModelCopyToOperationDetails	Dient zum Abrufen des Operation-Antwortobjekts.
DocumentModelDetails	Dokumentmodellinformationen.
DocumentTypeDetails	Dokumenttypinformationen.
OperationKind	Typ des Vorgangs.
PagedDocumentIntelligenceOperationDetails	Paged-Auflistung von DocumentIntelligenceOperationDetails-Elementen
SplitMode	Verhalten beim Teilen von Dateien.

AzureBlobContentSource

Objekt

Azure Blob Storage-Inhalt.

Name	Typ	Beschreibung
containerUrl	string (uri)	Azure Blob Storage-Container-URL.
prefix	string	Blobnamenpräfix.

AzureBlobFileListContentSource

Objekt

Dateiliste in Azure Blob Storage.

Name	Typ	Beschreibung
containerUrl	string (uri)	Azure Blob Storage-Container-URL.
fileList	string	Pfad zu einer JSONL-Datei innerhalb des Containers, der eine Teilmenge von Dokumenten angibt.

ClassifierDocumentTypeDetails

Objekt

Informationen zum Klassifiziererdokumenttyp.

Name	Typ	Beschreibung
azureBlobFileListSource	AzureBlobFileListContentSource	Azure Blob Storage-Dateiliste, die die Schulungsdaten für einen Klassifiziererdokumenttyp angibt. Entweder azureBlobSource oder azureBlobFileListSource muss angegeben werden.
azureBlobSource	AzureBlobContentSource	Azure Blob Storage-Speicherort, der die Schulungsdaten für einen Klassifiziererdokumenttyp enthält. Entweder azureBlobSource oder azureBlobFileListSource muss angegeben werden.
sourceKind	ContentSourceKind	Typ der Schulungsdatenquelle.

ContentSourceKind

Enumeration

Typ der Inhaltsquelle.

Wert	Beschreibung
url	Inhalt an einer bestimmten URL.
base64	Inhalte, die über die Base64-Codierung dargestellt werden.
azureBlob	Dateien in einem Pfad innerhalb eines Azure Blob Storage-Containers.
azureBlobFileList	Eine Dateiliste, die einzelne Dateien in einem Azure Blob Storage-Container angibt.

DocumentAnalysisFeature

Enumeration

Dokumentanalysefeatures, die aktiviert werden sollen.

Wert	Beschreibung
ocrHighResolution	Führen Sie OCR mit einer höheren Auflösung aus, um Dokumente mit Feindruck zu verarbeiten.
languages	Aktivieren Sie die Erkennung der Textinhaltssprache.
barcodes	Aktivieren Sie die Erkennung von Barcodes im Dokument.
formulas	Aktivieren Sie die Erkennung mathematischer Ausdrücke im Dokument.
keyValuePairs	Aktivieren Sie die Erkennung allgemeiner Schlüsselwertpaare (Formularfelder) im Dokument.
styleFont	Aktivieren Sie die Erkennung verschiedener Schriftformate.
queryFields	Aktivieren Sie die Extraktion zusätzlicher Felder über den QueryFields-Abfrageparameter.

DocumentBuildMode

Enumeration

Benutzerdefinierter Dokumentmodell-Buildmodus.

Wert	Beschreibung
template	Zieldokumente mit ähnlichen visuellen Vorlagen.
neural	Unterstützen Sie Dokumente mit verschiedenen visuellen Vorlagen.

DocumentClassifierBuildOperationDetails

Objekt

Dient zum Abrufen des Operation-Antwortobjekts.

Name	Typ	Beschreibung
apiVersion	string	API-Version, die zum Erstellen dieses Vorgangs verwendet wird.
createdDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Vorgang erstellt wurde.
error	DocumentIntelligenceError	Fehler.
kind	string: documentClassifierBuild	Typ des Vorgangs.
lastUpdatedDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Status zuletzt aktualisiert wurde.
operationId	string	Vorgangs-ID
percentCompleted	integer (int32) minimum: 0 maximum: 100	Vorgangsfortschritt (0-100).
resourceLocation	string (uri)	DIE URL der Ressource, die von diesem Vorgang verwendet wird.
result	DocumentClassifierDetails	Vorgangsergebnis nach Erfolg.
status	DocumentIntelligenceOperationStatus	Vorgangsstatus. notStarted, running, completed oder failed
tags	object	Liste der Schlüsselwerttagattribute, die dem Dokumentmodell zugeordnet sind.

DocumentClassifierCopyToOperationDetails

Objekt

Dient zum Abrufen des Operation-Antwortobjekts.

Name	Typ	Beschreibung
apiVersion	string	API-Version, die zum Erstellen dieses Vorgangs verwendet wird.
createdDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Vorgang erstellt wurde.
error	DocumentIntelligenceError	Fehler.
kind	string: documentClassifierCopyTo	Typ des Vorgangs.
lastUpdatedDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Status zuletzt aktualisiert wurde.
operationId	string	Vorgangs-ID
percentCompleted	integer (int32) minimum: 0 maximum: 100	Vorgangsfortschritt (0-100).
resourceLocation	string (uri)	DIE URL der Ressource, die von diesem Vorgang verwendet wird.
result	DocumentClassifierDetails	Vorgangsergebnis nach Erfolg.
status	DocumentIntelligenceOperationStatus	Vorgangsstatus. notStarted, running, completed oder failed
tags	object	Liste der Schlüsselwerttagattribute, die dem Dokumentmodell zugeordnet sind.

DocumentClassifierDetails

Objekt

Dokumentklassifiziererinformationen.

Name	Typ	Beschreibung
apiVersion	string	API-Version, die zum Erstellen dieses Dokumentklassifizierers verwendet wird.
baseClassifierId	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9._~-]{1,63}$	Basisklassifizierer-ID, auf deren Grundlage der Klassifizierer trainiert wurde.
classifierId	string maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._~-]{1,63}$	Eindeutiger Dokumentklassifizierername.
createdDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Dokumentklassifizierer erstellt wurde.
description	string maxLength: 4096	Beschreibung des Dokumentklassifizierers.
docTypes	<string, ClassifierDocumentTypeDetails>	Liste der Zu klassifizierenden Dokumenttypen.
expirationDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Dokumentklassifizierer abläuft.
modifiedDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann das Dokumentmodell zuletzt geändert wurde.
warnings	DocumentIntelligenceWarning[]	Liste der Warnungen, die beim Erstellen des Klassifizierers aufgetreten sind.

DocumentFieldSchema

Objekt

Beschreibung des Feldsemantikschemas mithilfe einer JSON-Schemaformatsyntax.

Name	Typ	Beschreibung
description	string maxLength: 4096	Feldbeschreibung.
example	string	Beispielfeldinhalt.
items	DocumentFieldSchema	Feldtypschema jedes Arrayelements.
properties	<string, DocumentFieldSchema>	Benannte Unterfelder des Objektfelds.
type	DocumentFieldType	Semantischer Datentyp des Feldwerts.

DocumentFieldType

Enumeration

Semantischer Datentyp des Feldwerts.

Wert	Beschreibung
string	Klartext.
date	Datum, normalisiert auf ISO 8601 (JJJJ-MM-DD) Format.
time	Zeit, normalisiert auf ISO 8601 (hh:mm:ss)-Format.
phoneNumber	Telefonnummer, normalisiert auf E.164 (+{CountryCode}{SubscriberNumber}) Format.
number	Gleitkommazahl, normalisiert in Gleitkommazahl mit doppelter Genauigkeit.
integer	Ganze Zahl, normalisiert auf 64-Bit-Ganzzahl mit Vorzeichen.
selectionMark	Ist das Feld ausgewählt?
countryRegion	Land/Region, normalisiert auf ISO 3166-1 Alpha-3-Format (z. B. USA).
signature	Ist die Signatur vorhanden?
array	Liste der Unterfelder desselben Typs.
object	Benannte Liste von Unterfeldern potenziell unterschiedlicher Typen.
currency	Währungsbetrag mit optionalem Währungssymbol und Einheit.
address	Analysierte Adresse.
boolean	Boolescher Wert, normalisiert auf "true" oder "false".
selectionGroup	Array der ausgewählten Zeichenfolgenwerte.

DocumentIntelligenceError

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	DocumentIntelligenceError[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	DocumentIntelligenceInnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

DocumentIntelligenceErrorResponse

Objekt

Fehlerantwortobjekt.

Name	Typ	Beschreibung
error	DocumentIntelligenceError	Fehlerinformationen.

DocumentIntelligenceInnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	DocumentIntelligenceInnerError	Innerer Fehler.
message	string	Eine lesbare Darstellung des Fehlers.

DocumentIntelligenceOperationStatus

Enumeration

Vorgangsstatus.

Wert	Beschreibung
notStarted	Der Vorgang wurde noch nicht gestartet.
running	Der Vorgang wird ausgeführt.
failed	Fehler beim Vorgang.
succeeded	Der Vorgang ist erfolgreich.
canceled	Der Vorgang wurde abgebrochen.
skipped	Der Vorgang wurde übersprungen.

DocumentIntelligenceWarning

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Einer der serverdefinierten Warnungscodes.
message	string	Eine lesbare Darstellung der Warnung.
target	string	Das Ziel des Fehlers.

DocumentModelBuildOperationDetails

Objekt

Dient zum Abrufen des Operation-Antwortobjekts.

Name	Typ	Beschreibung
apiVersion	string	API-Version, die zum Erstellen dieses Vorgangs verwendet wird.
createdDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Vorgang erstellt wurde.
error	DocumentIntelligenceError	Fehler.
kind	string: documentModelBuild	Typ des Vorgangs.
lastUpdatedDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Status zuletzt aktualisiert wurde.
operationId	string	Vorgangs-ID
percentCompleted	integer (int32) minimum: 0 maximum: 100	Vorgangsfortschritt (0-100).
resourceLocation	string (uri)	DIE URL der Ressource, die von diesem Vorgang verwendet wird.
result	DocumentModelDetails	Vorgangsergebnis nach Erfolg.
status	DocumentIntelligenceOperationStatus	Vorgangsstatus. notStarted, running, completed oder failed
tags	object	Liste der Schlüsselwerttagattribute, die dem Dokumentmodell zugeordnet sind.

DocumentModelComposeOperationDetails

Objekt

Dient zum Abrufen des Operation-Antwortobjekts.

Name	Typ	Beschreibung
apiVersion	string	API-Version, die zum Erstellen dieses Vorgangs verwendet wird.
createdDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Vorgang erstellt wurde.
error	DocumentIntelligenceError	Fehler.
kind	string: documentModelCompose	Typ des Vorgangs.
lastUpdatedDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Status zuletzt aktualisiert wurde.
operationId	string	Vorgangs-ID
percentCompleted	integer (int32) minimum: 0 maximum: 100	Vorgangsfortschritt (0-100).
resourceLocation	string (uri)	DIE URL der Ressource, die von diesem Vorgang verwendet wird.
result	DocumentModelDetails	Vorgangsergebnis nach Erfolg.
status	DocumentIntelligenceOperationStatus	Vorgangsstatus. notStarted, running, completed oder failed
tags	object	Liste der Schlüsselwerttagattribute, die dem Dokumentmodell zugeordnet sind.

DocumentModelCopyToOperationDetails

Objekt

Dient zum Abrufen des Operation-Antwortobjekts.

Name	Typ	Beschreibung
apiVersion	string	API-Version, die zum Erstellen dieses Vorgangs verwendet wird.
createdDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Vorgang erstellt wurde.
error	DocumentIntelligenceError	Fehler.
kind	string: documentModelCopyTo	Typ des Vorgangs.
lastUpdatedDateTime	string (date-time)	Datum und Uhrzeit (UTC), wann der Status zuletzt aktualisiert wurde.
operationId	string	Vorgangs-ID
percentCompleted	integer (int32) minimum: 0 maximum: 100	Vorgangsfortschritt (0-100).
resourceLocation	string (uri)	DIE URL der Ressource, die von diesem Vorgang verwendet wird.
result	DocumentModelDetails	Vorgangsergebnis nach Erfolg.
status	DocumentIntelligenceOperationStatus	Vorgangsstatus. notStarted, running, completed oder failed
tags	object	Liste der Schlüsselwerttagattribute, die dem Dokumentmodell zugeordnet sind.

DocumentModelDetails

Objekt

Dokumentmodellinformationen.

Name	Typ	Standardwert	Beschreibung
apiVersion	string		API-Version, die zum Erstellen dieses Dokumentmodells verwendet wird.
azureBlobFileListSource	AzureBlobFileListContentSource		Azure Blob Storage-Dateiliste, die die Schulungsdaten angibt. Entweder azureBlobSource oder azureBlobFileListSource muss angegeben werden.
azureBlobSource	AzureBlobContentSource		Azure Blob Storage-Speicherort, der die Schulungsdaten enthält. Entweder azureBlobSource oder azureBlobFileListSource muss angegeben werden.
buildMode	DocumentBuildMode		Benutzerdefinierter Dokumentmodell-Buildmodus.
classifierId	string		Bei zusammengesetzten Modellen wird der benutzerdefinierte Klassifizierer zum Teilen und Klassifizieren der Eingabedatei verwendet.
createdDateTime	string (date-time)		Datum und Uhrzeit (UTC), wann das Dokumentmodell erstellt wurde.
description	string maxLength: 4096		Dokumentmodellbeschreibung.
docTypes	<string, DocumentTypeDetails>		Unterstützte Dokumenttypen.
expirationDateTime	string (date-time)		Datum und Uhrzeit (UTC), wann das Dokumentmodell abläuft.
modelId	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9._~-]{1,63}$		Eindeutiger Dokumentmodellname.
modifiedDateTime	string (date-time)		Datum und Uhrzeit (UTC), wann das Dokumentmodell zuletzt geändert wurde.
split	SplitMode	none	Bei zusammengesetzten Modellen verhält sich das Dateiaufteilungsverhalten.
tags	object		Liste der Schlüsselwerttagattribute, die dem Dokumentmodell zugeordnet sind.
trainingHours	number (float)		Die Anzahl der V100-äquivalenten GPU-Stunden, die für die Modellschulung verbraucht wurden.
warnings	DocumentIntelligenceWarning[]		Liste der Warnungen, die beim Erstellen des Modells aufgetreten sind.

DocumentTypeDetails

Objekt

Dokumenttypinformationen.

Name	Typ	Beschreibung
buildMode	DocumentBuildMode	Benutzerdefinierter Dokumentmodell-Buildmodus.
confidenceThreshold	number (float)	Führen Sie nur Analysen durch, wenn die DocType-Konfidenz über dem Schwellenwert liegt.
description	string maxLength: 4096	Dokumentmodellbeschreibung.
features	DocumentAnalysisFeature[]	Liste der optionalen Analysefeatures.
fieldConfidence	object	Geschätzte Konfidenz für jedes Feld.
fieldSchema	<string, DocumentFieldSchema>	Beschreibung des Dokumentsemantikschemas mithilfe einer JSON-Schemaformatsyntax.
maxDocumentsToAnalyze	integer (int32)	Maximale Anzahl der zu analysierenden Dokumente des angegebenen Typs. Default=all.
modelId	string maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._~-]{1,63}$	Dokumentmodell, das zum Analysieren von Dokumenten mit angegebenem Typ verwendet werden soll.
queryFields	string[]	Liste der zu extrahierenden zusätzlichen Felder. Ex. "NumberOfGuests,StoreNumber"

OperationKind

Enumeration

Typ des Vorgangs.

Wert	Beschreibung
documentModelBuild	Erstellen Sie ein neues benutzerdefiniertes Dokumentmodell.
documentModelCompose	Verfassen Sie ein neues benutzerdefiniertes Dokumentmodell aus vorhandenen Modellen.
documentModelCopyTo	Kopieren Sie ein vorhandenes Dokumentmodell in potenziell eine andere Ressource, Region oder ein anderes Abonnement.
documentClassifierCopyTo	Kopieren Sie einen vorhandenen Dokumentklassifizierer in potenziell eine andere Ressource, Region oder ein anderes Abonnement.
documentClassifierBuild	Erstellen Sie ein neues benutzerdefiniertes Klassifizierermodell.

PagedDocumentIntelligenceOperationDetails

Objekt

Paged-Auflistung von DocumentIntelligenceOperationDetails-Elementen

Name	Typ	Beschreibung
nextLink	string (uri)	Der Link zur nächsten Seite von Elementen
value	DocumentIntelligenceOperationDetails[]: DocumentClassifierBuildOperationDetails[] DocumentClassifierCopyToOperationDetails[] DocumentModelBuildOperationDetails[] DocumentModelComposeOperationDetails[] DocumentModelCopyToOperationDetails[]	Die Elemente "DocumentIntelligenceOperationDetails" auf dieser Seite

SplitMode

Enumeration

Verhalten beim Teilen von Dateien.

Wert	Beschreibung
auto	Datei automatisch in Dokumente aufteilen.
none	Behandeln Sie die gesamte Datei als einzelnes Dokument.
perPage	Behandeln Sie jede Seite in der Datei als separates Dokument.