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

Servizio:

Purview

Versione API:

2026-01-12-preview

Recupera i metadati dell'asset con ambito per un dato asset all'interno di un dominio aziendale. Il prodotto dati è specificato come parametro di query opzionale.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
businessDomainId	path	True	string	Identificatore univoco per il dominio aziendale contenente il prodotto dati
dataAssetId	path	True	string	Identificatore univoco per l'asset dati i cui metadati a scopo vengono recuperati
endpoint	path	True	string (uri)
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
dataProductId	query		string	Per asset non associati a nessun Data Product, usa Guid.Empty per dataProductId. Optional.

Risposte

Nome	Tipo	Descrizione
200 OK	ScopedAssetMetadata	La richiesta ha avuto esito positivo.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://purview.azure.net/.default

Esempio

ScopedAssetMetaData_Get_V2

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.
Reference	Riferimento a entità nella gerarchia di governance dei dati per l'instaurazione delle relazioni
ScopedAssetMetadata	Configurazione dei metadati dell'asset, con ambito di ambito collegato a un asset dati specifico.
ScopedAssetMetadataRuntime	Opzioni di configurazione in tempo reale per un'entità metadata di asset con ambito definito.

Azure.Core.Foundations.Error

Oggetto

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Oggetto

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST Azure: https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

Reference

Oggetto

Riferimento a entità nella gerarchia di governance dei dati per l'instaurazione delle relazioni

Nome	Tipo	Descrizione
referenceId	string	Identificatore univoco dell'entità di riferimento
type	string	Classificazione del tipo dell'entità di riferimento

ScopedAssetMetadata

Oggetto

Configurazione dei metadati dell'asset, con ambito di ambito collegato a un asset dati specifico.

Nome	Tipo	Descrizione
ETag	string	Entity tag utilizzato per il controllo della concorrenza e la validazione delle versioni.
businessDomain	Reference	Riferimento al Business Domain associato.
createdAt	string (date-time)	Timestamp quando questi metadati sono stati creati.
createdBy	string	Identificatore dell'utente che ha creato questi metadati.
dataAsset	Reference	Riferimento all'Asset Dati associato.
dataProduct	Reference	Riferimento al prodotto dati associato.
description	string	Testo descrittivo che fornisce dettagli sui metadati dell'asset a scopo.
favouriteColumnPaths	string[]	Elenco dei percorsi di colonna preferiti selezionati per un accesso rapido o monitoraggio.
id	string	Identificatore unico per l'entità metadata dell'asset con ambito definito.
lastModifiedAt	string (date-time)	Timestamp quando questi metadati sono stati modificati l'ultima volta.
lastModifiedBy	string	Identificatore dell'utente che ha modificato questi metadati per ultimo.
runtime	ScopedAssetMetadataRuntime	Parametri di configurazione a runtime che definiscono il comportamento della riga di errore e il formato dell'output.

ScopedAssetMetadataRuntime

Oggetto

Opzioni di configurazione in tempo reale per un'entità metadata di asset con ambito definito.

Nome	Tipo	Descrizione
errorRowWriteFormat	string	Specifica il formato in cui vengono scritte le righe di errore (ad esempio, CSV, Parquet).
isErrorRowRequired	boolean	Indica se i dettagli della riga di errore devono essere catturati.