Clusters - List
Obtém os clusters do Log Analytics em uma assinatura.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.OperationalInsights/clusters?api-version=2025-07-01
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
subscription
|
path | True |
string minLength: 1 |
A ID da assinatura de destino. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Definição de resposta OK. |
|
| Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Exemplos
ClustersSubscriptionList
Solicitação de exemplo
GET https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/providers/Microsoft.OperationalInsights/clusters?api-version=2025-07-01
Resposta de exemplo
{
"value": [
{
"properties": {
"keyVaultProperties": {
"keyVaultUri": "https://aztest2170.vault.azure.net",
"keyName": "aztest2170cert",
"keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
},
"provisioningState": "Succeeded",
"clusterId": "5b02755b-5bf4-430c-9487-45502a2a7e62"
},
"sku": {
"name": "CapacityReservation",
"capacity": 1000
},
"id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/mycluster",
"identity": {
"principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
"tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
"type": "SystemAssigned"
},
"name": "mycluster",
"type": "Microsoft.OperationalInsights/clusters",
"location": "eastus"
}
]
}
Definições
| Nome | Description |
|---|---|
|
Associated |
A lista de workspaces do Log Analytics associados ao cluster. |
|
Billing |
O tipo de cobrança do cluster. |
|
Capacity |
As propriedades de Reserva de Capacidade. |
| Cluster |
O contêiner de recursos de cluster do Log Analytics de nível superior. |
|
Cluster |
O estado de provisionamento do cluster. |
|
Cluster |
A resposta da operação de clusters de lista. |
|
Cluster |
Propriedades de replicação de cluster. |
|
Cluster |
O estado de provisionamento da replicação do cluster. |
|
Cluster |
A definição de SKU do cluster. |
|
Cluster |
A SKU (camada) de um cluster. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
key |
As propriedades do cofre de chaves. |
|
Managed |
Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário) |
|
Managed |
Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). |
|
User |
Propriedades de identidade atribuídas pelo usuário |
AssociatedWorkspace
A lista de workspaces do Log Analytics associados ao cluster.
| Nome | Tipo | Description |
|---|---|---|
| associateDate |
string (date-time) |
O tempo de associação do espaço de trabalho. |
| resourceId |
string (arm-id) |
ID de recurso do braço do workspace associado, na forma de: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}. |
| workspaceId |
string (uuid) |
ID imutável do workspace associado. |
| workspaceName |
string |
Nome do recurso do workspace associado. |
BillingType
O tipo de cobrança do cluster.
| Valor | Description |
|---|---|
| Cluster | |
| Workspaces |
CapacityReservationProperties
As propriedades de Reserva de Capacidade.
| Nome | Tipo | Description |
|---|---|---|
| lastSkuUpdate |
string (date-time) |
A última vez que Sku foi atualizado. |
| minCapacity |
integer (int64) |
Valor mínimo de CapacityReservation em Gigabytes. |
Cluster
O contêiner de recursos de cluster do Log Analytics de nível superior.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| identity |
Identidade do recurso. |
|
| location |
string |
A localização geográfica onde o recurso reside |
| name |
string |
O nome do recurso |
| properties.associatedWorkspaces |
A lista de workspaces do Log Analytics associados ao cluster |
|
| properties.billingType |
O tipo de cobrança do cluster. |
|
| properties.capacityReservationProperties |
Propriedades adicionais para reserva de capacidade |
|
| properties.clusterId |
string |
A ID associada ao cluster. |
| properties.createdDate |
string (date-time) |
O tempo de criação do cluster |
| properties.isAvailabilityZonesEnabled |
boolean |
Define se o cluster dará suporte a zonas de disponibilidade. Isso pode ser definido como true somente em regiões em que o Azure Data Explorer dá suporte a Zonas de Disponibilidade. Essa propriedade não pode ser modificada após a criação do cluster. O valor padrão será 'true' se a região der suporte a Zonas de Disponibilidade. |
| properties.isDoubleEncryptionEnabled |
boolean |
Configura se o cluster usará criptografia dupla. Essa propriedade não pode ser modificada após a criação do cluster. O valor padrão é 'true' |
| properties.keyVaultProperties |
As propriedades de chave associadas. |
|
| properties.lastModifiedDate |
string (date-time) |
A última vez que o cluster foi atualizado. |
| properties.provisioningState |
O estado de provisionamento do cluster. |
|
| properties.replication |
Propriedades de replicação do cluster. |
|
| sku |
As propriedades de sku. |
|
| tags |
object |
Tags de recursos. |
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
ClusterEntityStatus
O estado de provisionamento do cluster.
| Valor | Description |
|---|---|
| Creating | |
| Succeeded | |
| Failed | |
| Canceled | |
| Deleting | |
| ProvisioningAccount | |
| Updating |
ClusterListResult
A resposta da operação de clusters de lista.
| Nome | Tipo | Description |
|---|---|---|
| nextLink |
string |
O link usado para obter a próxima página de recomendações. |
| value |
Cluster[] |
Uma lista de clusters do Log Analytics. |
ClusterReplicationProperties
Propriedades de replicação de cluster.
| Nome | Tipo | Description |
|---|---|---|
| createdDate |
string (date-time) |
O tempo de criação da replicação do cluster |
| enabled |
boolean |
Especifica se a replicação está habilitada ou não. Quando true, o cluster é replicado para o local especificado. |
| isAvailabilityZonesEnabled |
boolean |
Deve habilitar AvailabilityZones para o cluster replicado especificado |
| lastModifiedDate |
string (date-time) |
A última vez que a replicação do cluster foi atualizada. |
| location |
string |
O local secundário da replicação. Se a replicação estiver sendo habilitada, a habilitação deverá ser fornecida. |
| provisioningState |
O estado de provisionamento da replicação do cluster. |
ClusterReplicationState
O estado de provisionamento da replicação do cluster.
| Valor | Description |
|---|---|
| Succeeded | |
| EnableRequested | |
| Enabling | |
| DisableRequested | |
| Disabling | |
| RollbackRequested | |
| RollingBack | |
| Failed | |
| Canceled |
ClusterSku
A definição de SKU do cluster.
| Nome | Tipo | Description |
|---|---|---|
| capacity |
integer (int64) |
O nível de reserva de capacidade em Gigabytes para esse cluster. |
| name |
A SKU (camada) de um cluster. |
ClusterSkuNameEnum
A SKU (camada) de um cluster.
| Valor | Description |
|---|---|
| CapacityReservation |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
keyVaultProperties
As propriedades do cofre de chaves.
| Nome | Tipo | Description |
|---|---|---|
| keyName |
string |
O nome da chave associada ao cluster do Log Analytics. |
| keyRsaSize |
integer (int32) |
Tamanho mínimo necessário da chave selecionada. |
| keyVaultUri |
string |
O uri do Key Vault que contém a chave associada ao cluster do Log Analytics. |
| keyVersion |
string |
A versão da chave associada ao cluster do Log Analytics. |
ManagedServiceIdentity
Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário)
| Nome | Tipo | Description |
|---|---|---|
| principalId |
string (uuid) |
A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
| tenantId |
string (uuid) |
A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
| type |
Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). |
|
| userAssignedIdentities |
<string,
User |
Identidades de User-Assigned |
ManagedServiceIdentityType
Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).
| Valor | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
UserAssignedIdentity
Propriedades de identidade atribuídas pelo usuário
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string (uuid) |
A ID do cliente da identidade atribuída. |
| principalId |
string (uuid) |
A ID da entidade de segurança da identidade atribuída. |