Clusters - Create Or Update

Odwołanie

Usługa:: Log Analytics

Wersja interfejsu API:: 2023-09-01

Utwórz lub zaktualizuj klaster usługi Log Analytics.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
clusterName	path	True	string	Nazwa klastra usługi Log Analytics. Wzorzec wyrażenia regularnego: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
subscriptionId	path	True	string	Identyfikator subskrypcji docelowej.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
identity		ManagedServiceIdentity	Tożsamość zasobu.
properties.associatedWorkspaces		AssociatedWorkspace[]	Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem
properties.billingType		BillingType	Typ rozliczeń klastra.
properties.capacityReservationProperties		CapacityReservationProperties	Dodatkowe właściwości rezerwacji pojemności
properties.isAvailabilityZonesEnabled		boolean	Określa, czy klaster będzie obsługiwał strefy dostępności. Można to ustawić jako prawdziwe tylko w regionach, w których usługa Azure Data Explorer obsługuje Strefy dostępności. Nie można zmodyfikować tej właściwości po utworzeniu klastra. Wartość domyślna to "true", jeśli region obsługuje Strefy dostępności.
properties.isDoubleEncryptionEnabled		boolean	Określa, czy klaster będzie używać podwójnego szyfrowania. Nie można zmodyfikować tej właściwości po utworzeniu klastra. Wartość domyślna to "true"
properties.keyVaultProperties		keyVaultProperties	Skojarzone właściwości klucza.
sku		ClusterSku	Właściwości jednostki SKU.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Cluster	Definicja odpowiedzi OK.
201 Created	Cluster	Utworzono definicję odpowiedzi.
202 Accepted		Zaakceptowana definicja odpowiedzi.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ClustersCreate

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Kod stanu:: 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"
}

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
AssociatedWorkspace	Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem.
BillingType	Typ rozliczeń klastra.
Capacity	Poziom rezerwacji pojemności w gigabajtach dla tego klastra.
CapacityReservationProperties	Właściwości Rezerwacja pojemności.
Cluster	Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.
ClusterEntityStatus	Stan aprowizacji klastra.
ClusterSku	Definicja jednostki SKU klastra.
ClusterSkuNameEnum	Jednostka SKU (warstwa) klastra.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
keyVaultProperties	Właściwości magazynu kluczy.
ManagedServiceIdentity	Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub przypisane przez użytkownika)
ManagedServiceIdentityType	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
UserAssignedIdentity	Właściwości tożsamości przypisanej przez użytkownika

AssociatedWorkspace

Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem.

Nazwa	Typ	Opis
associateDate	string	Czas skojarzenia obszaru roboczego.
resourceId	string	Skojarzony identyfikator zasobu arm obszaru roboczego w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	Skojarzony identyfikator niezmiennego obszaru roboczego.
workspaceName	string	Skojarzona nazwa zasobu obszaru roboczego.

BillingType

Typ rozliczeń klastra.

Nazwa	Typ	Opis
Cluster	string
Workspaces	string

Capacity

Poziom rezerwacji pojemności w gigabajtach dla tego klastra.

Nazwa	Typ	Opis
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

CapacityReservationProperties

Właściwości Rezerwacja pojemności.

Nazwa	Typ	Opis
lastSkuUpdate	string	Czas ostatniej aktualizacji jednostki SKU.
minCapacity	integer	Minimalna wartość capacityReservation w gigabajtach.

Cluster

Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Tożsamość zasobu.
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.associatedWorkspaces	AssociatedWorkspace[]	Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem
properties.billingType	BillingType	Typ rozliczeń klastra.
properties.capacityReservationProperties	CapacityReservationProperties	Dodatkowe właściwości rezerwacji pojemności
properties.clusterId	string	Identyfikator skojarzony z klastrem.
properties.createdDate	string	Czas tworzenia klastra
properties.isAvailabilityZonesEnabled	boolean	Określa, czy klaster będzie obsługiwał strefy dostępności. Można to ustawić jako prawdziwe tylko w regionach, w których usługa Azure Data Explorer obsługuje Strefy dostępności. Nie można zmodyfikować tej właściwości po utworzeniu klastra. Wartość domyślna to "true", jeśli region obsługuje Strefy dostępności.
properties.isDoubleEncryptionEnabled	boolean	Określa, czy klaster będzie używać podwójnego szyfrowania. Nie można zmodyfikować tej właściwości po utworzeniu klastra. Wartość domyślna to "true"
properties.keyVaultProperties	keyVaultProperties	Skojarzone właściwości klucza.
properties.lastModifiedDate	string	Ostatni raz klaster został zaktualizowany.
properties.provisioningState	ClusterEntityStatus	Stan aprowizacji klastra.
sku	ClusterSku	Właściwości jednostki SKU.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Stan aprowizacji klastra.

Nazwa	Typ	Opis
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

ClusterSku

Definicja jednostki SKU klastra.

Nazwa	Typ	Opis
capacity	Capacity	Poziom rezerwacji pojemności w gigabajtach dla tego klastra.
name	ClusterSkuNameEnum	Jednostka SKU (warstwa) klastra.

ClusterSkuNameEnum

Jednostka SKU (warstwa) klastra.

Nazwa	Typ	Opis
CapacityReservation	string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

keyVaultProperties

Właściwości magazynu kluczy.

Nazwa	Typ	Opis
keyName	string	Nazwa klucza skojarzonego z klastrem usługi Log Analytics.
keyRsaSize	integer	Wybrany minimalny wymagany rozmiar klucza.
keyVaultUri	string	Identyfikator URI Key Vault, który przechowuje klucz skojarzony z klastrem usługi Log Analytics.
keyVersion	string	Wersja klucza skojarzonego z klastrem usługi Log Analytics.

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub przypisane przez użytkownika)

Nazwa	Typ	Opis
principalId	string	Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.
tenantId	string	Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.
type	ManagedServiceIdentityType	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	tożsamości User-Assigned Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

Nazwa	Typ	Opis
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Właściwości tożsamości przypisanej przez użytkownika

Nazwa	Typ	Opis
clientId	string	Identyfikator klienta przypisanej tożsamości.
principalId	string	Identyfikator podmiotu zabezpieczeń przypisanej tożsamości.

Udostępnij za pośrednictwem