Miscellaneous Operations - Get Document Classifier Build Operation

參考

Service:: Azure AI Services

API Version:: 2024-02-29-preview

取得作業資訊。

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

URI 參數

名稱	位於	必要	類型	Description
endpoint	path	True	string	Document Intelligence 服務端點。
operationId	path	True	string	作業識別碼
api-version	query	True	string	用於此作業的 API 版本。

要求標頭

名稱	必要	類型	Description
x-ms-client-request-id		string uuid	要求的不透明、全域唯一、用戶端產生的字串標識碼。

回應

名稱	類型	Description
200 OK	DocumentClassifierBuildOperationDetails	要求成功。 Headers x-ms-client-request-id: string
Other Status Codes	ErrorResponse	非預期的錯誤回應。

名稱

類型

Description

200 OK

DocumentClassifierBuildOperationDetails

要求成功。

Headers

x-ms-client-request-id: string

Other Status Codes

ErrorResponse

非預期的錯誤回應。

安全性

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

名稱	Description
https://cognitiveservices.azure.com/.default

範例

Get Operation - Document Classifier Build

Sample Request

HTTP

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

Sample Response

Status code:: 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-02-29-preview",
    "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"
        }
      }
    }
  }
}

定義

名稱	Description
AzureBlobContentSource	Azure Blob 儲存體內容。
AzureBlobFileListContentSource	Azure Blob 儲存體中的檔案清單。
ClassifierDocumentTypeDetails	分類器檔類型資訊。
ContentSourceKind	內容類型。
DocumentClassifierBuildOperationDetails	取得 Operation 回應物件。
DocumentClassifierDetails	檔分類器資訊。
Error	error 物件。
ErrorResponse	錯誤回應物件。
InnerError	物件，包含錯誤的詳細資訊。
OperationKind	作業的類型。
OperationStatus	作業狀態。
Warning	error 物件。

AzureBlobContentSource

Azure Blob 儲存體內容。

名稱	類型	Description
containerUrl	string	Azure Blob 儲存體容器 URL。
prefix	string	Blob 名稱前置詞。

AzureBlobFileListContentSource

Azure Blob 儲存體中的檔案清單。

名稱	類型	Description
containerUrl	string	Azure Blob 儲存體容器 URL。
fileList	string	指定文件子集之容器內的 JSONL 檔案路徑。

ClassifierDocumentTypeDetails

分類器檔類型資訊。

名稱	類型	Description
azureBlobFileListSource	AzureBlobFileListContentSource	Azure Blob 儲存體檔案清單，指定分類器檔類型的定型數據。必須指定 azureBlobSource 或 azureBlobFileListSource。
azureBlobSource	AzureBlobContentSource	Azure Blob 儲存體位置，其中包含分類器檔類型的定型數據。必須指定 azureBlobSource 或 azureBlobFileListSource。
sourceKind	ContentSourceKind	定型數據源的類型。

ContentSourceKind

內容類型。

名稱	類型	Description
azureBlob	string	Azure Blob 儲存體容器內路徑中的檔案。
azureBlobFileList	string	指定 Azure Blob 儲存體容器中個別檔案的檔案清單。
base64	string	透過Base64編碼表示的內容。
url	string	特定 URL 的內容。

DocumentClassifierBuildOperationDetails

取得 Operation 回應物件。

名稱	類型	Description
apiVersion	string	用來建立這項作業的 API 版本。
createdDateTime	string	建立作業時的日期和時間 (UTC) 。
error	Error	發生錯誤。
kind	string: documentClassifierBuild	作業的類型。
lastUpdatedDateTime	string	上次更新狀態時的日期和時間 (UTC) 。
operationId	string	作業識別碼
percentCompleted	integer	作業進度 (0-100) 。
resourceLocation	string	此作業的目標資源URL。
result	DocumentClassifierDetails	作業成功時的結果。
status	OperationStatus	作業狀態。 notStarted、running、completed 或 failed
tags	object	與檔模型相關聯的索引鍵/值標籤屬性清單。

DocumentClassifierDetails

檔分類器資訊。

名稱	類型	Description
apiVersion	string	用來建立此文件分類器的 API 版本。
baseClassifierId	string	分類器已定型的基底分類器標識碼。
classifierId	string	唯一的檔分類器名稱。
createdDateTime	string	建立文件分類器的日期和時間 (UTC) 。
description	string	檔分類器描述。
docTypes	<string, ClassifierDocumentTypeDetails>	要分類的檔案類型清單。
expirationDateTime	string	檔分類器到期時的日期和時間 (UTC) 。
warnings	Warning[]	建置分類器時遇到的警告清單。

Error

error 物件。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
details	Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innererror	InnerError	物件，包含比目前對象有關錯誤更具體的資訊。
message	string	人類可讀取的錯誤表示法。
target	string	錯誤的目標。

ErrorResponse

錯誤回應物件。

名稱	類型	Description
error	Error	錯誤資訊。

InnerError

物件，包含錯誤的詳細資訊。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
innererror	InnerError	內部錯誤。
message	string	人類可讀取的錯誤表示法。

OperationKind

作業的類型。

名稱	類型	Description
documentClassifierBuild	string	建置新的自定義分類器模型。
documentModelBuild	string	建置新的自定義檔模型。
documentModelCompose	string	從現有的模型撰寫新的自定義檔模型。
documentModelCopyTo	string	將現有的檔模型複製到可能不同的資源、區域或訂用帳戶。

OperationStatus

作業狀態。

名稱	類型	Description
canceled	string	作業已取消。
completed	string	作業已完成。
failed	string	作業失敗。
notStarted	string	作業尚未啟動。
running	string	作業正在進行中。
succeeded	string	此作業已成功。

Warning

error 物件。

名稱	類型	Description
code	string	其中一組伺服器定義的警告碼。
message	string	人類可讀的警告表示法。
target	string	錯誤的目標。

共用方式為

Miscellaneous Operations - Get Document Classifier Build Operation

URI 參數

要求標頭

回應

安全性

Ocp-Apim-Subscription-Key

OAuth2Auth

Scopes

範例

Get Operation - Document Classifier Build

Sample Request

Sample Response

定義

AzureBlobContentSource

AzureBlobFileListContentSource

ClassifierDocumentTypeDetails

ContentSourceKind

DocumentClassifierBuildOperationDetails

DocumentClassifierDetails

Error

ErrorResponse

InnerError

OperationKind

OperationStatus

Warning

其他資源