Miscellaneous Operations - List Operations

Riferimento

Service:: Azure AI Services

API Version:: 2024-02-29-preview

Elenchi tutte le operazioni.

GET {endpoint}/documentintelligence/operations?api-version=2024-02-29-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string	Endpoint del servizio Document Intelligence.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-request-id		string uuid	Identificatore stringa opaco, univoco a livello globale e generato dal client per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	PagedOperationDetails	La richiesta ha avuto esito positivo. Headers x-ms-client-request-id: string
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

PagedOperationDetails

La richiesta ha avuto esito positivo.

Headers

x-ms-client-request-id: string

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Flow: accessCode
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/token

Scopes

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Get Operations

Sample Request

HTTP

GET https://myendpoint.cognitiveservices.azure.com/documentintelligence/operations?api-version=2024-02-29-preview

Sample Response

Status code:: 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-02-29-preview"
    }
  ],
  "nextLink": "https://myendpoint.cognitiveservices.azure.com/documentintelligence/operations?nextLink=nextLinkData"
}

Definizioni

Nome	Descrizione
AzureBlobContentSource	Archiviazione BLOB di Azure contenuto.
AzureBlobFileListContentSource	Elenco di file in Archiviazione BLOB di Azure.
ClassifierDocumentTypeDetails	Informazioni sul tipo di documento del classificatore.
ContentSourceKind	Tipo di origine contenuto.
DocumentBuildMode	Modalità di compilazione del modello di documento personalizzata.
DocumentClassifierBuildOperationDetails	Ottiene l'oggetto risposta Operation.
DocumentClassifierDetails	Informazioni sul classificatore di documenti.
DocumentFieldSchema	Descrizione dello schema semantico del campo usando una sintassi dello stile dello schema JSON.
DocumentFieldType	Tipo di dati semantico del valore del campo.
DocumentModelBuildOperationDetails	Ottiene l'oggetto risposta Operation.
DocumentModelComposeOperationDetails	Ottiene l'oggetto risposta Operation.
DocumentModelCopyToOperationDetails	Ottiene l'oggetto risposta Operation.
DocumentModelDetails	Informazioni sul modello di documento.
DocumentTypeDetails	Informazioni sul tipo di documento.
Error	Oggetto error.
ErrorResponse	Oggetto risposta di errore.
InnerError	Oggetto contenente informazioni più specifiche sull'errore.
OperationKind	Tipo di operazione.
OperationStatus	Stato dell'operazione.
PagedOperationDetails	Raccolta di pagine di elementi OperationDetails
Warning	Oggetto error.

AzureBlobContentSource

Archiviazione BLOB di Azure contenuto.

Nome	Tipo	Descrizione
containerUrl	string	ARCHIVIAZIONE BLOB DI AZURE URL contenitore.
prefix	string	Prefisso del nome BLOB.

AzureBlobFileListContentSource

Elenco di file in Archiviazione BLOB di Azure.

Nome	Tipo	Descrizione
containerUrl	string	ARCHIVIAZIONE BLOB DI AZURE URL contenitore.
fileList	string	Percorso di un file JSONL all'interno del contenitore che specifica un subset di documenti.

ClassifierDocumentTypeDetails

Informazioni sul tipo di documento del classificatore.

Nome	Tipo	Descrizione
azureBlobFileListSource	AzureBlobFileListContentSource	Archiviazione BLOB di Azure elenco di file che specifica i dati di training per un tipo di documento classificatore. È necessario specificare azureBlobSource o azureBlobFileListSource.
azureBlobSource	AzureBlobContentSource	Archiviazione BLOB di Azure percorso contenente i dati di training per un tipo di documento classificatore. È necessario specificare azureBlobSource o azureBlobFileListSource.
sourceKind	ContentSourceKind	Tipo di origine dati di training.

ContentSourceKind

Tipo di origine contenuto.

Nome	Tipo	Descrizione
azureBlob	string	File in un percorso all'interno di un contenitore Archiviazione BLOB di Azure.
azureBlobFileList	string	Elenco di file che specifica singoli file in un contenitore di Archiviazione BLOB di Azure.
base64	string	Contenuto rappresentato tramite codifica Base64.
url	string	Contenuto in un URL specifico.

DocumentBuildMode

Modalità di compilazione del modello di documento personalizzata.

Nome	Tipo	Descrizione
neural	string	Supportare documenti con modelli visivi diversi.
template	string	Visualizzare documenti di destinazione con modelli di oggetto visivo simili.

DocumentClassifierBuildOperationDetails

Ottiene l'oggetto risposta Operation.

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API usata per creare questa operazione.
createdDateTime	string	Data e ora (UTC) di creazione dell'operazione.
error	Error	Errore rilevato.
kind	string: documentClassifierBuild	Tipo di operazione.
lastUpdatedDateTime	string	Data e ora (UTC) dell'ultimo aggiornamento dello stato.
operationId	string	ID operazione
percentCompleted	integer	Stato dell'operazione (0-100).
resourceLocation	string	URL della risorsa di destinazione di questa operazione.
result	DocumentClassifierDetails	Risultato dell'operazione al termine dell'operazione.
status	OperationStatus	Stato dell'operazione. notStarted, running, completed o failed
tags	object	Elenco degli attributi di tag chiave-valore associati al modello di documento.

DocumentClassifierDetails

Informazioni sul classificatore di documenti.

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API usata per creare questo classificatore di documenti.
baseClassifierId	string	ClassifierId di base su cui è stato eseguito il training del classificatore.
classifierId	string	Nome univoco del classificatore di documenti.
createdDateTime	string	Data e ora (UTC) in cui è stato creato il classificatore di documenti.
description	string	Descrizione del classificatore di documenti.
docTypes	<string, ClassifierDocumentTypeDetails>	Elenco dei tipi di documento da classificare in base a .
expirationDateTime	string	Data e ora (UTC) alla scadenza del classificatore di documenti.
warnings	Warning[]	Elenco di avvisi rilevati durante la compilazione del classificatore.

DocumentFieldSchema

Descrizione dello schema semantico del campo usando una sintassi dello stile dello schema JSON.

Nome	Tipo	Descrizione
description	string	Descrizione campo.
example	string	Contenuto del campo di esempio.
items	DocumentFieldSchema	Schema del tipo di campo di ogni elemento della matrice.
properties	<string, DocumentFieldSchema>	Campi secondari denominati del campo oggetto.
type	DocumentFieldType	Tipo di dati semantico del valore del campo.

DocumentFieldType

Tipo di dati semantico del valore del campo.

Nome	Tipo	Descrizione
address	string	Indirizzo analizzato.
array	string	Elenco di campi secondari dello stesso tipo.
boolean	string	Valore booleano, normalizzato su true o false.
countryRegion	string	Paese/area geografica, normalizzato in formato ISO 3166-1 alfa-3 (ad esempio USA).
currency	string	Importo valuta con simbolo di valuta facoltativo e unità.
date	string	Data, normalizzata in formato ISO 8601 (AAAA-MM-DD).
integer	string	Numero intero normalizzato a intero con segno a 64 bit.
number	string	Numero a virgola mobile normalizzato in virgola mobile doppia.
object	string	Elenco denominato di campi secondari di tipi potenzialmente diversi.
phoneNumber	string	Numero di telefono normalizzato in formato E.164 (+{CountryCode}{SubscriberNumber}).
selectionGroup	string	Matrice di valori stringa selezionati.
selectionMark	string	Il campo è selezionato?
signature	string	La firma è presente?
string	string	Testo normale.
time	string	Tempo normalizzato in formato ISO 8601 (hh:mm:ss).

DocumentModelBuildOperationDetails

Ottiene l'oggetto risposta Operation.

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API usata per creare questa operazione.
createdDateTime	string	Data e ora (UTC) di creazione dell'operazione.
error	Error	Errore rilevato.
kind	string: documentModelBuild	Tipo di operazione.
lastUpdatedDateTime	string	Data e ora (UTC) dell'ultimo aggiornamento dello stato.
operationId	string	ID operazione
percentCompleted	integer	Stato dell'operazione (0-100).
resourceLocation	string	URL della risorsa di destinazione di questa operazione.
result	DocumentModelDetails	Risultato dell'operazione al termine dell'operazione.
status	OperationStatus	Stato dell'operazione. notStarted, running, completed o failed
tags	object	Elenco degli attributi di tag chiave-valore associati al modello di documento.

DocumentModelComposeOperationDetails

Ottiene l'oggetto risposta Operation.

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API usata per creare questa operazione.
createdDateTime	string	Data e ora (UTC) di creazione dell'operazione.
error	Error	Errore rilevato.
kind	string: documentModelCompose	Tipo di operazione.
lastUpdatedDateTime	string	Data e ora (UTC) dell'ultimo aggiornamento dello stato.
operationId	string	ID operazione
percentCompleted	integer	Stato dell'operazione (0-100).
resourceLocation	string	URL della risorsa di destinazione di questa operazione.
result	DocumentModelDetails	Risultato dell'operazione al termine dell'operazione.
status	OperationStatus	Stato dell'operazione. notStarted, running, completed o failed
tags	object	Elenco degli attributi di tag chiave-valore associati al modello di documento.

DocumentModelCopyToOperationDetails

Ottiene l'oggetto risposta Operation.

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API usata per creare questa operazione.
createdDateTime	string	Data e ora (UTC) di creazione dell'operazione.
error	Error	Errore rilevato.
kind	string: documentModelCopyTo	Tipo di operazione.
lastUpdatedDateTime	string	Data e ora (UTC) dell'ultimo aggiornamento dello stato.
operationId	string	ID operazione
percentCompleted	integer	Stato dell'operazione (0-100).
resourceLocation	string	URL della risorsa di destinazione di questa operazione.
result	DocumentModelDetails	Risultato dell'operazione al termine dell'operazione.
status	OperationStatus	Stato dell'operazione. notStarted, running, completed o failed
tags	object	Elenco degli attributi di tag chiave-valore associati al modello di documento.

DocumentModelDetails

Informazioni sul modello di documento.

Nome	Tipo	Descrizione
apiVersion	string	Versione dell'API usata per creare questo modello di documento.
azureBlobFileListSource	AzureBlobFileListContentSource	Archiviazione BLOB di Azure elenco di file che specifica i dati di training. È necessario specificare azureBlobSource o azureBlobFileListSource.
azureBlobSource	AzureBlobContentSource	Archiviazione BLOB di Azure posizione contenente i dati di training. È necessario specificare azureBlobSource o azureBlobFileListSource.
buildMode	DocumentBuildMode	Modalità di compilazione del modello di documento personalizzato.
createdDateTime	string	Data e ora (UTC) in cui è stato creato il modello di documento.
description	string	Descrizione del modello di documento.
docTypes	<string, DocumentTypeDetails>	Tipi di documento supportati.
expirationDateTime	string	Data e ora (UTC) alla scadenza del modello di documento.
modelId	string	Nome univoco del modello di documento.
tags	object	Elenco degli attributi di tag chiave-valore associati al modello di documento.
warnings	Warning[]	Elenco di avvisi rilevati durante la compilazione del modello.

DocumentTypeDetails

Informazioni sul tipo di documento.

Nome	Tipo	Descrizione
buildMode	DocumentBuildMode	Modalità di compilazione del modello di documento personalizzata.
description	string	Descrizione del modello di documento.
fieldConfidence	object	Attendibilità stimata per ogni campo.
fieldSchema	<string, DocumentFieldSchema>	Descrizione dello schema semantico del documento usando una sintassi dello stile dello schema JSON.

Error

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno dei set definiti dal server di codici di errore.
details	Error[]	Matrice di dettagli sugli errori specifici che hanno causato questo errore segnalato.
innererror	InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto risposta di errore.

Nome	Tipo	Descrizione
error	Error	Informazioni sugli errori.

InnerError

Oggetto contenente informazioni più specifiche sull'errore.

Nome	Tipo	Descrizione
code	string	Uno dei set definiti dal server di codici di errore.
innererror	InnerError	Errore interno.
message	string	Rappresentazione leggibile dell'errore.

OperationKind

Tipo di operazione.

Nome	Tipo	Descrizione
documentClassifierBuild	string	Creare un nuovo modello di classificatore personalizzato.
documentModelBuild	string	Creare un nuovo modello di documento personalizzato.
documentModelCompose	string	Comporre un nuovo modello di documento personalizzato da modelli esistenti.
documentModelCopyTo	string	Copiare un modello di documento esistente in una risorsa, un'area o una sottoscrizione diversa.

OperationStatus

Stato dell'operazione.

Nome	Tipo	Descrizione
canceled	string	L'operazione è stata annullata.
completed	string	L'operazione è stata completata.
failed	string	L'operazione non è riuscita.
notStarted	string	L'operazione non è ancora stata avviata.
running	string	L'operazione è in corso.
succeeded	string	L'operazione è stata completata.

PagedOperationDetails

Raccolta di pagine di elementi OperationDetails

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva di elementi
value	OperationDetails[]: DocumentClassifierBuildOperationDetails[] DocumentModelBuildOperationDetails[] DocumentModelComposeOperationDetails[] DocumentModelCopyToOperationDetails[]	Elementi OperationDetails in questa pagina

Warning

Oggetto error.

Nome	Tipo	Descrizione
code	string	Un set definito dal server di codici di avviso.
message	string	Rappresentazione leggibile dell'avviso.
target	string	Destinazione dell'errore.

Share via

Miscellaneous Operations - List Operations

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

OAuth2Auth

Scopes

Esempio

Get Operations

Sample Request

Sample Response

Definizioni

AzureBlobContentSource

AzureBlobFileListContentSource

ClassifierDocumentTypeDetails

ContentSourceKind

DocumentBuildMode

DocumentClassifierBuildOperationDetails

DocumentClassifierDetails

DocumentFieldSchema

DocumentFieldType

DocumentModelBuildOperationDetails

DocumentModelComposeOperationDetails

DocumentModelCopyToOperationDetails

DocumentModelDetails

DocumentTypeDetails

Error

ErrorResponse

InnerError

OperationKind

OperationStatus

PagedOperationDetails

Warning

Risorse aggiuntive