Clusters - Create Or Update

Référence

Service:: Log Analytics

Version d'API:: 2023-09-01

Créer ou mettre à jour un cluster Log Analytics.

PUT 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. Modèle d’expression régulière: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
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	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
identity		ManagedServiceIdentity	Identité 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.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.
sku		ClusterSku	Propriétés de la référence sku.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	Cluster	Définition de réponse OK.
201 Created	Cluster	Définition de réponse créée.
202 Accepted		Définition de réponse acceptée.
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

ClustersCreate

Exemple de requête

HTTP

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

{
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Exemple de réponse

Code d’état:: 202

Location: https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685/operationresults/c0f02ffd-0d4e-491e-a10c-fb82a1543a77?api-version=2023-09-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/providers/Microsoft.OperationalInsights/locations/eastus/operationstatuses/c0f02ffd-0d4e-491e-a10c-fb82a1543a77?api-version=2023-09-01

Code d’état:: 200

{
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "provisioningState": "ProvisioningAccount",
    "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": [],
    "capacityReservationProperties": {
      "lastSkuUpdate": "Thu, 01 Jan 1970 00:00:00 GMT",
      "minCapacity": 100
    }
  },
  "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "location": "australiasoutheast"
}

Code d’état:: 201

{
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "provisioningState": "ProvisioningAccount",
    "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": [],
    "capacityReservationProperties": {
      "lastSkuUpdate": "Thu, 01 Jan 1970 00:00:00 GMT",
      "minCapacity": 100
    }
  },
  "id": "/subscriptions/594038b5-1093-476e-a366-482775671c11/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "location": "australiasoutheast"
}

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

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