Create Rules - Create Rules

Služba:: Purview

Verze rozhraní API:: 2026-01-12-preview

Vytváří pravidla pro konkrétní datové zařízení v datovém produktu a obchodní doméně.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
businessDomainId	path	True	string	Jedinečný identifikátor obchodní domény obsahující datový produkt
dataAssetId	path	True	string	Jedinečný identifikátor datového aktiva
dataProductId	path	True	string	Jedinečný identifikátor datového produktu obsahujícího datové zařízení
endpoint	path	True	string (uri)
ruleId	path	True	string	Jedinečný identifikátor pravidla
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
id	True	string	Jedinečný identifikátor pravidla
name	True	string	Popisný název pravidla
status	True	string	Aktuální stav provedení
type	True	string	Klasifikace typu pravidla
businessDomain		Reference	Reference obchodní domény
createdAt		string (date-time)	Časové razítko, kdy bylo toto pravidlo vytvořeno
createdBy		string	Identifikátor uživatele pro tvůrce pravidla
dataAsset		Reference	Reference datových aktiv
dataProduct		Reference	Referenční data produktu
description		string	Podrobný popis ověřování pravidel a obchodního účelu
dimension		string	Volitelná obchodní dimenze nebo klasifikace
lastModifiedAt		string (date-time)	Časové razítko, kdy bylo toto pravidlo naposledy upraveno
lastModifiedBy		string	Identifikátor uživatele pro poslední modifikátor pravidla
score		number (double)	Skóre kvality (0,0 až 1,0)
typeProperties		TypeProperties	Typově specifické konfigurační vlastnosti

Odpovědi

Name	Typ	Description
201 Created	RuleEntity	Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Name

Typ

Description

201 Created

RuleEntity

Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

CreateRules_DataAsset

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
}

Definice

Name	Description
Azure.Core.Foundations.Error	Objekt chyby.
Azure.Core.Foundations.ErrorResponse	Odpověď obsahující podrobnosti o chybě.
Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace o chybě. Pokyny k rozhraní REST API Azure – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Column	Definice sloupců pro validaci datových sad a kontroly kvality
Reference	Odkaz na entity v hierarchii správy dat pro navazování vztahů
RuleEntity	Entita pravidla kvality dat s validační logikou, výkonnými parametry a skórováním
TypeProperties	Typově specifické konfigurační vlastnosti pro pravidla kvality dat.

Azure.Core.Foundations.Error

Objekt

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	Azure.Core.Foundations.Error[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt

Objekt obsahující konkrétnější informace o chybě. Pokyny k rozhraní REST API Azure – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
innererror	Azure.Core.Foundations.InnerError	Vnitřní chyba.

Column

Objekt

Definice sloupců pro validaci datových sad a kontroly kvality

Name	Typ	Description
type	string	Typ nebo klasifikace dat sloupců
value	string	Název sloupce nebo identifikátor

Reference

Objekt

Odkaz na entity v hierarchii správy dat pro navazování vztahů

Name	Typ	Description
referenceId	string	Jedinečný identifikátor odkazované entity
type	string	Typová klasifikace odkazované entity

RuleEntity

Objekt

Entita pravidla kvality dat s validační logikou, výkonnými parametry a skórováním

Name	Typ	Description
businessDomain	Reference	Reference obchodní domény
createdAt	string (date-time)	Časové razítko, kdy bylo toto pravidlo vytvořeno
createdBy	string	Identifikátor uživatele pro tvůrce pravidla
dataAsset	Reference	Reference datových aktiv
dataProduct	Reference	Referenční data produktu
description	string	Podrobný popis ověřování pravidel a obchodního účelu
dimension	string	Volitelná obchodní dimenze nebo klasifikace
id	string	Jedinečný identifikátor pravidla
lastModifiedAt	string (date-time)	Časové razítko, kdy bylo toto pravidlo naposledy upraveno
lastModifiedBy	string	Identifikátor uživatele pro poslední modifikátor pravidla
name	string	Popisný název pravidla
score	number (double)	Skóre kvality (0,0 až 1,0)
status	string	Aktuální stav provedení
type	string	Klasifikace typu pravidla
typeProperties	TypeProperties	Typově specifické konfigurační vlastnosti

TypeProperties

Objekt

Typově specifické konfigurační vlastnosti pro pravidla kvality dat.

Name	Typ	Description
column	Column	Specifikace sloupců pro pravidla specifická pro sloupce.
columns	Column[]	Seznam sloupců pro vícesloupcová nebo relační pravidla (např. Duplicate, CustomTruth).
condition	string	Hlavní logická podmínka nebo výraz definující validační kritéria.
emptyCriteria	string	Volitelná podmínka určující, kdy je pole nebo sloupec považován za prázdný.
filterCriteria	string	Volitelná filtrační podmínka pro omezení řádků ověřených tímto pravidlem.
pattern	string	Regex nebo validační logika založená na vzorech pro formátová pravidla.

Sdílet prostřednictvím

Create Rules - Create Rules

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

OAuth2Auth

Rozsahy

Příklady

CreateRules_DataAsset

Ukázkový požadavek

Ukázková odpověď

Definice

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

Column

Reference

RuleEntity

TypeProperties