共用方式為


Clusters - Create Or Update

建立或更新Log Analytics叢集。

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

URI 參數

名稱 位於 必要 類型 Description
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 版本。

要求本文

名稱 必要 類型 Description
location True

string

資源所在的地理位置

identity

ManagedServiceIdentity

資源的身分識別。

properties.associatedWorkspaces

AssociatedWorkspace[]

與叢集相關聯的Log Analytics工作區清單

properties.billingType

BillingType

叢集的計費類型。

properties.capacityReservationProperties

CapacityReservationProperties

容量保留的其他屬性

properties.isAvailabilityZonesEnabled

boolean

設定叢集是否支援可用性區域。 這隻能在 Azure Data Explorer 支援 可用性區域 的區域設定為 true。 建立叢集之後,就無法修改此屬性。 如果區域支援 可用性區域,預設值為 'true'。

properties.isDoubleEncryptionEnabled

boolean

設定叢集是否會使用雙重加密。 建立叢集之後,就無法修改此屬性。 默認值為 'true'

properties.keyVaultProperties

keyVaultProperties

相關聯的索引鍵屬性。

sku

ClusterSku

SKU 屬性。

tags

object

資源標籤。

回應

名稱 類型 Description
200 OK

Cluster

確定回應定義。

201 Created

Cluster

已建立回應定義。

202 Accepted

接受的回應定義。

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

ClustersCreate

Sample Request

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

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

定義

名稱 Description
AssociatedWorkspace

與叢集相關聯的Log Analytics工作區清單。

BillingType

叢集的計費類型。

Capacity

此叢集的容量保留層級為 GB。

CapacityReservationProperties

容量保留屬性。

Cluster

最上層Log Analytics叢集資源容器。

ClusterEntityStatus

叢集的布建狀態。

ClusterSku

叢集 SKU 定義。

ClusterSkuNameEnum

叢集的 SKU (層) 。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

keyVaultProperties

金鑰保存庫屬性。

ManagedServiceIdentity

受控服務識別 (系統指派和/或使用者指派的身分識別)

ManagedServiceIdentityType

(允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。

UserAssignedIdentity

使用者指派的身分識別屬性

AssociatedWorkspace

與叢集相關聯的Log Analytics工作區清單。

名稱 類型 Description
associateDate

string

工作區關聯的時間。

resourceId

string

相關聯的工作區 arm 資源標識符,格式為:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}。

workspaceId

string

相關聯的工作區不可變標識碼。

workspaceName

string

相關聯的工作區資源名稱。

BillingType

叢集的計費類型。

名稱 類型 Description
Cluster

string

Workspaces

string

Capacity

此叢集的容量保留層級為 GB。

名稱 類型 Description
100

Integer

1000

Integer

10000

Integer

200

Integer

2000

Integer

25000

Integer

300

Integer

400

Integer

500

Integer

5000

Integer

50000

Integer

CapacityReservationProperties

容量保留屬性。

名稱 類型 Description
lastSkuUpdate

string

上次更新 Sku 的時間。

minCapacity

integer

以 GB 為單位的最小 CapacityReservation 值。

Cluster

最上層Log Analytics叢集資源容器。

名稱 類型 Description
id

string

資源的完整資源識別碼。 Ex - /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

設定叢集是否支援可用性區域。 這隻能在 Azure Data Explorer 支援 可用性區域 的區域設定為 true。 建立叢集之後,就無法修改此屬性。 如果區域支援 可用性區域,預設值為 '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

叢集的布建狀態。

名稱 類型 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

ProvisioningAccount

string

Succeeded

string

Updating

string

ClusterSku

叢集 SKU 定義。

名稱 類型 Description
capacity

Capacity

此叢集的容量保留層級為 GB。

name

ClusterSkuNameEnum

叢集的 SKU (層) 。

ClusterSkuNameEnum

叢集的 SKU (層) 。

名稱 類型 Description
CapacityReservation

string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

keyVaultProperties

金鑰保存庫屬性。

名稱 類型 Description
keyName

string

與 Log Analytics 叢集相關聯的金鑰名稱。

keyRsaSize

integer

選取的金鑰大小下限。

keyVaultUri

string

金鑰保存庫 uri,其會保存與 Log Analytics 叢集相關聯的密鑰。

keyVersion

string

與 Log Analytics 叢集相關聯的金鑰版本。

ManagedServiceIdentity

受控服務識別 (系統指派和/或使用者指派的身分識別)

名稱 類型 Description
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 類型的受控服務識別類型) 。

名稱 類型 Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

UserAssignedIdentity

使用者指派的身分識別屬性

名稱 類型 Description
clientId

string

指派之身分識別的用戶端標識碼。

principalId

string

指派之身分識別的主體標識碼。