Create Rules - Create Rules

Hizmet:: Purview

API Sürümü:: 2026-01-12-preview

Bir veri ürünü ve iş alanı içinde belirli bir veri varlığı için kurallar oluşturur.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
businessDomainId	path	True	string	Veri ürününü içeren iş alanı için benzersiz tanımlayıcı
dataAssetId	path	True	string	Veri varlığı için benzersiz tanımlayıcı
dataProductId	path	True	string	Veri varlığını içeren veri ürünü için benzersiz tanımlayıcı
endpoint	path	True	string (uri)
ruleId	path	True	string	Kural için benzersiz tanımlayıcı
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
id	True	string	Benzersiz kural tanımlayıcısı
name	True	string	Kuralın tanımlayıcı adı
status	True	string	Mevcut uygulama durumu
type	True	string	Kural tipi sınıflandırması
businessDomain		Reference	İş alanı referansı
createdAt		string (date-time)	Bu kuralın oluşturulduğu zaman damgası
createdBy		string	Kuralın yaratıcısı için kullanıcı tanımlayıcısı
dataAsset		Reference	Veri varlık referansı
dataProduct		Reference	Veri ürünü referansı
description		string	Kural doğrulaması ve iş amacının ayrıntılı açıklaması
dimension		string	Isteğe bağlı iş boyutu veya sınıflandırma
lastModifiedAt		string (date-time)	Bu kuralın en son değiştirildiği zaman damgası
lastModifiedBy		string	Kuralın son değiştiricisi için kullanıcı tanımlayıcısı
score		number (double)	Kalite puanı (0.0 - 1.0)
typeProperties		TypeProperties	Tipe özgü yapılandırma özellikleri

Yanıtlar

Name	Tür	Description
201 Created	RuleEntity	İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Beklenmeyen bir hata yanıtı. Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

201 Created

RuleEntity

İstek başarılı oldu ve sonuç olarak yeni bir kaynak oluşturuldu.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

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

Örnekler

CreateRules_DataAsset

Örnek isteği

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"
  }
}

Örnek yanıt

Durum kodu:: 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"
}

Tanımlar

Name	Description
Azure.Core.Foundations.Error	Hata nesnesi.
Azure.Core.Foundations.ErrorResponse	Hata ayrıntılarını içeren bir yanıt.
Azure.Core.Foundations.InnerError	Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Column	Veri seti doğrulaması ve kalite kontrolleri için sütun tanımı
Reference	İlişki kurulması için veri yönetişimi hiyerarşisindeki varlıklara referans
RuleEntity	Doğrulama mantığı, yürütme parametreleri ve puanlama ile veri kalitesi kuralı varlığı
TypeProperties	Veri kalitesi kuralları için tipe özgü yapılandırma özellikleri.

Azure.Core.Foundations.Error

Nesne

Hata nesnesi.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	Azure.Core.Foundations.Error[]	Bu bildirilen hataya yol açan belirli hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

Hata ayrıntılarını içeren bir yanıt.

Name	Tür	Description
error	Azure.Core.Foundations.Error	Hata nesnesi.

Azure.Core.Foundations.InnerError

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

Column

Nesne

Veri seti doğrulaması ve kalite kontrolleri için sütun tanımı

Name	Tür	Description
type	string	Sütun veri tipi veya sınıflandırma
value	string	Sütun adı veya tanımlayıcı

Reference

Nesne

İlişki kurulması için veri yönetişimi hiyerarşisindeki varlıklara referans

Name	Tür	Description
referenceId	string	Referans edilen varlığın benzersiz tanımlayıcısı
type	string	Referans edilen varlığın tür sınıflandırması

RuleEntity

Nesne

Doğrulama mantığı, yürütme parametreleri ve puanlama ile veri kalitesi kuralı varlığı

Name	Tür	Description
businessDomain	Reference	İş alanı referansı
createdAt	string (date-time)	Bu kuralın oluşturulduğu zaman damgası
createdBy	string	Kuralın yaratıcısı için kullanıcı tanımlayıcısı
dataAsset	Reference	Veri varlık referansı
dataProduct	Reference	Veri ürünü referansı
description	string	Kural doğrulaması ve iş amacının ayrıntılı açıklaması
dimension	string	Isteğe bağlı iş boyutu veya sınıflandırma
id	string	Benzersiz kural tanımlayıcısı
lastModifiedAt	string (date-time)	Bu kuralın en son değiştirildiği zaman damgası
lastModifiedBy	string	Kuralın son değiştiricisi için kullanıcı tanımlayıcısı
name	string	Kuralın tanımlayıcı adı
score	number (double)	Kalite puanı (0.0 - 1.0)
status	string	Mevcut uygulama durumu
type	string	Kural tipi sınıflandırması
typeProperties	TypeProperties	Tipe özgü yapılandırma özellikleri

TypeProperties

Nesne

Veri kalitesi kuralları için tipe özgü yapılandırma özellikleri.

Name	Tür	Description
column	Column	Sütun özel kurallar için sütun spesifikasyonu.
columns	Column[]	Çok sütunlu veya ilişkisel kurallar için sütun listesi (örneğin, Duplicate, CustomTruth).
condition	string	Doğrulama kriterlerini tanımlayan ana mantıksal koşul veya ifade.
emptyCriteria	string	Bir alan veya sütunun boş kabul edildiği zaman tanımlayan isteğe bağlı koşul.
filterCriteria	string	Bu kuralla doğrulanan satırları sınırlamak için isteğe bağlı filtreleme şartı.
pattern	string	Format kuralları için regex veya desen tabanlı doğrulama mantığı.

Aracılığıyla paylaş

Create Rules - Create Rules

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

OAuth2Auth

Kapsamlar

Örnekler

CreateRules_DataAsset

Örnek isteği

Örnek yanıt

Tanımlar

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

Column

Reference

RuleEntity

TypeProperties