Get Scoped Asset Meta Data For Asset DQ - Get Scoped Asset Meta Data For Asset DQ

Dienst:

Purview

API-Version:

2026-01-12-preview

Ruft die scoped asset-Metadaten für ein gegebenes Datenasset innerhalb einer Geschäftsdomäne ab. Das Datenprodukt ist als optionaler Abfrageparameter angegeben.

GET {endpoint}/purviewdataquality/api/business-domains/{businessDomainId}/data-assets/{dataAssetId}/scoped-asset-metadata?api-version=2026-01-12-preview

Mit optionalen Parametern:

GET {endpoint}/purviewdataquality/api/business-domains/{businessDomainId}/data-assets/{dataAssetId}/scoped-asset-metadata?api-version=2026-01-12-preview&dataProductId={dataProductId}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
businessDomainId	path	True	string	Eindeutige Kennung für die Geschäftsdomäne, die das Datenprodukt enthält
dataAssetId	path	True	string	Eindeutige Identifikatorin für das Datenasset, dessen scoped-Metadaten abgerufen werden
endpoint	path	True	string (uri)
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
dataProductId	query		string	Für Assets, die keinem Data Product zugeordnet sind, verwenden Sie Guid.Empty für dataProductId. Dies ist optional.

Antworten

Name	Typ	Beschreibung
200 OK	ScopedAssetMetadata	Die Anforderung ist erfolgreich.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

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

Beispiele

ScopedAssetMetaData_Get_V2

Beispielanforderung

HTTP

GET {endpoint}/purviewdataquality/api/business-domains/abcdef12-3456-7890-abcd-ef1234567890/data-assets/123e4567-e89b-12d3-a456-426614174000/scoped-asset-metadata?api-version=2026-01-12-preview&dataProductId=00000000-0000-0000-0000-000000000000

Beispiel für eine Antwort

Statuscode:

200

{
  "description": "",
  "favouriteColumnPaths": [],
  "id": "642bc3b4-66aa-494a-b9d9-797085ce2cb0",
  "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"
  },
  "runtime": {
    "isErrorRowRequired": false,
    "errorRowWriteFormat": ""
  },
  "createdAt": "2025-06-27T10:38:07.6920087Z",
  "lastModifiedAt": "2025-06-27T10:38:07.6920087Z",
  "createdBy": "92522642-6537-4785-9fcd-fe58afaa43c5",
  "lastModifiedBy": "92522642-6537-4785-9fcd-fe58afaa43c5",
  "ETag": "250026c0-0000-3200-0000-685e748f0000"
}

Definitionen

Name	Beschreibung
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß Azure REST-API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.
Reference	Verweise auf Entitäten in der Daten-Governance-Hierarchie für den Beziehungsaufbau
ScopedAssetMetadata	Konfiguration der Metadaten für das Scoped Asset ist mit einem bestimmten Datenasset verknüpft.
ScopedAssetMetadataRuntime	Laufzeit-Konfigurationsoptionen für eine Metadaten-Entität mit Scoped Asset.

Azure.Core.Foundations.Error

Objekt

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Objekt

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Objekt

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß Azure REST-API-Richtlinien – https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.

Reference

Objekt

Verweise auf Entitäten in der Daten-Governance-Hierarchie für den Beziehungsaufbau

Name	Typ	Beschreibung
referenceId	string	Eindeutige Identifikatorin der referenzierten Entität
type	string	Typklassifikation der referenzierten Entität

ScopedAssetMetadata

Objekt

Konfiguration der Metadaten für das Scoped Asset ist mit einem bestimmten Datenasset verknüpft.

Name	Typ	Beschreibung
ETag	string	Entitäten-Tag, das für Nebenlaufbarkeitskontrolle und Versionsvalidierung verwendet wird.
businessDomain	Reference	Verweise auf die zugehörige Geschäftsdomäne.
createdAt	string (date-time)	Zeitstempel, wann diese Metadaten erstellt wurden.
createdBy	string	Identifikator des Benutzers, der diese Metadaten erstellt hat.
dataAsset	Reference	Verweise auf das zugehörige Data Asset.
dataProduct	Reference	Verweise auf das zugehörige Datenprodukt.
description	string	Beschreibender Text mit Details zu den Metadaten des scoped assets.
favouriteColumnPaths	string[]	Liste der bevorzugten Spaltenpfade, die für schnellen Zugriff oder Überwachung ausgewählt wurden.
id	string	Eindeutige Identifikator für die Metadaten-Entität des Scoped Asset.
lastModifiedAt	string (date-time)	Zeitstempel, wann diese Metadaten zuletzt geändert wurden.
lastModifiedBy	string	Identifikator des Nutzers, der diese Metadaten zuletzt geändert hat.
runtime	ScopedAssetMetadataRuntime	Laufzeitkonfigurationsparameter definieren das Verhalten der Fehlerzeilen und das Ausgabeformat.

ScopedAssetMetadataRuntime

Objekt

Laufzeit-Konfigurationsoptionen für eine Metadaten-Entität mit Scoped Asset.

Name	Typ	Beschreibung
errorRowWriteFormat	string	Spezifiziert das Format, in dem Fehlerzeilen geschrieben werden (z. B. CSV, Parquet).
isErrorRowRequired	boolean	Gibt an, ob Details der Fehlerzeile erfasst werden sollten.