你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Miscellaneous Operations - Get Document Model Compose Operation

参考

服务:: Azure AI Services

API 版本:: 2024-07-31-preview

获取操作信息。

GET {endpoint}/documentintelligence/operations/{operationId}?_overload=getDocumentModelComposeOperation&api-version=2024-07-31-preview

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	DocumentModelComposeOperationDetails	请求已成功。标头 x-ms-client-request-id: string
Other Status Codes	ErrorResponse	意外的错误响应。

名称

类型

说明

200 OK

DocumentModelComposeOperationDetails

请求已成功。

标头

x-ms-client-request-id: string

Other Status Codes

ErrorResponse

意外的错误响应。

安全性

Ocp-Apim-Subscription-Key

类型: apiKey
在: header

OAuth2Auth

类型: oauth2
流向: accessCode
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize
令牌 URL: https://login.microsoftonline.com/common/oauth2/token

作用域

名称	说明
https://cognitiveservices.azure.com/.default

示例

Get Operation - Document Model Compose

示例请求

HTTP

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

示例响应

状态代码:: 200

{
  "operationId": "b704bb00-d130-4f3f-a1d8-ca96de3eabb4",
  "status": "succeeded",
  "percentCompleted": 100,
  "createdDateTime": "2021-09-23T09:12:57Z",
  "lastUpdatedDateTime": "2021-09-23T09:13:01Z",
  "kind": "documentModelCompose",
  "resourceLocation": "https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/myCustomModel",
  "result": {
    "modelId": "myCustomModel",
    "description": "Custom model description",
    "createdDateTime": "2021-09-23T09:13:01Z",
    "apiVersion": "2024-07-31-preview"
  }
}

定义

名称	说明
AzureBlobContentSource	Azure Blob 存储内容。
AzureBlobFileListContentSource	Azure Blob 存储中的文件列表。
DocumentAnalysisFeature	要启用的文档分析功能。
DocumentBuildMode	自定义文档模型生成模式。
DocumentFieldSchema	使用 JSON 架构样式语法描述字段语义架构。
DocumentFieldType	字段值的语义数据类型。
DocumentModelComposeOperationDetails	获取操作响应对象。
DocumentModelDetails	文档模型信息。
DocumentTypeDetails	文档类型信息。
Error	错误对象。
ErrorResponse	错误响应对象。
InnerError	包含有关错误的更具体信息的对象。
OperationKind	操作的类型。
OperationStatus	操作状态。
SplitMode	文件拆分行为。
Warning	错误对象。

AzureBlobContentSource

Azure Blob 存储内容。

名称	类型	说明
containerUrl	string	Azure Blob 存储容器 URL。
prefix	string	Blob 名称前缀。

AzureBlobFileListContentSource

Azure Blob 存储中的文件列表。

名称	类型	说明
containerUrl	string	Azure Blob 存储容器 URL。
fileList	string	指定文档子集的容器中的 JSONL 文件的路径。

DocumentAnalysisFeature

要启用的文档分析功能。

名称	类型	说明
barcodes	string	启用文档中条形码检测。
formulas	string	启用文档中数学表达式的检测。
keyValuePairs	string	启用文档中常规键值对（窗体字段）的检测。
languages	string	启用文本内容语言检测。
ocrHighResolution	string	以更高的分辨率执行 OCR 以处理带有精细打印的文档。
queryFields	string	通过 queryFields 查询参数启用其他字段的提取。
styleFont	string	启用各种字体样式的识别。

DocumentBuildMode

自定义文档模型生成模式。

名称	类型	说明
generative	string	使用生成式 AI 技术启用所有类型的文档。
neural	string	支持具有各种视觉模板的文档。
template	string	使用类似视觉模板的目标文档。

DocumentFieldSchema

使用 JSON 架构样式语法描述字段语义架构。

名称	类型	说明
description	string	字段说明。
example	string	示例字段内容。
items	DocumentFieldSchema	每个数组元素的字段类型架构。
properties	<string, DocumentFieldSchema>	对象字段的命名子字段。
type	DocumentFieldType	字段值的语义数据类型。

DocumentFieldType

字段值的语义数据类型。

名称	类型	说明
address	string	已分析的地址。
array	string	相同类型的子字段列表。
boolean	string	布尔值，规范化为 true 或 false。
countryRegion	string	国家/地区，规范化为 ISO 3166-1 alpha-3 格式（例如美国）。
currency	string	具有可选货币符号和单位的货币金额。
date	string	日期，规范化为 ISO 8601 （YYYY-MM-DD）格式。
integer	string	整数，规范化为 64 位有符号整数。
number	string	浮点数，规范化为双精度浮点。
object	string	可能不同类型的子字段的命名列表。
phoneNumber	string	电话号码，规范化为 E.164 （+{CountryCode}{SubscriberNumber}）格式。
selectionGroup	string	所选字符串值的数组。
selectionMark	string	是否选择了字段？
signature	string	签名是否存在？
string	string	纯文本。
time	string	时间，规范化为 ISO 8601 （hh：mm：ss）格式。

DocumentModelComposeOperationDetails

获取操作响应对象。

名称	类型	说明
apiVersion	string	用于创建此操作的 API 版本。
createdDateTime	string	创建操作的日期和时间（UTC）。
error	Error	遇到错误。
kind	string: documentModelCompose	操作的类型。
lastUpdatedDateTime	string	上次更新状态的日期和时间（UTC）。
operationId	string	操作 ID
percentCompleted	integer	操作进度（0-100）。
resourceLocation	string	此操作面向的资源的 URL。
result	DocumentModelDetails	成功后的操作结果。
status	OperationStatus	操作状态。 notStarted、running、completed 或 failed
tags	object	与文档模型关联的键值标记属性的列表。

DocumentModelDetails

文档模型信息。

名称	类型	默认值	说明
apiVersion	string		用于创建此文档模型的 API 版本。
azureBlobFileListSource	AzureBlobFileListContentSource		指定训练数据的 Azure Blob 存储文件列表。必须指定 azureBlobSource 或 azureBlobFileListSource。
azureBlobSource	AzureBlobContentSource		包含训练数据的 Azure Blob 存储位置。必须指定 azureBlobSource 或 azureBlobFileListSource。
buildMode	DocumentBuildMode		自定义文档模型生成模式。
classifierId	string		对于组合模型，自定义分类器用于拆分和分类输入文件。
createdDateTime	string		创建文档模型的日期和时间（UTC）。
description	string		文档模型说明。
docTypes	<string, DocumentTypeDetails>		支持的文档类型。
expirationDateTime	string		文档模型到期的日期和时间（UTC）。
modelId	string		唯一的文档模型名称。
split	SplitMode	none	对于组合模型，文件拆分行为。
tags	object		与文档模型关联的键值标记属性的列表。
trainingHours	number		用于模型训练的 V100 等效 GPU 小时数。
warnings	Warning[]		生成模型时遇到的警告列表。

DocumentTypeDetails

文档类型信息。

名称	类型	说明
buildMode	DocumentBuildMode	自定义文档模型生成模式。
confidenceThreshold	number	仅当 docType 置信度高于阈值时，才执行分析。
description	string	文档模型说明。
features	DocumentAnalysisFeature[]	可选分析功能列表。
fieldConfidence	object	每个字段的估计置信度。
fieldSchema	<string, DocumentFieldSchema>	使用 JSON 架构样式语法描述文档语义架构。
maxDocumentsToAnalyze	integer	要分析的指定类型的文档的最大数量。 Default=all。
modelId	string	用于分析具有指定类型的文档的文档模型。
queryFields	string[]	要提取的其他字段的列表。前任。 “NumberOfGuests，StoreNumber”

Error

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	错误的人工可读表示形式。
target	string	错误的目标。

ErrorResponse

错误响应对象。

名称	类型	说明
error	Error	错误信息。

InnerError

包含有关错误的更具体信息的对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
innererror	InnerError	内部错误。
message	string	错误的人工可读表示形式。

OperationKind

操作的类型。

名称	类型	说明
documentClassifierBuild	string	生成新的自定义分类器模型。
documentClassifierCopyTo	string	将现有文档分类器复制到可能不同的资源、区域或订阅。
documentModelBuild	string	生成新的自定义文档模型。
documentModelCompose	string	从现有模型撰写新的自定义文档模型。
documentModelCopyTo	string	将现有文档模型复制到可能不同的资源、区域或订阅。

OperationStatus

操作状态。

名称	类型	说明
canceled	string	操作已被取消。
completed	string	操作已完成。
failed	string	操作失败。
notStarted	string	操作尚未启动。
running	string	操作正在进行中。
succeeded	string	操作已成功。

SplitMode

文件拆分行为。

名称	类型	说明
auto	string	自动将文件拆分为文档。
none	string	将整个文件视为单个文档。
perPage	string	将文件中的每一页视为单独的文档。

Warning

错误对象。

名称	类型	说明
code	string	服务器定义的警告代码集之一。
message	string	警告的可读表示形式。
target	string	错误的目标。

通过

Miscellaneous Operations - Get Document Model Compose Operation

URI 参数

请求头

响应

安全性

Ocp-Apim-Subscription-Key

OAuth2Auth

作用域

示例

Get Operation - Document Model Compose

示例请求

示例响应

定义

AzureBlobContentSource

AzureBlobFileListContentSource

DocumentAnalysisFeature

DocumentBuildMode

DocumentFieldSchema

DocumentFieldType

DocumentModelComposeOperationDetails

DocumentModelDetails

DocumentTypeDetails

Error

ErrorResponse

InnerError

OperationKind

OperationStatus

SplitMode

Warning

其他资源