Clusters - Update

Référence

Service:: Log Analytics

Version d'API:: 2023-09-01

Met à jour un cluster Log Analytics.

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

Paramètres URI

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

Corps de la demande

Nom	Type	Description
identity	ManagedServiceIdentity	Identité de la ressource.
properties.billingType	BillingType	Type de facturation du cluster.
properties.keyVaultProperties	keyVaultProperties	Propriétés de clé associées.
sku	ClusterSku	Propriétés de la référence SKU.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	Cluster	Le cluster existant a été correctement mis à jour. Vérifiez provisioningStatus pour afficher l’état détaillé.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

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

ClustersPatch

Exemple de requête

HTTP

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

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {}
    }
  },
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "",
      "keyRsaSize": 1024
    }
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "tags": {
    "tag1": "val1"
  }
}

Exemple de réponse

Code d’état:: 200

{
  "identity": {
    "type": "UserAssigned",
    "tenantId": "72f999bf-acf1-41af-91ab-2d7cd011db47",
    "userAssignedIdentities": {
      "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {
        "clientId": "eb3a943d-6b12-48a6-b585-ac2316e15ab2",
        "principalId": "b31776d4-ee80-4860-9433-ec0101be1891"
      }
    }
  },
  "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",
    "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
    }
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685"
}

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 la réservation de capacité.
Cluster	Conteneur de ressources de cluster Log Analytics de niveau supérieur.
ClusterEntityStatus	État d’approvisionnement du cluster.
ClusterPatch	Conteneur de ressources de cluster Log Analytics de niveau supérieur.
ClusterSku	Définition de la référence SKU du 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 affectées par le système et/ou identités affecté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

Object

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

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

BillingType

Énumération

Type de facturation du cluster.

Valeur	Description
Cluster
Workspaces

Capacity

Énumération

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

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

CapacityReservationProperties

Object

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

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

Cluster

Object

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 comme true uniquement dans les régions où Azure Data Explorer prend en charge les 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 les 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	La dernière fois que le cluster a été mis à jour.
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

Énumération

État d’approvisionnement du cluster.

Valeur	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

ClusterPatch

Object

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

Nom	Type	Description
identity	ManagedServiceIdentity	Identité de la ressource.
properties.billingType	BillingType	Type de facturation du cluster.
properties.keyVaultProperties	keyVaultProperties	Propriétés de clé associées.
sku	ClusterSku	Propriétés de la référence SKU.
tags	object	Balises de ressource.

ClusterSku

Object

Définition de la référence SKU du cluster.

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

ClusterSkuNameEnum

Énumération

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

Valeur	Description
CapacityReservation

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

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

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

keyVaultProperties

Object

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 (int32)	Taille minimale minimale de la clé sélectionnée.
keyVaultUri	string	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

Object

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

Nom	Type	Description
principalId	string (uuid)	ID du 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 (uuid)	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 sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Énumération

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

Valeur	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

UserAssignedIdentity

Object

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

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

Partager via

Clusters - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

ClustersPatch

Exemple de requête

Exemple de réponse

Définitions

AssociatedWorkspace

BillingType

Capacity

CapacityReservationProperties

Cluster

ClusterEntityStatus

ClusterPatch

ClusterSku

ClusterSkuNameEnum

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

keyVaultProperties

ManagedServiceIdentity

ManagedServiceIdentityType

UserAssignedIdentity

Ressources supplémentaires