Clusters - Get

Service:: Log Analytics

API-versie:: 2025-07-01

Hiermee haalt u een Log Analytics-clusterexemplaar op.

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

URI-parameters

Name	In	Vereist	Type	Description
clusterName	path	True	string	Naam van het Log Analytics-cluster.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	Cluster	Azure-operatie succesvol voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ClustersGet

Voorbeeldaanvraag

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


/**
 * Samples for Clusters GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-07-01/ClustersGet.json
     */
    /**
     * Sample code: ClustersGet.
     * 
     * @param manager Entry point to LogAnalyticsManager.
     */
    public static void clustersGet(com.azure.resourcemanager.loganalytics.LogAnalyticsManager manager) {
        manager.clusters().getByResourceGroupWithResponse("oiautorest6685", "oiautorest6685",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.loganalytics import LogAnalyticsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-loganalytics
# USAGE
    python clusters_get.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = LogAnalyticsManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="53bc36c5-91e1-4d09-92c9-63b89e571926",
    )

    response = client.clusters.get(
        resource_group_name="oiautorest6685",
        cluster_name="oiautorest6685",
    )
    print(response)


# x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/ClustersGet.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armoperationalinsights_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/operationalinsights/armoperationalinsights/v3"
)

// Generated from example definition: 2025-07-01/ClustersGet.json
func ExampleClustersClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armoperationalinsights.NewClientFactory("53bc36c5-91e1-4d09-92c9-63b89e571926", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewClustersClient().Get(ctx, "oiautorest6685", "oiautorest6685", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armoperationalinsights.ClustersClientGetResponse{
	// 	Cluster: armoperationalinsights.Cluster{
	// 		Name: to.Ptr("TestResourceLock"),
	// 		Type: to.Ptr("Microsoft.OperationalInsights/clusters"),
	// 		ID: to.Ptr("/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685"),
	// 		Identity: &armoperationalinsights.ManagedServiceIdentity{
	// 			Type: to.Ptr(armoperationalinsights.ManagedServiceIdentityTypeSystemAssigned),
	// 			PrincipalID: to.Ptr("356d057d-cba5-44dd-8a30-b2e547bc416b"),
	// 			TenantID: to.Ptr("72f988bf-86f1-41af-91ab-2d7cd011db47"),
	// 		},
	// 		Location: to.Ptr("eastus"),
	// 		Properties: &armoperationalinsights.ClusterProperties{
	// 			AssociatedWorkspaces: []*armoperationalinsights.AssociatedWorkspace{
	// 				{
	// 					AssociateDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T23:40:33Z"); return t}()),
	// 					ResourceID: to.Ptr("/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs1"),
	// 					WorkspaceID: to.Ptr("942bdefd-e6c9-411c-ac69-70ffad564363"),
	// 					WorkspaceName: to.Ptr("testWs1"),
	// 				},
	// 				{
	// 					AssociateDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T23:40:33Z"); return t}()),
	// 					ResourceID: to.Ptr("/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs2"),
	// 					WorkspaceID: to.Ptr("c7edb8f8-67f7-41f2-bddb-aecf22507e3f"),
	// 					WorkspaceName: to.Ptr("testWs2"),
	// 				},
	// 			},
	// 			BillingType: to.Ptr(armoperationalinsights.BillingTypeCluster),
	// 			CapacityReservationProperties: &armoperationalinsights.CapacityReservationProperties{
	// 				LastSKUUpdate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T17:40:33Z"); return t}()),
	// 				MinCapacity: to.Ptr[int64](100),
	// 			},
	// 			ClusterID: to.Ptr("1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1"),
	// 			CreatedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T17:40:33Z"); return t}()),
	// 			IsAvailabilityZonesEnabled: to.Ptr(true),
	// 			IsDoubleEncryptionEnabled: to.Ptr(true),
	// 			KeyVaultProperties: &armoperationalinsights.KeyVaultProperties{
	// 				KeyName: to.Ptr("aztest2170cert"),
	// 				KeyVaultURI: to.Ptr("https://aztest2170.vault.azure.net"),
	// 				KeyVersion: to.Ptr("654ft6c4e63845cbb50fd6fg51540429"),
	// 			},
	// 			LastModifiedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T17:40:33Z"); return t}()),
	// 			ProvisioningState: to.Ptr(armoperationalinsights.ClusterEntityStatusSucceeded),
	// 			Replication: &armoperationalinsights.ClusterReplicationProperties{
	// 				CreatedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T17:40:33Z"); return t}()),
	// 				Enabled: to.Ptr(true),
	// 				LastModifiedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-13T17:40:33Z"); return t}()),
	// 				Location: to.Ptr("westus3"),
	// 				ProvisioningState: to.Ptr(armoperationalinsights.ClusterReplicationStateSucceeded),
	// 			},
	// 		},
	// 		SKU: &armoperationalinsights.ClusterSKU{
	// 			Name: to.Ptr(armoperationalinsights.ClusterSKUNameEnumCapacityReservation),
	// 			Capacity: to.Ptr[int64](1000),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { OperationalInsightsManagementClient } = require("@azure/arm-operationalinsights");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to gets a Log Analytics cluster instance.
 *
 * @summary gets a Log Analytics cluster instance.
 * x-ms-original-file: 2025-07-01/ClustersGet.json
 */
async function clustersGet() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "53bc36c5-91e1-4d09-92c9-63b89e571926";
  const client = new OperationalInsightsManagementClient(credential, subscriptionId);
  const result = await client.clusters.get("oiautorest6685", "oiautorest6685");
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

{
  "name": "TestResourceLock",
  "type": "Microsoft.OperationalInsights/clusters",
  "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
  },
  "location": "eastus",
  "properties": {
    "associatedWorkspaces": [
      {
        "associateDate": "2020-01-13T23:40:33Z",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs1",
        "workspaceId": "942bdefd-e6c9-411c-ac69-70ffad564363",
        "workspaceName": "testWs1"
      },
      {
        "associateDate": "2020-01-13T23:40:33Z",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs2",
        "workspaceId": "c7edb8f8-67f7-41f2-bddb-aecf22507e3f",
        "workspaceName": "testWs2"
      }
    ],
    "billingType": "Cluster",
    "capacityReservationProperties": {
      "lastSkuUpdate": "2020-01-13T17:40:33Z",
      "minCapacity": 100
    },
    "clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1",
    "createdDate": "2020-01-13T17:40:33Z",
    "isAvailabilityZonesEnabled": true,
    "isDoubleEncryptionEnabled": true,
    "keyVaultProperties": {
      "keyName": "aztest2170cert",
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "lastModifiedDate": "2020-01-13T17:40:33Z",
    "provisioningState": "Succeeded",
    "replication": {
      "createdDate": "2020-01-13T17:40:33Z",
      "enabled": true,
      "lastModifiedDate": "2020-01-13T17:40:33Z",
      "location": "westus3",
      "provisioningState": "Succeeded"
    }
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  }
}

Definities

Name	Description
AssociatedWorkspace	De lijst met Log Analytics-werkruimten die aan het cluster zijn gekoppeld.
BillingType	Stelt in of de facturering alleen op de cluster wordt geplaatst of dat elke werkruimte wordt gefactureerd op basis van het evenredige gebruik. Dit verandert de totale facturering niet, alleen hoe deze wordt verdeeld. De standaardwaarde is 'Cluster'
CapacityReservationProperties	De eigenschappen van de capaciteitsreservering.
Cluster	De resourcecontainer voor Log Analytics-cluster op het hoogste niveau.
ClusterEntityStatus	De inrichtingsstatus van het cluster.
ClusterReplicationProperties	Eigenschappen van clusterreplicatie.
ClusterReplicationState	De inrichtingsstatus van de clusterreplicatie.
ClusterSku	De definitie van cluster-sku.
ClusterSkuNameEnum	De SKU (laag) van een cluster.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
keyVaultProperties	De eigenschappen van de sleutelkluis.
ManagedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)
ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UserAssignedIdentity	Door de gebruiker toegewezen identiteitseigenschappen

AssociatedWorkspace

Object

De lijst met Log Analytics-werkruimten die aan het cluster zijn gekoppeld.

Name	Type	Description
associateDate	string (date-time)	De tijd van de vereniging van de werkruimte.
resourceId	string (arm-id)	Gekoppelde resource-id van de werkruimte-arm, in de vorm van: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string (uuid)	Gekoppelde onveranderlijke id van de werkruimte.
workspaceName	string	Naam van gekoppelde werkruimteresource.

BillingType

Opsomming

Stelt in of de facturering alleen op de cluster wordt geplaatst of dat elke werkruimte wordt gefactureerd op basis van het evenredige gebruik. Dit verandert de totale facturering niet, alleen hoe deze wordt verdeeld. De standaardwaarde is 'Cluster'

Waarde	Description
Cluster	Cluster
Workspaces	Werkruimtes

CapacityReservationProperties

Object

De eigenschappen van de capaciteitsreservering.

Name	Type	Description
lastSkuUpdate	string (date-time)	De laatste keer dat Sku is bijgewerkt.
minCapacity	integer (int64)	Minimale capaciteitReserveringswaarde in gigabytes.

Cluster

Object

De resourcecontainer voor Log Analytics-cluster op het hoogste niveau.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	De beheerde service-identiteiten die zijn toegewezen aan deze resource.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.associatedWorkspaces	AssociatedWorkspace[]	De lijst met Log Analytics-werkruimten die zijn gekoppeld aan het cluster
properties.billingType	BillingType	Het factureringstype van het cluster.
properties.capacityReservationProperties	CapacityReservationProperties	Aanvullende eigenschappen voor capaciteitsreservering
properties.clusterId	string	De id die aan het cluster is gekoppeld.
properties.createdDate	string (date-time)	De tijd voor het maken van het cluster
properties.isAvailabilityZonesEnabled	boolean	Hiermee stelt u in of het cluster beschikbaarheidszones ondersteunt. Dit kan alleen worden ingesteld als waar in regio's waar Azure Data Explorer beschikbaarheidszones ondersteunt. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true' als de regio beschikbaarheidszones ondersteunt.
properties.isDoubleEncryptionEnabled	boolean	Hiermee configureert u of het cluster dubbele versleuteling gebruikt. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true'
properties.keyVaultProperties	keyVaultProperties	De bijbehorende sleuteleigenschappen.
properties.lastModifiedDate	string (date-time)	De laatste keer dat het cluster is bijgewerkt.
properties.provisioningState	ClusterEntityStatus	De inrichtingsstatus van het cluster.
properties.replication	ClusterReplicationProperties	De replicatie-eigenschappen van het cluster.
sku	ClusterSku	De sKU-eigenschappen.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ClusterEntityStatus

Opsomming

De inrichtingsstatus van het cluster.

Waarde	Description
Creating	Creëren
Succeeded	Succeeded
Failed	Mislukt
Canceled	Geannuleerd
Deleting	Verwijderen
ProvisioningAccount	ProvisioningAccount
Updating	Bijwerken

ClusterReplicationProperties

Object

Eigenschappen van clusterreplicatie.

Name	Type	Description
createdDate	string (date-time)	De tijd die nodig is om de replicatie van het cluster te maken
enabled	boolean	Hiermee geeft u op of de replicatie is ingeschakeld of niet. Wanneer waar is, wordt het cluster gerepliceerd naar de opgegeven locatie.
isAvailabilityZonesEnabled	boolean	Moet AvailabilityZones inschakelen voor het opgegeven gerepliceerde cluster
lastModifiedDate	string (date-time)	De laatste keer dat de replicatie van het cluster is bijgewerkt.
location	string	De secundaire locatie van de replicatie. Als replicatie wordt ingeschakeld, moet deze zijn ingeschakeld.
provisioningState	ClusterReplicationState	De inrichtingsstatus van de clusterreplicatie.

ClusterReplicationState

Opsomming

De inrichtingsstatus van de clusterreplicatie.

Waarde	Description
Succeeded	Succeeded
EnableRequested	EnableRequested
Enabling	Inschakelen
DisableRequested	DeactivGevraagd
Disabling	Uitschakelen
RollbackRequested	TerugrolAangevraagd
RollingBack	RollingBack
Failed	Mislukt
Canceled	Geannuleerd

ClusterSku

Object

De definitie van cluster-sku.

Name	Type	Description
capacity	integer (int64)	Het capaciteitsreserveringsniveau in Gigabytes voor dit cluster.
name	ClusterSkuNameEnum	De SKU (laag) van een cluster.

ClusterSkuNameEnum

Opsomming

De SKU (laag) van een cluster.

Waarde	Description
CapacityReservation	CapaciteitReservering

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

keyVaultProperties

Object

De eigenschappen van de sleutelkluis.

Name	Type	Description
keyName	string	De naam van de sleutel die is gekoppeld aan het Log Analytics-cluster.
keyRsaSize	integer (int32)	De minimale vereiste grootte van de geselecteerde sleutel.
keyVaultUri	string	De Key Vault-URI die de sleutel bevat die is gekoppeld aan het Log Analytics-cluster.
keyVersion	string	De versie van de sleutel die is gekoppeld aan het Log Analytics-cluster.

ManagedServiceIdentity

Object

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name	Type	Description
principalId	string (uuid)	De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
tenantId	string (uuid)	De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
type	ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteiten De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

ManagedServiceIdentityType

Opsomming

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Waarde	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserAssignedIdentity

Object

Door de gebruiker toegewezen identiteitseigenschappen

Name	Type	Description
clientId	string (uuid)	De client-id van de toegewezen identiteit.
principalId	string (uuid)	De principal-id van de toegewezen identiteit.