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 매개 변수

Name	In(다음 안에)	필수	형식	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	데이터 제품과 연관되지 않은 자산의 경우, dataProductId에 Guid.Empty를 사용하세요. Optional.

응답

Name	형식	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

범위

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

정의

Name	Description
Azure.Core.Foundations.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

오류 개체입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
details	Azure.Core.Foundations.Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	Azure.Core.Foundations.InnerError	오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

Object

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	Azure.Core.Foundations.Error	오류 개체입니다.

Azure.Core.Foundations.InnerError

Object

오류에 대한 보다 구체적인 정보를 포함하는 개체입니다. Azure REST API 지침에 따라 - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합 중 하나입니다.
innererror	Azure.Core.Foundations.InnerError	내부 오류입니다.

Reference

Object

관계 구축을 위한 데이터 거버넌스 계층 내 엔터티에 대한 참조

Name	형식	Description
referenceId	string	참조된 엔터티의 고유 식별자
type	string	참조된 엔터티의 유형 분류

ScopedAssetMetadata

Object

특정 데이터 자산에 연결된 범위가 설정된 자산 메타데이터 구성.

Name	형식	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

스코프 자산 메타데이터 엔티티의 런타임 구성 옵션.

Name	형식	Description
errorRowWriteFormat	string	오류 행이 기록되는 형식을 지정합니다(예: CSV, Parquet).
isErrorRowRequired	boolean	오류 행 세부 정보를 캡처해야 하는지 여부를 나타냅니다.