Tables - Create Or Update

서비스:: Log Analytics

API 버전:: 2025-07-01

Log Analytics 작업 영역 테이블을 업데이트하거나 만듭니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
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.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	OK 응답 정의.
202 Accepted		수락된 응답 정의(장기 실행 작업).
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

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow?api-version=2025-07-01

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.loganalytics import LogAnalyticsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-loganalytics
# USAGE
    python tables_upsert.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = LogAnalyticsManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-00000000000",
    )

    response = client.tables.begin_create_or_update(
        resource_group_name="oiautorest6685",
        workspace_name="oiautorest6685",
        table_name="AzureNetworkFlow",
        parameters={
            "properties": {
                "retentionInDays": 45,
                "schema": {"columns": [{"name": "MyNewColumn", "type": "guid"}], "name": "AzureNetworkFlow"},
                "totalRetentionInDays": 70,
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/TablesUpsert.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "Microsoft",
      "columns": [
        {
          "isHidden": false,
          "name": "MyNewColumn",
          "type": "guid",
          "isDefaultDisplay": false
        }
      ],
      "standardColumns": [
        {
          "isHidden": true,
          "name": "TenantId",
          "type": "guid",
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "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
        }
      ],
      "solutions": [
        "LogManagement"
      ]
    },
    "provisioningState": "Succeeded",
    "retentionInDays": 45,
    "totalRetentionInDays": 70,
    "archiveRetentionInDays": 25,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDaysAsDefault": false,
    "plan": "Analytics"
  },
  "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow",
  "name": "AzureNetworkFlow"
}

상태 코드:: 202

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

정의

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

Column

Object

테이블 열.

Name	형식	Description
dataTypeHint	ColumnDataTypeHintEnum	열 데이터 형식 논리 힌트입니다.
description	string	열 설명입니다.
displayName	string	열 표시 이름입니다.
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-xxxx-xxxx-xxxx-xxxx)를 따르는 표준 128비트 GUID
armPath	ARM(Azure Resource Model) 경로: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft입니다. {...}/{...}/{...}/{...}...
ip	표준 셰이프인 x.x.x.x/y:y:y:y를 따르는 표준 V4/V6 IP 주소

ColumnTypeEnum

열거형

열 데이터 형식입니다.

값	Description
string
int
long
real
boolean
dateTime
guid
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	오류 개체입니다.

ProvisioningStateEnum

열거형

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

값	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 multipleOf: 0.01	작업 완료율을 검색합니다.
scannedGb	number multipleOf: 0.01	검색 작업: 스캔한 데이터의 양입니다.

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	리소스에 대한 정규화된 리소스 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.provisioningState	ProvisioningStateEnum	테이블의 현재 프로비저닝 상태입니다. 'updating'으로 설정하면 진행 중인 작업으로 인한 리소스 잠금을 나타내며 진행 중인 작업이 완료될 때까지 테이블에 대한 업데이트를 금지합니다.
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	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

TablePlanEnum

열거형

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

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

TableSubTypeEnum

열거형

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

값	Description
Any	기본 제공 테이블이 생성되는 데 사용되는 기본 하위 형식입니다.
Classic	Data Collector API를 통해 또는 MMA 에이전트의 사용자 지정 로그 기능을 사용하여 만든 테이블 또는 사용자 지정 필드가 만들어진 테이블을 나타냅니다.
DataCollectionRuleBased	데이터 수집 규칙에서 지원하는 모든 방법(데이터 수집 엔드포인트 API, 수집 시간 변환 또는 데이터 수집 규칙에서 제공하는 기타 메커니즘)을 통해 데이터를 보낼 수 있는 테이블

TableTypeEnum

열거형

테이블의 생성자.

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

다음을 통해 공유

Tables - Create Or Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

TablesUpsert

샘플 요청

샘플 응답

정의

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum