Content Analyzers - Grant Copy Authorization

Служба:: Azure AI Services

Версия API:: 2025-11-01

Получите разрешение на копирование этого анализатора в другое место.

POST {endpoint}/contentunderstanding/analyzers/{analyzerId}:grantCopyAuthorization?api-version=2025-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
analyzerId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-zA-Z0-9._-]{1,64}$	Уникальный идентификатор анализатора.
endpoint	path	True	string (uri)	Понимание контента: конечная точка сервиса.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Обязательно	Тип	Описание
x-ms-client-request-id		string (uuid)	Непрозрачный, глобально уникальный, созданный клиентом идентификатор строки для запроса.

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

Имя	Обязательно	Тип	Описание
targetAzureResourceId	True	string	Azure Resource ID расположения целевого анализатора.
targetRegion		string	Область Azure от расположения целевого анализатора. По умолчанию отображается текущий регион.

Ответы

Имя	Тип	Описание
200 OK	CopyAuthorization	Запрос выполнен успешно. Заголовки x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Имя

Тип

Описание

200 OK

CopyAuthorization

Запрос выполнен успешно.

Заголовки

x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Непредвиденное сообщение об ошибке.

Заголовки

x-ms-error-code: string

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

Ocp-Apim-Subscription-Key

Аутентификация по ключу с использованием ключа доступа ресурса Azure.

Тип: apiKey
В: header

EntraIdToken

Аутентификация Microsoft Entra ID OAuth2 с использованием токена доступа.

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/token

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Grant Copy Authorization

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

HTTP

POST {endpoint}/contentunderstanding/analyzers/sourceAnalyzer:grantCopyAuthorization?api-version=2025-11-01

{
  "targetAzureResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/myResource",
  "targetRegion": "westus2"
}

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

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

{
  "source": "https://myendpoint.cognitiveservices.azure.com/contentunderstanding/analyzers/sourceAnalyzer",
  "targetAzureResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/myResource",
  "expiresAt": "2025-12-01T18:46:36.051Z"
}

Определения

Имя	Описание
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по Azure REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.
CopyAuthorization	Данные авторизации копирования для копирования между ресурсами.
GrantCopyAuthorizationRequest	Запрос на авторизацию копии.

Azure.Core.Foundations.Error

Объект

Объект ошибки.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
details	Azure.Core.Foundations.Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.
message	string	Читаемое пользователем представление ошибки.
target	string	Целевой объект ошибки.

Azure.Core.Foundations.ErrorResponse

Объект

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	Azure.Core.Foundations.Error	Объект ошибки.

Azure.Core.Foundations.InnerError

Объект

Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по Azure REST API — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
innererror	Azure.Core.Foundations.InnerError	Внутренняя ошибка.

CopyAuthorization

Объект

Данные авторизации копирования для копирования между ресурсами.

Имя	Тип	Описание
expiresAt	string (date-time)	Дата/время истечения срока авторизации копирования.
source	string	Полный путь анализатора источника.
targetAzureResourceId	string	Azure Resource ID целевого места для копирования.

GrantCopyAuthorizationRequest

Объект

Запрос на авторизацию копии.

Имя	Тип	Описание
targetAzureResourceId	string	Azure Resource ID расположения целевого анализатора.
targetRegion	string	Область Azure от расположения целевого анализатора. По умолчанию отображается текущий регион.