Miscellaneous Operations - Get Document Classifier Build Operation

Referência

Serviço:: Azure AI Services

Versão da API:: 2024-11-30

Obtém informações de operação.

GET {endpoint}/documentintelligence/operations/{operationId}?_overload=getDocumentClassifierBuildOperation&api-version=2024-11-30

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string uri	O ponto de extremidade do serviço do Document Intelligence.
operationId	path	True	string	ID da operação
api-version	query	True	string	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-request-id		string uuid	Um identificador de cadeia de caracteres opaco, globalmente exclusivo e gerado pelo cliente para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	DocumentClassifierBuildOperationDetails	A solicitação foi bem-sucedida. Cabeçalhos x-ms-client-request-id: string
Other Status Codes	DocumentIntelligenceErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

DocumentClassifierBuildOperationDetails

A solicitação foi bem-sucedida.

Cabeçalhos

x-ms-client-request-id: string

Other Status Codes

DocumentIntelligenceErrorResponse

Uma resposta de erro inesperada.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

OAuth2Auth

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize
URL do Token: https://login.microsoftonline.com/common/oauth2/token

Escopos

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

Exemplos

Get Operation - Document Classifier Build

Solicitação de exemplo

HTTP

GET https://myendpoint.cognitiveservices.azure.com/documentintelligence/operations/b704bb00-d130-4f3f-a1d8-ca96de3eabb4?_overload=getDocumentClassifierBuildOperation&api-version=2024-11-30

Resposta de exemplo

Código de status:: 200

{
  "operationId": "b704bb00-d130-4f3f-a1d8-ca96de3eabb4",
  "status": "succeeded",
  "percentCompleted": 100,
  "createdDateTime": "2021-09-23T09:12:57Z",
  "lastUpdatedDateTime": "2021-09-23T09:13:01Z",
  "kind": "documentClassifierBuild",
  "resourceLocation": "https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentClassifiers/myClassifier",
  "result": {
    "classifierId": "myClassifier",
    "description": "Classifier description",
    "createdDateTime": "2022-07-30T00:00:00Z",
    "expirationDateTime": "2023-01-01T00:00:00Z",
    "apiVersion": "2024-11-30",
    "docTypes": {
      "formA": {
        "azureBlobSource": {
          "containerUrl": "https://myStorageAccount.blob.core.windows.net/myContainer",
          "prefix": "formADocs/"
        }
      },
      "formB": {
        "azureBlobFileListSource": {
          "containerUrl": "https://myStorageAccount.blob.core.windows.net/myContainer",
          "fileList": "formB.jsonl"
        }
      }
    }
  }
}

Definições

Nome	Description
AzureBlobContentSource	Conteúdo do Armazenamento de Blobs do Azure.
AzureBlobFileListContentSource	Lista de arquivos no Armazenamento de Blobs do Azure.
ClassifierDocumentTypeDetails	Informações de tipo de documento do classificador.
ContentSourceKind	Tipo de fonte de conteúdo.
DocumentClassifierBuildOperationDetails	Obter objeto de resposta da Operação.
DocumentClassifierDetails	Informações do classificador de documento.
DocumentIntelligenceError	O objeto de erro.
DocumentIntelligenceErrorResponse	Objeto de resposta de erro.
DocumentIntelligenceInnerError	Um objeto que contém informações mais específicas sobre o erro.
DocumentIntelligenceOperationStatus	Status da operação.
DocumentIntelligenceWarning	O objeto de erro.
OperationKind	Tipo de operação.

AzureBlobContentSource

Conteúdo do Armazenamento de Blobs do Azure.

Nome	Tipo	Description
containerUrl	string	URL do contêiner do Armazenamento de Blobs do Azure.
prefix	string	Prefixo de nome de blob.

AzureBlobFileListContentSource

Lista de arquivos no Armazenamento de Blobs do Azure.

Nome	Tipo	Description
containerUrl	string	URL do contêiner do Armazenamento de Blobs do Azure.
fileList	string	Caminho para um arquivo JSONL dentro do contêiner especificando um subconjunto de documentos.

ClassifierDocumentTypeDetails

Informações de tipo de documento do classificador.

Nome	Tipo	Description
azureBlobFileListSource	AzureBlobFileListContentSource	Lista de arquivos do Armazenamento de Blobs do Azure especificando os dados de treinamento para um tipo de documento classificador. AzureBlobSource ou azureBlobFileListSource devem ser especificados.
azureBlobSource	AzureBlobContentSource	Local do Armazenamento de Blobs do Azure que contém os dados de treinamento para um tipo de documento classificador. AzureBlobSource ou azureBlobFileListSource devem ser especificados.
sourceKind	ContentSourceKind	Tipo de fonte de dados de treinamento.

ContentSourceKind

Tipo de fonte de conteúdo.

Nome	Tipo	Description
azureBlob	string	Arquivos em um caminho dentro de um contêiner do Armazenamento de Blobs do Azure.
azureBlobFileList	string	Uma lista de arquivos que especifica arquivos individuais em um contêiner do Armazenamento de Blobs do Azure.
base64	string	Conteúdo representado por meio da codificação Base64.
url	string	Conteúdo em uma URL específica.

DocumentClassifierBuildOperationDetails

Obter objeto de resposta da Operação.

Nome	Tipo	Description
apiVersion	string	Versão da API usada para criar essa operação.
createdDateTime	string	Data e hora (UTC) quando a operação foi criada.
error	DocumentIntelligenceError	Erro encontrado.
kind	string: documentClassifierBuild	Tipo de operação.
lastUpdatedDateTime	string	Data e hora (UTC) quando o status foi atualizado pela última vez.
operationId	string	ID da operação
percentCompleted	integer	Progresso da operação (0-100).
resourceLocation	string	URL do recurso direcionado por esta operação.
result	DocumentClassifierDetails	Resultado da operação após o êxito.
status	DocumentIntelligenceOperationStatus	Status da operação. notStarted, running, completed ou failed
tags	object	Lista de atributos de marca chave-valor associados ao modelo de documento.

DocumentClassifierDetails

Informações do classificador de documento.

Nome	Tipo	Description
apiVersion	string	Versão da API usada para criar este classificador de documento.
baseClassifierId	string	ClassifierId base na parte superior da qual o classificador foi treinado.
classifierId	string	Nome do classificador de documento exclusivo.
createdDateTime	string	Data e hora (UTC) quando o classificador de documento foi criado.
description	string	Descrição do classificador de documento.
docTypes	<string, ClassifierDocumentTypeDetails>	Lista de tipos de documento com os quais classificar.
expirationDateTime	string	Data e hora (UTC) em que o classificador de documento expirará.
modifiedDateTime	string	Data e hora (UTC) quando o modelo de documento foi modificado pela última vez.
warnings	DocumentIntelligenceWarning[]	Lista de avisos encontrados durante a criação do classificador.

DocumentIntelligenceError

O objeto de erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	DocumentIntelligenceError[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	DocumentIntelligenceInnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível pelo ser humano do erro.
target	string	O destino do erro.

DocumentIntelligenceErrorResponse

Objeto de resposta de erro.

Nome	Tipo	Description
error	DocumentIntelligenceError	Informações de erro.

DocumentIntelligenceInnerError

Um objeto que contém informações mais específicas sobre o erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
innererror	DocumentIntelligenceInnerError	Erro interno.
message	string	Uma representação legível pelo ser humano do erro.

DocumentIntelligenceOperationStatus

Status da operação.

Nome	Tipo	Description
canceled	string	A operação foi cancelada.
failed	string	A operação falhou.
notStarted	string	A operação ainda não foi iniciada.
running	string	A operação está em andamento.
skipped	string	A operação foi ignorada.
succeeded	string	A operação foi bem-sucedida.

DocumentIntelligenceWarning

O objeto de erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de aviso.
message	string	Uma representação legível pelo ser humano do aviso.
target	string	O destino do erro.

OperationKind

Tipo de operação.

Nome	Tipo	Description
documentClassifierBuild	string	Crie um novo modelo de classificador personalizado.
documentClassifierCopyTo	string	Copie um classificador de documento existente para potencialmente um recurso, uma região ou uma assinatura diferente.
documentModelBuild	string	Crie um novo modelo de documento personalizado.
documentModelCompose	string	Redigir um novo modelo de documento personalizado de modelos existentes.
documentModelCopyTo	string	Copie um modelo de documento existente para potencialmente um recurso, uma região ou uma assinatura diferente.

Compartilhar via

Miscellaneous Operations - Get Document Classifier Build Operation

Parâmetros de URI

Cabeçalho da solicitação

Respostas

Segurança

Ocp-Apim-Subscription-Key

OAuth2Auth

Escopos

Exemplos

Get Operation - Document Classifier Build

Solicitação de exemplo

Resposta de exemplo

Definições

AzureBlobContentSource

AzureBlobFileListContentSource

ClassifierDocumentTypeDetails

ContentSourceKind

DocumentClassifierBuildOperationDetails

DocumentClassifierDetails

DocumentIntelligenceError

DocumentIntelligenceErrorResponse

DocumentIntelligenceInnerError

DocumentIntelligenceOperationStatus

DocumentIntelligenceWarning

OperationKind

Recursos adicionais