Content Classifiers - Classify
Classificare i contenuti con la suddivisione facoltativa.
POST {endpoint}/contentunderstanding/classifiers/{classifierId}:classify?api-version=2025-05-01-preview
POST {endpoint}/contentunderstanding/classifiers/{classifierId}:classify?api-version=2025-05-01-preview&stringEncoding={stringEncoding}&processingLocation={processingLocation}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
classifier
|
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. |
processing
|
query |
Il luogo in cui i dati possono essere elaborati. |
||
string
|
query |
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
|
|
Other Status Codes |
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
POST {endpoint}/contentunderstanding/classifiers/myClassifier:classify?api-version=2025-05-01-preview
{
"url": "https://host.com/doc.pdf"
}
Risposta di esempio
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. |
Oggetto error. |
Azure. |
Risposta contenente i dettagli dell'errore. |
Azure. |
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. |
Classify |
Classificare la richiesta di operazione. |
Processing |
Il luogo in cui i dati possono essere elaborati. |
String |
La codifica delle stringhe utilizzata per i contenuti si estende. |
Azure.Core.Foundations.Error
Oggetto error.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Uno di un set definito dal server di codici di errore. |
details |
Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato. |
|
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
Risposta contenente i dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
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.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Uno di un set definito dal server di codici di errore. |
innererror |
Errore interno. |
ClassifyRequest
Classificare la richiesta di operazione.
Nome | Tipo | Descrizione |
---|---|---|
url |
string (uri) |
URL del documento da classificare. |
ProcessingLocation
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
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. |