Clusters - Create Or Update

Riferimento

Servizio:: Log Analytics

Versione API:: 2023-09-01

Creare o aggiornare un cluster di Log Analytics.

PUT 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 di Log Analytics. Criterio di espressione regolare: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
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	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
identity		ManagedServiceIdentity	Identità della risorsa.
properties.associatedWorkspaces		AssociatedWorkspace[]	Elenco di 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.isAvailabilityZonesEnabled		boolean	Imposta un valore che indica se il cluster supporterà le zone di disponibilità. Questa impostazione può essere impostata su 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.
sku		ClusterSku	Proprietà sku.
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	Cluster	Definizione di risposta OK.
201 Created	Cluster	Definizione della risposta creata.
202 Accepted		Definizione di risposta accettata.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui 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

ClustersCreate

Esempio di richiesta

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

Risposta di esempio

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

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

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

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 cluster di Log Analytics di primo livello.
ClusterEntityStatus	Stato di provisioning del cluster.
ClusterSku	Definizione dello SKU del cluster.
ClusterSkuNameEnum	SKU (livello) di un cluster.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di 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à assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti i tipi SystemAssigned e 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 associata.
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	Ora dell'ultimo aggiornamento dello SKU.
minCapacity	integer	Valore minimo capacityReservation in Gigabytes.

Cluster

Contenitore di risorse cluster di Log Analytics di primo livello.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identità della risorsa.
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.associatedWorkspaces	AssociatedWorkspace[]	Elenco di 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	Ora di creazione del cluster
properties.isAvailabilityZonesEnabled	boolean	Imposta un valore che indica se il cluster supporterà le zone di disponibilità. Questa impostazione può essere impostata su 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	Ora dell'ultimo aggiornamento del cluster.
properties.provisioningState	ClusterEntityStatus	Stato di provisioning del cluster.
sku	ClusterSku	Proprietà sku.
tags	object	Tag delle 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

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 sull'errore di 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 di Log Analytics.
keyRsaSize	integer	Dimensione minima richiesta della chiave selezionata.
keyVaultUri	string	URI Key Vault che contiene la chiave associata al cluster di Log Analytics.
keyVersion	string	Versione della chiave associata al cluster di Log Analytics.

ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate 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 i tipi SystemAssigned e 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 i tipi SystemAssigned e 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