Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Nota:
El Catálogo de datos de Microsoft Purview (clásico), Data Health Insights (clásico) y el flujo de trabajo de Purview (clásico) ya no aceptan nuevos clientes y estos servicios, antes Azure Purview, ahora están en modo de soporte técnico al cliente.
En agosto de 2021, el control de acceso en Microsoft Purview pasó de Azure Identity & Access Management (IAM) (plano de control) a colecciones de Microsoft Purview (plano de datos). Este cambio proporciona a los conservadores y administradores de datos empresariales un control de acceso más preciso y granular sobre sus orígenes de datos examinados por Microsoft Purview. El cambio también permite a las organizaciones auditar el acceso y el uso correctos de sus datos.
Este tutorial le guiará paso a paso por el uso de las API de directiva de metadatos de Microsoft Purview para ayudarle a agregar usuarios, grupos o entidades de servicio a una colección, y administrar o quitar sus roles dentro de esa colección. Las API de REST son un método alternativo al uso del portal de gobierno de Azure Portal o Microsoft Purview para lograr el mismo control de acceso granular basado en roles.
Para obtener más información sobre los roles integrados en Microsoft Purview, consulta la guía de permisos de Microsoft Purview. La guía asigna los roles al nivel de permisos de acceso que se conceden a los usuarios.
Resumen de referencia de la API de directiva de metadatos
En la tabla siguiente se proporciona información general sobre la referencia de la API de directiva de metadatos de Microsoft Purview.
Nota:
Reemplace {pv-acc-name} por el nombre de su cuenta de Microsoft Purview antes de ejecutar estas API. Por ejemplo, si el nombre de la cuenta de Microsoft Purview es FabrikamPurviewAccount, los puntos de conexión de API se convertirán en FabrikamPurviewAccount.purview.azure.com. El parámetro "api-version" está sujeto a cambios. Consulte la documentación de la API de REST de la directiva de metadatos de Microsoft Purview para obtener la "versión de API" y la firma de la API más recientes.
| Función API | Método REST | Punto de conexión de API | Description |
|---|---|---|---|
| Leer todos los roles de metadatos | GET | https://{pv-acc-name}.purview.azure.com /policystore/metadataroles?&api-version=2021-07-01 | Lee todos los roles de metadatos de su cuenta de Microsoft Purview. |
| Directiva de metadatos de lectura por nombre de colección | GET | https://{pv-acc-name}.purview.azure.com /policystore/collections/{collectionName}/metadataPolicy?&api-version=2021-07-01 | Lee la directiva de metadatos mediante un nombre de colección especificado (el nombre aleatorio de seis caracteres que genera Microsoft Purview cuando crea la directiva). |
| Leer directiva de metadatos por PolicyID | GET | https://{pv-acc-name}.purview.azure.com /policystore/metadataPolicies/{policyId}?&api-version=2021-07-01 | Lee la directiva de metadatos mediante un identificador de directiva especificado. El identificador de directiva tiene el formato GUID. |
| Leer todas las directivas de metadatos | GET | https://{pv-acc-name}.purview.azure.com /policystore/metadataPolicies?&api-version=2021-07-01 | Lee todas las directivas de metadatos de la cuenta de Microsoft Purview. Puede elegir una directiva determinada con la que trabajar en la lista de salida JSON generada por esta API. |
| Directiva de metadatos PUT o de actualización | PUT | https://{pv-acc-name}.purview.azure.com /policystore/metadataPolicies/{policyId}?&api-version=2021-07-01 | Actualiza las novedades de la directiva de metadatos mediante un identificador de directiva especificado. El identificador de directiva tiene el formato GUID. |
Resumen de referencia de la API de colecciones de catálogos de Microsoft Purview
En la tabla siguiente se proporciona información general sobre las API de colecciones de Microsoft Purview. Para obtener documentación completa sobre cada API, seleccione la operación de la API en la columna izquierda.
| Operación | Descripción |
|---|---|
| Crear o actualizar colección | Crea o actualiza una entidad de colección. |
| Eliminar colección | Elimina una entidad de colección. |
| Obtener colección | Obtiene una colección. |
| Obtener ruta de acceso de colección | Obtiene las cadenas de nombres primarios y de nombres para mostrar que representan la ruta de acceso de la colección. |
| Enumerar nombres de colecciones secundarias | Enumera los nombres de las colecciones secundarias de la colección. |
| Enumerar colecciones | Enumera las colecciones de la cuenta. |
Si usa la API, la entidad de servicio, el usuario o el grupo que ejecuta la API debe tener asignado un rol de Administración de colección en Microsoft Purview para ejecutar esta API correctamente.
Para todas las API de Microsoft Purview que requieran {collectionName}, deberá usar "name" (y no "friendlyName"). Reemplace {collectionName} por la cadena de nombre de colección alfanumérica de seis caracteres real.
Nota:
Este nombre es diferente del nombre para mostrar descriptivo que proporcionó al crear la colección. Si no tiene {collectionName} a mano, use la API List Collections para seleccionar el nombre de colección de seis caracteres de la salida JSON.
Este es un archivo JSON de ejemplo:
{
"name": "74dhe7",
"friendlyName": "Friendly Name",
"parentCollection": {
"type": "CollectionReference",
"referenceName": "{your_purview_account_name}"
},
"systemData": {
"createdBy": "{guid}",
"createdByType": "Application",
"createdAt": "2021-08-26T21:21:51.2646627Z",
"lastModifiedBy": "7f8d47e2-330c-42f0-8744-fcfb1ecb3ea0",
"lastModifiedByType": "Application",
"lastModifiedAt": "2021-08-26T21:21:51.2646628Z"
},
"collectionProvisioningState": "Succeeded"
}
Descripción de JSON de directiva
Estos son algunos de los identificadores importantes en la salida JSON que se recibe de las API de colección:
Nombre: el nombre de la directiva.
Id.: identificador único de la directiva.
Versión: el número de versión más reciente de la directiva.
Importante
El número de versión se incrementa cada vez que se llama a la API Update-Metadata-Policy. Asegúrese de capturar la copia más reciente de la directiva invocando la API Get-Policy-by-Policy-ID. Realice esta actualización cada vez que llame a la API de directiva de actualización (PUT), para que siempre tenga la última versión del archivo JSON.
DecisionRules: enumere las reglas y el efecto de esta directiva. Para las directivas de metadatos, el efecto siempre es "Permitir".
Agregar o quitar usuarios de una colección o rol
Use las API de REST de Microsoft Purview para agregar o quitar un usuario, grupo o entidad de servicio de una colección o rol. Se proporciona el uso detallado de la API junto con salidas JSON de ejemplo. Se recomienda encarecidamente seguir las instrucciones de las secciones siguientes secuencialmente para comprender mejor las API de la directiva de metadatos de Microsoft Purview.
Obtener todos los roles de metadatos
Para obtener una lista de todos los roles de permisos de acceso a metadatos disponibles, ejecute uno de los siguientes comandos, en función del portal que use:
Portal de gobierno clásico de Microsoft Purview:
GET https://{your_purview_account_name}.purview.azure.com/policystore/metadataroles?api-version=2021-07-01
Nuevo portal de Microsoft Purview:
GET https://api.purview-service.microsoft.com/policystore/metadataroles?api-version=2021-07-01
El JSON de salida describirá los roles y sus permisos asociados en este formato.
En la tabla siguiente se enumeran los roles de metadatos predeterminados:
| Id. de rol | Permissions | Descripción de tabla |
|---|---|---|
| purviewmetadatarole_builtin_data-source-administrator | Microsoft.Purview/accounts/scan/read Microsoft.Purview/accounts/scan/write Microsoft.Purview/accounts/collection/read | Concede acceso a otros usuarios para leer, escribir recopilación, registrar orígenes de datos y desencadenar exámenes. |
| purviewmetadatarole_builtin_collection administrador | Microsoft.Purview/accounts/collection/read Microsoft.Purview/accounts/collection/write | Acceso completo a nivel de administrador a toda la colección, incluida la opción de agregar o quitar usuarios y nombres de entidad de seguridad de servicio (SPN) de la colección, derechos de administración y conceder o revocar acceso. En algunos casos, el administrador de la colección puede ser diferente del creador de la colección. |
| purviewmetadatarole_builtin_purview-lector | Microsoft.Purview/accounts/data/read Microsoft.Purview/accounts/collection/read | Concede solo acceso de lectura al control de datos y a todos los metadatos, incluidas las clasificaciones, las etiquetas de confidencialidad, la información y los activos de lectura de una colección, excepto los enlaces de análisis. |
| purviewmetadatarole_builtin_data-curador | Microsoft.Purview/accounts/data/read Microsoft.Purview/accounts/data/write Microsoft.Purview/accounts/collection/read | Concede acceso completo al control de datos y a todos los metadatos, incluidas las clasificaciones, las etiquetas de confidencialidad, la información y los activos de lectura de una colección, excepto los enlaces de análisis. |
| purviewmetadatarole_builtin_data-share-contributor | Microsoft.Purview/accounts/share/read Microsoft.Purview/accounts/share/write | Concede acceso a recursos compartidos de datos como colaborador. |
{
"values": [
{
"id": "purviewmetadatarole_builtin_data-curator",
"name": "data-curator",
"type": "Microsoft.Purview/role",
"properties": {
"provisioningState": "Provisioned",
"roleType": "BuiltIn",
"friendlyName": "Data Curator",
"cnfCondition": [
[
{
"attributeName": "request.azure.dataAction",
"attributeValueIncludedIn": [
"Microsoft.Purview/accounts/data/read",
"Microsoft.Purview/accounts/data/write",
"Microsoft.Purview/accounts/collection/read"
]
}
]
],
"version": 1
}
},
{
"id": "purviewmetadatarole_builtin_data-source-administrator",
"name": "data-source-administrator",
"type": "Microsoft.Purview/role",
"properties": {
"provisioningState": "Provisioned",
"roleType": "BuiltIn",
"friendlyName": "Data Source Administrator",
"cnfCondition": [
[
{
"attributeName": "request.azure.dataAction",
"attributeValueIncludedIn": [
"Microsoft.Purview/accounts/scan/read",
"Microsoft.Purview/accounts/scan/write",
"Microsoft.Purview/accounts/collection/read"
]
}
]
],
"version": 1
}
},
{
"id": "purviewmetadatarole_builtin_collection-administrator",
"name": "collection-administrator",
"type": "Microsoft.Purview/role",
"properties": {
"provisioningState": "Provisioned",
"roleType": "BuiltIn",
"friendlyName": "Collection Administrator",
"cnfCondition": [
[
{
"attributeName": "request.azure.dataAction",
"attributeValueIncludedIn": [
"Microsoft.Purview/accounts/collection/read",
"Microsoft.Purview/accounts/collection/write"
]
}
]
],
"version": 1
}
},
{
"id": "purviewmetadatarole_builtin_purview-reader",
"name": "purview-reader",
"type": "Microsoft.Purview/role",
"properties": {
"provisioningState": "Provisioned",
"roleType": "BuiltIn",
"friendlyName": "Microsoft Purview Reader",
"cnfCondition": [
[
{
"attributeName": "request.azure.dataAction",
"attributeValueIncludedIn": [
"Microsoft.Purview/accounts/data/read",
"Microsoft.Purview/accounts/collection/read"
]
}
]
],
"version": 1
}
},
{
"id": "purviewmetadatarole_builtin_data-share-contributor",
"name": "data-share-contributor",
"type": "Microsoft.Purview/role",
"properties": {
"provisioningState": "Provisioned",
"roleType": "BuiltIn",
"friendlyName": "Data share contributor",
"cnfCondition": [
[
{
"attributeName": "request.azure.dataAction",
"attributeValueIncludedIn": [
"Microsoft.Purview/accounts/share/read",
"Microsoft.Purview/accounts/share/write"
]
}
]
],
"version": 1
}
}
]
}
Obtener todas las directivas de metadatos
Portal de gobierno clásico de Microsoft Purview:
GET https://{your_purview_account_name}.purview.azure.com/policystore/metadataPolicies?api-version=2021-07-01
Nuevo portal de Microsoft Purview:
GET https://api.purview-service.microsoft.com/policystore/metadataPolicies?api-version=2021-07-01
El comando anterior enumera todas las directivas de metadatos disponibles en toda la jerarquía de colecciones en formato de árbol, desde la colección raíz en la parte superior hasta todas sus directivas secundarias. Cada colección infantil contiene a cada uno de sus hijos del siguiente nivel.
Ejemplo:
{
"values": [
{
"name": "policy_FabrikamPurview",
"id": "9b2f1cb9-584c-4a16-811e-9232884b5cac",
"version": 30,
"properties": {
"description": "",
"decisionRules": [
{
"kind": "decisionrule",
"effect": "Permit",
"dnfCondition": [
[
{
"attributeName": "resource.purview.collection",
"attributeValueIncludes": "fabrikampurview"
},
{
"fromRule": "permission:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:fabrikampurview"
}
]
]
}
],
"attributeRules": [
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview",
"name": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0",
"04314867-60a4-4e5a-ae16-8e5856f415d9",
"8988fe5c-5736-4179-9435-0a64c273b90b",
"6d563253-1d5b-48f2-baaa-5489f22ddce9",
"26f98046-5b02-4fa9-b709-e0519c658891",
"73fc02dc-becd-468b-a2a3-82238e722dae"
]
},
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
},
{
"attributeName": "principal.microsoft.groups",
"attributeValueIncludedIn": [
"ffd851fa-86ec-431b-95ea-8b84d5012383",
"cf84b126-4384-4952-91f1-7f705b25e569",
"5046aba1-5b81-411c-8fec-b84600f3f08b",
"b055a5c6-a04e-4d1a-8524-001ad81bfb28",
"cc194892-92fa-4ce3-96ae-1f98bef8211c"
]
}
]
]
},
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_data-curator:fabrikampurview",
"name": "purviewmetadatarole_builtin_data-curator:fabrikampurview",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0",
"649f56ab-2dd2-40de-a731-3d3f28e7af92",
"c29a5809-f9ec-49fd-b762-2d4d64abb93e",
"04314867-60a4-4e5a-ae16-8e5856f415d9",
"73fc02dc-becd-468b-a2a3-82238e722dae",
"517a27d2-39ba-4c91-a032-dd9ecf8ad6f1",
"6d563253-1d5b-48f2-baaa-5489f22ddce9"
]
},
{
"fromRule": "purviewmetadatarole_builtin_data-curator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_data-curator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_data-curator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_data-curator"
},
{
"attributeName": "principal.microsoft.groups",
"attributeValueIncludedIn": [
"b055a5c6-a04e-4d1a-8524-001ad81bfb28",
"cc194892-92fa-4ce3-96ae-1f98bef8211c",
"5046aba1-5b81-411c-8fec-b84600f3f08b"
]
}
]
]
},
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_data-source-administrator:fabrikampurview",
"name": "purviewmetadatarole_builtin_data-source-administrator:fabrikampurview",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0",
"04314867-60a4-4e5a-ae16-8e5856f415d9",
"517a27d2-39ba-4c91-a032-dd9ecf8ad6f1",
"6d563253-1d5b-48f2-baaa-5489f22ddce9"
]
},
{
"fromRule": "purviewmetadatarole_builtin_data-source-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_data-source-administrator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_data-source-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_data-source-administrator"
},
{
"attributeName": "principal.microsoft.groups",
"attributeValueIncludedIn": [
"b055a5c6-a04e-4d1a-8524-001ad81bfb28",
"cc194892-92fa-4ce3-96ae-1f98bef8211c",
"d34eb741-be5e-4098-90d7-eca8d4a5153f",
"664ec992-9af0-4773-88f2-dc39edc46f6f",
"5046aba1-5b81-411c-8fec-b84600f3f08b"
]
}
]
]
},
{
"kind": "attributerule",
"id": "permission:fabrikampurview",
"name": "permission:fabrikampurview",
"dnfCondition": [
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_purview-reader:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_purview-reader:fabrikampurview"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_data-curator:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_data-curator:fabrikampurview"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_data-source-administrator:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_data-source-administrator:fabrikampurview"
}
]
]
}
],
"collection": {
"type": "CollectionReference",
"referenceName": "fabrikampurview"
}
}
},
{
"name": "policy_b2zpf1",
"id": "12b0bb28-2acc-413e-8fe1-179ff9cc54c3",
"version": 0,
"properties": {
"description": "",
"decisionRules": [
{
"kind": "decisionrule",
"effect": "Permit",
"dnfCondition": [
[
{
"attributeName": "resource.purview.collection",
"attributeValueIncludes": "b2zpf1"
},
{
"fromRule": "permission:b2zpf1",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:b2zpf1"
}
]
]
}
],
"attributeRules": [
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_collection-administrator:b2zpf1",
"name": "purviewmetadatarole_builtin_collection-administrator:b2zpf1",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0"
]
},
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:ukx7pq",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:ukx7pq"
}
]
]
},
{
"kind": "attributerule",
"id": "permission:b2zpf1",
"name": "permission:b2zpf1",
"dnfCondition": [
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:b2zpf1",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:b2zpf1"
}
],
[
{
"fromRule": "permission:ukx7pq",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:ukx7pq"
}
]
]
}
],
"collection": {
"type": "CollectionReference",
"referenceName": "b2zpf1"
},
"parentCollectionName": "ukx7pq"
}
},
{
"name": "policy_7wte2n",
"id": "a72084e4-ccab-4aec-a364-08ab001e4999",
"version": 0,
"properties": {
"description": "",
"decisionRules": [
{
"kind": "decisionrule",
"effect": "Permit",
"dnfCondition": [
[
{
"attributeName": "resource.purview.collection",
"attributeValueIncludes": "7wte2n"
},
{
"fromRule": "permission:7wte2n",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:7wte2n"
}
]
]
}
],
"attributeRules": [
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_collection-administrator:7wte2n",
"name": "purviewmetadatarole_builtin_collection-administrator:7wte2n",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0"
]
},
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:ukx7pq",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:ukx7pq"
}
]
]
},
{
"kind": "attributerule",
"id": "permission:7wte2n",
"name": "permission:7wte2n",
"dnfCondition": [
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:7wte2n",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:7wte2n"
}
],
[
{
"fromRule": "permission:ukx7pq",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:ukx7pq"
}
]
]
}
],
"collection": {
"type": "CollectionReference",
"referenceName": "7wte2n"
},
"parentCollectionName": "ukx7pq"
}
}
]
}
Obtener la directiva de metadatos seleccionada
Puede usar cualquiera de las dos API para capturar la estructura JSON de la directiva de metadatos de una colección determinada proporcionando {collectionName} o {PolicyID}.
Como se describe en las dos secciones siguientes, ambas API sirven para el mismo propósito y las salidas de JSON de ambas son exactamente las mismas.
Obtenga la directiva de metadatos de la colección mediante el nombre de la colección
Portal de gobierno clásico de Microsoft Purview:
GET https://{your_purview_account_name}.purview.azure.com/policystore/collections/{collectionName}/metadataPolicy?api-version=2021-07-01
Nuevo portal de Microsoft Purview:
GET https://api.purview-service.microsoft.com/policystore/collections/{collectionName}/metadataPolicy?api-version=2021-07-01
El nombre de la cuenta de Microsoft Purview es {your_purview_account_name}. Reemplázala por el nombre de tu cuenta de Microsoft Purview.
En la salida JSON de la API anterior, "Obtener todas las directivas de metadatos", busque la siguiente sección:
{ "type": "CollectionReference", "referenceName": "7xkdg2"}
Reemplace "{collectionName}" en la dirección URL de la API por el valor de "referenceName": "{6-char-collection-name}". Por ejemplo, si el nombre de la colección de seis caracteres es "7xkdg2", la dirección URL de la API tendrá el siguiente formato:
https://{your_purview_account_name}.purview.azure.com/policystore/collections/7xkdg2/metadataPolicy?api-version=2021-07-01Ejecute la siguiente API:
{ "name": "policy_qu45fs", "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "version": 0, "properties": { "description": "", "decisionRules": [ { "kind": "decisionrule", "effect": "Permit", "dnfCondition": [ [ { "attributeName": "resource.purview.collection", "attributeValueIncludes": "qu45fs" }, { "fromRule": "permission:qu45fs", "attributeName": "derived.purview.permission", "attributeValueIncludes": "permission:qu45fs" } ] ] } ], "attributeRules": [ { "kind": "attributerule", "id": "purviewmetadatarole_builtin_collection-administrator:qu45fs", "name": "purviewmetadatarole_builtin_collection-administrator:qu45fs", "dnfCondition": [ [ { "attributeName": "principal.microsoft.id", "attributeValueIncludedIn": [ "2f656762-e440-4b62-9eb6-a991d17d64b0" ] }, { "fromRule": "purviewmetadatarole_builtin_collection-administrator", "attributeName": "derived.purview.role", "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator" } ], [ { "fromRule": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview", "attributeName": "derived.purview.permission", "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview" } ] ] }, { "kind": "attributerule", "id": "permission:qu45fs", "name": "permission:qu45fs", "dnfCondition": [ [ { "fromRule": "purviewmetadatarole_builtin_collection-administrator:qu45fs", "attributeName": "derived.purview.permission", "attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:qu45fs" } ], [ { "fromRule": "permission:fabrikampurview", "attributeName": "derived.purview.permission", "attributeValueIncludes": "permission:fabrikampurview" } ] ] } ], "collection": { "type": "CollectionReference", "referenceName": "qu45fs" }, "parentCollectionName": "fabrikampurview" } }
Obtenga la directiva de metadatos de la colección mediante el identificador de directiva
Portal de gobierno clásico de Microsoft Purview:
GET https://{your_purview_account_name}.purview.azure.com/policystore/metadataPolicies/{policyId}?api-version=2021-07-01
Nuevo portal de Microsoft Purview:
GET https://api.purview-service.microsoft.com/policystore/metadataPolicies/{policyId}?api-version=2021-07-01
El nombre de la cuenta de Microsoft Purview es {your_purview_account_name}. Reemplázala por el nombre de tu cuenta de Microsoft Purview.
En la salida JSON de la API anterior, "Obtener todas las directivas de metadatos", busque la siguiente sección:
{.... "name": "policy_qu45fs", "id": "{policy-guid}", "version": N ....}
Reemplace "{policyId}" en la dirección URL de API por el valor de "id". Por ejemplo, si su "{policy-guid}" es "aaaabbbb-0000-cccc-1111-dddd2222eeee", la dirección URL de la API tendrá el siguiente formato:
https://{your_purview_account_name}.purview.azure.com/policystore/metadataPolicies/aaaabbbb-0000-cccc-1111-dddd2222eeee?api-version=2021-07-01
Ahora ejecute la siguiente API:
Nota:
El resultado de esta llamada a la API y la anterior es el mismo. Como se mencionó anteriormente, puede elegir cualquiera de los dos.
{
"name": "policy_qu45fs",
"id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"version": 0,
"properties": {
"description": "",
"decisionRules": [
{
"kind": "decisionrule",
"effect": "Permit",
"dnfCondition": [
[
{
"attributeName": "resource.purview.collection",
"attributeValueIncludes": "qu45fs"
},
{
"fromRule": "permission:qu45fs",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:qu45fs"
}
]
]
}
],
"attributeRules": [
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_collection-administrator:qu45fs",
"name": "purviewmetadatarole_builtin_collection-administrator:qu45fs",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0"
]
},
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview"
}
]
]
},
{
"kind": "attributerule",
"id": "permission:qu45fs",
"name": "permission:qu45fs",
"dnfCondition": [
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:qu45fs",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:qu45fs"
}
],
[
{
"fromRule": "permission:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:fabrikampurview"
}
]
]
}
],
"collection": {
"type": "CollectionReference",
"referenceName": "qu45fs"
},
"parentCollectionName": "fabrikampurview"
}
}
Actualizar la directiva de recopilación
PUT https://{your_purview_account_name}.purview.azure.com/policystore/metadataPolicies/{policyId}?api-version=2021-07-01
En esta sección, se actualiza el JSON de directiva que obtuvo en el paso anterior agregando o quitando un usuario, grupo o entidad de servicio de la colección. A continuación, lo inserta en el servicio Microsoft Purview mediante un método PUT REST.
Tanto si agrega como si quita un usuario, un grupo o una entidad de servicio, seguirá el mismo proceso de API.
Proporcione el usuario, grupo o id. de objeto de entidad de servicio {guid} en la matriz "attributeValueIncludedIn" del JSON.
Busque la salida JSON de la API Get-Policy-by-ID para la matriz "attributeValueIncludedIn" en el paso anterior y agregue o elimine el usuario, grupo o identificador de objeto de entidad de servicio en la matriz. Si no está seguro de cómo obtener el usuario, grupo o identificador de objeto de entidad de servicio, consulte Get-MgUser.
Hay varias secciones en la asignación JSON para cada uno de los cuatro roles. Para el rol de permisos de Administrador de la colección, use la sección con el identificador denominada "purviewmetadatarole_builtin_collection-administrador". Del mismo modo, use la sección correspondiente para los demás roles.
Para comprender mejor la operación de agregar y quitar, examine cuidadosamente la diferencia entre la salida de JSON de la API anterior y la siguiente salida. En la salida de JSON siguiente, hemos agregado el id. de usuario "aaaabbbb-0000-cccc-1111-dddd2222eeee" como administrador de la colección.
{
"name": "policy_qu45fs",
"id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"version": 0,
"properties": {
"description": "",
"decisionRules": [
{
"kind": "decisionrule",
"effect": "Permit",
"dnfCondition": [
[
{
"attributeName": "resource.purview.collection",
"attributeValueIncludes": "qu45fs"
},
{
"fromRule": "permission:qu45fs",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:qu45fs"
}
]
]
}
],
"attributeRules": [
{
"kind": "attributerule",
"id": "purviewmetadatarole_builtin_collection-administrator:qu45fs",
"name": "purviewmetadatarole_builtin_collection-administrator:qu45fs",
"dnfCondition": [
[
{
"attributeName": "principal.microsoft.id",
"attributeValueIncludedIn": [
"2f656762-e440-4b62-9eb6-a991d17d64b0",
"00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
]
},
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator",
"attributeName": "derived.purview.role",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator"
}
],
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:fabrikampurview"
}
]
]
},
{
"kind": "attributerule",
"id": "permission:qu45fs",
"name": "permission:qu45fs",
"dnfCondition": [
[
{
"fromRule": "purviewmetadatarole_builtin_collection-administrator:qu45fs",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "purviewmetadatarole_builtin_collection-administrator:qu45fs"
}
],
[
{
"fromRule": "permission:fabrikampurview",
"attributeName": "derived.purview.permission",
"attributeValueIncludes": "permission:fabrikampurview"
}
]
]
}
],
"collection": {
"type": "CollectionReference",
"referenceName": "qu45fs"
},
"parentCollectionName": "fabrikampurview"
}
}
Agregue el rol de administrador de la colección raíz
De forma predeterminada, el usuario que creó la cuenta de Microsoft Purview es el administrador de la colección raíz (es decir, el administrador del nivel superior de la jerarquía de colecciones). Sin embargo, en algunos casos, es posible que una organización desee cambiar el administrador de la colección raíz mediante la API.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/addRootCollectionAdmin?api-version=2021-07-01
Para ejecutar el comando anterior, basta con pasar el ID de objeto del nuevo administrador de la colección raíz. Como hemos mencionado antes, el ID de objeto puede ser el de cualquier usuario, grupo o entidad de servicio.
{"objectId": "{guid}"}
Nota:
Los usuarios que llamen a esta API deben tener permisos de propietario o cuenta de usuario y autenticación (UAA) en la cuenta de Microsoft Purview para ejecutar una acción de escritura en la cuenta.
Más recursos
Puede optar por ejecutar las API de REST de Microsoft Purview mediante la utilidad PowerShell. Se puede instalar fácilmente desde la Galería de PowerShell. Con esta utilidad, puede ejecutar todos los mismos comandos, pero desde Windows PowerShell.