다음을 통해 공유

Clusters - Update

  • 참조
서비스:
Log Analytics
API 버전:
2023-09-01

Log Analytics 클러스터를 업데이트.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
clusterName
 path True

string

Log Analytics 클러스터의 이름입니다.
resourceGroupName
 path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
subscriptionId
 path True

string

대상 구독의 ID입니다.
api-version
 query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
identity

ManagedServiceIdentity

리소스의 ID입니다.
properties.billingType

BillingType

클러스터의 청구 유형입니다.
properties.keyVaultProperties

keyVaultProperties

연결된 키 속성입니다.
sku

ClusterSku

sku 속성입니다.
tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

Cluster

기존 클러스터가 성공적으로 업데이트되었습니다. provisioningStatus를 확인하여 자세한 상태 확인합니다.
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

ClustersPatch

샘플 요청

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

샘플 응답

상태 코드:
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"
}

정의

Name Description
AssociatedWorkspace

클러스터와 연결된 Log Analytics 작업 영역 목록입니다.
BillingType

클러스터의 청구 유형입니다.
Capacity

이 클러스터의 용량 예약 수준(기가바이트)입니다.
CapacityReservationProperties

용량 예약 속성입니다.
Cluster

최상위 Log Analytics 클러스터 리소스 컨테이너입니다.
ClusterEntityStatus

클러스터의 프로비전 상태입니다.
ClusterPatch

최상위 Log Analytics 클러스터 리소스 컨테이너입니다.
ClusterSku

클러스터 sku 정의입니다.
ClusterSkuNameEnum

클러스터의 SKU(계층)입니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
keyVaultProperties

키 자격 증명 모음 속성입니다.
ManagedServiceIdentity

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
ManagedServiceIdentityType

관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨).
UserAssignedIdentity

사용자 할당 ID 속성

AssociatedWorkspace

클러스터와 연결된 Log Analytics 작업 영역 목록입니다.

Name 형식 Description
associateDate

string

작업 영역 연결 시간입니다.
resourceId

string

'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}의 형식으로 연결된 작업 영역 arm 리소스 ID입니다.
workspaceId

string

연결된 작업 영역 변경할 수 없는 ID입니다.
workspaceName

string

연결된 작업 영역 리소스 이름입니다.

BillingType

클러스터의 청구 유형입니다.

Name 형식 Description
Cluster

string

Workspaces

string

Capacity

이 클러스터의 용량 예약 수준(기가바이트)입니다.

Name 형식 Description
100

Integer

1000

Integer

10000

Integer

200

Integer

2000

Integer

25000

Integer

300

Integer

400

Integer

500

Integer

5000

Integer

50000

Integer

CapacityReservationProperties

용량 예약 속성입니다.

Name 형식 Description
lastSkuUpdate

string

Sku가 마지막으로 업데이트된 시간입니다.
minCapacity

integer

최소 CapacityReservation 값(기가바이트)입니다.

Cluster

최상위 Log Analytics 클러스터 리소스 컨테이너입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

ManagedServiceIdentity

리소스의 ID입니다.
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 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

클러스터의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

ProvisioningAccount

string

Succeeded

string

Updating

string

ClusterPatch

최상위 Log Analytics 클러스터 리소스 컨테이너입니다.

Name 형식 Description
identity

ManagedServiceIdentity

리소스의 ID입니다.
properties.billingType

BillingType

클러스터의 청구 유형입니다.
properties.keyVaultProperties

keyVaultProperties

연결된 키 속성입니다.
sku

ClusterSku

sku 속성입니다.
tags

object

리소스 태그.

ClusterSku

클러스터 sku 정의입니다.

Name 형식 Description
capacity

Capacity

이 클러스터의 용량 예약 수준(기가바이트)입니다.
name

ClusterSkuNameEnum

클러스터의 SKU(계층)입니다.

ClusterSkuNameEnum

클러스터의 SKU(계층)입니다.

Name 형식 Description
CapacityReservation

string

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

keyVaultProperties

키 자격 증명 모음 속성입니다.

Name 형식 Description
keyName

string

Log Analytics 클러스터와 연결된 키의 이름입니다.
keyRsaSize

integer

선택한 키 최소 필수 크기입니다.
keyVaultUri

string

Log Analytics 클러스터와 연결된 키를 보유하는 Key Vault URI입니다.
keyVersion

string

Log Analytics 클러스터와 연결된 키의 버전입니다.

ManagedServiceIdentity

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)

Name 형식 Description
principalId

string

시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId

string

시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type

ManagedServiceIdentityType

관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨).
userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned ID
리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

ManagedServiceIdentityType

관리 서비스 ID 유형(SystemAssigned 및 UserAssigned 형식이 모두 허용됨).

Name 형식 Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

UserAssignedIdentity

사용자 할당 ID 속성

Name 형식 Description
clientId

string

할당된 ID의 클라이언트 ID입니다.
principalId

string

할당된 ID의 보안 주체 ID입니다.