你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Clusters - Update

参考

Service:: Log Analytics

API Version:: 2022-10-01

汇报 Log Analytics 群集。

PATCH 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 群集的名称。
resourceGroupName	path	True	string	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string	目标订阅的 ID。
api-version	query	True	string	要用于此操作的 API 版本。

请求正文

名称	类型	说明
identity	ManagedServiceIdentity	资源的标识。
properties.billingType	BillingType	群集的计费类型。
properties.keyVaultProperties	keyVaultProperties	关联的键属性。
sku	ClusterSku	SKU 属性。
tags	object	资源标记。

响应

名称	类型	说明
200 OK	Cluster	已成功更新现有群集。检查 provisioningStatus 以查看详细状态。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

ClustersPatch

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2022-10-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"
  }
}

Sample Response

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

定义

名称	说明
AssociatedWorkspace	与群集关联的 Log Analytics 工作区列表。
BillingType	群集的计费类型。
Capacity	此群集的容量预留级别（以 GB 为单位）。
CapacityReservationProperties	容量预留属性。
Cluster	顶级 Log Analytics 群集资源容器。
ClusterEntityStatus	群集的预配状态。
ClusterPatch	顶级 Log Analytics 群集资源容器。
ClusterSku	群集 SKU 定义。
ClusterSkuNameEnum	群集的 SKU (层) 。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
keyVaultProperties	密钥保管库属性。
ManagedServiceIdentity	托管服务标识 (系统分配的标识和/或用户分配的标识)
ManagedServiceIdentityType	托管服务标识的类型 (其中允许 systemAssigned 和 UserAssigned 类型) 。
UserAssignedIdentity	用户分配的标识属性

AssociatedWorkspace

与群集关联的 Log Analytics 工作区列表。

名称	类型	说明
associateDate	string	工作区关联的时间。
resourceId	string	关联的工作区 arm 资源 ID，格式为：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}。
workspaceId	string	关联的工作区不可变 ID。
workspaceName	string	关联的工作区资源名称。

BillingType

群集的计费类型。

名称	类型	说明
Cluster	string
Workspaces	string

Capacity

此群集的容量预留级别（以 GB 为单位）。

名称	类型	说明
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 值（以 GB 为单位）。

Cluster

顶级 Log Analytics 群集资源容器。

名称	类型	说明
id	string	资源的完全限定的资源 ID。例如 - /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	与群集关联的 ID。
properties.createdDate	string	群集创建时间
properties.isAvailabilityZonesEnabled	boolean	设置群集是否支持可用性区域。仅在 Azure 数据资源管理器支持可用性区域的区域，才能将其设置为 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

群集的预配状态。

名称	类型	说明
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

ClusterPatch

顶级 Log Analytics 群集资源容器。

名称	类型	说明
identity	ManagedServiceIdentity	资源的标识。
properties.billingType	BillingType	群集的计费类型。
properties.keyVaultProperties	keyVaultProperties	关联的键属性。
sku	ClusterSku	SKU 属性。
tags	object	资源标记。

ClusterSku

群集 SKU 定义。

名称	类型	说明
capacity	Capacity	此群集的容量预留级别（以 GB 为单位）。
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，用于保存它们与 Log Analytics 群集关联的密钥。
keyVersion	string	与 Log Analytics 群集关联的密钥的版本。

ManagedServiceIdentity

托管服务标识 (系统分配的标识和/或用户分配的标识)

名称	类型	说明
principalId	string	系统分配的标识的服务主体 ID。仅为系统分配的标识提供此属性。
tenantId	string	系统分配的标识的租户 ID。仅为系统分配的标识提供此属性。
type	ManagedServiceIdentityType	托管服务标识的类型 (其中允许 systemAssigned 和 UserAssigned 类型) 。
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned 标识与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将是采用以下格式的 ARM 资源 ID：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是请求中 ({}) 的空对象。

ManagedServiceIdentityType

托管服务标识的类型 (其中允许 systemAssigned 和 UserAssigned 类型) 。

名称	类型	说明
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

UserAssignedIdentity

用户分配的标识属性

名称	类型	说明
clientId	string	分配的标识的客户端 ID。
principalId	string	已分配标识的主体 ID。