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	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://westus.api.cognitive.microsoft.com).

Заголовок запроса

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string	Укажите ключ подписки cognitive services здесь.

Ответы

Имя	Тип	Описание
200 OK	SupportedFileFormats	Возвращает список поддерживаемых форматов файлов глоссария Заголовки Retry-After: integer
429 Too Many Requests	TranslationErrorResponse	Слишком много запросов
500 Internal Server Error	TranslationErrorResponse	Внутренняя ошибка сервера
Other Status Codes	TranslationErrorResponse	Временный сервер недоступен

Безопасность

Ocp-Apim-Subscription-Key

Укажите ключ подписки cognitive services здесь.

Тип: 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 Cognitive Services, который доступен в 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 Cognitive Services, который доступен в https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Это содержит обязательные свойства ErrorCode, сообщение и необязательные свойства, сведения (пара значений ключа), внутренняя ошибка (это может быть вложено).

Имя	Тип	Описание
code	string	Возвращает строку ошибки кода.
innerError	InnerTranslationError	Новый формат внутренней ошибки, соответствующий рекомендациям ПО API Cognitive Services, который доступен в https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Это содержит обязательные свойства ErrorCode, сообщение и необязательные свойства, сведения (пара значений ключа), внутренняя ошибка (это может быть вложено).
message	string	Возвращает сообщение об ошибке высокого уровня.
target	string	Возвращает источник ошибки. Например, это будет "документы" или "идентификатор документа" в случае недопустимого документа.

SupportedFileFormats

Object

Базовый тип для возврата списка в нашем API

Имя	Тип	Описание
value	FileFormat[]	список объектов

TranslationError

Object

Это содержит внешнюю ошибку с кодом ошибки, сообщением, сведениями, целевой и внутренней ошибкой с более описательными сведениями.

Имя	Тип	Описание
code	TranslationErrorCode	Перечисления, содержащие коды ошибок высокого уровня.
innerError	InnerTranslationError	Новый формат внутренней ошибки, соответствующий рекомендациям ПО API Cognitive Services, который доступен в https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Это содержит обязательные свойства ErrorCode, сообщение и необязательные свойства, сведения (пара значений ключа), внутренняя ошибка (это может быть вложено).
message	string	Возвращает сообщение об ошибке высокого уровня.
target	string	Возвращает источник ошибки. Например, это будет "документы" или "идентификатор документа" в случае недопустимого документа.

TranslationErrorCode

Перечисление

Перечисления, содержащие коды ошибок высокого уровня.

Значение	Описание
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable
ResourceNotFound
Unauthorized
RequestRateTooHigh

TranslationErrorResponse

Object

Содержит унифицированные сведения об ошибках, используемые для ответов HTTP в любой когнитивной службе. Экземпляры можно создавать либо с помощью Microsoft.CloudAI.Containers.HttpStatusExceptionV2, либо путем возврата непосредственно из контроллера.

Имя	Тип	Описание
error	TranslationError	Это содержит внешнюю ошибку с кодом ошибки, сообщением, сведениями, целевой и внутренней ошибкой с более описательными сведениями.

Поделиться через

Document Translation - Get Supported Glossary Formats

Параметры URI

Заголовок запроса

Ответы

Безопасность

Ocp-Apim-Subscription-Key

Примеры

Get Glossary Formats

Образец запроса

Пример ответа

Определения

FileFormat

InnerTranslationError

SupportedFileFormats

TranslationError

TranslationErrorCode

TranslationErrorResponse