Create Rules - Create Rules

서비스:: Purview

API 버전:: 2026-01-12-preview

데이터 제품 및 비즈니스 도메인 내 특정 데이터 자산에 대한 규칙을 만듭니다.

PUT {endpoint}/purviewdataquality/api/business-domains/{businessDomainId}/data-products/{dataProductId}/data-assets/{dataAssetId}/rules/{ruleId}?api-version=2026-01-12-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
businessDomainId	path	True	string	데이터 제품을 포함하는 비즈니스 도메인의 고유 식별자
dataAssetId	path	True	string	데이터 자산의 고유 식별자
dataProductId	path	True	string	데이터 자산을 포함하는 데이터 산물에 대한 고유 식별자
endpoint	path	True	string (uri)
ruleId	path	True	string	규칙의 고유 식별자
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
id	True	string	고유 규칙 식별자
name	True	string	규칙의 설명적 명칭
status	True	string	현재 실행 상태
type	True	string	규칙 유형 분류
businessDomain		Reference	비즈니스 도메인 참조
createdAt		string (date-time)	이 규칙이 만들어진 타임스탬프
createdBy		string	규칙 작성자의 사용자 식별자
dataAsset		Reference	데이터 자산 참조
dataProduct		Reference	데이터 제품 참조
description		string	규칙 검증 및 비즈니스 목적에 대한 상세한 설명
dimension		string	선택적 사업 차원 또는 분류
lastModifiedAt		string (date-time)	이 규칙이 마지막으로 수정된 타임스탬프
lastModifiedBy		string	규칙의 마지막 수정자를 위한 사용자 식별자
score		number (double)	품질 점수 (0.0에서 1.0)
typeProperties		TypeProperties	타입별 구성 속성

응답

Name	형식	Description
201 Created	RuleEntity	요청이 성공했고 결과적으로 새 리소스가 생성되었습니다.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

201 Created

RuleEntity

요청이 성공했고 결과적으로 새 리소스가 생성되었습니다.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

OAuth2Auth

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

범위

Name	Description
https://purview.azure.net/.default

예제

CreateRules_DataAsset

샘플 요청

HTTP

PUT {endpoint}/purviewdataquality/api/business-domains/abcdef12-3456-7890-abcd-ef1234567890/data-products/12345678-abcd-1234-ef00-123456abcdef/data-assets/abcd1234-5678-abcd-1234-abcd5678ef00/rules/rule-1234-5678-abcd-ef00-123456abcdef?api-version=2026-01-12-preview

{
  "id": "06dda07d-126b-43c1-aade-2484b265a271",
  "name": "Custom",
  "description": "",
  "type": "CustomTruth",
  "status": "Active",
  "typeProperties": {
    "condition": "{REVENUE} > 50000",
    "filterCriteria": "{REGION} == 'India'",
    "emptyCriteria": "{REVENUE_TARGET} < 100000",
    "columns": [
      {
        "value": "REVENUE",
        "type": "Column"
      },
      {
        "value": "REGION",
        "type": "Column"
      },
      {
        "value": "REVENUE_TARGET",
        "type": "Column"
      }
    ]
  },
  "dimension": "Accuracy",
  "businessDomain": {
    "referenceId": "76be16f9-5cb3-4839-83d6-4e3829a8ab0c",
    "type": "BusinessDomainReference"
  },
  "dataProduct": {
    "referenceId": "2a1d2087-09e2-4ecf-817d-1f5bfcbc31bf",
    "type": "DataProductReference"
  },
  "dataAsset": {
    "referenceId": "fadb55b6-aa10-47d5-82c4-5e2723ba7869",
    "type": "DataAssetReference"
  }
}

샘플 응답

상태 코드:: 201

{
  "name": "Custom",
  "description": "",
  "type": "CustomTruth",
  "status": "Active",
  "typeProperties": {
    "condition": "{REVENUE} > 50000",
    "filterCriteria": "{REGION} == 'India'",
    "emptyCriteria": "{REVENUE_TARGET} < 100000",
    "columns": [
      {
        "value": "REVENUE",
        "type": "Column"
      },
      {
        "value": "REGION",
        "type": "Column"
      },
      {
        "value": "REVENUE_TARGET",
        "type": "Column"
      }
    ]
  },
  "dimension": "Accuracy",
  "id": "06dda07d-126b-43c1-aade-2484b265a271",
  "businessDomain": {
    "type": "BusinessDomainReference",
    "referenceId": "76be16f9-5cb3-4839-83d6-4e3829a8ab0c"
  },
  "dataProduct": {
    "type": "DataProductReference",
    "referenceId": "2a1d2087-09e2-4ecf-817d-1f5bfcbc31bf"
  },
  "dataAsset": {
    "type": "DataAssetReference",
    "referenceId": "fadb55b6-aa10-47d5-82c4-5e2723ba7869"
  },
  "score": -1,
  "createdAt": "2025-11-13T09:08:28.1798306Z",
  "lastModifiedAt": "2025-11-13T09:08:29.1508867Z",
  "createdBy": "6f19d772-4716-4523-9910-cb1575512ce6",
  "lastModifiedBy": "6f19d772-4716-4523-9910-cb1575512ce6"
}

정의

Name	Description
Azure.Core.Foundations.Error	오류 개체입니다.
Azure.Core.Foundations.ErrorResponse	오류 세부 정보가 포함된 응답입니다.
Azure.Core.Foundations.InnerError	오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Column	데이터셋 검증 및 품질 검사를 위한 컬럼 정의
Reference	관계 구축을 위한 데이터 거버넌스 계층 내 엔터티에 대한 참조
RuleEntity	검증 논리, 실행 매개변수, 점수 부여를 포함한 데이터 품질 규칙 엔터티
TypeProperties	데이터 품질 규칙에 대한 유형별 구성 속성.

Azure.Core.Foundations.Error

Object

오류 개체입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Azure.Core.Foundations.Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	Azure.Core.Foundations.InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	Azure.Core.Foundations.Error	오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror	Azure.Core.Foundations.InnerError	내부 오류입니다.

Column

Object

데이터셋 검증 및 품질 검사를 위한 컬럼 정의

Name	형식	Description
type	string	열 데이터 유형 또는 분류
value	string	열명 또는 식별자

Reference

Object

관계 구축을 위한 데이터 거버넌스 계층 내 엔터티에 대한 참조

Name	형식	Description
referenceId	string	참조된 엔터티의 고유 식별자
type	string	참조된 엔터티의 유형 분류

RuleEntity

Object

검증 논리, 실행 매개변수, 점수 부여를 포함한 데이터 품질 규칙 엔터티

Name	형식	Description
businessDomain	Reference	비즈니스 도메인 참조
createdAt	string (date-time)	이 규칙이 만들어진 타임스탬프
createdBy	string	규칙 작성자의 사용자 식별자
dataAsset	Reference	데이터 자산 참조
dataProduct	Reference	데이터 제품 참조
description	string	규칙 검증 및 비즈니스 목적에 대한 상세한 설명
dimension	string	선택적 사업 차원 또는 분류
id	string	고유 규칙 식별자
lastModifiedAt	string (date-time)	이 규칙이 마지막으로 수정된 타임스탬프
lastModifiedBy	string	규칙의 마지막 수정자를 위한 사용자 식별자
name	string	규칙의 설명적 명칭
score	number (double)	품질 점수 (0.0에서 1.0)
status	string	현재 실행 상태
type	string	규칙 유형 분류
typeProperties	TypeProperties	타입별 구성 속성

TypeProperties

Object

데이터 품질 규칙에 대한 유형별 구성 속성.

Name	형식	Description
column	Column	컬럼별 규칙을 위한 컬럼 명세.
columns	Column[]	다중 열 또는 관계형 규칙(예: Duplicate, CustomTruth)의 열 목록입니다.
condition	string	검증 기준을 정의하는 주요 논리적 조건 또는 표현.
emptyCriteria	string	필드나 열이 비어 있다고 간주되는 경우를 정의하는 선택적 조건입니다.
filterCriteria	string	이 규칙으로 검증된 행을 제한하는 선택적 필터 조건.
pattern	string	형식 규칙에 대한 정규식 또는 패턴 기반 검증 논리.

다음을 통해 공유

Create Rules - Create Rules

URI 매개 변수

요청 본문

응답

보안

OAuth2Auth

범위

예제

CreateRules_DataAsset

샘플 요청

샘플 응답

정의

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

Column

Reference

RuleEntity

TypeProperties