Clusters - List

Referentie

Service:: Log Analytics

API-versie:: 2023-09-01

Hiermee haalt u de Log Analytics-clusters in een abonnement op.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.OperationalInsights/clusters?api-version=2023-09-01

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	ClusterListResult	Ok-antwoorddefinitie.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ClustersSubscriptionList

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

{
  "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"
    }
  ]
}

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 capaciteitsreservering.
Cluster	De resourcecontainer van het Log Analytics-cluster op het hoogste niveau.
ClusterEntityStatus	De inrichtingsstatus van het cluster.
ClusterListResult	Het antwoord van de bewerking van de lijstclusters.
ClusterSku	De SKU-definitie van het cluster.
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-typen zijn toegestaan).
UserAssignedIdentity	Door de gebruiker toegewezen identiteitseigenschappen

AssociatedWorkspace

Object

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

Name	Type	Description
associateDate	string	Het tijdstip van de werkruimtekoppeling.
resourceId	string (arm-id)	Gekoppelde resource-id van werkruimte arm, in de vorm van: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string (uuid)	Onveranderbare id van gekoppelde werkruimte.
workspaceName	string	Naam van gekoppelde werkruimteresource.

BillingType

Inventarisatie

Het factureringstype van het cluster.

Waarde	Description
Cluster
Workspaces

Capacity

Inventarisatie

Het capaciteitsreserveringsniveau in Gigabytes voor dit cluster.

Waarde	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

CapacityReservationProperties

Object

De eigenschappen capaciteitsreservering.

Name	Type	Description
lastSkuUpdate	string	De laatste keer dat de SKU is bijgewerkt.
minCapacity	integer (int64)	Minimumwaarde CapacityReservation in Gigabytes.

Cluster

Object

De resourcecontainer van het Log Analytics-cluster 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 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	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

Inventarisatie

De inrichtingsstatus van het cluster.

Waarde	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

ClusterListResult

Object

Het antwoord van de bewerking van de lijstclusters.

Name	Type	Description
nextLink	string	De koppeling wordt gebruikt om de volgende pagina met aanbevelingen op te halen.
value	Cluster[]	Een lijst met Log Analytics-clusters.

ClusterSku

Object

De SKU-definitie van het cluster.

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

ClusterSkuNameEnum

Inventarisatie

De SKU (laag) van een cluster.

Waarde	Description
CapacityReservation

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

Inventarisatie

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

Waarde	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

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.

Delen via

Clusters - List

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

ClustersSubscriptionList

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AssociatedWorkspace

BillingType

Capacity

CapacityReservationProperties

Cluster

ClusterEntityStatus

ClusterListResult

ClusterSku

ClusterSkuNameEnum

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

keyVaultProperties

ManagedServiceIdentity

ManagedServiceIdentityType

UserAssignedIdentity

Aanvullende resources