Miscellaneous Operations - Get Document Classifier Build Operation

サービス:

Azure AI Services

API バージョン:

2024-11-30

操作情報を取得します。

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

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string uri	ドキュメント インテリジェンス サービス エンドポイント。
operationId	path	True	string	操作 ID
api-version	query	True	string	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
x-ms-client-request-id		string uuid	要求の非透過的なグローバルに一意のクライアント生成文字列識別子。

応答

名前	型	説明
200 OK	DocumentClassifierBuildOperationDetails	要求は成功しました。 ヘッダー x-ms-client-request-id: string
Other Status Codes	DocumentIntelligenceErrorResponse	予期しないエラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

型: apiKey
/: header

OAuth2Auth

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize
Token URL (トークン URL): https://login.microsoftonline.com/common/oauth2/token

スコープ

名前	説明
https://cognitiveservices.azure.com/.default

例

Get Operation - Document Classifier Build

要求のサンプル

HTTP

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

応答のサンプル

状態コード:

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

定義

名前	説明
AzureBlobContentSource	Azure Blob Storage のコンテンツ。
AzureBlobFileListContentSource	Azure Blob Storage のファイルの一覧。
ClassifierDocumentTypeDetails	分類子ドキュメントの種類の情報。
ContentSourceKind	コンテンツ ソースの種類。
DocumentClassifierBuildOperationDetails	操作応答オブジェクトを取得します。
DocumentClassifierDetails	分類子情報をドキュメント化します。
DocumentIntelligenceError	エラー オブジェクト。
DocumentIntelligenceErrorResponse	エラー応答オブジェクト。
DocumentIntelligenceInnerError	エラーに関するより具体的な情報を含むオブジェクト。
DocumentIntelligenceOperationStatus	操作の状態。
DocumentIntelligenceWarning	エラー オブジェクト。
OperationKind	操作の種類。

AzureBlobContentSource

Azure Blob Storage のコンテンツ。

名前	型	説明
containerUrl	string	Azure Blob Storage コンテナーの URL。
prefix	string	BLOB 名プレフィックス。

AzureBlobFileListContentSource

Azure Blob Storage のファイルの一覧。

名前	型	説明
containerUrl	string	Azure Blob Storage コンテナーの URL。
fileList	string	ドキュメントのサブセットを指定するコンテナー内の JSONL ファイルへのパス。

ClassifierDocumentTypeDetails

分類子ドキュメントの種類の情報。

名前	型	説明
azureBlobFileListSource	AzureBlobFileListContentSource	分類子ドキュメントの種類のトレーニング データを指定する Azure Blob Storage ファイルの一覧。 azureBlobSource または azureBlobFileListSource を指定する必要があります。
azureBlobSource	AzureBlobContentSource	分類子ドキュメントの種類のトレーニング データを含む Azure Blob Storage の場所。 azureBlobSource または azureBlobFileListSource を指定する必要があります。
sourceKind	ContentSourceKind	トレーニング データ ソースの種類。

ContentSourceKind

コンテンツ ソースの種類。

名前	型	説明
azureBlob	string	Azure Blob Storage コンテナー内のパス内のファイル。
azureBlobFileList	string	Azure Blob Storage コンテナー内の個々のファイルを指定するファイルの一覧。
base64	string	Base64 エンコードによって表されるコンテンツ。
url	string	特定の URL のコンテンツ。

DocumentClassifierBuildOperationDetails

操作応答オブジェクトを取得します。

名前	型	説明
apiVersion	string	この操作の作成に使用される API バージョン。
createdDateTime	string	操作が作成された日時 (UTC)。
error	DocumentIntelligenceError	エラーが発生しました。
kind	string: documentClassifierBuild	操作の種類。
lastUpdatedDateTime	string	状態が最後に更新された日時 (UTC)。
operationId	string	操作 ID
percentCompleted	integer	操作の進行状況 (0 から 100)。
resourceLocation	string	この操作の対象となるリソースの URL。
result	DocumentClassifierDetails	成功した場合の操作の結果。
status	DocumentIntelligenceOperationStatus	操作の状態。 notStarted、running、completed、または failed
tags	object	ドキュメント モデルに関連付けられているキーと値のタグ属性の一覧。

DocumentClassifierDetails

分類子情報をドキュメント化します。

名前	型	説明
apiVersion	string	このドキュメント分類子の作成に使用される API バージョン。
baseClassifierId	string	分類子がトレーニングされた上の基本 classifierId。
classifierId	string	一意のドキュメント分類子名。
createdDateTime	string	ドキュメント分類子が作成された日時 (UTC)。
description	string	分類子の説明を文書化します。
docTypes	<string,  ClassifierDocumentTypeDetails>	分類対象のドキュメントの種類の一覧。
expirationDateTime	string	ドキュメント分類子の有効期限が切れる日時 (UTC)。
modifiedDateTime	string	ドキュメント モデルが最後に変更された日時 (UTC)。
warnings	DocumentIntelligenceWarning[]	分類子の構築中に発生した警告の一覧。

DocumentIntelligenceError

エラー オブジェクト。

名前	型	説明
code	string	サーバー定義の一連のエラー コードの 1 つ。
details	DocumentIntelligenceError[]	この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror	DocumentIntelligenceInnerError	エラーに関する現在のオブジェクトよりも具体的な情報を含むオブジェクト。
message	string	エラーの人間が判読できる表現。
target	string	エラーのターゲット。

DocumentIntelligenceErrorResponse

エラー応答オブジェクト。

名前	型	説明
error	DocumentIntelligenceError	エラー情報。

DocumentIntelligenceInnerError

エラーに関するより具体的な情報を含むオブジェクト。

名前	型	説明
code	string	サーバー定義の一連のエラー コードの 1 つ。
innererror	DocumentIntelligenceInnerError	内部エラー。
message	string	エラーの人間が判読できる表現。

DocumentIntelligenceOperationStatus

操作の状態。

名前	型	説明
canceled	string	操作が取り消されました。
failed	string	操作が失敗しました。
notStarted	string	操作はまだ開始されていません。
running	string	操作が進行中です。
skipped	string	操作はスキップされました。
succeeded	string	操作は成功しました。

DocumentIntelligenceWarning

エラー オブジェクト。

名前	型	説明
code	string	サーバー定義の警告コードのセットの 1 つ。
message	string	警告の人間が判読できる表現。
target	string	エラーのターゲット。

OperationKind

操作の種類。

名前	型	説明
documentClassifierBuild	string	新しいカスタム分類子モデルを構築します。
documentClassifierCopyTo	string	既存のドキュメント分類子を別のリソース、リージョン、またはサブスクリプションにコピーします。
documentModelBuild	string	新しいカスタム ドキュメント モデルを構築します。
documentModelCompose	string	既存のモデルから新しいカスタム ドキュメント モデルを作成します。
documentModelCopyTo	string	既存のドキュメント モデルを別のリソース、リージョン、またはサブスクリプションにコピーします。