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

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

El portal de gobierno de Microsoft Purview presenta herramientas como el Mapa de datos de Microsoft Purview y el Catálogo de datos de Microsoft Purview que le ayudan a administrar y gobernar el panorama de datos. Al conectarse a los datos a través de 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 linaje 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 introducción a las soluciones de gobernanza.

Requisitos previos

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

• Un inquilino de Microsoft Entra asociado a su suscripción.

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

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

Iniciar sesión en Azure

Inicie sesión en 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.

SDK de Azure .NET

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

Crear una aplicación en Microsoft Entra ID

1. En Creación de una aplicación de Microsoft Entra, cree una aplicación que represente la aplicación de .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 el inicio de sesión, obtenga el identificador de aplicación y el identificador de inquilino, y anote los valores que use 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.

Crear un proyecto de Visual Studio

A continuación, cree una aplicación de consola C# .NET 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 superior de .NET.
3. En Nombre del proyecto, escriba PurviewQuickStart.
4. Seleccione Crear para crear el proyecto.

Instalar paquetes NuGet

1. Seleccionar herramientas>Administrador de> paquetes NuGetAdministrador de paquetes Consola.

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

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

Crear un cliente de Microsoft Purview

1. Abra Program.cs, incluya las instrucciones siguientes 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 . Use este objeto 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 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();

Ejecutar el código

Genere e inicie la aplicación y, a continuación, 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...

Comprobar la salida

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

Eliminar una cuenta de Microsoft Purview

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

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

Comprobar 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 imprimirá "True" si el nombre está disponible y "False" si el nombre no está disponible.

Pasos siguientes

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

Sigue los siguientes artículos para aprender a navegar por el portal de gobierno de Microsoft Purview, crear una colección y conceder acceso al portal de gobierno de Microsoft Purview.

• Cómo usar el portal de gobierno de Microsoft Purview
• Conceder permisos de usuario al portal de gobierno
• Creación de una colección