Clusters - Update

Riferimento

Servizio:: Log Analytics

Versione API:: 2023-09-01

Aggiornamenti un cluster Log Analytics.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
clusterName	path	True	string	Nome del cluster Log Analytics.
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità della risorsa.
properties.billingType	BillingType	Tipo di fatturazione del cluster.
properties.keyVaultProperties	keyVaultProperties	Proprietà chiave associate.
sku	ClusterSku	Proprietà sku.
tags	object	Tag di risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	Cluster	Il cluster esistente è stato aggiornato correttamente. Controllare provisioningStatus per visualizzare lo stato dettagliato.
Other Status Codes	ErrorResponse	Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ClustersPatch

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
AssociatedWorkspace	Elenco delle aree di lavoro Log Analytics associate al cluster.
BillingType	Tipo di fatturazione del cluster.
Capacity	Livello di prenotazione della capacità in Gigabyte per questo cluster.
CapacityReservationProperties	Proprietà Della prenotazione della capacità.
Cluster	Contenitore di risorse del cluster Log Analytics di primo livello.
ClusterEntityStatus	Stato di provisioning del cluster.
ClusterPatch	Contenitore di risorse del cluster Log Analytics di primo livello.
ClusterSku	Definizione dello sku del cluster.
ClusterSkuNameEnum	SKU (livello) di un cluster.
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
keyVaultProperties	Proprietà dell'insieme di credenziali delle chiavi.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnata dal sistema e/o assegnata dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

AssociatedWorkspace

Elenco delle aree di lavoro Log Analytics associate al cluster.

Nome	Tipo	Descrizione
associateDate	string	Ora dell'associazione dell'area di lavoro.
resourceId	string	ID risorsa arm dell'area di lavoro associata, sotto forma di :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	ID non modificabile dell'area di lavoro associato.
workspaceName	string	Nome della risorsa dell'area di lavoro associata.

BillingType

Tipo di fatturazione del cluster.

Nome	Tipo	Descrizione
Cluster	string
Workspaces	string

Capacity

Livello di prenotazione della capacità in Gigabyte per questo cluster.

Nome	Tipo	Descrizione
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

CapacityReservationProperties

Proprietà Della prenotazione della capacità.

Nome	Tipo	Descrizione
lastSkuUpdate	string	L'ultima volta che sku è stato aggiornato.
minCapacity	integer	Valore minimo di CapacityReservation in Gigabytes.

Cluster

Contenitore di risorse del cluster Log Analytics di primo livello.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identità della risorsa.
location	string	Posizione geografica in cui vive la risorsa
name	string	nome della risorsa.
properties.associatedWorkspaces	AssociatedWorkspace[]	Elenco delle aree di lavoro Log Analytics associate al cluster
properties.billingType	BillingType	Tipo di fatturazione del cluster.
properties.capacityReservationProperties	CapacityReservationProperties	Proprietà aggiuntive per la prenotazione della capacità
properties.clusterId	string	ID associato al cluster.
properties.createdDate	string	Tempo di creazione del cluster
properties.isAvailabilityZonesEnabled	boolean	Imposta se il cluster supporta le zone di disponibilità. Questa opzione può essere impostata come true solo nelle aree in cui Azure Esplora dati supporta zone di disponibilità. Questa proprietà non può essere modificata dopo la creazione del cluster. Il valore predefinito è 'true' se l'area supporta zone di disponibilità.
properties.isDoubleEncryptionEnabled	boolean	Configura se il cluster userà la doppia crittografia. Questa proprietà non può essere modificata dopo la creazione del cluster. Il valore predefinito è 'true'
properties.keyVaultProperties	keyVaultProperties	Proprietà chiave associate.
properties.lastModifiedDate	string	Ultima volta che il cluster è stato aggiornato.
properties.provisioningState	ClusterEntityStatus	Stato di provisioning del cluster.
sku	ClusterSku	Proprietà sku.
tags	object	Tag di risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Stato di provisioning del cluster.

Nome	Tipo	Descrizione
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

ClusterPatch

Contenitore di risorse del cluster Log Analytics di primo livello.

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità della risorsa.
properties.billingType	BillingType	Tipo di fatturazione del cluster.
properties.keyVaultProperties	keyVaultProperties	Proprietà chiave associate.
sku	ClusterSku	Proprietà sku.
tags	object	Tag di risorse.

ClusterSku

Definizione dello sku del cluster.

Nome	Tipo	Descrizione
capacity	Capacity	Livello di prenotazione della capacità in Gigabyte per questo cluster.
name	ClusterSkuNameEnum	SKU (livello) di un cluster.

ClusterSkuNameEnum

SKU (livello) di un cluster.

Nome	Tipo	Descrizione
CapacityReservation	string

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

keyVaultProperties

Proprietà dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
keyName	string	Nome della chiave associata al cluster Log Analytics.
keyRsaSize	integer	Dimensioni minime necessarie per la chiave selezionata.
keyVaultUri	string	URI Key Vault che contiene la chiave associata al cluster Log Analytics.
keyVersion	string	Versione della chiave associata al cluster Log Analytics.

ManagedServiceIdentity

Identità del servizio gestita (identità assegnata dal sistema e/o assegnata dall'utente)

Nome	Tipo	Descrizione
principalId	string	ID dell'entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno id risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata.
principalId	string	ID principale dell'identità assegnata.

Condividi tramite