Content Classifiers - Classify

Servizio:

Azure AI Services

Versione API:

2025-05-01-preview

Classificare i contenuti con la suddivisione facoltativa.

POST {endpoint}/contentunderstanding/classifiers/{classifierId}:classify?api-version=2025-05-01-preview

Con parametri facoltativi:

POST {endpoint}/contentunderstanding/classifiers/{classifierId}:classify?api-version=2025-05-01-preview&stringEncoding={stringEncoding}&processingLocation={processingLocation}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
classifierId	path	True	string pattern: ^[a-zA-Z0-9._-]{1,64}$	Identificatore univoco del classificatore.
endpoint	path	True	string (uri)	Informazioni sul contenuto dell'endpoint del servizio.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
processingLocation	query		ProcessingLocation	Il luogo in cui i dati possono essere elaborati.
stringEncoding	query		StringEncoding	Il formato di codifica per il contenuto si estende nella risposta.

Intestazione della richiesta

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

Corpo della richiesta

Nome	Tipo	Descrizione
url	string (uri)	URL del documento da classificare.

Risposte

Nome	Tipo	Descrizione
202 Accepted		La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata. Intestazioni Operation-Location: string x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize
URL token: https://login.microsoftonline.com/common/oauth2/token

Ambiti

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

Esempio

Classify URL

Esempio di richiesta

HTTP

POST {endpoint}/contentunderstanding/classifiers/myClassifier:classify?api-version=2025-05-01-preview

{
  "url": "https://host.com/doc.pdf"
}

Risposta di esempio

Codice di stato:

202

Operation-Location: https://myendpoint.cognitiveservices.azure.com/contentunderstanding/classifierResults/3b31320d-8bab-4f88-b19c-2322a7f11034?api-version=2025-05-01-preview

{
  "id": "3b31320d-8bab-4f88-b19c-2322a7f11034",
  "status": "NotStarted"
}

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
ClassifyRequest	Classificare la richiesta di operazione.
ProcessingLocation	Il luogo in cui i dati possono essere elaborati.
StringEncoding	La codifica delle stringhe utilizzata per i contenuti si estende.

Azure.Core.Foundations.Error

Object

Oggetto error.

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

Azure.Core.Foundations.ErrorResponse

Object

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Object

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

ClassifyRequest

Object

Classificare la richiesta di operazione.

Nome	Tipo	Descrizione
url	string (uri)	URL del documento da classificare.

ProcessingLocation

Enumerazione

Il luogo in cui i dati possono essere elaborati.

Valore	Descrizione
dataZone	I dati possono essere elaborati nella stessa area dati della risorsa.
geography	I dati possono essere elaborati nella stessa area geografica della risorsa.
global	I dati possono essere elaborati in qualsiasi data center di Azure a livello globale.

StringEncoding

Enumerazione

La codifica delle stringhe utilizzata per i contenuti si estende.

Valore	Descrizione
codePoint	Codifica del punto di codice Unicode (UTF-32), utilizzata da linguaggi come Python, ecc.
utf16	Codifica UTF-16, utilizzata da linguaggi come C#, JavaScript, Java, ecc.
utf8	Codifica UTF-8, utilizzata da linguaggi come Go, Rust, Ruby, PHP, ecc.