Data Products - List

Služba:: Purview

Verze rozhraní API:: 2026-03-20-preview

Uvádí datové produkty s volitelným filtrem domény, řazením a stránkováním. Limit rychlosti: 100 požadavků za 20sekundové okno.

GET {endpoint}/datagovernance/catalog/dataProducts?api-version=2026-03-20-preview

S volitelnými parametry:

GET {endpoint}/datagovernance/catalog/dataProducts?api-version=2026-03-20-preview&skip={skip}&top={top}&domainId={domainId}&orderBy={orderBy}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Koncový bod služby Purview Unified Catalog. Příklad: https://api.purview-service.microsoft.com/
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
domainId	query		string (uuid)	Volitelný filtr identifikátoru domény.
orderBy	query		string	Výrazy, které určují pořadí vrácených výsledků.
skip	query		integer (int32)	Počet položek výsledků, které se mají přeskočit.
top	query		integer (int32)	Počet výsledných položek, které se mají vrátit.

Odpovědi

Name	Typ	Description
200 OK	PagedDataProduct	Požadavek byl úspěšný.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Name

Typ

Description

200 OK

PagedDataProduct

Požadavek byl úspěšný.

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

DataProducts_List

Ukázkový požadavek

HTTP

GET {endpoint}/datagovernance/catalog/dataProducts?api-version=2026-03-20-preview&skip=0&top=12&domainId=b3b4cc6e-6a91-4d34-8af3-90e2f93d6c7a&orderBy=seqyx

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "id": "4e74f902-62f5-49f4-8258-92ed2b8537ba",
      "name": "myDataProduct",
      "domain": "7e74f902-62f5-49f4-8258-92ed2b8537ba",
      "type": "Master",
      "description": "Superstore Sales generally refers to the sales data and performance of a superstore or a large retail store that offers a wide range of products as well as merchandise.",
      "businessUse": "Forecasting of future revenue. Sales trend analysis.",
      "contacts": {
        "owner": [
          {
            "id": "4e74f902-62f5-49f4-8258-92ed2b8537ba",
            "description": "db1"
          },
          {
            "id": "5e74f902-62f5-49f4-8258-92ed2b8537ba",
            "description": "db2"
          }
        ],
        "expert": [
          {
            "id": "4e74f902-62f5-49f4-8258-92ed2b8537ba",
            "description": "db1"
          },
          {
            "id": "5e74f902-62f5-49f4-8258-92ed2b8537ba",
            "description": "db2"
          }
        ],
        "databaseAdmin": [
          {
            "id": "4e74f902-62f5-49f4-8258-92ed2b8537ba",
            "description": "db1"
          },
          {
            "id": "5e74f902-62f5-49f4-8258-92ed2b8537ba",
            "description": "db2"
          }
        ]
      },
      "updateFrequency": "Daily",
      "termsOfUse": [
        {
          "url": "https://www.microsoft.com",
          "name": "Microsoft",
          "dataAssetId": "4e74f902-62f5-49f4-8258-92ed2b8537ba"
        }
      ],
      "documentation": [
        {
          "url": "https://www.microsoft.com",
          "name": "Microsoft",
          "dataAssetId": "4e74f902-62f5-49f4-8258-92ed2b8537ba"
        }
      ],
      "sensitivityLabel": "9620744d-630c-4d07-b8db-541ec20e1a2a",
      "status": "DRAFT",
      "endorsed": false,
      "additionalProperties": {
        "assetCount": 100
      },
      "systemData": {
        "lastModifiedAt": "1970-01-01T00:00:00.000Z",
        "lastModifiedBy": "766BF2B9-5D8A-4FB1-B8D5-D30A53E22A9E",
        "createdAt": "1970-01-01T00:00:00.000Z",
        "createdBy": "766BF2B9-5D8A-4FB1-B8D5-D30A53E22A9E",
        "expiredAt": "1970-01-01T00:00:00.000Z",
        "expiredBy": "766BF2B9-5D8A-4FB1-B8D5-D30A53E22A9E"
      }
    }
  ]
}

Definice

Name	Description
AudienceEnum	Výčet cílových skupin pro datové produkty.
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ě. Podle Azure REST API – https://aka.ms/AzureRestApiGuidelines#handling-errors.
CatalogModelContactsValueInner	Kontaktní informace pro katalogové entity.
CatalogModelDataProductAllOfAdditionalProperties	Další vlastnosti pro datový model produktu.
CatalogModelDataProductTypeEnum	CatalogModelDataProductTypeVýčet
CatalogModelExternalLink	Externí odkazový model pro datový produkt.
CatalogModelManagedAttribute	Konfigurace spravovaných atributů pro entity katalogu.
CatalogModelStatus	Stav entity modelu katalogu označující stav jejího životního cyklu.
CatalogModelSystemDataWithExpired	Systémová metadata s informacemi o vypršení platnosti pro entity katalogu.
ContactsMap	Slovník seznamů kontaktů zadaných podle typu kontaktu (např. 'Vlastník', 'Expert').
DataAssetProvisioningState	Stav provisioningu datového aktiva.
DataProduct	Datový produkt modelu katalogu zásad správného řízení dat Microsoft Purview.
PagedDataProduct	Stránkovaná kolekce položek DataProduct
UpdateFrequencyEnum	Výčet UpdateFrequencyEnum

AudienceEnum

Výčet

Výčet cílových skupin pro datové produkty.

Hodnota	Description
DataEngineer	Cílová skupina datových inženýrů.
BIEngineer	Cílová skupina inženýrů BI.
DataAnalyst	Cílová skupina datového analytika.
DataScientist	Cílová skupina datových vědců.
BusinessAnalyst	Cílová skupina obchodního analytika.
SoftwareEngineer	Publikum softwarových inženýrů.
BusinessUser	Cílové skupiny firemních uživatelů.
Executive	Výkonné publikum.

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ě. Podle Azure REST API – 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.

CatalogModelContactsValueInner

Objekt

Kontaktní informace pro katalogové entity.

Name	Typ	Description
description	string	Popis tohoto uživatelského přiřazení
id	string (uuid)	AAD oid pro danou osobu nebo skupinu

CatalogModelDataProductAllOfAdditionalProperties

Objekt

Další vlastnosti pro datový model produktu.

Name	Typ	Description
assetCount	integer (int64)	Počet datových zdrojů v datovém produktu.

CatalogModelDataProductTypeEnum

Výčet

CatalogModelDataProductTypeVýčet

Hodnota	Description
Master	Stav je Master.
Reference	Stav je Odkaz.
Analytical	Stav je Analytický.
AI	Stav je AI.
MasterDataAndReferenceData	Stav je MasterDataAndReferenceData.
BusinessSystemOrApplication	Stav je BusinessSystemOrApplication.
ModelTypes	Stav je ModelTypes.
DashboardsOrReports	Stav je DashboardsOrReports.
Operational	Stav je Provozní.
MLAITrainingDataSet	Stav je MLAITrainingDataSet.
MLAITestingDataSet	Stav je MLAITestingDataSet.
TransactionalDataset	Stav je TransactionalDataset.
AnalyticsModel	Stav je AnalyticsModel.
SemanticModel	Stav je SemanticModel.

CatalogModelExternalLink

Objekt

Externí odkazový model pro datový produkt.

Name	Typ	Description
dataAssetId	string (uuid)	Identifikátor datového assetu přidružený k odkazu.
name	string	Název externího odkazu.
url	string (uri)	Adresa URL externího odkazu.

CatalogModelManagedAttribute

Objekt

Konfigurace spravovaných atributů pro entity katalogu.

Name	Typ	Description
isRequired	boolean	Zda je tento atribut povinný.
name	string	Název spravovaného atributu.
value	string	Hodnota atributu.

CatalogModelStatus

Výčet

Stav entity modelu katalogu označující stav jejího životního cyklu.

Hodnota	Description
DRAFT	Entita je ve stavu konceptu.
PUBLISHED	Entita je publikovaná a aktivní.
EXPIRED	Platnost entity vypršela a již není aktivní.

CatalogModelSystemDataWithExpired

Objekt

Systémová metadata s informacemi o vypršení platnosti pro entity katalogu.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko, kdy byl záznam vytvořen.
createdBy	string (uuid)	Jedinečný identifikátor uživatele, který záznam vytvořil.
expiredAt	string (date-time)	Časové razítko po vypršení platnosti záznamu.
expiredBy	string (uuid)	Jedinečný identifikátor uživatele, jehož platnost záznamu vypršela.
lastModifiedAt	string (date-time)	Časové razítko, kdy byl záznam naposledy změněn.
lastModifiedBy	string (uuid)	Jedinečný identifikátor uživatele, který záznam naposledy změnil.
provisioningState	DataAssetProvisioningState	Stav poskytování záznamu. např: softdeleted

ContactsMap

Objekt

Slovník seznamů kontaktů zadaných podle typu kontaktu (např. 'Vlastník', 'Expert').

Name	Typ	Description
databaseAdmin	CatalogModelContactsValueInner[]	Seznam kontaktů na správce databáze.
expert	CatalogModelContactsValueInner[]	Seznam kontaktů odborníků.
owner	CatalogModelContactsValueInner[]	Seznam kontaktů majitelů.

DataAssetProvisioningState

Výčet

Stav provisioningu datového aktiva.

Hodnota	Description
Unknown	Stav zásobování není znám.
Succeeded	Zdroj byl úspěšně zajištěn.
SoftDeleted	Zdroj byl měkko smazán.

DataProduct

Objekt

Datový produkt modelu katalogu zásad správného řízení dat Microsoft Purview.

Name	Typ	Description
activeSubscriberCount	integer (int32)	Počet aktivních předplatitelů.
additionalProperties	CatalogModelDataProductAllOfAdditionalProperties	Další vlastnosti datového produktu.
audience	AudienceEnum[]	Cílová skupina pro datový produkt.
businessUse	string	Obchodní využití datového produktu.
contacts	ContactsMap	Kontakty spojené s datovým produktem.
dataQualityScore	number (double)	Skóre kvality dat datového produktu.
description	string	Popis datového produktu.
documentation	CatalogModelExternalLink[]	Odkazy na dokumentaci k datovému produktu.
domain	string (uuid)	Doména datového produktu.
endorsed	boolean	Zda je datový produkt schválen.
id	string (uuid)	Jedinečný identifikátor datového produktu.
managedAttributes	CatalogModelManagedAttribute[]	Spravované atributy spojené s datovým produktem.
name	string	Název datového produktu.
sensitivityLabel	string	Popisek citlivosti datového produktu.
status	CatalogModelStatus	Stav datového produktu.
systemData	CatalogModelSystemDataWithExpired	Systémová data datového produktu.
termsOfUse	CatalogModelExternalLink[]	Podmínky použití pro datový produkt.
type	CatalogModelDataProductTypeEnum	Typ datového produktu.
updateFrequency	UpdateFrequencyEnum	Četnost aktualizací datového produktu.

PagedDataProduct

Objekt

Stránkovaná kolekce položek DataProduct

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	DataProduct[]	Položky DataProduct na této stránce

UpdateFrequencyEnum

Výčet

Výčet UpdateFrequencyEnum

Hodnota	Description
Hourly	Stav je Hourly.
Daily	Stav je Denně.
Weekly	Stav je Týdně.
Monthly	Stav je Měsíčně.
Quarterly	Stav je Čtvrtletní.
Yearly	Stav je Roční.