Linked Services - Create Or Update

Служба:
Log Analytics
Версия API:
2026-03-01

Создайте или обновите связанную службу.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/linkedServices/{linkedServiceName}?api-version=2026-03-01

Параметры URI

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

string

Название связанной службы.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя нечувствительно к регистру.
subscriptionId
 path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
workspaceName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Имя рабочей области.
api-version
 query True

string

minLength: 1

Версия API, используемая для данной операции.

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

Имя Тип Описание
properties.provisioningState

LinkedServiceEntityStatus

Состояние подготовки связанной службы.
properties.resourceId

string

Идентификатор ресурса, который будет связан с рабочей областью. Это необходимо использовать для связывания ресурсов, для которых требуется доступ на чтение
properties.writeAccessResourceId

string

Идентификатор ресурса, который будет связан с рабочей областью. Это необходимо использовать для связывания ресурсов, для которых требуется доступ на запись
tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

LinkedService

Операция обновления ресурса 'LinkedService' успешно прошла
201 Created

LinkedService

Операция создания ресурса 'LinkedService' успешно выполнена

Заголовки

  • Location: string
  • Retry-After: integer
202 Accepted

Операция ресурса принята.

Заголовки

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

ErrorResponse

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

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

Имя Описание
user_impersonation выдать себя за учетную запись пользователя

Примеры

LinkedServicesCreate

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

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/workspaces/TestLinkWS/linkedServices/Cluster?api-version=2026-03-01

{
  "properties": {
    "writeAccessResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/clusters/testcluster"
  }
}

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

Код состояния:
200 
{
  "name": "TestLinkWS/Cluster",
  "type": "Microsoft.OperationalInsights/workspaces/linkedServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/cluster",
  "properties": {
    "provisioningState": "ProvisioningAccount",
    "writeAccessResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/clusters/testcluster"
  }
}
Код состояния:
201 
{
  "name": "TestLinkWS/Cluster",
  "type": "Microsoft.OperationalInsights/workspaces/linkedServices",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/mms-eus/providers/microsoft.operationalinsights/workspaces/testlinkws/linkedservices/cluster",
  "properties": {
    "provisioningState": "ProvisioningAccount",
    "writeAccessResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mms-eus/providers/Microsoft.OperationalInsights/clusters/testcluster"
  }
}
Код состояния:
202

Определения

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

Тип учётной записи, создавшей ресурс.
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Подробности ошибки.
ErrorResponse

Ответ на ошибку
LinkedService

Контейнер ресурсов связанной службы верхнего уровня.
LinkedServiceEntityStatus

Состояние подготовки связанной службы.
systemData

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

createdByType

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

Тип учётной записи, создавшей ресурс.

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

ErrorAdditionalInfo

Объект

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

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

object

Дополнительные сведения.
type

string

Тип дополнительных сведений.

ErrorDetail

Объект

Подробности ошибки.

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

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

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

string

Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

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

ErrorDetail

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

LinkedService

Объект

Контейнер ресурсов связанной службы верхнего уровня.

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

string (arm-id)

Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

Имя ресурса.
properties.provisioningState

LinkedServiceEntityStatus

Состояние подготовки связанной службы.
properties.resourceId

string

Идентификатор ресурса, который будет связан с рабочей областью. Это необходимо использовать для связывания ресурсов, для которых требуется доступ на чтение
properties.writeAccessResourceId

string

Идентификатор ресурса, который будет связан с рабочей областью. Это необходимо использовать для связывания ресурсов, для которых требуется доступ на запись
systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags

object

Теги ресурсов.
type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

LinkedServiceEntityStatus

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

Состояние подготовки связанной службы.

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

Succeeded
Deleting

Удаление
ProvisioningAccount

ПодготовкаAccount
Updating

Updating

systemData

Объект

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

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

string (date-time)

Метка времени создания ресурса (UTC).
createdBy

string

Идентификатор, создавший ресурс.
createdByType

createdByType

Тип учётной записи, создавшей ресурс.
lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)
lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.
lastModifiedByType

createdByType

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