Clusters - List By Resource Group

Получает кластеры Log Analytics в группе ресурсов.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters?api-version=2025-07-01

Параметры URI

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

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не зависит от регистра.

subscriptionId
path True

string (uuid)

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

api-version
query True

string

minLength: 1

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

Ответы

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

ClusterListResult

Операция Azure успешно завершена.

Other Status Codes

ErrorResponse

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

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

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

Примеры

ClustersGet

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

GET https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters?api-version=2025-07-01

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

{
  "value": [
    {
      "name": "mycluster",
      "type": "Microsoft.OperationalInsights/clusters",
      "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/mycluster",
      "identity": {
        "type": "SystemAssigned",
        "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
      },
      "location": "eastus",
      "properties": {
        "clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
        "keyVaultProperties": {
          "keyName": "aztest2170cert",
          "keyVaultUri": "https://aztest2170.vault.azure.net",
          "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
        },
        "provisioningState": "Succeeded"
      },
      "sku": {
        "name": "CapacityReservation",
        "capacity": 1000
      }
    }
  ]
}

Определения

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

Список рабочих областей Log Analytics, связанных с кластером.

BillingType

Определяет, будет ли выставление счетов только в кластере или каждое рабочее пространство будет оцениваться пропорционально по использованию. Это не меняет общий уровень оплаты, а лишь то, как он будет распределяться. По умолчанию значение — «Кластер»

CapacityReservationProperties

Свойства резервирования мощности.

Cluster

Контейнер ресурсов кластера Log Analytics верхнего уровня.

ClusterEntityStatus

Состояние подготовки кластера.

ClusterListResult

Ответ операции со списком кластеров.

ClusterReplicationProperties

Свойства репликации кластера.

ClusterReplicationState

Состояние подготовки репликации кластера.

ClusterSku

Определение кластера sku.

ClusterSkuNameEnum

Номер SKU (уровень) кластера.

createdByType

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

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

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

keyVaultProperties

Свойства хранилища ключей.

ManagedServiceIdentity

Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

systemData

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

UserAssignedIdentity

Свойства назначаемого пользователем удостоверения

AssociatedWorkspace

Список рабочих областей Log Analytics, связанных с кластером.

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

string (date-time)

Время объединения рабочего пространства.

resourceId

string (arm-id)

Идентификатор связанного ресурса рабочей области в форме: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.

workspaceId

string (uuid)

Связанный неизменяемый идентификатор рабочей области.

workspaceName

string

Имя связанного ресурса рабочей области.

BillingType

Определяет, будет ли выставление счетов только в кластере или каждое рабочее пространство будет оцениваться пропорционально по использованию. Это не меняет общий уровень оплаты, а лишь то, как он будет распределяться. По умолчанию значение — «Кластер»

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

Cluster

Workspaces

Пространства для работы

CapacityReservationProperties

Свойства резервирования мощности.

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

string (date-time)

Последний раз Sku обновлялся.

minCapacity

integer (int64)

Минимальное значение CapacityReservation в гигабайтах.

Cluster

Контейнер ресурсов кластера Log Analytics верхнего уровня.

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

string (arm-id)

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

identity

ManagedServiceIdentity

Удостоверения управляемой службы, назначенные этому ресурсу.

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса

properties.associatedWorkspaces

AssociatedWorkspace[]

Список рабочих областей Log Analytics, связанных с кластером

properties.billingType

BillingType

Тип выставления счетов кластера.

properties.capacityReservationProperties

CapacityReservationProperties

Дополнительные свойства для резервирования емкости

properties.clusterId

string

Идентификатор, связанный с кластером.

properties.createdDate

string (date-time)

Время создания кластера

properties.isAvailabilityZonesEnabled

boolean

Задает, будет ли кластер поддерживать зоны доступности. Это значение может быть задано как true только в регионах, где Azure Data Explorer поддерживает зоны доступности. Это свойство невозможно изменить после создания кластера. Значение по умолчанию — true, если регион поддерживает зоны доступности.

properties.isDoubleEncryptionEnabled

boolean

Указывает, будет ли кластер использовать двойное шифрование. Это свойство невозможно изменить после создания кластера. Значение по умолчанию — true

properties.keyVaultProperties

keyVaultProperties

Связанные свойства ключей.

properties.lastModifiedDate

string (date-time)

Последнее обновление кластера.

properties.provisioningState

ClusterEntityStatus

Состояние подготовки кластера.

properties.replication

ClusterReplicationProperties

Свойства репликации кластера.

sku

ClusterSku

Свойства SKU.

systemData

systemData

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

tags

object

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

type

string

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

ClusterEntityStatus

Состояние подготовки кластера.

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

Создавать

Succeeded

Succeeded

Failed

Неудача

Canceled

Отменено

Deleting

Удаление

ProvisioningAccount

ProvisioningAccount

Updating

Обновление

ClusterListResult

Ответ операции со списком кластеров.

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

string (uri)

Ссылка на следующую страницу элементов

value

Cluster[]

Элементы кластера на этой странице

ClusterReplicationProperties

Свойства репликации кластера.

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

string (date-time)

Время создания репликации кластера

enabled

boolean

Указывает, включена ли репликация. Если кластер реплицируется в указанное расположение.

isAvailabilityZonesEnabled

boolean

Следует включить availabilityZones для данного реплицированного кластера

lastModifiedDate

string (date-time)

Последний раз репликация кластера обновлялась.

location

string

Дополнительное расположение репликации. Если репликация включена, необходимо включить ее.

provisioningState

ClusterReplicationState

Состояние подготовки репликации кластера.

ClusterReplicationState

Состояние подготовки репликации кластера.

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

Succeeded

EnableRequested

ВключитьЗапрошено

Enabling

Включение

DisableRequested

DisableRequested

Disabling

Отключение

RollbackRequested

Запрос отката

RollingBack

RollingBack

Failed

Неудача

Canceled

Отменено

ClusterSku

Определение кластера sku.

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

integer (int64)

Уровень резервирования емкости в Гигабайтах для этого кластера.

name

ClusterSkuNameEnum

Номер SKU (уровень) кластера.

ClusterSkuNameEnum

Номер SKU (уровень) кластера.

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

Резервирование вместимости

createdByType

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

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

ErrorAdditionalInfo

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

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

object

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

type

string

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

ErrorDetail

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

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

ErrorAdditionalInfo[]

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

code

string

Код ошибки.

details

ErrorDetail[]

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

message

string

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

target

string

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

ErrorResponse

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

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

ErrorDetail

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

keyVaultProperties

Свойства хранилища ключей.

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

string

Имя ключа, связанного с кластером Log Analytics.

keyRsaSize

integer (int32)

Выбранный минимальный необходимый размер ключа.

keyVaultUri

string

URI Key Vault, содержащий ключ, связанный с кластером Log Analytics.

keyVersion

string

Версия ключа, связанного с кластером Log Analytics.

ManagedServiceIdentity

Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения

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

string (uuid)

Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.

tenantId

string (uuid)

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

type

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

удостоверения User-Assigned
Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

Значение Описание
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

systemData

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

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

string (date-time)

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

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

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

lastModifiedAt

string (date-time)

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

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

UserAssignedIdentity

Свойства назначаемого пользователем удостоверения

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

string (uuid)

Идентификатор клиента назначенного удостоверения.

principalId

string (uuid)

Основной идентификатор назначенного удостоверения.