Clusters - List By Resource Group

Référence

Service:: Log Analytics

Version d'API:: 2023-09-01

Obtient des clusters Log Analytics dans un groupe de ressources.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string	ID de l’abonnement cible.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	ClusterListResult	Définition de réponse OK.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

ClustersGet

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
    }
  ]
}

Définitions

Nom	Description
AssociatedWorkspace	Liste des espaces de travail Log Analytics associés au cluster.
BillingType	Type de facturation du cluster.
Capacity	Niveau de réservation de capacité en Gigaoctets pour ce cluster.
CapacityReservationProperties	Propriétés de réservation de capacité.
Cluster	Conteneur de ressources de cluster Log Analytics de niveau supérieur.
ClusterEntityStatus	État d’approvisionnement du cluster.
ClusterListResult	Réponse de l’opération de liste des clusters.
ClusterSku	Définition de la référence sku de cluster.
ClusterSkuNameEnum	Référence SKU (niveau) d’un cluster.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
keyVaultProperties	Propriétés du coffre de clés.
ManagedServiceIdentity	Identité de service managée (identités attribuées par le système et/ou attribuées par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
UserAssignedIdentity	Propriétés d’identité attribuées par l’utilisateur

AssociatedWorkspace

Liste des espaces de travail Log Analytics associés au cluster.

Nom	Type	Description
associateDate	string	Heure d’association de l’espace de travail.
resourceId	string	ID de ressource de l’arm de l’espace de travail associé, sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	ID immuable de l’espace de travail associé.
workspaceName	string	Nom de ressource d’espace de travail associé.

BillingType

Type de facturation du cluster.

Nom	Type	Description
Cluster	string
Workspaces	string

Capacity

Niveau de réservation de capacité en Gigaoctets pour ce cluster.

Nom	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

Propriétés de réservation de capacité.

Nom	Type	Description
lastSkuUpdate	string	Dernière mise à jour de la référence SKU.
minCapacity	integer	Valeur minimale de capacityReservation en Gigaoctets.

Cluster

Conteneur de ressources de cluster Log Analytics de niveau supérieur.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identité de la ressource.
location	string	Emplacement géographique où réside la ressource
name	string	nom de la ressource.
properties.associatedWorkspaces	AssociatedWorkspace[]	Liste des espaces de travail Log Analytics associés au cluster
properties.billingType	BillingType	Type de facturation du cluster.
properties.capacityReservationProperties	CapacityReservationProperties	Propriétés supplémentaires pour la réservation de capacité
properties.clusterId	string	ID associé au cluster.
properties.createdDate	string	Heure de création du cluster
properties.isAvailabilityZonesEnabled	boolean	Définit si le cluster prend en charge les zones de disponibilité. Cela peut être défini sur true uniquement dans les régions où Azure Data Explorer prend en charge Zones de disponibilité. Cette propriété ne peut pas être modifiée après la création du cluster. La valeur par défaut est « true » si la région prend en charge Zones de disponibilité.
properties.isDoubleEncryptionEnabled	boolean	Configure si le cluster utilisera le double chiffrement. Cette propriété ne peut pas être modifiée après la création du cluster. La valeur par défaut est « true »
properties.keyVaultProperties	keyVaultProperties	Propriétés de clé associées.
properties.lastModifiedDate	string	Dernière mise à jour du cluster.
properties.provisioningState	ClusterEntityStatus	État d’approvisionnement du cluster.
sku	ClusterSku	Propriétés de la référence sku.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ClusterEntityStatus

État d’approvisionnement du cluster.

Nom	Type	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

ClusterListResult

Réponse de l’opération de liste des clusters.

Nom	Type	Description
nextLink	string	Lien utilisé pour obtenir la page suivante de recommandations.
value	Cluster[]	Liste des clusters Log Analytics.

ClusterSku

Définition de la référence sku de cluster.

Nom	Type	Description
capacity	Capacity	Niveau de réservation de capacité en Gigaoctets pour ce cluster.
name	ClusterSkuNameEnum	Référence SKU (niveau) d’un cluster.

ClusterSkuNameEnum

Référence SKU (niveau) d’un cluster.

Nom	Type	Description
CapacityReservation	string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

keyVaultProperties

Propriétés du coffre de clés.

Nom	Type	Description
keyName	string	Nom de la clé associée au cluster Log Analytics.
keyRsaSize	integer	Taille minimale requise de la clé sélectionnée.
keyVaultUri	string	L’uri Key Vault qui contient la clé associée au cluster Log Analytics.
keyVersion	string	Version de la clé associée au cluster Log Analytics.

ManagedServiceIdentity

Identité de service managée (identités attribuées par le système et/ou attribuées par l’utilisateur)

Nom	Type	Description
principalId	string	ID de principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
userAssignedIdentities	<string, UserAssignedIdentity>	identités User-Assigned Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM au format « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs du dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Nom	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

Nom	Type	Description
clientId	string	ID client de l’identité affectée.
principalId	string	ID principal de l’identité affectée.

Partager via