Shared Private Link Resources - Create Or Update

Ссылка

Служба:: Search Management

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

Инициирует создание или обновление общего ресурса приватного канала, управляемого службой поиска в данной группе ресурсов.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2025-05-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов в текущей подписке. Это значение можно получить из API Azure Resource Manager или портала.
searchServiceName	path	True	string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$	Имя службы поиска ИИ Azure, связанной с указанной группой ресурсов.
sharedPrivateLinkResourceName	path	True	string	Имя ресурса общего приватного канала, управляемого службой поиска ИИ Azure в указанной группе ресурсов.
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure. Это значение можно получить из API Azure Resource Manager или портала.
api-version	query	True	string	Версия API, используемая для каждого запроса.

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

Имя	Обязательно	Тип	Описание
x-ms-client-request-id		string (uuid)	Значение GUID, созданное клиентом, идентифицирующее этот запрос. Если этот параметр указан, он будет включен в сведения о ответе в качестве способа отслеживания запроса.

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

Имя	Тип	Описание
properties	SharedPrivateLinkResourceProperties	Описывает свойства общего ресурса приватного канала, управляемого службой поиска ИИ Azure.

Ответы

Имя	Тип	Описание
200 OK	SharedPrivateLinkResource	Сведения о ресурсе общего приватного канала, который был создан или обновлен.
202 Accepted		Операция создания или обновления общего ресурса приватного канала была принята и будет завершена асинхронно.
Other Status Codes	CloudError	HTTP 400 (недопустимый запрос): указанное имя ресурса общего приватного канала или определение ресурса общего приватного канала недопустимо; Дополнительные сведения см. в коде ошибки и сообщении в ответе. HTTP 404 (не найдено): не удалось найти подписку, группу ресурсов, службу поиска или общий ресурс приватного канала. HTTP 409 (конфликт): указанная подписка отключена.

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

azure_auth

Указывает неявный поток предоставления, как поддерживается на платформе удостоверений Майкрософт.

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

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

SharedPrivateLinkResourceCreateOrUpdate

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

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2025-05-01

{
  "properties": {
    "requestMessage": "please approve",
    "groupId": "blob",
    "privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
    "resourceRegion": null
  }
}

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

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

Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2025-05-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2025-05-01

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

{
  "name": "testResource",
  "type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
  "properties": {
    "requestMessage": "please approve",
    "groupId": "blob",
    "privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
    "status": "Pending",
    "resourceRegion": null
  }
}

Определения

Имя	Описание
CloudError	Содержит сведения об ошибке API.
CloudErrorBody	Описывает определенную ошибку API с кодом ошибки и сообщением.
createdByType	Тип удостоверения, создавшего ресурс.
SharedPrivateLinkResource	Описывает общий ресурс приватного канала, управляемый службой поиска ИИ Azure.
SharedPrivateLinkResourceProperties	Описывает свойства существующего ресурса общего приватного канала, управляемого службой поиска ИИ Azure.
SharedPrivateLinkResourceProvisioningState	Состояние подготовки общего ресурса приватного канала. Допустимые значения: обновление, удаление, сбой, успешное или неполное.
SharedPrivateLinkResourceStatus	Состояние ресурса общего приватного канала. Допустимые значения: ожидающие, утвержденные, отклоненные или отключенные.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

CloudError

Object

Содержит сведения об ошибке API.

Имя	Тип	Описание
error	CloudErrorBody	Описывает определенную ошибку API с кодом ошибки и сообщением.
message	string	Краткое описание ошибки, которая указывает на то, что пошло не так (для получения сведений или отладки см. свойство error.message).

CloudErrorBody

Object

Описывает определенную ошибку API с кодом ошибки и сообщением.

Имя	Тип	Описание
code	string	Код ошибки, описывающий условие ошибки точнее, чем код состояния HTTP. Можно использовать для программной обработки конкретных случаев ошибок.
details	CloudErrorBody[]	Содержит вложенные ошибки, связанные с этой ошибкой.
message	string	Сообщение, описывающее ошибку подробно и предоставляющее сведения об отладке.
target	string	Целевой объект конкретной ошибки (например, имя свойства в ошибке).

createdByType

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

Тип удостоверения, создавшего ресурс.

Значение	Описание
Application
Key
ManagedIdentity
User

SharedPrivateLinkResource

Object

Описывает общий ресурс приватного канала, управляемый службой поиска ИИ Azure.

Имя	Тип	Описание
id	string (arm-id)	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	The name of the resource
properties	SharedPrivateLinkResourceProperties	Описывает свойства общего ресурса приватного канала, управляемого службой поиска ИИ Azure.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Object

Описывает свойства существующего ресурса общего приватного канала, управляемого службой поиска ИИ Azure.

Имя	Тип	Описание
groupId	string	Идентификатор группы от поставщика ресурса, для которой используется общий ресурс приватного канала.
privateLinkResourceId	string	Идентификатор ресурса, для которой используется общий ресурс приватного канала.
provisioningState	SharedPrivateLinkResourceProvisioningState	Состояние подготовки общего ресурса приватного канала. Допустимые значения: обновление, удаление, сбой, успешное или неполное.
requestMessage	string	Сообщение о запросе утверждения общего ресурса приватного канала.
resourceRegion	string	Необязательно. Можно использовать для указания расположения Azure Resource Manager ресурса, для которого создается общая приватная ссылка. Это необходимо только для тех ресурсов, конфигурации DNS которых являются региональными (например, служба Azure Kubernetes).
status	SharedPrivateLinkResourceStatus	Состояние ресурса общего приватного канала. Допустимые значения: ожидающие, утвержденные, отклоненные или отключенные.

SharedPrivateLinkResourceProvisioningState

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

Состояние подготовки общего ресурса приватного канала. Допустимые значения: обновление, удаление, сбой, успешное или неполное.

Значение	Описание
Deleting	Общий ресурс приватного канала находится в процессе удаления.
Failed	Не удалось подготовить или удалить общий ресурс приватного канала.
Incomplete	Запрос на подготовку ресурса общего приватного канала был принят, но процесс создания еще не начался.
Succeeded	Общий ресурс приватного канала завершил подготовку и готов к утверждению.
Updating	Общий ресурс приватного канала находится в процессе создания вместе с другими ресурсами, чтобы он был полностью функциональным.

SharedPrivateLinkResourceStatus

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

Состояние ресурса общего приватного канала. Допустимые значения: ожидающие, утвержденные, отклоненные или отключенные.

Значение	Описание
Approved	Общий ресурс приватного канала утвержден и готов к использованию.
Disconnected	Общий ресурс приватного канала удален из службы.
Pending	Создан общий ресурс приватного канала и ожидает утверждения.
Rejected	Общий ресурс приватного канала был отклонен и не может использоваться.

systemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

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

Shared Private Link Resources - Create Or Update

Параметры URI

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

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

Ответы

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

azure_auth

Области

Примеры

SharedPrivateLinkResourceCreateOrUpdate

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

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

Определения

CloudError

CloudErrorBody

createdByType

SharedPrivateLinkResource

SharedPrivateLinkResourceProperties

SharedPrivateLinkResourceProvisioningState

SharedPrivateLinkResourceStatus

systemData

Дополнительные ресурсы