다음을 통해 공유

Workspaces - Create Or Update

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

작업 영역을 만들거나 업데이트합니다.

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

URI 매개 변수

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

string

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

string

대상 구독의 ID입니다.
workspaceName
 path True

string

작업 영역의 이름

regex 패턴: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

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

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치
etag

string

작업 영역의 etag입니다.
identity

Identity

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

string

이 작업 영역에 사용할 기본 데이터 수집 규칙의 리소스 ID입니다. 예상 형식은 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}입니다.
properties.features

WorkspaceFeatures

작업 영역 기능.
properties.forceCmkForQuery

boolean

고객 관리형 스토리지가 쿼리 관리에 필수인지 여부를 나타냅니다.
properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Log Analytics 수집에 액세스하기 위한 네트워크 액세스 유형입니다.
properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Log Analytics 쿼리에 액세스하기 위한 네트워크 액세스 유형입니다.
properties.retentionInDays

integer

작업 영역 데이터 보존 기간(일)입니다. 허용되는 값은 가격 책정 플랜에 따라 다릅니다. 자세한 내용은 가격 책정 계층 설명서를 참조하세요.
properties.sku

WorkspaceSku

작업 영역의 SKU입니다.
properties.workspaceCapping

WorkspaceCapping

수집을 위한 일일 볼륨 한도입니다.
tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

Workspace

확인 응답 정의입니다.
201 Created

Workspace

응답 정의를 만들었습니다.
202 Accepted

수락됨
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 사용자 계정 가장

예제

WorkspacesCreate

샘플 요청

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2023-09-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}
상태 코드:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}
상태 코드:
202

정의

Name Description
CapacityReservationLevel

CapacityReservation sku가 선택된 경우 이 작업 영역에 대한 용량 예약 수준(GB)입니다.
createdByType

리소스를 만든 ID 유형입니다.
DataIngestionStatus

이 작업 영역에 대한 데이터 수집의 상태.
ErrorAdditionalInfo

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

오류 세부 정보입니다.
ErrorResponse

오류 응답
Identity

리소스의 ID입니다.
IdentityType

관리 서비스 ID의 유형입니다.
PrivateLinkScopedResource

프라이빗 링크 scope 리소스 참조입니다.
PublicNetworkAccessType

Log Analytics 작업 영역에서 작동하기 위한 네트워크 액세스 유형입니다. 기본적으로 Enabled입니다.
systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
UserIdentityProperties

사용자 할당 ID 속성입니다.
Workspace

최상위 작업 영역 리소스 컨테이너입니다.
WorkspaceCapping

수집을 위한 일일 볼륨 한도입니다.
WorkspaceEntityStatus

작업 영역의 프로비전 상태입니다.
WorkspaceFeatures

작업 영역 기능.
WorkspaceSku

작업 영역의 SKU(계층)입니다.
WorkspaceSkuNameEnum

SKU의 이름입니다.

CapacityReservationLevel

CapacityReservation sku가 선택된 경우 이 작업 영역에 대한 용량 예약 수준(GB)입니다.

Name 형식 Description
100

Integer

1000

Integer

10000

Integer

200

Integer

2000

Integer

25000

Integer

300

Integer

400

Integer

500

Integer

5000

Integer

50000

Integer

createdByType

리소스를 만든 ID 유형입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

DataIngestionStatus

이 작업 영역에 대한 데이터 수집의 상태.

Name 형식 Description
ApproachingQuota

string

일일 한도 할당량의 80%에 도달했습니다.
ForceOff

string

서비스 설정 변경 후 수집이 중지되었습니다.
ForceOn

string

서비스 설정 변경 후 수집이 시작되었습니다.
OverQuota

string

일일 한도 할당량에 도달하여 수집이 중지되었습니다.
RespectQuota

string

일일 한도 할당량 재설정 또는 구독 사용 설정에 따라 수집이 사용하도록 설정되었습니다.
SubscriptionSuspended

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 개체.

Identity

리소스의 ID입니다.

Name 형식 Description
principalId

string

리소스 ID의 보안 주체 ID입니다.
tenantId

string

리소스의 테넌트 ID입니다.
type

IdentityType

관리 서비스 ID의 유형입니다.
userAssignedIdentities

<string,  UserIdentityProperties>

리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

IdentityType

관리 서비스 ID의 유형입니다.

Name 형식 Description
None

string

SystemAssigned

string

UserAssigned

string

PrivateLinkScopedResource

프라이빗 링크 scope 리소스 참조입니다.

Name 형식 Description
resourceId

string

프라이빗 링크 scope 리소스의 전체 리소스 ID입니다.
scopeId

string

프라이빗 링크 scope 고유 식별자입니다.

PublicNetworkAccessType

Log Analytics 작업 영역에서 작동하기 위한 네트워크 액세스 유형입니다. 기본적으로 Enabled입니다.

Name 형식 Description
Disabled

string

공용 DNS를 통해 Log Analytics에 대한 공용 연결을 사용하지 않도록 설정합니다.
Enabled

string

공용 DNS를 통해 Log Analytics에 연결할 수 있습니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID 유형입니다.
lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

UserIdentityProperties

사용자 할당 ID 속성입니다.

Name 형식 Description
clientId

string

사용자 할당 ID의 클라이언트 ID입니다.
principalId

string

사용자 할당 ID의 보안 주체 ID입니다.

Workspace

최상위 작업 영역 리소스 컨테이너입니다.

Name 형식 Default value Description
etag

string

작업 영역의 etag입니다.
id

string

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

Identity

리소스의 ID입니다.
location

string

리소스가 있는 지리적 위치
name

string

리소스의 이름입니다.
properties.createdDate

string

작업 영역 만들기 날짜입니다.
properties.customerId

string

이 속성은 읽기 전용입니다. 작업 영역과 연결된 ID를 나타냅니다.
properties.defaultDataCollectionRuleResourceId

string

이 작업 영역에 사용할 기본 데이터 수집 규칙의 리소스 ID입니다. 예상 형식은 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}입니다.
properties.features

WorkspaceFeatures

작업 영역 기능.
properties.forceCmkForQuery

boolean

고객 관리형 스토리지가 쿼리 관리에 필수인지 여부를 나타냅니다.
properties.modifiedDate

string

작업 영역 수정 날짜입니다.
properties.privateLinkScopedResources

PrivateLinkScopedResource[]

연결된 프라이빗 링크 scope 리소스 목록입니다.
properties.provisioningState

WorkspaceEntityStatus

작업 영역의 프로비전 상태입니다.
properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Log Analytics 수집에 액세스하기 위한 네트워크 액세스 유형입니다.
properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Log Analytics 쿼리에 액세스하기 위한 네트워크 액세스 유형입니다.
properties.retentionInDays

integer

작업 영역 데이터 보존 기간(일)입니다. 허용되는 값은 가격 책정 플랜에 따라 다릅니다. 자세한 내용은 가격 책정 계층 설명서를 참조하세요.
properties.sku

WorkspaceSku

작업 영역의 SKU입니다.
properties.workspaceCapping

WorkspaceCapping

수집을 위한 일일 볼륨 한도입니다.
systemData

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
tags

object

리소스 태그.
type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

WorkspaceCapping

수집을 위한 일일 볼륨 한도입니다.

Name 형식 Description
dailyQuotaGb

number

수집을 위한 작업 영역 일일 할당량입니다.
dataIngestionStatus

DataIngestionStatus

이 작업 영역에 대한 데이터 수집의 상태.
quotaNextResetTime

string

할당량이 휴지되는 시간입니다.

WorkspaceEntityStatus

작업 영역의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

ProvisioningAccount

string

Succeeded

string

Updating

string

WorkspaceFeatures

작업 영역 기능.

Name 형식 Description
clusterResourceId

string

작업 영역에 연결된 전용 LA 클러스터 resourceId입니다.
disableLocalAuth

boolean

비 AAD 기반 인증을 사용하지 않도록 설정합니다.
enableDataExport

boolean

데이터를 내보내야 하는지 여부를 나타내는 플래그입니다.
enableLogAccessUsingOnlyResourcePermissions

boolean

사용할 사용 권한을 나타내는 플래그입니다( 리소스 또는 작업 영역 또는 둘 다).
immediatePurgeDataOn30Days

boolean

30일 후에 데이터를 제거할지 설명하는 플래그입니다.
unifiedSentinelBillingOnly

boolean

지정 작업 영역이 sentinel의 통합 청구 모델로만 제한되는지를 나타냅니다.

WorkspaceSku

작업 영역의 SKU(계층)입니다.

Name 형식 Description
capacityReservationLevel

CapacityReservationLevel

CapacityReservation sku가 선택된 경우 이 작업 영역에 대한 용량 예약 수준(GB)입니다.
lastSkuUpdate

string

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

WorkspaceSkuNameEnum

SKU의 이름입니다.

WorkspaceSkuNameEnum

SKU의 이름입니다.

Name 형식 Description
CapacityReservation

string

Free

string

LACluster

string

PerGB2018

string

PerNode

string

Premium

string

Standalone

string

Standard

string