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

Service:

Purview

Version d'API:

2026-01-12-preview

Récupère les métadonnées de l’actif à portée de portée pour un actif de données donné dans un domaine d’activité. Le produit de données est spécifié comme paramètre de requête optionnel.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
businessDomainId	path	True	string	Identifiant unique pour le domaine métier contenant le produit de données
dataAssetId	path	True	string	Identifiant unique pour l’actif de données dont les métadonnées ciblées sont récupérées
endpoint	path	True	string (uri)
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
dataProductId	query		string	Pour les actifs non associés à aucun produit de données, utilisez Guid.Empty pour dataProductId. Optionnel.

Réponses

Nom	Type	Description
200 OK	ScopedAssetMetadata	La demande a réussi.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

ScopedAssetMetaData_Get_V2

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API REST Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.
Reference	Référence aux entités dans la hiérarchie de gouvernance des données pour l’établissement de relations
ScopedAssetMetadata	Configuration des métadonnées d’actifs à portée liée à un actif de données spécifique.
ScopedAssetMetadataRuntime	Options de configuration à l’exécution pour une entité de métadonnées d’assets à portée de contrôle.

Azure.Core.Foundations.Error

Objet

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Une représentation lisible par une personne de l'erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Objet

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Objet

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API REST Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

Reference

Objet

Référence aux entités dans la hiérarchie de gouvernance des données pour l’établissement de relations

Nom	Type	Description
referenceId	string	Identifiant unique de l’entité référencée
type	string	Classification de type de l’entité référencée

ScopedAssetMetadata

Objet

Configuration des métadonnées d’actifs à portée liée à un actif de données spécifique.

Nom	Type	Description
ETag	string	Balise d’entité utilisée pour le contrôle de la concurrence et la validation des versions.
businessDomain	Reference	Référence au domaine commercial associé.
createdAt	string (date-time)	Horodatage de la création de ces métadonnées.
createdBy	string	Identifiant de l’utilisateur ayant créé ces métadonnées.
dataAsset	Reference	Référence à l’Asset de Données associé.
dataProduct	Reference	Référence au produit de données associé.
description	string	Texte descriptif fournissant des détails sur les métadonnées de l’actif à portée d’application.
favouriteColumnPaths	string[]	Liste des chemins de colonnes favoris sélectionnés pour un accès rapide ou une surveillance.
id	string	Identifiant unique pour l’entité de métadonnées d’actifs à portée d’application.
lastModifiedAt	string (date-time)	Heure de la dernière modification de ces métadonnées.
lastModifiedBy	string	Identifiant de l’utilisateur ayant modifié ces métadonnées en dernier.
runtime	ScopedAssetMetadataRuntime	Paramètres de configuration à l’exécution définissant le comportement des lignes d’erreur et le format de sortie.

ScopedAssetMetadataRuntime

Objet

Options de configuration à l’exécution pour une entité de métadonnées d’assets à portée de contrôle.

Nom	Type	Description
errorRowWriteFormat	string	Spécifie le format dans lequel les lignes d’erreur sont écrites (par exemple, CSV, Parquet).
isErrorRowRequired	boolean	Indique si les détails de la ligne d’erreur doivent être capturés.