Metadata Policy - Get

Servicio:

Purview

Versión de la API:

2021-07-01-preview

Obtiene una directiva de metadatos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Punto de conexión de la cuenta de Purview. Ejemplo: https://{accountName}.purview.azure.com.
policyId	path	True	string	Identificador de una directiva existente que debe capturarse.
api-version	query	True	string	La versión de api que se va a usar.

Respuestas

Nombre	Tipo	Description
200 OK	MetadataPolicy	Correcto
Other Status Codes	ErrorResponseModel	Una respuesta de error recibida del servicio de directivas de metadatos Encabezados x-ms-error-code: string

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

MetadataPolicy_Get

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

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

Definiciones

Nombre	Description
AttributeMatcher	Buscador de coincidencias de atributos para una regla
AttributeRule	Regla de atributo para una directiva
CollectionReference	Referencia de colección para una directiva
Decision	El efecto de la regla
DecisionRule	Regla de decisión de una directiva
ErrorModel	Modelo de error para la directiva de metadatos
ErrorResponseModel	Modelo de respuesta de error para la directiva de metadatos
Kind	El tipo de regla
MetadataPolicy
MetadataPolicyProperties

AttributeMatcher

Buscador de coincidencias de atributos para una regla

Nombre	Tipo	Description
attributeName	string	AttributeName
attributeValueExcludedIn	string[]	Lista de valores excluidos para el atributo
attributeValueExcludes	string	Valor excluido para el atributo
attributeValueIncludedIn	string[]	Lista de valores para el atributo
attributeValueIncludes	string	Valor del atributo

AttributeRule

Regla de atributo para una directiva

Nombre	Tipo	Description
dnfCondition	AttributeMatcher[]	Condición dnf para una regla
id	string	El identificador de la regla
kind	Kind	El tipo de regla
name	string	El nombre de la regla

CollectionReference

Referencia de colección para una directiva

Nombre	Tipo	Valor predeterminado	Description
referenceName	string		Nombre de referencia
type	string	CollectionReference	Tipo de referencia

Decision

El efecto de la regla

Nombre	Tipo	Description
Deny	string
Permit	string

DecisionRule

Regla de decisión de una directiva

Nombre	Tipo	Description
dnfCondition	AttributeMatcher[]	Condición dnf para una regla
effect	Decision	El efecto de la regla
kind	Kind	El tipo de regla

ErrorModel

Modelo de error para la directiva de metadatos

Nombre	Tipo	Description
code	string	Código de error.
details	ErrorModel[]	Detalles del error
message	string	El mensaje de error.
target	string	Destino del error

ErrorResponseModel

Modelo de respuesta de error para la directiva de metadatos

Nombre	Tipo	Description
error	ErrorModel	Modelo de error para la directiva de metadatos

Kind

El tipo de regla

Nombre	Tipo	Description
decisionrule	string

MetadataPolicy

Nombre	Tipo	Description
id	string	El identificador de la directiva
name	string	Nombre de la directiva
properties	MetadataPolicyProperties
version	integer	La versión de la directiva

MetadataPolicyProperties

Nombre	Tipo	Description
attributeRules	AttributeRule[]	AttributeRules de la directiva
collection	CollectionReference	Referencia de colección para una directiva
decisionRules	DecisionRule[]	DecisionRules de la directiva
description	string	Descripción de la directiva
parentCollectionName	string	Colección primaria de la directiva