Tables - Update

서비스:

Log Analytics

API 버전:

2026-03-01

Log Analytics 작업 영역 테이블을 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2026-03-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	테이블의 이름입니다.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	작업 영역의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties.plan	TablePlanEnum	이 테이블에 수집된 로그를 처리하고 충전하는 방법을 시스템에 지시합니다.
properties.protectionLevel	TableProtectionLevelEnum	테이블의 보호 수준. 기본 데이터 접근 격리 동작을 결정합니다.
properties.restoredLogs	RestoredLogs	이 테이블을 시작한 복원 작업의 매개 변수입니다.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	분석 테이블: 테이블은 4에서 730 사이의 분석 보존 기간(일)입니다. 이 속성을 -1 설정하면 기본적으로 작업 영역 보존이 설정됩니다. 기본 및 보조 테이블: 읽기 전용 속성.
properties.schema	Schema	테이블 스키마입니다.
properties.searchResults	SearchResults	이 테이블을 시작한 검색 작업의 매개 변수입니다.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	4에서 4383 사이의 테이블 총 보존 기간(일)입니다. 이 속성을 -1로 설정하면 기본적으로 retentionInDays가 됩니다.

응답

Name	형식	Description
200 OK	Table	Azure 작업이 성공적으로 완료되었습니다.
202 Accepted		리소스 업데이트 요청이 수락되었습니다. 헤더 Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name	Description
user_impersonation	사용자 계정을 사칭하다

예제

TablesUpsert

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow?api-version=2026-03-01

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid"
        }
      ]
    },
    "retentionInDays": 45,
    "totalRetentionInDays": 70
  }
}

샘플 응답

상태 코드:

200

{
  "name": "AzureNetworkFlow",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow",
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid",
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "solutions": [
        "LogManagement"
      ],
      "standardColumns": [
        {
          "name": "TenantId",
          "type": "guid",
          "isDefaultDisplay": false,
          "isHidden": true
        },
        {
          "name": "SourceSystem",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TimeGenerated",
          "type": "dateTime",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "AgentID",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourceIP",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Protocol",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourcePort",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "DestinationPort",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TcpFlags",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Packets",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Bytes",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "BytesOut",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "DurationInMs",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "RstCount",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "MaxSampleRtt",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "Microsoft"
    },
    "archiveRetentionInDays": 25,
    "plan": "Analytics",
    "provisioningState": "Succeeded",
    "retentionInDays": 45,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDays": 70,
    "totalRetentionInDaysAsDefault": false
  }
}

상태 코드:

202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperaitonalInsights/workspaces/oiautorest6685/tables/table1_CL/operationresults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01
azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.OperaitonalInsights/locations/eastus/operationstatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01

정의

Name	Description
Column	테이블 열입니다.
ColumnDataTypeHintEnum	열 데이터 형식 논리 힌트입니다.
ColumnTypeEnum	열 데이터 형식입니다.
createdByType	리소스를 만든 ID 유형입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
OperationalInsightsTableProvisioningState	테이블의 현재 프로비전 상태입니다. '업데이트'로 설정하면 진행 중인 작업으로 인한 리소스 잠금을 나타내며 진행 중인 작업이 완료될 때까지 테이블에 대한 업데이트를 금지합니다.
RestoredLogs	매개 변수를 복원합니다.
ResultStatistics	작업 실행 통계를 검색합니다.
Schema	테이블의 스키마입니다.
SearchResults	이 테이블을 시작한 검색 작업의 매개 변수입니다.
SourceEnum	테이블의 생성자.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
Table	작업 영역 데이터 테이블 정의입니다.
TablePlanEnum	이 테이블에 수집된 로그를 처리하고 충전하는 방법을 시스템에 지시합니다.
TableProtectionLevelEnum	테이블의 보호 수준. 기본 데이터 접근 격리 동작을 결정합니다.
TableSubTypeEnum	하위 유형은 테이블과 상호 작용하는 데 사용할 수 있는 API와 테이블에 대해 사용할 수 있는 기능을 설명합니다.
TableTypeEnum	테이블의 생성자.

Column

Object

테이블 열입니다.

Name	형식	Description
dataTypeHint	ColumnDataTypeHintEnum	열 데이터 형식 논리 힌트입니다.
description	string	열 설명입니다.
displayName	string	열 표시 이름입니다. 생성 시점에 설정할 수 있습니다; 생성 후 업데이트는 열명과 일치하거나 null/empty로 설정해야 합니다. 제공되지 않으면 기본적으로 열 이름으로 표시됩니다.
isDefaultDisplay	boolean	기본적으로 표시됩니다.
isHidden	boolean	숨겨진 열입니다.
name	string	열 이름.
type	ColumnTypeEnum	열 데이터 형식입니다.

ColumnDataTypeHintEnum

열거형

열 데이터 형식 논리 힌트입니다.

값	Description
uri	URI 패턴과 일치하는 문자열(예: scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment)
guid	표준 셰이프 xxxxxxxx-xxxx-xx를 따르는 표준 128비트 GUID
armPath	ARM(Azure 리소스 모델) 경로: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
ip	표준 셰이프 x.x.x.x/y:y:y:y:y:y:y:y
vector16	의미론적 / 유사도 검색에 사용되는 단정밀도 부동소수점 값들의 벡터입니다.

ColumnTypeEnum

열거형

열 데이터 형식입니다.

값	Description
string	string
int	int
long	long
real	진짜 / 현실
boolean	부울
dateTime	dateTime
guid	guid
dynamic	dynamic

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

OperationalInsightsTableProvisioningState

열거형

테이블의 현재 프로비전 상태입니다. '업데이트'로 설정하면 진행 중인 작업으로 인한 리소스 잠금을 나타내며 진행 중인 작업이 완료될 때까지 테이블에 대한 업데이트를 금지합니다.

값	Description
Updating	테이블 스키마는 아직 빌드되고 업데이트되고 있으며, 프로시저가 완료될 때까지 테이블은 변경 내용에 대해 현재 잠겨 있습니다.
InProgress	테이블 스키마는 안정적이며 변경 없이 테이블 데이터가 업데이트되고 있습니다.
Succeeded	테이블 상태는 안정적이며 변경 없이 테이블이 잠금 해제되어 새 업데이트를 위해 열립니다.
Deleting	테이블 상태가 삭제 중입니다.

RestoredLogs

Object

매개 변수를 복원합니다.

Name	형식	Description
azureAsyncOperationId	string	검색 결과 테이블 비동기 작업 ID입니다.
endRestoreTime	string (date-time)	복원을 종료할 타임스탬프(UTC)입니다.
sourceTable	string	데이터를 복원할 테이블입니다.
startRestoreTime	string (date-time)	복원을 시작할 타임스탬프(UTC)입니다.

ResultStatistics

Object

작업 실행 통계를 검색합니다.

Name	형식	Description
ingestedRecords	integer (int32)	검색 작업에서 반환된 행 수입니다.
progress	number (float)	검색 작업 완료율입니다.
scannedGb	number (float)	검색 작업: 스캔한 데이터의 양입니다.

Schema

Object

테이블의 스키마입니다.

Name	형식	Description
categories	string[]	테이블 범주입니다.
columns	Column[]	테이블 사용자 지정 열 목록입니다.
description	string	테이블 설명입니다.
displayName	string	테이블 표시 이름입니다.
labels	string[]	테이블 레이블입니다.
name	string	테이블 이름입니다.
solutions	string[]	테이블이 연결된 솔루션 목록
source	SourceEnum	테이블의 생성자.
standardColumns	Column[]	테이블 표준 열 목록입니다.
tableSubType	TableSubTypeEnum	하위 유형은 테이블과 상호 작용하는 데 사용할 수 있는 API와 테이블에 대해 사용할 수 있는 기능을 설명합니다.
tableType	TableTypeEnum	테이블의 생성자.

SearchResults

Object

이 테이블을 시작한 검색 작업의 매개 변수입니다.

Name	형식	Description
azureAsyncOperationId	string	검색 결과 테이블 비동기 작업 ID입니다.
description	string	검색 작업 설명입니다.
endSearchTime	string (date-time)	검색을 종료할 타임스탬프(UTC)
limit	integer (int32)	지정된 행 수까지 반환하도록 검색 작업을 제한합니다.
query	string	작업 쿼리를 검색합니다.
sourceTable	string	검색 작업에 사용되는 테이블입니다.
startSearchTime	string (date-time)	검색을 시작할 타임스탬프(UTC)

SourceEnum

열거형

테이블의 생성자.

값	Description
microsoft	진단 설정, 에이전트 또는 기타 표준 데이터 수집 수단을 통해 수집되는 시스템에서 프로비전된 테이블입니다.
customer	작업 영역 소유자가 만든 테이블이며 이 작업 영역에서만 찾을 수 있습니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID 유형입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

Table

Object

작업 영역 데이터 테이블 정의입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties.archiveRetentionInDays	integer (int32)	테이블은 장기 보존 기간(일)입니다. (totalRetentionInDays-retentionInDays)로 계산됩니다.
properties.lastPlanModifiedDate	string	테이블 계획이 마지막으로 수정된 타임스탬프(UTC)입니다.
properties.plan	TablePlanEnum	이 테이블에 수집된 로그를 처리하고 충전하는 방법을 시스템에 지시합니다.
properties.protectionLevel	TableProtectionLevelEnum	테이블의 보호 수준. 기본 데이터 접근 격리 동작을 결정합니다.
properties.provisioningState	OperationalInsightsTableProvisioningState	테이블의 현재 프로비전 상태입니다. '업데이트'로 설정하면 진행 중인 작업으로 인한 리소스 잠금을 나타내며 진행 중인 작업이 완료될 때까지 테이블에 대한 업데이트를 금지합니다.
properties.restoredLogs	RestoredLogs	이 테이블을 시작한 복원 작업의 매개 변수입니다.
properties.resultStatistics	ResultStatistics	작업 실행 통계를 검색합니다.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	분석 테이블: 테이블은 4에서 730 사이의 분석 보존 기간(일)입니다. 이 속성을 -1 설정하면 기본적으로 작업 영역 보존이 설정됩니다. 기본 및 보조 테이블: 읽기 전용 속성.
properties.retentionInDaysAsDefault	boolean	True - 값은 작업 영역 보존 기간(일 단위, False - 고객별)에서 발생합니다.
properties.schema	Schema	테이블 스키마입니다.
properties.searchResults	SearchResults	이 테이블을 시작한 검색 작업의 매개 변수입니다.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	4에서 4383 사이의 테이블 총 보존 기간(일)입니다. 이 속성을 -1로 설정하면 기본적으로 retentionInDays가 됩니다.
properties.totalRetentionInDaysAsDefault	boolean	True - 값은 보존 기간(일 단위, False - 고객별)에서 발생합니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

TablePlanEnum

열거형

이 테이블에 수집된 로그를 처리하고 충전하는 방법을 시스템에 지시합니다.

값	Description
Basic	문제 해결 및 사고 대응에 필요한 중간 터치 로그입니다.
Analytics	지속적인 모니터링, 실시간 탐지 및 성능 분석에 사용되는 고부가가치 로그입니다.
Auxiliary	자세한 로그와 같은 로우 터치 로그와 감사 및 규정 준수에 필요한 데이터입니다.

TableProtectionLevelEnum

열거형

테이블의 보호 수준. 기본 데이터 접근 격리 동작을 결정합니다.

값	Description
General	기본 보호 수준입니다. 테이블 데이터는 표준 권한을 통해 접근할 수 있습니다.
Protected	테이블 데이터는 기본적으로 격리되어 있습니다. 데이터에 접근하거나 내보내려면 명시적이고 범위가 정한 권한이 필요합니다.

TableSubTypeEnum

열거형

하위 유형은 테이블과 상호 작용하는 데 사용할 수 있는 API와 테이블에 대해 사용할 수 있는 기능을 설명합니다.

값	Description
Any	기본 제공 테이블을 만드는 기본 하위 형식입니다.
Classic	데이터 수집기 API 또는 MMA 에이전트의 사용자 지정 로그 기능 또는 사용자 지정 필드를 만든 테이블을 통해 만든 테이블을 나타냅니다.
DataCollectionRuleBased	데이터 수집 규칙(데이터 수집 엔드포인트 API, 수집 시간 변환 또는 데이터 수집 규칙에서 제공하는 다른 메커니즘)에서 지원하는 수단을 통해 데이터를 전송할 수 있는 테이블

TableTypeEnum

열거형

테이블의 생성자.

값	Description
Microsoft	Azure Monitor에서 수집한 표준 데이터입니다.
CustomLog	사용자 지정 로그 테이블입니다.
RestoredLogs	복원된 데이터입니다.
SearchResults	검색 작업에서 수집한 데이터입니다.