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

Document Translation - Get Supported Glossary Formats

返回支持的术语表格式列表
文档翻译服务支持的术语表格式列表。 此列表包括常用文件扩展名。

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

URI 参数

Name In Required Type Description
endpoint
path True
  • string

支持的认知服务终结点 (协议和主机名,例如: https://westus.api.cognitive.microsoft.com) 。

请求头

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

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

响应

Name Type Description
200 OK

返回支持的术语表文件格式列表

Headers

  • Retry-After: integer
500 Internal Server Error

内部服务器错误

Other Status Codes

请求过多

Other Status Codes

服务器暂不可用

安全性

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

示例

Get Glossary Formats

Sample Request

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

Sample Response

{
  "error": {
    "code": "RequestRateTooHigh",
    "message": "User's request rate is too high",
    "innerError": {
      "code": "RateTooHigh",
      "message": "Request rate is too high"
    }
  }
}
{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}
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

Name Type Description
contentTypes
  • string[]

此格式支持的内容类型

defaultVersion
  • string

如果未指定,则为默认版本

fileExtensions
  • string[]

此格式支持的文件扩展名

format
  • string

格式的名称

versions
  • string[]

支持的版本

InnerTranslationError

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

Name Type Description
code
  • string

获取代码错误字符串。

innerError

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

message
  • string

获取高级别错误消息。

target
  • string

获取错误的源。 例如,如果文档无效,应为“文档”或“文档 ID”。

SupportedFileFormats

Api 中列表返回的基类型

Name Type Description
value

对象列表

TranslationError

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

Name Type Description
code

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

innerError

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

message
  • string

获取高级别错误消息。

target
  • string

获取错误的源。 例如,如果文档无效,应为“文档”或“文档 ID”。

TranslationErrorCode

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

Name Type Description
InternalServerError
  • string
InvalidArgument
  • string
InvalidRequest
  • string
RequestRateTooHigh
  • string
ResourceNotFound
  • string
ServiceUnavailable
  • string
Unauthorized
  • string

TranslationErrorResponse

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

Name Type Description
error

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