Create Rules - Create Rules

Szolgáltatás:: Purview

API-verzió:: 2026-01-12-preview

Szabályokat hoz létre egy adott adateszközre egy adatterméken és üzleti területen belül.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
businessDomainId	path	True	string	Egyedi azonosító az üzleti domainhez, amely tartalmazza az adatterméket
dataAssetId	path	True	string	Az adateszköz egyedi azonosítója
dataProductId	path	True	string	Az adat eszközt tartalmazó adattermékhez tartozó egyedi azonosító
endpoint	path	True	string (uri)
ruleId	path	True	string	A szabály egyedi azonosítója
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
id	True	string	Egyedi szabályazonosító
name	True	string	A szabály leíró neve
status	True	string	Jelenlegi végrehajtási állapot
type	True	string	Szabálytípus osztályozás
businessDomain		Reference	Üzleti területi referencia
createdAt		string (date-time)	Időbélyeg, amikor ezt a szabályt létrehozták
createdBy		string	A szabály megalkotójának felhasználói azonosítója
dataAsset		Reference	Adat-eszköz referencia
dataProduct		Reference	Adattermék-referencia
description		string	Részletes leírás a szabály validálásáról és üzleti céljáról
dimension		string	Opcionális üzleti dimenzió vagy osztályozás
lastModifiedAt		string (date-time)	Időbélyeg, amikor ezt a szabályt utoljára módosították
lastModifiedBy		string	Felhasználói azonosító a szabály utolsó módosítójához
score		number (double)	Minőségi pontszám (0,0–1,0)
typeProperties		TypeProperties	Típus-specifikus konfigurációs tulajdonságok

Válaszok

Name	Típus	Description
201 Created	RuleEntity	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Name

Típus

Description

201 Created

RuleEntity

A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

CreateRules_DataAsset

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
}

Definíciók

Name	Description
Azure.Core.Foundations.Error	A hibaobjektum.
Azure.Core.Foundations.ErrorResponse	Hibaadatokat tartalmazó válasz.
Azure.Core.Foundations.InnerError	Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Azure REST API-irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Column	Oszlopdefiníció az adathalmaz-ellenőrzéshez és minőségellenőrzéshez
Reference	Hivatkozás az adatirányítási hierarchiában szereplő entitásokra a kapcsolat kialakításához
RuleEntity	Adatminőségi szabály entitás validációs logikával, végrehajtási paraméterekkel és pontozással
TypeProperties	Adatminőségi szabályokhoz tartozó típusspecifikus konfigurációs tulajdonságok.

Azure.Core.Foundations.Error

Tárgy

A hibaobjektum.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
details	Azure.Core.Foundations.Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	Azure.Core.Foundations.InnerError	Egy objektum, amely az aktuális objektumnál pontosabb információt tartalmaz a hibáról.
message	string	A hiba ember által olvasható ábrázolása.
target	string	A hiba célja.

Azure.Core.Foundations.ErrorResponse

Tárgy

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	Azure.Core.Foundations.Error	A hibaobjektum.

Azure.Core.Foundations.InnerError

Tárgy

Egy objektum, amely részletesebb információkat tartalmaz a hibáról. Azure REST API-irányelvek szerint – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
innererror	Azure.Core.Foundations.InnerError	Belső hiba.

Column

Tárgy

Oszlopdefiníció az adathalmaz-ellenőrzéshez és minőségellenőrzéshez

Name	Típus	Description
type	string	Oszlopadattípus vagy osztályozás
value	string	Oszlop neve vagy azonosító

Reference

Tárgy

Hivatkozás az adatirányítási hierarchiában szereplő entitásokra a kapcsolat kialakításához

Name	Típus	Description
referenceId	string	A hivatkozott entitás egyedi azonosítója
type	string	A hivatkozott egység típusbesorolása

RuleEntity

Tárgy

Adatminőségi szabály entitás validációs logikával, végrehajtási paraméterekkel és pontozással

Name	Típus	Description
businessDomain	Reference	Üzleti területi referencia
createdAt	string (date-time)	Időbélyeg, amikor ezt a szabályt létrehozták
createdBy	string	A szabály megalkotójának felhasználói azonosítója
dataAsset	Reference	Adat-eszköz referencia
dataProduct	Reference	Adattermék-referencia
description	string	Részletes leírás a szabály validálásáról és üzleti céljáról
dimension	string	Opcionális üzleti dimenzió vagy osztályozás
id	string	Egyedi szabályazonosító
lastModifiedAt	string (date-time)	Időbélyeg, amikor ezt a szabályt utoljára módosították
lastModifiedBy	string	Felhasználói azonosító a szabály utolsó módosítójához
name	string	A szabály leíró neve
score	number (double)	Minőségi pontszám (0,0–1,0)
status	string	Jelenlegi végrehajtási állapot
type	string	Szabálytípus osztályozás
typeProperties	TypeProperties	Típus-specifikus konfigurációs tulajdonságok

TypeProperties

Tárgy

Adatminőségi szabályokhoz tartozó típusspecifikus konfigurációs tulajdonságok.

Name	Típus	Description
column	Column	Oszlopspecifikus szabályok specifikációja.
columns	Column[]	Többoszlopos vagy relációs szabályok oszlopainak listája (pl. Duplicate, CustomTruth).
condition	string	A fő logikai feltétel vagy kifejezés, amely meghatározza az érvényesítési kritériumokat.
emptyCriteria	string	Opcionális feltétel, amely meghatározza, mikor tekintik egy mezőt vagy oszlopot üresnek.
filterCriteria	string	Opcionális szűrőfeltétel a sorok korlátozására, amelyeket ez a szabály validál.
pattern	string	Regex vagy mintáalapú validációs logika formátumszabályokhoz.

Megosztás a következőn keresztül:

Create Rules - Create Rules

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

OAuth2Auth

Hatókörök

Példák

CreateRules_DataAsset

Mintakérelem

Mintaválasz

Definíciók

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

Column

Reference

RuleEntity

TypeProperties