Metadata Policy - Update

リファレンス

サービス:: Purview

API バージョン:: 2021-07-01-preview

メタデータポリシーを更新する

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

URI パラメーター

名前	/	必須	型	説明
Endpoint	path	True	string	Purview アカウントのエンドポイント。例: https://{accountName}.purview.azure.com。
policyId	path	True	string	一意のポリシー ID。
api-version	query	True	string	使用する API バージョン。

要求本文

名前	型	説明
id	string	ポリシーの ID
name	string	ポリシーの名前
properties	MetadataPolicyProperties
version	integer	ポリシーのバージョン

応答

名前	型	説明
200 OK	MetadataPolicy	Success
Other Status Codes	ErrorResponseModel	メタデータポリシーサービスから受信したエラー応答ヘッダー x-ms-error-code: string

名前

型

説明

200 OK

MetadataPolicy

Success

Other Status Codes

ErrorResponseModel

メタデータポリシーサービスから受信したエラー応答

ヘッダー

x-ms-error-code: string

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントの借用

例

MetadataPolicy_Update

要求のサンプル

HTTP

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

{
  "name": "policy_mycollection",
  "id": "98ed42ff-b67f-44df-8c8c-7e6b43e77055",
  "version": 1,
  "properties": {
    "description": "",
    "decisionRules": [
      {
        "effect": "Permit",
        "dnfCondition": [
          [
            {
              "attributeName": "resource.purview.collection",
              "attributeValueIncludes": "mycollection"
            },
            {
              "attributeName": "derived.purview.permission",
              "attributeValueIncludes": "permission:mycollection"
            }
          ]
        ]
      }
    ],
    "attributeRules": [
      {
        "id": "purviewmetadatarole_builtin_collection-administrator:mycollection",
        "name": "purviewmetadatarole_builtin_collection-administrator:mycollection",
        "dnfCondition": [
          [
            {
              "attributeName": "principal.microsoft.id",
              "attributeValueIncludedIn": [
                "69e520f2-5f26-4074-9fe1-5187d85ec005",
                "3f10f245-d5c4-4541-98ce-01a4580a30e0"
              ]
            },
            {
              "attributeName": "derived.purview.role",
              "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
            }
          ],
          [
            {
              "attributeName": "derived.purview.permission",
              "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:myparentcollection"
            }
          ]
        ]
      },
      {
        "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": {
      "referenceName": "mycollection"
    },
    "parentCollectionName": "myparentcollection"
  }
}

応答のサンプル

状態コード:: 200

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

{
  "name": "policy_mycollection",
  "id": "98ed42ff-b67f-44df-8c8c-7e6b43e77055",
  "version": 2,
  "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",
                "3f10f245-d5c4-4541-98ce-01a4580a30e0"
              ]
            },
            {
              "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"
  }
}

定義

名前	説明
AttributeMatcher	ルールの属性マッチャー
AttributeRule	ポリシーの属性ルール
CollectionReference	ポリシーのコレクション参照
Decision	ルールの効果
DecisionRule	ポリシーの決定ルール
ErrorModel	メタデータポリシーのエラーモデル
ErrorResponseModel	メタデータポリシーのエラー応答モデル
Kind	ルールの種類
MetadataPolicy
MetadataPolicyProperties

AttributeMatcher

ルールの属性マッチャー

名前	型	説明
attributeName	string	AttributeName
attributeValueExcludedIn	string[]	属性に対して除外される値の一覧
attributeValueExcludes	string	属性に対して除外される値
attributeValueIncludedIn	string[]	属性の値の一覧
attributeValueIncludes	string	属性の値

AttributeRule

ポリシーの属性ルール

名前	型	説明
dnfCondition	AttributeMatcher[]	ルールの dnf 条件
id	string	ルールの ID
kind	Kind	ルールの種類
name	string	ルールの名前

CollectionReference

ポリシーのコレクション参照

名前	型	規定値	説明
referenceName	string		参照の名前
type	string	CollectionReference	参照の種類

Decision

ルールの効果

名前	型	説明
Deny	string
Permit	string

DecisionRule

ポリシーの決定ルール

名前	型	説明
dnfCondition	AttributeMatcher[]	ルールの dnf 条件
effect	Decision	ルールの効果
kind	Kind	ルールの種類

ErrorModel

メタデータポリシーのエラーモデル

名前	型	説明
code	string	エラーコード
details	ErrorModel[]	エラーの詳細
message	string	エラーメッセージ
target	string	エラーターゲット

ErrorResponseModel

メタデータポリシーのエラー応答モデル

名前	型	説明
error	ErrorModel	メタデータポリシーのエラーモデル

Kind

ルールの種類

名前	型	説明
decisionrule	string

MetadataPolicy

名前	型	説明
id	string	ポリシーの ID
name	string	ポリシーの名前
properties	MetadataPolicyProperties
version	integer	ポリシーのバージョン

MetadataPolicyProperties

名前	型	説明
attributeRules	AttributeRule[]	ポリシーの AttributeRules
collection	CollectionReference	ポリシーのコレクション参照
decisionRules	DecisionRule[]	ポリシーの DecisionRules
description	string	ポリシーの説明
parentCollectionName	string	ポリシーの親コレクション

次の方法で共有

Metadata Policy - Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

MetadataPolicy_Update

要求のサンプル

応答のサンプル

定義

AttributeMatcher

AttributeRule

CollectionReference

Decision

DecisionRule

ErrorModel

ErrorResponseModel

Kind

MetadataPolicy

MetadataPolicyProperties

その他のリソース