Create Rules - Create Rules

Service:: Purview

API-versie:: 2026-01-12-preview

Maakt regels op voor een specifiek data-asset binnen een dataproduct en bedrijfsdomein.

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

URI-parameters

Name	In	Vereist	Type	Description
businessDomainId	path	True	string	Unieke identificatie voor het bedrijfsdomein dat het dataproduct bevat
dataAssetId	path	True	string	Unieke identificatie voor het data-asset
dataProductId	path	True	string	Unieke identificatie voor het dataproduct dat het data-asset bevat
endpoint	path	True	string (uri)
ruleId	path	True	string	Unieke identificatie voor de regel
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
id	True	string	Unieke regelidentificatie
name	True	string	Beschrijvende naam van de regel
status	True	string	Huidige uitvoeringsstatus
type	True	string	Classificatie van regeltypen
businessDomain		Reference	Zakelijke domeinreferentie
createdAt		string (date-time)	Tijdstempel wanneer deze regel werd gecreëerd
createdBy		string	Gebruikersidentificatie voor de maker van de regel
dataAsset		Reference	Data asset referentie
dataProduct		Reference	Referentie van het dataproduct
description		string	Gedetailleerde beschrijving van regelvalidatie en bedrijfsdoel
dimension		string	Optionele zakelijke dimensie of classificatie
lastModifiedAt		string (date-time)	Tijdstempel wanneer deze regel voor het laatst werd aangepast
lastModifiedBy		string	Gebruikersidentificatie voor de laatste modifier van de regel
score		number (double)	Kwaliteitsscore (0,0 tot 1,0)
typeProperties		TypeProperties	Type-specifieke configuratie-eigenschappen

Antwoorden

Name	Type	Description
201 Created	RuleEntity	De aanvraag is geslaagd en er is een nieuwe resource gemaakt.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Name

Type

Description

201 Created

RuleEntity

De aanvraag is geslaagd en er is een nieuwe resource gemaakt.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Een onverwachte foutreactie.

Kopteksten

x-ms-error-code: string

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

Voorbeelden

CreateRules_DataAsset

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
Azure.Core.Foundations.Error	Het foutobject.
Azure.Core.Foundations.ErrorResponse	Een antwoord met foutdetails.
Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie over de fout. Volgens Azure REST API-richtlijnen - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Column	Kolomdefinitie voor validatie en kwaliteitscontroles van datasets
Reference	Verwijzing naar entiteiten in de datagovernance-hiërarchie voor het opzetten van relaties
RuleEntity	Regelentiteit voor gegevenskwaliteit met validatielogica, uitvoeringsparameters en scoring
TypeProperties	Type-specifieke configuratie-eigenschappen voor datakwaliteitsregels.

Azure.Core.Foundations.Error

Object

Het foutobject.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	Azure.Core.Foundations.Error[]	Een matrix met details over specifieke fouten die hebben geleid tot deze gemelde fout.
innererror	Azure.Core.Foundations.InnerError	Een object met meer specifieke informatie dan het huidige object over de fout.
message	string	Een leesbare weergave van de fout.
target	string	Het doel van de fout.

Azure.Core.Foundations.ErrorResponse

Object

Een antwoord met foutdetails.

Name	Type	Description
error	Azure.Core.Foundations.Error	Het foutobject.

Azure.Core.Foundations.InnerError

Object

Een object met meer specifieke informatie over de fout. Volgens Azure REST API-richtlijnen - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
innererror	Azure.Core.Foundations.InnerError	Interne fout.

Column

Object

Kolomdefinitie voor validatie en kwaliteitscontroles van datasets

Name	Type	Description
type	string	Kolomgegevenstype of classificatie
value	string	Kolomnaam of identificatie

Reference

Object

Verwijzing naar entiteiten in de datagovernance-hiërarchie voor het opzetten van relaties

Name	Type	Description
referenceId	string	Unieke identificatie van de verwezen entiteit
type	string	Typeclassificatie van de verwezen entiteit

RuleEntity

Object

Regelentiteit voor gegevenskwaliteit met validatielogica, uitvoeringsparameters en scoring

Name	Type	Description
businessDomain	Reference	Zakelijke domeinreferentie
createdAt	string (date-time)	Tijdstempel wanneer deze regel werd gecreëerd
createdBy	string	Gebruikersidentificatie voor de maker van de regel
dataAsset	Reference	Data asset referentie
dataProduct	Reference	Referentie van het dataproduct
description	string	Gedetailleerde beschrijving van regelvalidatie en bedrijfsdoel
dimension	string	Optionele zakelijke dimensie of classificatie
id	string	Unieke regelidentificatie
lastModifiedAt	string (date-time)	Tijdstempel wanneer deze regel voor het laatst werd aangepast
lastModifiedBy	string	Gebruikersidentificatie voor de laatste modifier van de regel
name	string	Beschrijvende naam van de regel
score	number (double)	Kwaliteitsscore (0,0 tot 1,0)
status	string	Huidige uitvoeringsstatus
type	string	Classificatie van regeltypen
typeProperties	TypeProperties	Type-specifieke configuratie-eigenschappen

TypeProperties

Object

Type-specifieke configuratie-eigenschappen voor datakwaliteitsregels.

Name	Type	Description
column	Column	Kolomspecificatie voor kolomspecifieke regels.
columns	Column[]	Lijst van kolommen voor meerkoloms- of relationele regels (bijv. Duplicate, CustomTruth).
condition	string	Belangrijkste logische voorwaarde of uitdrukking die validatiecriteria definieert.
emptyCriteria	string	Optionele voorwaarde die bepaalt wanneer een veld of kolom als leeg wordt beschouwd.
filterCriteria	string	Optionele filtervoorwaarde om rijen te beperken die door deze regel worden gevalideerd.
pattern	string	Regex of patroongebaseerde validatielogica voor formateerregels.

Delen via

Create Rules - Create Rules

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

OAuth2Auth

Bereiken

Voorbeelden

CreateRules_DataAsset

Voorbeeldaanvraag

Voorbeeldrespons

Definities

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

Column

Reference

RuleEntity

TypeProperties