Metadata Policy - Get

서비스:

Purview

API 버전:

2021-07-01-preview

메타데이터 정책을 가져옵니다.

GET {Endpoint}/policyStore/metadataPolicies/{policyId}?api-version=2021-07-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Endpoint	path	True	string	Purview 계정의 엔드포인트입니다. 예: https://{accountName}.purview.azure.com.
policyId	path	True	string	페치해야 하는 기존 정책의 ID입니다.
api-version	query	True	string	사용할 api 버전입니다.

응답

Name	형식	Description
200 OK	MetadataPolicy	Success
Other Status Codes	ErrorResponseModel	메타데이터 정책 서비스에서 받은 오류 응답 헤더 x-ms-error-code: string

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

MetadataPolicy_Get

샘플 요청

HTTP

GET {Endpoint}/policyStore/metadataPolicies/98ed42ff-b67f-44df-8c8c-7e6b43e77055?api-version=2021-07-01-preview

샘플 응답

상태 코드:

200

x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea889

{
  "name": "policy_mycollection",
  "id": "98ed42ff-b67f-44df-8c8c-7e6b43e77055",
  "version": 1,
  "properties": {
    "description": "",
    "decisionRules": [
      {
        "kind": "decisionrule",
        "effect": "Permit",
        "dnfCondition": [
          [
            {
              "attributeName": "resource.purview.collection",
              "attributeValueIncludes": "mycollection"
            },
            {
              "attributeName": "derived.purview.permission",
              "attributeValueIncludes": "permission:mycollection"
            }
          ]
        ]
      }
    ],
    "attributeRules": [
      {
        "kind": "attributerule",
        "id": "purviewmetadatarole_builtin_collection-administrator:mycollection",
        "name": "purviewmetadatarole_builtin_collection-administrator:mycollection",
        "dnfCondition": [
          [
            {
              "attributeName": "principal.microsoft.id",
              "attributeValueIncludedIn": [
                "69e520f2-5f26-4074-9fe1-5187d85ec005"
              ]
            },
            {
              "attributeName": "derived.purview.role",
              "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
            }
          ],
          [
            {
              "attributeName": "derived.purview.permission",
              "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:myparentcollection"
            }
          ]
        ]
      },
      {
        "kind": "attributerule",
        "id": "permission:mycollection",
        "name": "permission:mycollection",
        "dnfCondition": [
          [
            {
              "attributeName": "derived.purview.permission",
              "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:mycollection"
            }
          ],
          [
            {
              "attributeName": "derived.purview.permission",
              "attributeValueIncludes": "permission:myparentcollection"
            }
          ]
        ]
      }
    ],
    "collection": {
      "type": "CollectionReference",
      "referenceName": "mycollection"
    },
    "parentCollectionName": "myparentcollection"
  }
}

정의

Name	Description
AttributeMatcher	규칙에 대한 특성 일치자
AttributeRule	정책에 대한 특성 규칙
CollectionReference	정책에 대한 컬렉션 참조
Decision	규칙에 대한 효과
DecisionRule	정책에 대한 의사 결정 규칙
ErrorModel	메타데이터 정책에 대한 오류 모델
ErrorResponseModel	메타데이터 정책에 대한 오류 응답 모델
Kind	규칙의 종류
MetadataPolicy
MetadataPolicyProperties

AttributeMatcher

규칙에 대한 특성 일치자

Name	형식	Description
attributeName	string	AttributeName
attributeValueExcludedIn	string[]	특성에 대해 제외된 값 목록
attributeValueExcludes	string	특성에 대해 제외된 값
attributeValueIncludedIn	string[]	특성 값 목록
attributeValueIncludes	string	특성 값

AttributeRule

정책에 대한 특성 규칙

Name	형식	Description
dnfCondition	AttributeMatcher[]	규칙에 대한 dnf 조건
id	string	규칙의 ID
kind	Kind	규칙의 종류
name	string	규칙의 이름

CollectionReference

정책에 대한 컬렉션 참조

Name	형식	Default value	Description
referenceName	string		참조 이름
type	string	CollectionReference	참조 유형

Decision

규칙에 대한 효과

Name	형식	Description
Deny	string
Permit	string

DecisionRule

정책에 대한 의사 결정 규칙

Name	형식	Description
dnfCondition	AttributeMatcher[]	규칙에 대한 dnf 조건
effect	Decision	규칙에 대한 효과
kind	Kind	규칙의 종류

ErrorModel

메타데이터 정책에 대한 오류 모델

Name	형식	Description
code	string	오류 코드
details	ErrorModel[]	오류 세부 정보
message	string	오류 메시지입니다.
target	string	오류 대상

ErrorResponseModel

메타데이터 정책에 대한 오류 응답 모델

Name	형식	Description
error	ErrorModel	메타데이터 정책에 대한 오류 모델

Kind

규칙의 종류

Name	형식	Description
decisionrule	string

MetadataPolicy

Name	형식	Description
id	string	정책 ID
name	string	정책 이름
properties	MetadataPolicyProperties
version	integer	정책 버전

MetadataPolicyProperties

Name	형식	Description
attributeRules	AttributeRule[]	정책의 AttributeRules
collection	CollectionReference	정책에 대한 컬렉션 참조
decisionRules	DecisionRule[]	정책의 DecisionRules
description	string	정책에 대한 설명
parentCollectionName	string	정책의 부모 컬렉션