Clusters - Update

Referens

Tjänst:: Log Analytics

API-version:: 2023-09-01

Uppdateringar ett Log Analytics-kluster.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
clusterName	path	True	string	Namnet på Log Analytics-klustret.
resourceGroupName	path	True	string	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string	ID för målprenumerationen.
api-version	query	True	string	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
identity	ManagedServiceIdentity	Resursens identitet.
properties.billingType	BillingType	Klustrets faktureringstyp.
properties.keyVaultProperties	keyVaultProperties	De associerade nyckelegenskaperna.
sku	ClusterSku	SKU-egenskaperna.
tags	object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	Cluster	Det befintliga klustret uppdaterades. Kontrollera provisioningStatus för att se detaljerad status.
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ClustersPatch

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
AssociatedWorkspace	Listan över Log Analytics-arbetsytor som är associerade med klustret.
BillingType	Klustrets faktureringstyp.
Capacity	Kapacitetsreservationsnivån i Gigabyte för det här klustret.
CapacityReservationProperties	Egenskaper för kapacitetsreservation.
Cluster	Log Analytics-klusterresurscontainern på den översta nivån.
ClusterEntityStatus	Klustrets etableringstillstånd.
ClusterPatch	Log Analytics-klusterresurscontainern på den översta nivån.
ClusterSku	Kluster-SKU-definitionen.
ClusterSkuNameEnum	SKU:n (nivå) för ett kluster.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
keyVaultProperties	Egenskaperna för nyckelvalvet.
ManagedServiceIdentity	Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)
ManagedServiceIdentityType	Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
UserAssignedIdentity	Användartilldelade identitetsegenskaper

AssociatedWorkspace

Listan över Log Analytics-arbetsytor som är associerade med klustret.

Name	Typ	Description
associateDate	string	Tid för arbetsyteassociation.
resourceId	string	Associerad resurs-ID för arbetsytan i form av: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	Associerat arbetsyte oföränderligt ID.
workspaceName	string	Associerat resursnamn för arbetsytan.

BillingType

Klustrets faktureringstyp.

Name	Typ	Description
Cluster	string
Workspaces	string

Capacity

Kapacitetsreservationsnivån i Gigabyte för det här klustret.

Name	Typ	Description
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

CapacityReservationProperties

Egenskaper för kapacitetsreservation.

Name	Typ	Description
lastSkuUpdate	string	Senaste gången Sku uppdaterades.
minCapacity	integer	Minsta CapacityReservation-värde i Gigabytes.

Cluster

Log Analytics-klusterresurscontainern på den översta nivån.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Resursens identitet.
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.associatedWorkspaces	AssociatedWorkspace[]	Listan över Log Analytics-arbetsytor som är associerade med klustret
properties.billingType	BillingType	Klustrets faktureringstyp.
properties.capacityReservationProperties	CapacityReservationProperties	Ytterligare egenskaper för kapacitetsreservation
properties.clusterId	string	Det ID som är associerat med klustret.
properties.createdDate	string	Tiden då klustret skapades
properties.isAvailabilityZonesEnabled	boolean	Anger om klustret ska ha stöd för tillgänglighetszoner. Detta kan endast anges som sant i regioner där Azure Data Explorer stöder Tillgänglighetszoner. Det går inte att ändra den här egenskapen när klustret har skapats. Standardvärdet är "sant" om regionen stöder Tillgänglighetszoner.
properties.isDoubleEncryptionEnabled	boolean	Konfigurerar om klustret ska använda dubbel kryptering. Det går inte att ändra den här egenskapen när klustret har skapats. Standardvärdet är "true"
properties.keyVaultProperties	keyVaultProperties	De associerade nyckelegenskaperna.
properties.lastModifiedDate	string	Senaste gången klustret uppdaterades.
properties.provisioningState	ClusterEntityStatus	Klustrets etableringstillstånd.
sku	ClusterSku	SKU-egenskaperna.
tags	object	Resurstaggar.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Klustrets etableringstillstånd.

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

ClusterPatch

Log Analytics-klusterresurscontainern på den översta nivån.

Name	Typ	Description
identity	ManagedServiceIdentity	Resursens identitet.
properties.billingType	BillingType	Klustrets faktureringstyp.
properties.keyVaultProperties	keyVaultProperties	De associerade nyckelegenskaperna.
sku	ClusterSku	SKU-egenskaperna.
tags	object	Resurstaggar.

ClusterSku

Kluster-SKU-definitionen.

Name	Typ	Description
capacity	Capacity	Kapacitetsreservationsnivån i Gigabyte för det här klustret.
name	ClusterSkuNameEnum	SKU:n (nivå) för ett kluster.

ClusterSkuNameEnum

SKU:n (nivå) för ett kluster.

Name	Typ	Description
CapacityReservation	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

keyVaultProperties

Egenskaperna för nyckelvalvet.

Name	Typ	Description
keyName	string	Namnet på nyckeln som är associerad med Log Analytics-klustret.
keyRsaSize	integer	Minsta storlek som krävs för den valda nyckeln.
keyVaultUri	string	Den Key Vault uri som innehåller nyckeln som är associerad med Log Analytics-klustret.
keyVersion	string	Versionen av nyckeln som är associerad med Log Analytics-klustret.

ManagedServiceIdentity

Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)

Name	Typ	Description
principalId	string	Tjänstens huvudnamns-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet.
tenantId	string	Klientorganisations-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet.
type	ManagedServiceIdentityType	Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteter Den uppsättning användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden.

ManagedServiceIdentityType

Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).

Name	Typ	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Användartilldelade identitetsegenskaper

Name	Typ	Description
clientId	string	Klient-ID för den tilldelade identiteten.
principalId	string	Huvud-ID för den tilldelade identiteten.

Dela via