Partager via

Clusters - Update

  • Référence
Service:
Log Analytics
Version d'API:
2023-09-01

Mises à 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

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
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

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 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.