Compartir a través de

Inicio rápido: Creación de una cuenta de Microsoft Purview (anteriormente Azure Purview) mediante el SDK de .NET

  • Artículo

Importante

Solo puede crear una cuenta de Microsoft Purview por inquilino. Si su organización ya tiene una cuenta de Microsoft Purview, no podrá crear una nueva cuenta de Microsoft Purview a menos que la organización ya tenga varias cuentas y siga estando bajo la cuota preexistente. Para obtener más información, consulte las preguntas más frecuentes.

En este inicio rápido, usará el SDK de .NET para crear una cuenta de Microsoft Purview (anteriormente Azure Purview).

El portal de gobernanza de Microsoft Purview muestra herramientas como la Mapa de datos de Microsoft Purview y Catálogo de datos de Microsoft Purview que le ayudan a administrar y controlar el panorama de los datos. Al conectarse a datos en los orígenes locales, multinube y de software como servicio (SaaS), el Mapa de datos de Microsoft Purview crea un mapa actualizado de la información. Identifica y clasifica los datos confidenciales y proporciona linage de un extremo a otro. Los consumidores de datos pueden detectar datos en toda la organización y los administradores de datos pueden auditar, proteger y garantizar el uso correcto de los datos.

Para obtener más información sobre las funcionalidades de gobernanza clásicas de Microsoft Purview, consulte nuestra página de información general sobre soluciones de gobernanza.

Requisitos previos

  • Si no tiene una suscripción de Azure, cree una suscripción gratuita antes de empezar.

  • Un inquilino Microsoft Entra asociado a la suscripción.

  • La cuenta de usuario que use para iniciar sesión en Azure debe ser miembro del rol de colaborador o propietario , o un administrador de la suscripción de Azure. Para ver los permisos que tiene en la suscripción, siga estos pasos:

    1. Vaya al Azure Portal
    2. Seleccione el nombre de usuario en la esquina superior derecha.
    3. Seleccione el botón de puntos suspensivos ("...") para obtener más opciones.
    4. A continuación, seleccione Mis permisos.
    5. Si tiene acceso a varias suscripciones, seleccione la suscripción adecuada.

Inicio de sesión en Azure

Inicie sesión en el Azure Portal con su cuenta de Azure.

Visual Studio

En el tutorial de este artículo se usa Visual Studio 2019. Los procedimientos para Visual Studio 2013, 2015 o 2017 pueden diferir ligeramente.

Azure .NET SDK

Descargue e instale el SDK de Azure .NET en el equipo.

Creación de una aplicación en Microsoft Entra ID

  1. En Crear una aplicación Microsoft Entra, cree una aplicación que represente la aplicación .NET que va a crear en este tutorial. Para la dirección URL de inicio de sesión, puede proporcionar una dirección URL ficticia como se muestra en el artículo (https://contoso.org/exampleapp).
  2. En Obtener valores para iniciar sesión, obtenga el identificador de aplicación y el identificador de inquilino y anote estos valores que usará más adelante en este tutorial.
  3. En Certificados y secretos, obtenga la clave de autenticación y anote este valor que usará más adelante en este tutorial.
  4. En Asignar la aplicación a un rol, asigne la aplicación al rol Colaborador en el nivel de suscripción para que la aplicación pueda crear factorías de datos en la suscripción.

Creación de un proyecto de Visual Studio

A continuación, cree una aplicación de consola .NET de C# en Visual Studio:

  1. Inicie Visual Studio.
  2. En la ventana Inicio, seleccione Crear un nuevo proyecto>Aplicación de consola (.NET Framework). Se requiere la versión 4.5.2 o posterior de .NET.
  3. En Nombre del proyecto, escriba PurviewQuickStart.
  4. Seleccione Crear para crear el proyecto.

Instalar paquetes NuGet

  1. Seleccione Herramientas>NuGet Package ManagerPackage Manager Console (Consola del Administrador> de paquetes de NuGet).

  2. En el panel Consola del Administrador de paquetes, ejecute los siguientes comandos para instalar paquetes. Para obtener más información, consulte el paquete NuGet Microsoft.Azure.Management.Purview.

    Install-Package Microsoft.Azure.Management.Purview
Install-Package Microsoft.Azure.Management.ResourceManager -IncludePrerelease
Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory

Sugerencia

Si recibe un error que dice: El <nombre> del paquete no se encuentra en los siguientes orígenes principales : y está enumerando una carpeta local, debe actualizar los orígenes del paquete en Visual Studio para incluir el sitio nuget como origen en línea.

  1. Vaya a Herramientas
  2. Selección del Administrador de paquetes NuGet
  3. Seleccione Configuración de administración de paquetes
  4. Seleccionar orígenes de paquete
  5. Agregar https://nuget.org/api/v2/ como origen.

Creación de un cliente de Microsoft Purview

  1. Abra Program.cs, incluya las siguientes instrucciones para agregar referencias a espacios de nombres.

    using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.Rest;
using Microsoft.Rest.Serialization;
   using Microsoft.Azure.Management.ResourceManager;
using Microsoft.Azure.Management.Purview;
   using Microsoft.Azure.Management.Purview.Models;
   using Microsoft.IdentityModel.Clients.ActiveDirectory;

  2. Agregue el código siguiente al método Main que establece las variables. Reemplace los marcadores de posición por sus propios valores. Para obtener una lista de las regiones de Azure en las que Microsoft Purview está disponible actualmente, busque En Microsoft Purview y seleccione las regiones que le interesen en la página siguiente: Productos disponibles por región.

    // Set variables
string tenantID = "<your tenant ID>";
string applicationId = "<your application ID>";
string authenticationKey = "<your authentication key for the application>";
string subscriptionId = "<your subscription ID where the data factory resides>";
string resourceGroup = "<your resource group where the data factory resides>";
string region = "<the location of your resource group>";
string purviewAccountName = 
    "<specify the name of purview account to create. It must be globally unique.>";

  3. Agregue el código siguiente al método Main que crea una instancia de la clase PurviewManagementClient . Este objeto se usa para crear una cuenta de Microsoft Purview.

    // Authenticate and create a purview management client
var context = new AuthenticationContext("https://login.windows.net/" + tenantID);
ClientCredential cc = new ClientCredential(applicationId, authenticationKey);
AuthenticationResult result = context.AcquireTokenAsync(
"https://management.azure.com/", cc).Result;
ServiceClientCredentials cred = new TokenCredentials(result.AccessToken);
var client = new PurviewManagementClient(cred)
{
   SubscriptionId = subscriptionId           
};

Crear una cuenta

Agregue el código siguiente al método Main que creará la cuenta de Microsoft Purview.

// Create a purview Account
Console.WriteLine("Creating Microsoft Purview Account " + purviewAccountName + "...");
Account account = new Account()
{
Location = region,
Identity = new Identity(type: "SystemAssigned"),
Sku = new AccountSku(name: "Standard", capacity: 4)
};            
try
{
  client.Accounts.CreateOrUpdate(resourceGroup, purviewAccountName, account);
  Console.WriteLine(client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState);                
}
catch (ErrorResponseModelException purviewException)
{
Console.WriteLine(purviewException.StackTrace);
  }
  Console.WriteLine(
    SafeJsonConvert.SerializeObject(account, client.SerializationSettings));
  while (client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState ==
         "PendingCreation")
  {
    System.Threading.Thread.Sleep(1000);
  }
Console.WriteLine("\nPress any key to exit...");
Console.ReadKey();

Ejecución del código

Compile e inicie la aplicación y compruebe la ejecución.

La consola imprime el progreso de la creación de la cuenta de Microsoft Purview.

Salida de ejemplo

Creating Microsoft Purview Account testpurview...
Succeeded
{
  "sku": {
    "capacity": 4,
    "name": "Standard"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "southcentralus"
}

Press any key to exit...

Comprobación de la salida

Vaya a la página Cuentas de Microsoft Purview en el Azure Portal y compruebe la cuenta creada con el código anterior.

Eliminación de una cuenta de Microsoft Purview

Para eliminar mediante programación una cuenta de Microsoft Purview, agregue las siguientes líneas de código al programa:

Console.WriteLine("Deleting the Microsoft Purview Account");
client.Accounts.Delete(resourceGroup, purviewAccountName);

Compruebe si el nombre de la cuenta de Microsoft Purview está disponible.

Para comprobar la disponibilidad de una cuenta de Purview, use el código siguiente:

CheckNameAvailabilityRequest checkNameAvailabilityRequest = newCheckNameAvailabilityRequest()
{
    Name = purviewAccountName,
    Type =  "Microsoft.Purview/accounts"
};
Console.WriteLine("Check Microsoft Purview account name");
Console.WriteLine(client.Accounts.CheckNameAvailability(checkNameAvailabilityRequest).NameAvailable);

El código anterior con la impresión "True" si el nombre está disponible y "False" si el nombre no está disponible.

Pasos siguientes

En este inicio rápido, ha aprendido a crear una cuenta de Microsoft Purview (anteriormente Azure Purview), a eliminar la cuenta y a comprobar la disponibilidad de nombres. Ahora puede descargar el SDK de .NET y obtener información sobre otras acciones del proveedor de recursos que puede realizar para una cuenta de Microsoft Purview.

Siga estos artículos siguientes para obtener información sobre cómo navegar por el portal de gobernanza de Microsoft Purview, crear una colección y conceder acceso al portal de gobernanza de Microsoft Purview.