Получение сведений о поддерживаемых источниках хранилища

Метод получения поддерживаемых источников хранения возвращает список источников/параметров хранения, поддерживаемых службой перевода документов.

URL-адрес запроса

Отправьте запрос GET на следующий адрес.

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/storagesources

Узнайте, как найти имя личного домена.

Важно!

  • Во всех запросах API к службе перевода документов необходимо указывать конечную точку личного домена.
  • Вы не можете использовать конечную точку, указанную на портале Azure на странице ресурса Ключи и конечная точка, и глобальную конечную точку перевода (api.cognitive.microsofttranslator.com) для создания HTTP-запросов к службе перевода документов.

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

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

Заголовки Описание
Ocp-Apim-Subscription-Key Обязательный заголовок запроса

Коды состояния ответа

Ниже приведены возможные коды состояния HTTP, которые возвращает запрос.

Код состояния Описание
200 Все в порядке. Успешный запрос и возвращает список источников хранения.
500 Внутренняя ошибка сервера.
Другие коды состояния
  • Слишком много запросов
  • Сервер временно недоступен

Получить ответ о поддерживаемых источниках хранения

Успешный ответ на получение поддерживаемых источников хранения

Базовый тип для возврата списка в API получения поддерживаемых источников хранения.

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

Сообщение об ошибке

Имя Тип Описание
code строка Перечисления с высокоуровневыми кодами ошибок. Возможные значения:
  • InternalServerError
  • InvalidArgument
  • InvalidRequest
  • RequestRateTooHigh
  • ResourceNotFound
  • ServiceUnavailable
  • Не авторизовано
message строка Получение высокоуровневого сообщения об ошибке.
innerError InnerTranslationError Новый формат внутренней ошибки, соответствующий рекомендациям Cognitive Services API. Он содержит обязательные свойства ErrorCode и message, а также необязательные свойства target, details (пара "ключ-значение"), inner error (это свойство может быть вложенным).
innerError.code строка Получение строки с кодом ошибки.
innerError.message строка Получение высокоуровневого сообщения об ошибке.
innerError.target строка Получает источник ошибки. Например, в случае недействительного документа это будет "документы" или "идентификатор документа".

Примеры

Пример успешного ответа

Ниже приведен пример успешного ответа.

{
  "value": [
    "AzureBlob"
  ]
}

Пример ответа с ошибкой

Ниже приведен пример ответа с ошибкой. Схема для других кодов ошибок такая же.

Код состояния: 500

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

Дальнейшие действия

Чтобы узнать больше об использовании службы перевода документов и клиентской библиотеки, обратитесь к нашему краткому руководству.