Metadata Policy - Get

Service:

Purview

API Version:

2021-07-01-preview

Obtient une stratégie de métadonnées

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Point de terminaison de votre compte Purview. Exemple : https://{accountName}.purview.azure.com.
policyId	path	True	string	ID d’une stratégie existante qui doit être extraite.
api-version	query	True	string	Version de l’API à utiliser.

Réponses

Nom	Type	Description
200 OK	MetadataPolicy	Succès
Other Status Codes	ErrorResponseModel	Réponse d’erreur reçue du service de stratégie de métadonnées Headers x-ms-error-code: string

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

MetadataPolicy_Get

Sample Request

HTTP

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

Sample Response

Status code:

200

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

Response Body

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

Définitions

Nom	Description
AttributeMatcher	Matcher d’attribut pour une règle
AttributeRule	Règle d’attribut pour une stratégie
CollectionReference	Référence de collection pour une stratégie
Decision	Effet pour la règle
DecisionRule	Règle de décision pour une stratégie
ErrorModel	Modèle d’erreur pour la stratégie de métadonnées
ErrorResponseModel	Modèle de réponse aux erreurs pour la stratégie de métadonnées
Kind	Type de règle
MetadataPolicy
MetadataPolicyProperties

AttributeMatcher

Matcher d’attribut pour une règle

Nom	Type	Description
attributeName	string	AttributeName
attributeValueExcludedIn	string[]	Liste des valeurs exclues pour l’attribut
attributeValueExcludes	string	Valeur exclue pour l’attribut
attributeValueIncludedIn	string[]	Liste des valeurs de l’attribut
attributeValueIncludes	string	Valeur de l’attribut

AttributeRule

Règle d’attribut pour une stratégie

Nom	Type	Description
dnfCondition	AttributeMatcher[]	Condition dnf pour une règle
id	string	ID de règle
kind	Kind	Type de règle
name	string	Nom de la règle

CollectionReference

Référence de collection pour une stratégie

Nom	Type	Valeur par défaut	Description
referenceName	string		Nom de référence
type	string	CollectionReference	Type de référence

Decision

Effet pour la règle

Nom	Type	Description
Deny	string
Permit	string

DecisionRule

Règle de décision pour une stratégie

Nom	Type	Description
dnfCondition	AttributeMatcher[]	Condition dnf pour une règle
effect	Decision	Effet pour la règle
kind	Kind	Type de règle

ErrorModel

Modèle d’erreur pour la stratégie de métadonnées

Nom	Type	Description
code	string	Le code d'erreur
details	ErrorModel[]	Détails de l’erreur
message	string	Message d'erreur.
target	string	Cible d’erreur

ErrorResponseModel

Modèle de réponse aux erreurs pour la stratégie de métadonnées

Nom	Type	Description
error	ErrorModel	Modèle d’erreur pour la stratégie de métadonnées

Kind

Type de règle

Nom	Type	Description
decisionrule	string

MetadataPolicy

Nom	Type	Description
id	string	ID de stratégie
name	string	Nom de la stratégie
properties	MetadataPolicyProperties
version	integer	Version de la stratégie

MetadataPolicyProperties

Nom	Type	Description
attributeRules	AttributeRule[]	AttributeRules de la stratégie
collection	CollectionReference	Référence de collection pour une stratégie
decisionRules	DecisionRule[]	DecisionRules de la stratégie
description	string	Description de la stratégie
parentCollectionName	string	Collection parente de la stratégie