Compartilhar via


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
subscriptionId
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

ClusterListResult

Definição de resposta OK.

Other Status Codes

ErrorResponse

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
AssociatedWorkspace

A lista de workspaces do Log Analytics associados ao cluster.

BillingType

O tipo de cobrança do cluster.

CapacityReservationProperties

As propriedades de Reserva de Capacidade.

Cluster

O contêiner de recursos de cluster do Log Analytics de nível superior.

ClusterEntityStatus

O estado de provisionamento do cluster.

ClusterListResult

A resposta da operação de clusters de lista.

ClusterReplicationProperties

Propriedades de replicação de cluster.

ClusterReplicationState

O estado de provisionamento da replicação do cluster.

ClusterSku

A definição de SKU do cluster.

ClusterSkuNameEnum

A SKU (camada) de um cluster.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

keyVaultProperties

As propriedades do cofre de chaves.

ManagedServiceIdentity

Identidade de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário)

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).

UserAssignedIdentity

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

ManagedServiceIdentity

Identidade do recurso.

location

string

A localização geográfica onde o recurso reside

name

string

O nome do recurso

properties.associatedWorkspaces

AssociatedWorkspace[]

A lista de workspaces do Log Analytics associados ao cluster

properties.billingType

BillingType

O tipo de cobrança do cluster.

properties.capacityReservationProperties

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

keyVaultProperties

As propriedades de chave associadas.

properties.lastModifiedDate

string (date-time)

A última vez que o cluster foi atualizado.

properties.provisioningState

ClusterEntityStatus

O estado de provisionamento do cluster.

properties.replication

ClusterReplicationProperties

Propriedades de replicação do cluster.

sku

ClusterSku

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

ClusterReplicationState

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

ClusterSkuNameEnum

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

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

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

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).

userAssignedIdentities

<string,  UserAssignedIdentity>

Identidades de User-Assigned
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações.

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.