Document Translation - Get Supported Glossary Formats

服务:

Azure AI Services

API 版本:

v1.0

返回支持的术语表格式列表
文档翻译服务支持的术语表格式列表。 该列表包含使用的通用文件扩展名。

GET {endpoint}/translator/text/batch/v1.0/glossaries/formats

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string	支持的认知服务终结点（协议和主机名，例如：https://westus.api.cognitive.microsoft.com）。

请求头

名称	必需	类型	说明
Ocp-Apim-Subscription-Key	True	string	在此处提供认知服务订阅密钥。

响应

名称	类型	说明
200 OK	SupportedFileFormats	返回支持的术语表文件格式列表 标头 Retry-After: integer
429 Too Many Requests	TranslationErrorResponse	请求过多
500 Internal Server Error	TranslationErrorResponse	内部服务器错误
Other Status Codes	TranslationErrorResponse	服务器临时不可用

安全性

Ocp-Apim-Subscription-Key

在此处提供认知服务订阅密钥。

类型: apiKey
在: header

示例

Get Glossary Formats

示例请求

HTTP

GET {endpoint}/translator/text/batch/v1.0/glossaries/formats

示例响应

状态代码:

429

{
  "error": {
    "code": "RequestRateTooHigh",
    "message": "User's request rate is too high",
    "innerError": {
      "code": "RateTooHigh",
      "message": "Request rate is too high"
    }
  }
}

状态代码:

500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

状态代码:

503

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

状态代码:

200

retry-after: 30
ETag: 686897696a7c876b7e

{
  "value": [
    {
      "format": "XLIFF",
      "fileExtensions": [
        ".xlf"
      ],
      "contentTypes": [
        "application/xliff+xml"
      ],
      "defaultVersion": "1.2",
      "versions": [
        "1.0",
        "1.1",
        "1.2"
      ]
    },
    {
      "format": "TMX",
      "fileExtensions": [
        ".tmx"
      ],
      "contentTypes": [],
      "versions": [
        "1.0",
        "1.1",
        "1.2",
        "1.3",
        "1.4"
      ]
    }
  ]
}

定义

名称	说明
FileFormat
InnerTranslationError	符合认知服务 API 准则的新内部错误格式，可在 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。 这包括必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可嵌套）。
SupportedFileFormats	Api 中列表返回的基类型
TranslationError	这包含一个外部错误，其中包含错误代码、消息、详细信息、目标和内部错误，其中包含更具描述性的详细信息。
TranslationErrorCode	包含高级错误代码的枚举。
TranslationErrorResponse	包含用于跨任何认知服务的 HTTP 响应的统一错误信息。 可以通过 Microsoft.CloudAI.Containers.HttpStatusExceptionV2 或通过直接从控制器返回实例来创建实例。

FileFormat

Object

名称	类型	说明
contentTypes	string[]	此格式支持的内容类型
defaultVersion	string	如果未指定默认版本
fileExtensions	string[]	此格式支持的文件扩展名
format	string	格式的名称
versions	string[]	支持的版本

InnerTranslationError

Object

符合认知服务 API 准则的新内部错误格式，可在 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。 这包括必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可嵌套）。

名称	类型	说明
code	string	获取代码错误代码字符串。
innerError	InnerTranslationError	符合认知服务 API 准则的新内部错误格式，可在 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。 这包括必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可嵌套）。
message	string	获取高级别错误消息。
target	string	获取错误的源。 例如，如果文档无效，则为“documents”或“document id”。

SupportedFileFormats

Object

Api 中列表返回的基类型

名称	类型	说明
value	FileFormat[]	对象列表

TranslationError

Object

这包含一个外部错误，其中包含错误代码、消息、详细信息、目标和内部错误，其中包含更具描述性的详细信息。

名称	类型	说明
code	TranslationErrorCode	包含高级错误代码的枚举。
innerError	InnerTranslationError	符合认知服务 API 准则的新内部错误格式，可在 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。 这包括必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可嵌套）。
message	string	获取高级别错误消息。
target	string	获取错误的源。 例如，如果文档无效，则为“documents”或“document id”。

TranslationErrorCode

枚举

包含高级错误代码的枚举。

值	说明
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable
ResourceNotFound
Unauthorized
RequestRateTooHigh

TranslationErrorResponse

Object

包含用于跨任何认知服务的 HTTP 响应的统一错误信息。 可以通过 Microsoft.CloudAI.Containers.HttpStatusExceptionV2 或通过直接从控制器返回实例来创建实例。

名称	类型	说明
error	TranslationError	这包含一个外部错误，其中包含错误代码、消息、详细信息、目标和内部错误，其中包含更具描述性的详细信息。