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

服務:

Purview

API 版本:

2026-01-12-preview

取得企業領域內特定資料資產的範圍化資產元資料。 資料產品被指定為可選的查詢參數。

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

含選擇性參數:

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

URI 參數

名稱	位於	必要	類型	Description
businessDomainId	path	True	string	包含資料產品的商業網域唯一識別碼
dataAssetId	path	True	string	唯一識別碼，用於取回其範圍化元資料的資料資產
endpoint	path	True	string (uri)
api-version	query	True	string minLength: 1	用於此作業的 API 版本。
dataProductId	query		string	對於與任何資料產品無關聯的資產，請使用 guiid.Empty 作為 dataProductId。 選擇性。

回應

名稱	類型	Description
200 OK	ScopedAssetMetadata	要求已成功。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	未預期的錯誤回應。 標題 x-ms-error-code: string

安全性

OAuth2Auth

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
https://purview.azure.net/.default

範例

ScopedAssetMetaData_Get_V2

範例要求

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

範例回覆

狀態碼:

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

定義

名稱	Description
Azure.Core.Foundations.Error	error 物件。
Azure.Core.Foundations.ErrorResponse	包含錯誤詳細數據的回應。
Azure.Core.Foundations.InnerError	物件，包含有關錯誤的更特定資訊。 根據 Azure REST API 指引 - https://aka.ms/AzureRestApiGuidelines#handling-errors。
Reference	在建立關係時，參考資料治理階層中的實體
ScopedAssetMetadata	有範圍的資產元資料配置，連結到特定的資料資產。
ScopedAssetMetadataRuntime	針對有範圍的資產元資料實體的執行時設定選項。

Azure.Core.Foundations.Error

Object

error 物件。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
details	Azure.Core.Foundations.Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innererror	Azure.Core.Foundations.InnerError	物件，包含與目前對象有關錯誤更具體的資訊。
message	string	錯誤的人類可讀取表示法。
target	string	錯誤的目標。

Azure.Core.Foundations.ErrorResponse

Object

包含錯誤詳細數據的回應。

名稱	類型	Description
error	Azure.Core.Foundations.Error	error 物件。

Azure.Core.Foundations.InnerError

Object

物件，包含有關錯誤的更特定資訊。 根據 Azure REST API 指引 - https://aka.ms/AzureRestApiGuidelines#handling-errors。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
innererror	Azure.Core.Foundations.InnerError	內部錯誤。

Reference

Object

在建立關係時，參考資料治理階層中的實體

名稱	類型	Description
referenceId	string	被參考實體的唯一識別碼
type	string	所參考實體的類型分類

ScopedAssetMetadata

Object

有範圍的資產元資料配置，連結到特定的資料資產。

名稱	類型	Description
ETag	string	實體標籤用於並行控制與版本驗證。
businessDomain	Reference	相關商業領域。
createdAt	string (date-time)	這個元資料建立的時間戳記。
createdBy	string	建立此元資料的使用者識別碼。
dataAsset	Reference	參考相關的資料資產。
dataProduct	Reference	參考相關資料產品。
description	string	描述性文字，提供有關範圍資產元資料的詳細資訊。
favouriteColumnPaths	string[]	列出為快速存取或監控所選的熱門欄位路徑。
id	string	針對範圍化資產元資料實體的唯一識別碼。
lastModifiedAt	string (date-time)	這個元資料最後修改的時間戳記。
lastModifiedBy	string	最後修改此元資料的使用者識別碼。
runtime	ScopedAssetMetadataRuntime	執行時設定參數，定義錯誤列行為與輸出格式。

ScopedAssetMetadataRuntime

Object

針對有範圍的資產元資料實體的執行時設定選項。

名稱	類型	Description
errorRowWriteFormat	string	指定錯誤列的格式（例如 CSV、Parquet）。
isErrorRowRequired	boolean	指示是否應擷取錯誤列細節。