Workspaces - Get
작업 영역 인스턴스를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-07-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
|
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
|
workspace
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
작업 영역의 이름입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Azure 작업이 성공적으로 완료되었습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
WorkspaceGet
샘플 요청
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01
샘플 응답
{
"name": "oiautorest6685",
"type": "Microsoft.OperationalInsights/workspaces",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/oiautorest6685",
"location": "eastus",
"properties": {
"customerId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
"failover": {
"lastModifiedDate": "2020-07-05T07:35:51Z",
"state": "Active"
},
"provisioningState": "Succeeded",
"publicNetworkAccessForIngestion": "Enabled",
"publicNetworkAccessForQuery": "Enabled",
"replication": {
"createdDate": "2020-07-04T07:35:51Z",
"enabled": true,
"lastModifiedDate": "2020-07-04T07:35:51Z",
"location": "westus3",
"provisioningState": "Succeeded"
},
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
}
}
정의
| Name | Description |
|---|---|
|
created |
리소스를 만든 ID 유형입니다. |
|
Data |
이 작업 영역에 대한 데이터 수집 상태입니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
| Identity |
리소스의 ID입니다. |
|
Identity |
관리 서비스 ID의 유형입니다. |
|
Private |
프라이빗 링크 범위 리소스 참조입니다. |
|
Public |
Log Analytics 수집에 액세스하기 위한 네트워크 액세스 유형입니다. |
|
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
|
User |
사용자 할당 ID 속성입니다. |
| Workspace |
최상위 작업 영역 리소스 컨테이너입니다. |
|
Workspace |
수집을 위한 일일 볼륨 한도입니다. |
|
Workspace |
작업 영역의 프로비전 상태입니다. |
|
Workspace |
복제의 장애 조치(failover) 상태입니다. |
|
Workspace |
복제의 장애 조치(failover) 상태입니다. |
|
Workspace |
작업 영역 기능. |
|
Workspace |
작업 영역 복제 속성. |
|
Workspace |
복제의 프로비저닝 상태입니다. |
|
Workspace |
작업 영역의 SKU(계층)입니다. |
|
Workspace |
SKU의 이름입니다. |
createdByType
리소스를 만든 ID 유형입니다.
| 값 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataIngestionStatus
이 작업 영역에 대한 데이터 수집 상태입니다.
| 값 | Description |
|---|---|
| RespectQuota |
일일 한도 할당량 재설정 또는 구독 활성화 후 수집이 활성화되었습니다. |
| ForceOn |
서비스 설정 변경 후 수집이 시작되었습니다. |
| ForceOff |
서비스 설정 변경 후 수집이 중지되었습니다. |
| OverQuota |
일일 한도 할당량에 도달하여 수집이 중지되었습니다. |
| SubscriptionSuspended |
구독이 일시 중단된 후 수집이 중지되었습니다. |
| ApproachingQuota |
일일 한도 할당량의 80%에 도달했습니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
Identity
리소스의 ID입니다.
| Name | 형식 | Description |
|---|---|---|
| principalId |
string |
리소스 ID의 보안 주체 ID입니다. |
| tenantId |
string |
리소스의 테넌트 ID입니다. |
| type |
관리 서비스 ID의 유형입니다. |
|
| userAssignedIdentities |
<string,
User |
리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. |
IdentityType
관리 서비스 ID의 유형입니다.
| 값 | Description |
|---|---|
| SystemAssigned |
시스템 지정됨 |
| UserAssigned |
UserAssigned |
| None |
None |
PrivateLinkScopedResource
프라이빗 링크 범위 리소스 참조입니다.
| Name | 형식 | Description |
|---|---|---|
| resourceId |
string |
프라이빗 링크 범위 리소스의 전체 리소스 ID입니다. |
| scopeId |
string |
프라이빗 링크 범위 고유 식별자입니다. |
PublicNetworkAccessType
Log Analytics 수집에 액세스하기 위한 네트워크 액세스 유형입니다.
| 값 | Description |
|---|---|
| Enabled |
공용 DNS를 통해 Log Analytics에 연결할 수 있습니다. |
| Disabled |
공용 DNS를 통해 Log Analytics에 대한 공용 연결을 사용하지 않도록 설정합니다. |
| SecuredByPerimeter |
리소스는 개인 네트워크에서만 액세스할 수 있으며 이 리소스와 연결된 네트워크 보안 경계에서 승인한 액세스입니다. |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| createdAt |
string (date-time) |
리소스 생성 타임스탬프(UTC)입니다. |
| createdBy |
string |
리소스를 만든 ID입니다. |
| createdByType |
리소스를 만든 ID 유형입니다. |
|
| lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
| lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
| lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
UserIdentityProperties
사용자 할당 ID 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| clientId |
string |
사용자 할당 ID의 클라이언트 ID입니다. |
| principalId |
string |
사용자 할당 ID의 보안 주체 ID입니다. |
Workspace
최상위 작업 영역 리소스 컨테이너입니다.
| Name | 형식 | Default value | Description |
|---|---|---|---|
| etag |
string |
작업 영역의 etag입니다. |
|
| id |
string (arm-id) |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
리소스의 ID입니다. |
||
| location |
string |
리소스가 있는 지리적 위치 |
|
| name |
string |
리소스의 이름 |
|
| properties.createdDate |
string (date-time) |
작업 영역 생성 날짜. |
|
| properties.customerId |
string |
읽기 전용 속성입니다. 작업공간과 연관된 ID를 나타냅니다. |
|
| properties.defaultDataCollectionRuleResourceId |
string |
이 작업 영역에 사용할 기본 데이터 수집 규칙의 리소스 ID입니다. 예상 형식은 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}입니다. |
|
| properties.failover |
작업 영역 장애 조치(failover) 속성입니다. |
||
| properties.features |
작업 영역 기능. |
||
| properties.forceCmkForQuery |
boolean |
고객 관리형 스토리지가 쿼리 관리에 필수인지 여부를 나타냅니다. |
|
| properties.modifiedDate |
string (date-time) |
작업 공간 수정 날짜. |
|
| properties.privateLinkScopedResources |
연결된 프라이빗 링크 범위 리소스 목록입니다. |
||
| properties.provisioningState |
작업 영역의 프로비전 상태입니다. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Log Analytics 수집에 액세스하기 위한 네트워크 액세스 유형입니다. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Log Analytics 쿼리에 액세스하기 위한 네트워크 액세스 유형입니다. |
|
| properties.replication |
작업 영역 복제 속성입니다. |
||
| properties.retentionInDays |
integer (int32) |
작업 영역 데이터 보존 기간(일)입니다. 허용되는 값은 가격 책정 계획에 따라 다릅니다. 자세한 내용은 가격 책정 계층 설명서를 참조하세요. |
|
| properties.sku |
작업 영역의 SKU입니다. |
||
| properties.workspaceCapping |
수집을 위한 일일 볼륨 한도입니다. |
||
| systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
||
| tags |
object |
리소스 태그. |
|
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
WorkspaceCapping
수집을 위한 일일 볼륨 한도입니다.
| Name | 형식 | Description |
|---|---|---|
| dailyQuotaGb |
number (double) |
수집을 위한 작업 영역 일일 할당량입니다. |
| dataIngestionStatus |
이 작업 영역에 대한 데이터 수집 상태입니다. |
|
| quotaNextResetTime |
string |
할당량이 쉬는 시간입니다. |
WorkspaceEntityStatus
작업 영역의 프로비전 상태입니다.
| 값 | Description |
|---|---|
| Creating |
만드는 중 |
| Succeeded |
성공함 |
| Failed |
실패 |
| Canceled |
취소됨 |
| Deleting |
삭제 중 |
| ProvisioningAccount |
프로비저닝 계정 |
| Updating |
업데이트 중 |
WorkspaceFailoverProperties
복제의 장애 조치(failover) 상태입니다.
| Name | 형식 | Description |
|---|---|---|
| lastModifiedDate |
string (date-time) |
장애 조치(failover) 상태가 마지막으로 업데이트된 시간입니다. |
| state |
복제의 장애 조치(failover) 상태입니다. |
WorkspaceFailoverState
복제의 장애 조치(failover) 상태입니다.
| 값 | Description |
|---|---|
| Inactive |
비활성 |
| Activating |
활성화 중 |
| Active |
Active |
| Deactivating |
비활성화 중 |
| Failed |
실패 |
WorkspaceFeatures
작업 영역 기능.
| Name | 형식 | Description |
|---|---|---|
| associations |
string[] |
작업 영역에 대한 연결 목록입니다. 작업 영역이 MDC, Sentinel, SentinelGraph 등의 환경과 연결되어 있는지 여부를 나타냅니다. |
| clusterResourceId |
string |
작업 영역에 연결된 전용 LA 클러스터 resourceId입니다. |
| disableLocalAuth |
boolean |
비 AAD 기반 인증을 사용하지 않도록 설정합니다. |
| enableDataExport |
boolean |
데이터를 내보내야 하는지 여부를 나타내는 플래그입니다. |
| enableLogAccessUsingOnlyResourcePermissions |
boolean |
사용할 권한(리소스 또는 작업 영역 또는 둘 다)을 나타내는 플래그입니다. |
| immediatePurgeDataOn30Days |
boolean |
30일 후에 데이터를 제거할지 설명하는 플래그입니다. |
| unifiedSentinelBillingOnly |
boolean |
지정 작업 영역이 sentinel의 통합 청구 모델로만 제한되는지 여부를 나타냅니다. |
WorkspaceReplicationProperties
작업 영역 복제 속성.
| Name | 형식 | Description |
|---|---|---|
| createdDate |
string (date-time) |
복제가 마지막으로 활성화된 시간입니다. |
| enabled |
boolean |
복제를 사용할지 여부를 지정합니다. true이면 작업 영역 구성 및 데이터가 지정된 위치에 복제됩니다. 복제를 사용하도록 설정한 경우 위치를 제공해야 합니다. |
| lastModifiedDate |
string (date-time) |
복제가 마지막으로 업데이트된 시간입니다. |
| location |
string |
복제의 위치입니다. |
| provisioningState |
복제의 프로비저닝 상태입니다. |
WorkspaceReplicationState
복제의 프로비저닝 상태입니다.
| 값 | Description |
|---|---|
| Succeeded |
성공함 |
| EnableRequested |
요청 가능 |
| Enabling |
사용 |
| DisableRequested |
비활성화 요청 |
| Disabling |
비활성화 |
| RollbackRequested |
롤백 요청됨 |
| RollingBack |
롤링백 |
| Failed |
실패 |
| Canceled |
취소됨 |
WorkspaceSku
작업 영역의 SKU(계층)입니다.
| Name | 형식 | Description |
|---|---|---|
| capacityReservationLevel |
integer (int32) |
CapacityReservation sku가 선택된 경우 이 작업 영역에 대한 용량 예약 수준(GB)입니다. |
| lastSkuUpdate |
string (date-time) |
sku가 마지막으로 업데이트된 시간입니다. |
| name |
SKU의 이름입니다. |
WorkspaceSkuNameEnum
SKU의 이름입니다.
| 값 | Description |
|---|---|
| Free |
Free |
| Standard |
표준 |
| Premium |
Premium |
| PerNode |
PerNode |
| PerGB2018 |
페르GB2018 |
| Standalone |
독립 실행형 |
| CapacityReservation |
수용 인원 예약 |
| LACluster |
LACluster |