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
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя не зависит от регистра. |
|
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID). |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция Azure успешно завершена. |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
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
}
}
]
}
Определения
| Имя | Описание |
|---|---|
|
Associated |
Список рабочих областей Log Analytics, связанных с кластером. |
|
Billing |
Определяет, будет ли выставление счетов только в кластере или каждое рабочее пространство будет оцениваться пропорционально по использованию. Это не меняет общий уровень оплаты, а лишь то, как он будет распределяться. По умолчанию значение — «Кластер» |
|
Capacity |
Свойства резервирования мощности. |
| Cluster |
Контейнер ресурсов кластера Log Analytics верхнего уровня. |
|
Cluster |
Состояние подготовки кластера. |
|
Cluster |
Ответ операции со списком кластеров. |
|
Cluster |
Свойства репликации кластера. |
|
Cluster |
Состояние подготовки репликации кластера. |
|
Cluster |
Определение кластера sku. |
|
Cluster |
Номер SKU (уровень) кластера. |
|
created |
Тип удостоверения, создавшего ресурс. |
|
Error |
Дополнительные сведения об ошибке управления ресурсами. |
|
Error |
Сведения об ошибке. |
|
Error |
Ответ на ошибку |
|
key |
Свойства хранилища ключей. |
|
Managed |
Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения |
|
Managed |
Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
|
User |
Свойства назначаемого пользователем удостоверения |
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 |
Удостоверения управляемой службы, назначенные этому ресурсу. |
|
| location |
string |
Географическое расположение, в котором находится ресурс |
| name |
string |
Имя ресурса |
| properties.associatedWorkspaces |
Список рабочих областей Log Analytics, связанных с кластером |
|
| properties.billingType |
Тип выставления счетов кластера. |
|
| properties.capacityReservationProperties |
Дополнительные свойства для резервирования емкости |
|
| properties.clusterId |
string |
Идентификатор, связанный с кластером. |
| properties.createdDate |
string (date-time) |
Время создания кластера |
| properties.isAvailabilityZonesEnabled |
boolean |
Задает, будет ли кластер поддерживать зоны доступности. Это значение может быть задано как true только в регионах, где Azure Data Explorer поддерживает зоны доступности. Это свойство невозможно изменить после создания кластера. Значение по умолчанию — true, если регион поддерживает зоны доступности. |
| properties.isDoubleEncryptionEnabled |
boolean |
Указывает, будет ли кластер использовать двойное шифрование. Это свойство невозможно изменить после создания кластера. Значение по умолчанию — true |
| properties.keyVaultProperties |
Связанные свойства ключей. |
|
| properties.lastModifiedDate |
string (date-time) |
Последнее обновление кластера. |
| properties.provisioningState |
Состояние подготовки кластера. |
|
| properties.replication |
Свойства репликации кластера. |
|
| sku |
Свойства SKU. |
|
| 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
Состояние подготовки репликации кластера.
| Значение | Описание |
|---|---|
| Succeeded |
Succeeded |
| EnableRequested |
ВключитьЗапрошено |
| Enabling |
Включение |
| DisableRequested |
DisableRequested |
| Disabling |
Отключение |
| RollbackRequested |
Запрос отката |
| RollingBack |
RollingBack |
| Failed |
Неудача |
| Canceled |
Отменено |
ClusterSku
Определение кластера sku.
| Имя | Тип | Описание |
|---|---|---|
| capacity |
integer (int64) |
Уровень резервирования емкости в Гигабайтах для этого кластера. |
| name |
Номер SKU (уровень) кластера. |
ClusterSkuNameEnum
Номер SKU (уровень) кластера.
| Значение | Описание |
|---|---|
| CapacityReservation |
Резервирование вместимости |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
| Имя | Тип | Описание |
|---|---|---|
| info |
object |
Дополнительные сведения. |
| type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
Дополнительные сведения об ошибке. |
|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке. |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
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 |
Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). |
|
| userAssignedIdentities |
<string,
User |
удостоверения User-Assigned |
ManagedServiceIdentityType
Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
| Значение | Описание |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |
UserAssignedIdentity
Свойства назначаемого пользователем удостоверения
| Имя | Тип | Описание |
|---|---|---|
| clientId |
string (uuid) |
Идентификатор клиента назначенного удостоверения. |
| principalId |
string (uuid) |
Основной идентификатор назначенного удостоверения. |