Clusters - Update
Updates einen Log Analytics-Cluster.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2023-09-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
cluster
|
path | True |
string |
Name des Log Analytics-Clusters. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
identity |
Die Identität der Ressource. |
|
properties.billingType |
Der Abrechnungstyp des Clusters. |
|
properties.keyVaultProperties |
Die zugeordneten Schlüsseleigenschaften. |
|
sku |
Die SKU-Eigenschaften. |
|
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der vorhandene Cluster wurde erfolgreich aktualisiert. Überprüfen Sie provisioningStatus, um detaillierte status anzuzeigen. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
ClustersPatch
Beispielanforderung
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"
}
}
Beispiel für eine Antwort
{
"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"
}
Definitionen
Name | Beschreibung |
---|---|
Associated |
Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind. |
Billing |
Der Abrechnungstyp des Clusters. |
Capacity |
Die Kapazitätsreservierungsebene in Gigabyte für diesen Cluster. |
Capacity |
Die Eigenschaften der Kapazitätsreservierung. |
Cluster |
Der Log Analytics-Clusterressourcencontainer der obersten Ebene. |
Cluster |
Der Bereitstellungsstatus des Clusters. |
Cluster |
Der Log Analytics-Clusterressourcencontainer der obersten Ebene. |
Cluster |
Die Definition der Cluster-SKU. |
Cluster |
Die SKU (Ebene) eines Clusters. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
key |
Die Schlüsseltresoreigenschaften. |
Managed |
Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten) |
Managed |
Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind). |
User |
Benutzerseitig zugewiesene Identitätseigenschaften |
AssociatedWorkspace
Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind.
Name | Typ | Beschreibung |
---|---|---|
associateDate |
string |
Die Zeit der Arbeitsbereichszuordnung. |
resourceId |
string |
Zugeordnete Ressourcen-ID des Arbeitsbereichsarms in form von: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}. |
workspaceId |
string |
Unveränderliche ID des zugeordneten Arbeitsbereichs. |
workspaceName |
string |
Name der zugeordneten Arbeitsbereichsressource. |
BillingType
Der Abrechnungstyp des Clusters.
Name | Typ | Beschreibung |
---|---|---|
Cluster |
string |
|
Workspaces |
string |
Capacity
Die Kapazitätsreservierungsebene in Gigabyte für diesen Cluster.
Name | Typ | Beschreibung |
---|---|---|
100 |
Integer |
|
1000 |
Integer |
|
10000 |
Integer |
|
200 |
Integer |
|
2000 |
Integer |
|
25000 |
Integer |
|
300 |
Integer |
|
400 |
Integer |
|
500 |
Integer |
|
5000 |
Integer |
|
50000 |
Integer |
CapacityReservationProperties
Die Eigenschaften der Kapazitätsreservierung.
Name | Typ | Beschreibung |
---|---|---|
lastSkuUpdate |
string |
Der Zeitpunkt, zu dem die SKU zuletzt aktualisiert wurde. |
minCapacity |
integer |
Minimaler CapacityReservation-Wert in Gigabyte. |
Cluster
Der Log Analytics-Clusterressourcencontainer der obersten Ebene.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
Die Identität der Ressource. |
|
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.associatedWorkspaces |
Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind |
|
properties.billingType |
Der Abrechnungstyp des Clusters. |
|
properties.capacityReservationProperties |
Zusätzliche Eigenschaften für die Kapazitätsreservierung |
|
properties.clusterId |
string |
Die id, die dem Cluster zugeordnet ist. |
properties.createdDate |
string |
Die Erstellungszeit des Clusters |
properties.isAvailabilityZonesEnabled |
boolean |
Legt fest, ob der Cluster Verfügbarkeitszonen unterstützt. Dies kann nur in Regionen, in denen Azure Data Explorer unterstützung Verfügbarkeitszonen, als true festgelegt werden. Diese Eigenschaft kann nach der Clustererstellung nicht geändert werden. Der Standardwert ist "true", wenn die Region Verfügbarkeitszonen unterstützt. |
properties.isDoubleEncryptionEnabled |
boolean |
Konfiguriert, ob der Cluster die doppelte Verschlüsselung verwendet. Diese Eigenschaft kann nach der Clustererstellung nicht geändert werden. Der Standardwert ist "true". |
properties.keyVaultProperties |
Die zugeordneten Schlüsseleigenschaften. |
|
properties.lastModifiedDate |
string |
Der Zeitpunkt, zu dem der Cluster zuletzt aktualisiert wurde. |
properties.provisioningState |
Der Bereitstellungsstatus des Clusters. |
|
sku |
Die SKU-Eigenschaften. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
ClusterEntityStatus
Der Bereitstellungsstatus des Clusters.
Name | Typ | Beschreibung |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
ProvisioningAccount |
string |
|
Succeeded |
string |
|
Updating |
string |
ClusterPatch
Der Log Analytics-Clusterressourcencontainer der obersten Ebene.
Name | Typ | Beschreibung |
---|---|---|
identity |
Die Identität der Ressource. |
|
properties.billingType |
Der Abrechnungstyp des Clusters. |
|
properties.keyVaultProperties |
Die zugeordneten Schlüsseleigenschaften. |
|
sku |
Die SKU-Eigenschaften. |
|
tags |
object |
Ressourcentags. |
ClusterSku
Die Definition der Cluster-SKU.
Name | Typ | Beschreibung |
---|---|---|
capacity |
Die Kapazitätsreservierungsebene in Gigabyte für diesen Cluster. |
|
name |
Die SKU (Ebene) eines Clusters. |
ClusterSkuNameEnum
Die SKU (Ebene) eines Clusters.
Name | Typ | Beschreibung |
---|---|---|
CapacityReservation |
string |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
keyVaultProperties
Die Schlüsseltresoreigenschaften.
Name | Typ | Beschreibung |
---|---|---|
keyName |
string |
Der Name des Schlüssels, der dem Log Analytics-Cluster zugeordnet ist. |
keyRsaSize |
integer |
Mindestens erforderliche Größe des ausgewählten Schlüssels. |
keyVaultUri |
string |
Der Key Vault URI, der den Schlüssel enthält, der dem Log Analytics-Cluster zugeordnet ist. |
keyVersion |
string |
Die Version des Schlüssels, der dem Log Analytics-Cluster zugeordnet ist. |
ManagedServiceIdentity
Verwaltete Dienstidentität (systemseitig zugewiesene und/oder benutzerseitig zugewiesene Identitäten)
Name | Typ | Beschreibung |
---|---|---|
principalId |
string |
Die Dienstprinzipal-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt. |
tenantId |
string |
Die Mandanten-ID der systemseitig zugewiesenen Identität. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt. |
type |
Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind). |
|
userAssignedIdentities |
<string,
User |
User-Assigned Identitäten |
ManagedServiceIdentityType
Typ der verwalteten Dienstidentität (wobei sowohl der SystemAssigned- als auch der UserAssigned-Typ zulässig sind).
Name | Typ | Beschreibung |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
UserAssignedIdentity
Benutzerseitig zugewiesene Identitätseigenschaften
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Die Client-ID der zugewiesenen Identität. |
principalId |
string |
Die Prinzipal-ID der zugewiesenen Identität. |