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

Usługa:

Purview

Wersja interfejsu API:

2026-01-12-preview

Pobiera metadane o skali zasobów dla danego zasobu danych w ramach domeny biznesowej. Produkt danych jest określany jako opcjonalny parametr zapytania.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
businessDomainId	path	True	string	Unikalny identyfikator domeny biznesowej zawierającej produkt danych
dataAssetId	path	True	string	Unikalny identyfikator dla zasobu danych, którego metadane o skali są pobierane
endpoint	path	True	string (uri)
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
dataProductId	query		string	Dla zasobów niepowiązanych z żadnym produktem danych użyj Guid.Empty dla dataProductId. Opcjonalny.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ScopedAssetMetadata	Żądanie zakończyło się pomyślnie.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://purview.azure.net/.default

Przykłady

ScopedAssetMetaData_Get_V2

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi interfejsu API REST Azure — https://aka.ms/AzureRestApiGuidelines#handling-errors.
Reference	Odniesienie do podmiotów w hierarchii zarządzania danymi dla ustanawiania relacji
ScopedAssetMetadata	Konfiguracja metadanych zasobów o skaloryscie powiązana z konkretnym zasobem danych.
ScopedAssetMetadataRuntime	Opcje konfiguracji w czasie działania dla entencji metadanych zasobów o skalacji.

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi interfejsu API REST Azure — https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

Reference

Objekt

Odniesienie do podmiotów w hierarchii zarządzania danymi dla ustanawiania relacji

Nazwa	Typ	Opis
referenceId	string	Unikalny identyfikator cytowanego podmiotu
type	string	Klasyfikacja typów podmiotu odniesienego

ScopedAssetMetadata

Objekt

Konfiguracja metadanych zasobów o skaloryscie powiązana z konkretnym zasobem danych.

Nazwa	Typ	Opis
ETag	string	Tag podmiotu używany do kontroli współbieżności i walidacji wersji.
businessDomain	Reference	Odniesienie do powiązanej domeny biznesowej.
createdAt	string (date-time)	Znacznik czasu od momentu utworzenia tych metadanych.
createdBy	string	Identyfikator użytkownika, który stworzył te metadane.
dataAsset	Reference	Odniesienie do powiązanego zasobu danych.
dataProduct	Reference	Odniesienie do powiązanego produktu danych.
description	string	Tekst opisowy zawierający szczegóły dotyczące metadanych zasobów.
favouriteColumnPaths	string[]	Lista ulubionych ścieżek kolumn wybranych do szybkiego dostępu lub monitorowania.
id	string	Unikalny identyfikator dla jednostki metadanych aktywów objętych zakresem.
lastModifiedAt	string (date-time)	Znacznik czasu, kiedy te metadane zostały ostatnio zmodyfikowane.
lastModifiedBy	string	Identyfikator użytkownika, który ostatnio zmodyfikował te metadane.
runtime	ScopedAssetMetadataRuntime	Parametry konfiguracyjne w czasie wykonywania określają zachowanie wiersza błędu oraz format wyjścia.

ScopedAssetMetadataRuntime

Objekt

Opcje konfiguracji w czasie działania dla entencji metadanych zasobów o skalacji.

Nazwa	Typ	Opis
errorRowWriteFormat	string	Określa format, w jakim zapisywane są wiersze błędu (np. CSV, Parquet).
isErrorRowRequired	boolean	Wskazuje, czy należy rejestrować szczegóły wiersza błędu.