Clusters - Create Or Update

Referentie

Service:: Log Analytics

API-versie:: 2023-09-01

Een Log Analytics-cluster maken of bijwerken.

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

URI-parameters

Name	In	Vereist	Type	Description
clusterName	path	True	string	De naam van het Log Analytics-cluster. Regex-patroon: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string	De id van het doelabonnement.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
identity		ManagedServiceIdentity	De identiteit van de resource.
properties.associatedWorkspaces		AssociatedWorkspace[]	De lijst met Log Analytics-werkruimten die zijn gekoppeld aan het cluster
properties.billingType		BillingType	Het factureringstype van het cluster.
properties.capacityReservationProperties		CapacityReservationProperties	Aanvullende eigenschappen voor capaciteitsreservering
properties.isAvailabilityZonesEnabled		boolean	Hiermee stelt u in of het cluster beschikbaarheidszones ondersteunt. Dit kan alleen worden ingesteld als waar in regio's waar Azure Data Explorer ondersteuning bieden voor Beschikbaarheidszones. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true' als regio Beschikbaarheidszones ondersteunt.
properties.isDoubleEncryptionEnabled		boolean	Hiermee configureert u of het cluster dubbele versleuteling gebruikt. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true'
properties.keyVaultProperties		keyVaultProperties	De bijbehorende sleuteleigenschappen.
sku		ClusterSku	De SKU-eigenschappen.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Cluster	Definitie van OK-antwoord.
201 Created	Cluster	Antwoorddefinitie gemaakt.
202 Accepted		Geaccepteerde antwoorddefinitie.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ClustersCreate

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Statuscode:: 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"
}

Statuscode:: 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"
}

Definities

Name	Description
AssociatedWorkspace	De lijst met Log Analytics-werkruimten die zijn gekoppeld aan het cluster.
BillingType	Het factureringstype van het cluster.
Capacity	Het capaciteitsreserveringsniveau in gigabytes voor dit cluster.
CapacityReservationProperties	De eigenschappen van capaciteitsreservering.
Cluster	De resourcecontainer op het hoogste niveau van het Log Analytics-cluster.
ClusterEntityStatus	De inrichtingsstatus van het cluster.
ClusterSku	De definitie van de cluster-SKU.
ClusterSkuNameEnum	De SKU (laag) van een cluster.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
keyVaultProperties	De eigenschappen van de sleutelkluis.
ManagedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)
ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned als UserAssigned zijn toegestaan).
UserAssignedIdentity	Eigenschappen van door de gebruiker toegewezen identiteit

AssociatedWorkspace

De lijst met Log Analytics-werkruimten die zijn gekoppeld aan het cluster.

Name	Type	Description
associateDate	string	Het tijdstip van de werkruimtekoppeling.
resourceId	string	Resource-id van de gekoppelde werkruimtearm, in de vorm van: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	De onveranderbare id van de gekoppelde werkruimte.
workspaceName	string	Resourcenaam van de gekoppelde werkruimte.

BillingType

Het factureringstype van het cluster.

Name	Type	Description
Cluster	string
Workspaces	string

Capacity

Het capaciteitsreserveringsniveau in gigabytes voor dit cluster.

Name	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

De eigenschappen van capaciteitsreservering.

Name	Type	Description
lastSkuUpdate	string	De laatste keer dat SKU is bijgewerkt.
minCapacity	integer	Minimumwaarde voor CapacityReservation in Gigabytes.

Cluster

De resourcecontainer op het hoogste niveau van het Log Analytics-cluster.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	De identiteit van de resource.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.associatedWorkspaces	AssociatedWorkspace[]	De lijst met Log Analytics-werkruimten die zijn gekoppeld aan het cluster
properties.billingType	BillingType	Het factureringstype van het cluster.
properties.capacityReservationProperties	CapacityReservationProperties	Aanvullende eigenschappen voor capaciteitsreservering
properties.clusterId	string	De id die is gekoppeld aan het cluster.
properties.createdDate	string	De aanmaaktijd van het cluster
properties.isAvailabilityZonesEnabled	boolean	Hiermee stelt u in of het cluster beschikbaarheidszones ondersteunt. Dit kan alleen worden ingesteld als waar in regio's waar Azure Data Explorer ondersteuning bieden voor Beschikbaarheidszones. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true' als regio Beschikbaarheidszones ondersteunt.
properties.isDoubleEncryptionEnabled	boolean	Hiermee configureert u of het cluster dubbele versleuteling gebruikt. Deze eigenschap kan niet worden gewijzigd nadat het cluster is gemaakt. De standaardwaarde is 'true'
properties.keyVaultProperties	keyVaultProperties	De bijbehorende sleuteleigenschappen.
properties.lastModifiedDate	string	De laatste keer dat het cluster is bijgewerkt.
properties.provisioningState	ClusterEntityStatus	De inrichtingsstatus van het cluster.
sku	ClusterSku	De SKU-eigenschappen.
tags	object	Resourcetags.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ClusterEntityStatus

De inrichtingsstatus van het cluster.

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

ClusterSku

De definitie van de cluster-SKU.

Name	Type	Description
capacity	Capacity	Het capaciteitsreserveringsniveau in gigabytes voor dit cluster.
name	ClusterSkuNameEnum	De SKU (laag) van een cluster.

ClusterSkuNameEnum

De SKU (laag) van een cluster.

Name	Type	Description
CapacityReservation	string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

keyVaultProperties

De eigenschappen van de sleutelkluis.

Name	Type	Description
keyName	string	De naam van de sleutel die is gekoppeld aan het Log Analytics-cluster.
keyRsaSize	integer	Geselecteerde sleutel minimale vereiste grootte.
keyVaultUri	string	De Key Vault-URI die de sleutel bevat die is gekoppeld aan het Log Analytics-cluster.
keyVersion	string	De versie van de sleutel die is gekoppeld aan het Log Analytics-cluster.

ManagedServiceIdentity

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name	Type	Description
principalId	string	De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen opgegeven voor een door het systeem toegewezen identiteit.
tenantId	string	De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen opgegeven voor een door het systeem toegewezen identiteit.
type	ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned als UserAssigned zijn toegestaan).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteiten De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De userAssignedIdentities-woordenlijstsleutels zijn ARM-resource-id's in de volgende notatie: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De woordenlijstwaarden kunnen lege objecten ({}) in aanvragen zijn.

ManagedServiceIdentityType

Type beheerde service-identiteit (waarbij zowel SystemAssigned als UserAssigned zijn toegestaan).

Name	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Eigenschappen van door de gebruiker toegewezen identiteit

Name	Type	Description
clientId	string	De client-id van de toegewezen identiteit.
principalId	string	De principal-id van de toegewezen identiteit.

Delen via