Clusters - Update

Référence

Service:: Log Analytics

API Version:: 2022-10-01

Mises à jour un cluster Log Analytics.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
clusterName	path	True	string	Nom du cluster Log Analytics.
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.

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. Consultez provisioningStatus pour afficher des status détaillées.
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
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Exemples

ClustersPatch

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2022-10-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"
  }
}

Sample Response

Status code:: 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 par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
UserAssignedIdentity	Propriétés de l’identité affectée par l’utilisateur

AssociatedWorkspace

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	ID de ressource 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 la réservation de capacité.

Nom	Type	Description
lastSkuUpdate	string	La dernière fois que la référence SKU a été mise à jour.
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	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

État d’approvisionnement du cluster.

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

ClusterPatch

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

Définition de la référence SKU du 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 error.

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 affectées par le système et/ou 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 sont 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 de l’identité affectée 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