Condividi tramite


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
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

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.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

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

Risposta contenente i dettagli dell'errore.

Nome Tipo Descrizione
error

Azure.Core.Foundations.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

Azure.Core.Foundations.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.