Share via


Clusters - Get

Hiermee haalt u een Log Analytics-clusterexemplaar op.

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

URI-parameters

Name In Vereist Type Description
clusterName
path True

string

Naam van het Log Analytics-cluster.

resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

Cluster

Definitie van OK-antwoord.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

ClustersGet

Sample Request

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

Sample Response

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

Definities

Name Description
AssociatedWorkspace

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

BillingType

Het factureringstype van het cluster.

Capacity

Het capaciteitsreserveringsniveau in gigabytes voor dit cluster.

CapacityReservationProperties

De eigenschappen van capaciteitsreservering.

Cluster

De log analytics-clusterresourcecontainer op het hoogste niveau.

ClusterEntityStatus

De inrichtingsstatus van het cluster.

ClusterSku

De definitie van de cluster-SKU.

ClusterSkuNameEnum

De SKU (laag) van een cluster.

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 zijn toegestaan).

UserAssignedIdentity

Eigenschappen van door de gebruiker toegewezen identiteit

AssociatedWorkspace

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

Name Type Description
associateDate

string

Het tijdstip van de werkruimtekoppeling.

resourceId

string

Gekoppelde arm-resource-id van de werkruimte, in de vorm van: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.

workspaceId

string

De onveranderbare id van de gekoppelde werkruimte.

workspaceName

string

Resourcenaam van de gekoppelde werkruimte.

BillingType

Het factureringstype van het cluster.

Name Type Description
Cluster

string

Workspaces

string

Capacity

Het capaciteitsreserveringsniveau in gigabytes voor dit cluster.

Name Type Description
100

Integer

1000

Integer

10000

Integer

200

Integer

2000

Integer

25000

Integer

300

Integer

400

Integer

500

Integer

5000

Integer

50000

Integer

CapacityReservationProperties

De eigenschappen van capaciteitsreservering.

Name Type Description
lastSkuUpdate

string

De laatste keer dat SKU is bijgewerkt.

minCapacity

integer

Minimumwaarde voor CapacityReservation in Gigabytes.

Cluster

De log analytics-clusterresourcecontainer op het hoogste niveau.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

De identiteit van de 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 is gekoppeld aan het cluster.

properties.createdDate

string

De aanmaaktijd van het cluster

properties.isAvailabilityZonesEnabled

boolean

Hiermee stelt u in of het cluster beschikbaarheidszones ondersteunt. Dit kan alleen als waar worden ingesteld in regio's waar Azure Data Explorer ondersteuning bieden voor Beschikbaarheidszones. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true' als 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

De laatste keer dat het cluster is bijgewerkt.

properties.provisioningState

ClusterEntityStatus

De inrichtingsstatus van het cluster.

sku

ClusterSku

De SKU-eigenschappen.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ClusterEntityStatus

De inrichtingsstatus van het cluster.

Name Type Description
Canceled

string

Creating

string

Deleting

string

Failed

string

ProvisioningAccount

string

Succeeded

string

Updating

string

ClusterSku

De definitie van de cluster-SKU.

Name Type Description
capacity

Capacity

Het capaciteitsreserveringsniveau in gigabytes voor dit cluster.

name

ClusterSkuNameEnum

De SKU (laag) van een cluster.

ClusterSkuNameEnum

De SKU (laag) van een cluster.

Name Type Description
CapacityReservation

string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

keyVaultProperties

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

Geselecteerde sleutel minimale vereiste grootte.

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

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

Name Type Description
principalId

string

De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen opgegeven voor een door het systeem toegewezen identiteit.

tenantId

string

De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen opgegeven voor een door het systeem toegewezen identiteit.

type

ManagedServiceIdentityType

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

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned-identiteiten
De set door de gebruiker toegewezen identiteiten die zijn gekoppeld aan de resource. De userAssignedIdentities-woordenlijstsleutels zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De woordenlijstwaarden kunnen lege objecten ({}) in aanvragen zijn.

ManagedServiceIdentityType

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

Name Type Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

UserAssignedIdentity

Eigenschappen van door de gebruiker toegewezen identiteit

Name Type Description
clientId

string

De client-id van de toegewezen identiteit.

principalId

string

De principal-id van de toegewezen identiteit.