Clusters - Create Or Update

Ссылка

Service:: Log Analytics

API Version:: 2022-10-01

Создание или обновление кластера Log Analytics.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
clusterName	path	True	string	Имя кластера Log Analytics. Regex pattern: `^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$`
resourceGroupName	path	True	string	Имя группы ресурсов. Регистр букв в имени не учитывается.
subscriptionId	path	True	string	Идентификатор целевой подписки.
api-version	query	True	string	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
identity		ManagedServiceIdentity	Удостоверение ресурса.
properties.associatedWorkspaces		AssociatedWorkspace[]	Список рабочих областей Log Analytics, связанных с кластером
properties.billingType		BillingType	Тип выставления счетов кластера.
properties.capacityReservationProperties		CapacityReservationProperties	Дополнительные свойства для резервирования емкости
properties.isAvailabilityZonesEnabled		boolean	Задает, будет ли кластер поддерживать зоны доступности. Значение true можно задать только в регионах, где Data Explorer Azure поддерживает Зоны доступности. Это свойство нельзя изменить после создания кластера. Значение по умолчанию — true, если регион поддерживает Зоны доступности.
properties.isDoubleEncryptionEnabled		boolean	Определяет, будет ли кластер использовать двойное шифрование. Это свойство нельзя изменить после создания кластера. Значение по умолчанию — true.
properties.keyVaultProperties		keyVaultProperties	Связанные свойства ключа.
sku		ClusterSku	Свойства SKU.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	Cluster	Определение ответа OK.
201 Created	Cluster	Создано определение ответа.
202 Accepted		Определение принятого ответа.
Other Status Codes	ErrorResponse	Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

ClustersCreate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2022-10-01

{
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Sample Response

Status code:: 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=2021-06-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=2015-11-01-preview

Status code:: 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"
}

Status code:: 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"
}

Определения

Имя	Описание
AssociatedWorkspace	Список рабочих областей Log Analytics, связанных с кластером.
BillingType	Тип выставления счетов кластера.
Capacity	Уровень резервирования емкости в гигабайтах для этого кластера.
CapacityReservationProperties	Свойства резервирования мощности.
Cluster	Контейнер ресурсов кластера Log Analytics верхнего уровня.
ClusterEntityStatus	Состояние подготовки кластера.
ClusterSku	Определение SKU кластера.
ClusterSkuNameEnum	SKU (уровень) кластера.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
keyVaultProperties	Свойства хранилища ключей.
ManagedServiceIdentity	Управляемое удостоверение службы (назначаемые системой и /или назначенные пользователем удостоверения)
ManagedServiceIdentityType	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
UserAssignedIdentity	Свойства удостоверения, назначаемые пользователем

AssociatedWorkspace

Список рабочих областей Log Analytics, связанных с кластером.

Имя	Тип	Описание
associateDate	string	Время сопоставления рабочей области.
resourceId	string	Связанный идентификатор ресурса arm рабочей области в формате : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string	Связанная рабочая область неизменяемый идентификатор.
workspaceName	string	Имя связанного ресурса рабочей области.

BillingType

Тип выставления счетов кластера.

Имя	Тип	Описание
Cluster	string
Workspaces	string

Capacity

Уровень резервирования емкости в гигабайтах для этого кластера.

Имя	Тип	Описание
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

CapacityReservationProperties

Свойства резервирования мощности.

Имя	Тип	Описание
lastSkuUpdate	string	Время последнего обновления SKU.
minCapacity	integer	Минимальное значение CapacityReservation в гигабайтах.

Cluster

Контейнер ресурсов кластера Log Analytics верхнего уровня.

Имя	Тип	Описание
id	string	Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Удостоверение ресурса.
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties.associatedWorkspaces	AssociatedWorkspace[]	Список рабочих областей Log Analytics, связанных с кластером
properties.billingType	BillingType	Тип выставления счетов кластера.
properties.capacityReservationProperties	CapacityReservationProperties	Дополнительные свойства для резервирования емкости
properties.clusterId	string	Идентификатор, связанный с кластером.
properties.createdDate	string	Время создания кластера
properties.isAvailabilityZonesEnabled	boolean	Задает, будет ли кластер поддерживать зоны доступности. Значение true можно задать только в регионах, где Data Explorer Azure поддерживает Зоны доступности. Это свойство нельзя изменить после создания кластера. Значение по умолчанию — true, если регион поддерживает Зоны доступности.
properties.isDoubleEncryptionEnabled	boolean	Определяет, будет ли кластер использовать двойное шифрование. Это свойство нельзя изменить после создания кластера. Значение по умолчанию — true.
properties.keyVaultProperties	keyVaultProperties	Связанные свойства ключа.
properties.lastModifiedDate	string	Время последнего обновления кластера.
properties.provisioningState	ClusterEntityStatus	Состояние подготовки кластера.
sku	ClusterSku	Свойства SKU.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Состояние подготовки кластера.

Имя	Тип	Описание
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

ClusterSku

Определение SKU кластера.

Имя	Тип	Описание
capacity	Capacity	Уровень резервирования емкости в гигабайтах для этого кластера.
name	ClusterSkuNameEnum	SKU (уровень) кластера.

ClusterSkuNameEnum

SKU (уровень) кластера.

Имя	Тип	Описание
CapacityReservation	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

keyVaultProperties

Свойства хранилища ключей.

Имя	Тип	Описание
keyName	string	Имя ключа, связанного с кластером Log Analytics.
keyRsaSize	integer	Выбранный минимальный требуемый размер ключа.
keyVaultUri	string	URI Key Vault, содержащий ключ, связанный с кластером Log Analytics.
keyVersion	string	Версия ключа, связанного с кластером Log Analytics.

ManagedServiceIdentity

Управляемое удостоверение службы (назначаемые системой и /или назначенные пользователем удостоверения)

Имя	Тип	Описание
principalId	string	Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство предоставляется только для удостоверения, назначаемого системой.
tenantId	string	Идентификатор клиента удостоверения, назначаемого системой. Это свойство предоставляется только для удостоверения, назначаемого системой.
type	ManagedServiceIdentityType	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	Удостоверения User-Assigned Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут иметь идентификаторы ресурсов ARM в формате :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

Имя	Тип	Описание
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

Свойства удостоверения, назначаемые пользователем

Имя	Тип	Описание
clientId	string	Идентификатор клиента назначенного удостоверения.
principalId	string	Идентификатор субъекта назначенного удостоверения.

Share via