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

Models - Copy

  • Ссылка
Служба:
Azure AI Services
Версия API:
v3.2-preview.2

Копирует модель из одной подписки в другую.
Этот метод можно использовать для копирования модели из этого речевого ресурса в целевой. Авторизация будет получена для целевого речевого ресурса. В другой ресурс службы распознавания речи можно скопировать только пользовательские модели.

POST {endpoint}/speechtotext/v3.2-preview.2/models/{id}:copy

Параметры URI

Имя В Обязательно Тип Описание
endpoint
 path True

string

Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например). https://westus.api.cognitive.microsoft.com
id
 path True

string (uuid)

Идентификатор модели, которая будет скопирована.

Текст запроса

Имя Обязательно Тип Описание
expirationDateTime True

string (date-time)

Дата окончания срока действия этой авторизации копирования.
id True

string

minLength: 1

Идентификатор этой авторизации копирования.
sourceResourceId True

string

minLength: 1

Идентификатор ресурса Azure исходного речевого ресурса.
targetResourceEndpoint True

string

minLength: 1

Конечная точка (базовый URL-адрес) целевого ресурса (с именем личного домена при его использовании).
targetResourceId True

string

minLength: 1

Идентификатор ресурса Azure целевого речевого ресурса.
targetResourceRegion True

string

minLength: 1

Регион (расположение) целевого речевого ресурса (например, westus2).

Ответы

Имя Тип Описание
202 Accepted

Operation

Ответ содержит сведения о сущности в качестве полезных данных и ее расположении в качестве заголовка.

Заголовки

  • Retry-After: integer
  • Operation-Location: string
Other Status Codes

Error

Произошла ошибка.

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

Ocp-Apim-Subscription-Key

Укажите ключ учетной записи Cognitive Services здесь.

Тип: apiKey
В: header

Authorization

Укажите маркер доступа из JWT, возвращенный службой маркеров безопасности этого региона. Обязательно добавьте область управления в маркер, добавив следующую строку запроса в URL-адрес службы маркеров безопасности: ?область=speechservicesmanagement

Тип: apiKey
В: header

Примеры

Copy a model from source resource to target resource

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

POST {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy

{
  "targetResourceRegion": "westus2",
  "targetResourceId": "/subscriptions/targetSubscriptionId/resourceGroups/targetResourceGroupName/providers/Microsoft.CognitiveServices/accounts/targetSpeechResourceName",
  "targetResourceEndpoint": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models",
  "sourceResourceId": "/subscriptions/sourceSubscriptionId/resourceGroups/sourceResourceGroupName/providers/Microsoft.CognitiveServices/accounts/sourceSpeechResourceName",
  "expirationDateTime": "2019-01-07T11:34:12Z",
  "id": "d61573c6-788b-4eff-b3f5-38a1c7a9585b"
}

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

Код состояния:
202 
Operation-Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/operations/models/copy/E30F6A27-82BE-4CCA-9258-0399C70489FF
{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/operations/models/copy/E30F6A27-82BE-4CCA-9258-0399C70489FF",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:34:12Z",
  "status": "NotStarted",
  "id": "e30f6a27-82be-4cca-9258-0399c70489ff"
}

Определения

Имя Описание
DetailedErrorCode

DetailedErrorCode
EntityError

EntityError
Error

Ошибка
ErrorCode

ErrorCode
InnerError

InnerError
ModelCopyAuthorization

ModelCopyAuthorization
Operation

Операция
OperationResult

OperationResult
Status

Состояние

DetailedErrorCode

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

DetailedErrorCode

Значение Описание
DataImportFailed

Сбой импорта данных.
DeleteNotAllowed

Удаление запрещено.
DeployNotAllowed

Развертывание запрещено.
DeployingFailedModel

Развертывание модели, завершилось сбоем.
EmptyRequest

Пустой запрос.
EndpointCannotBeDefault

Конечная точка не может быть по умолчанию.
EndpointNotUpdatable

Конечная точка не является обновляемой.
EndpointWithoutLogging

Конечная точка без ведения журнала.
ExceededNumberOfRecordingsUris

Превышено число URI записей.
FailedDataset

Сбой набора данных.
Forbidden

Запрещено.
InUseViolation

Нарушение при использовании.
InaccessibleCustomerStorage

Недоступное хранилище клиента.
InvalidAdaptationMapping

Недопустимое сопоставление адаптации.
InvalidBaseModel

Недопустимая базовая модель.
InvalidCallbackUri

Недопустимый URI обратного вызова.
InvalidCollection

Недопустимая коллекция.
InvalidDataset

Недопустимый набор данных.
InvalidDocument

Недопустимый документ.
InvalidDocumentBatch

Недопустимый пакет документа.
InvalidLocale

Недопустимый языковой стандарт.
InvalidLogDate

Недопустимая дата журнала.
InvalidLogEndTime

Недопустимое время окончания журнала.
InvalidLogId

Недопустимый идентификатор журнала.
InvalidLogStartTime

Недопустимое время начала журнала.
InvalidModel

Недопустимая модель.
InvalidModelUri

Недопустимый универсальный код ресурса (URI) модели.
InvalidParameter

Недопустимый параметр.
InvalidParameterValue

Недопустимое значение параметра.
InvalidPayload

Недопустимые полезные данные.
InvalidPermissions

Недопустимые разрешения.
InvalidPrerequisite

Недопустимое предварительное условие.
InvalidProductId

Недопустимый идентификатор продукта.
InvalidProject

Недопустимый проект.
InvalidProjectKind

Недопустимый тип проекта.
InvalidRecordingsUri

Недопустимый URI записей.
InvalidRequestBodyFormat

Недопустимый формат текста запроса.
InvalidSasValidityDuration

Недопустимая длительность действия SAS.
InvalidSkipTokenForLogs

Недопустимый маркер пропуска для журналов.
InvalidSourceAzureResourceId

Недопустимый исходный идентификатор ресурса Azure.
InvalidSubscription

Недопустимая подписка.
InvalidTest

Недопустимый тест.
InvalidTimeToLive

Недопустимое время жизни.
InvalidTopForLogs

Недопустимое начало для журналов.
InvalidTranscription

Недопустимое транскрибирование.
InvalidWebHookEventKind

Недопустимый тип события веб-перехватчика.
MissingInputRecords

Отсутствуют входные записи.
ModelCopyOperationExists

Операция копирования модели существует.
ModelDeploymentNotCompleteState

Состояние развертывания модели не завершено.
ModelDeprecated

Модель не рекомендуется.
ModelExists

Модель существует.
ModelMismatch

Несоответствие модели.
ModelNotDeployable

Модель не развертывается.
ModelVersionIncorrect

Неправильная версия модели.
NoUtf8WithBom

Нет utf8 с bom.
OnlyOneOfUrlsOrContainerOrDataset

Только один из URL-адресов, контейнера или набора данных.
ProjectGenderMismatch

Несоответствие пола проекта.
QuotaViolation

Нарушение квоты.
SingleDefaultEndpoint

Одна конечная точка по умолчанию.
SkuLimitsExist

Существуют ограничения номера SKU.
SubscriptionNotFound

Подписка не найдена.
UnexpectedError

Непредвиденная ошибка.
UnsupportedClassBasedAdaptation

Неподдерживаемая адаптация на основе класса.
UnsupportedDelta

Неподдерживаемая разностная разница.
UnsupportedDynamicConfiguration

Динамическая конфигурация не поддерживается.
UnsupportedFilter

Неподдерживаемый фильтр.
UnsupportedLanguageCode

Неподдерживаемый код языка.
UnsupportedOrderBy

Неподдерживаемый заказ.
UnsupportedPagination

Неподдерживаемое разбиение на страницы.
UnsupportedTimeRange

Неподдерживаемый диапазон времени.

EntityError

Object

EntityError

Имя Тип Описание
code

string

Код этой ошибки.
message

string

Сообщение для этой ошибки.

Error

Object

Ошибка

Имя Тип Описание
code

ErrorCode

ErrorCode
Коды ошибок высокого уровня.
details

Error[]

Дополнительные сведения об ошибке и (или) ожидаемых политиках.
innerError

InnerError

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

string

Сообщение об ошибке высокого уровня.
target

string

Источник ошибки. Например, в случае недействительного документа это будет "документы" или "идентификатор документа".

ErrorCode

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

ErrorCode

Значение Описание
Conflict

Представляет код ошибки конфликта.
Forbidden

Представляет код запрещенной ошибки.
InternalCommunicationFailed

Представляет код ошибки сбоя внутреннего взаимодействия.
InternalServerError

Представляет код ошибки внутреннего сервера.
InvalidArgument

Представляет код ошибки недопустимого аргумента.
InvalidRequest

Представляет недопустимый код ошибки запроса.
NotAllowed

Представляет недопустимый код ошибки.
NotFound

Представляет код ошибки "Не найден".
PipelineError

Представляет код ошибки конвейера.
ServiceUnavailable

Представляет код ошибки недоступности службы.
TooManyRequests

Представляет код ошибки слишком большого количества запросов.
Unauthorized

Представляет код неавторизованной ошибки.
UnprocessableEntity

Представляет код ошибки необработаемой сущности.
UnsupportedMediaType

Представляет код ошибки типа неподдерживаемого носителя.

InnerError

Object

InnerError

Имя Тип Описание
code

DetailedErrorCode

DetailedErrorCode
Подробное перечисление кода ошибки.
details

object

Дополнительные сведения об ошибке и (или) ожидаемых политиках.
innerError

InnerError

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

string

Сообщение об ошибке высокого уровня.
target

string

Источник ошибки. Например, в случае недействительного документа это будет "документы" или "идентификатор документа".

ModelCopyAuthorization

Object

ModelCopyAuthorization

Имя Тип Описание
expirationDateTime

string (date-time)

Дата окончания срока действия этой авторизации копирования.
id

string

minLength: 1

Идентификатор этой авторизации копирования.
sourceResourceId

string

minLength: 1

Идентификатор ресурса Azure исходного речевого ресурса.
targetResourceEndpoint

string

minLength: 1

Конечная точка (базовый URL-адрес) целевого ресурса (с именем личного домена при его использовании).
targetResourceId

string

minLength: 1

Идентификатор ресурса Azure целевого речевого ресурса.
targetResourceRegion

string

minLength: 1

Регион (расположение) целевого речевого ресурса (например, westus2).

Operation

Object

Операция

Имя Тип Описание
createdDateTime

string (date-time)

Метка времени создания объекта. Метка времени закодирована в формате даты и времени ISO 8601 ("ГГГГ-ММ-ДДЧч:мм:ссЗ", см https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
error

EntityError

EntityError
id

string (uuid)

Идентификатор этой операции.
lastActionDateTime

string (date-time)

Метка времени ввода текущего состояния. Метка времени закодирована в формате даты и времени ISO 8601 ("ГГГГ-ММ-ДДЧч:мм:ссЗ", см https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations. ).
result

OperationResult

OperationResult
self

string (uri)

Расположение этой сущности.
status

Status

Состояние
Описание текущего состояния API

OperationResult

Object

OperationResult

Имя Тип Описание
link

string (uri)

Ссылка на результат операции.

Status

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

Состояние

Значение Описание
Failed

Долго выполняющаяся операция завершилась сбоем.
NotStarted

Долго выполняющаяся операция еще не запущена.
Running

В настоящее время выполняется длительная операция.
Succeeded

Длительная операция успешно завершена.