クイック スタート: .NET SDK を使用して Microsoft Purview (旧称 Azure Purview) アカウントを作成する

注:

Microsoft Purview データ カタログ (クラシック) と Data Health Insights (クラシック) は新しい顧客を引き受けなくなり、これらのサービス (以前は Azure Purview) はカスタマー サポート モードになりました。

重要

テナントごとに作成できる Microsoft Purview アカウントは 1 つだけです。 organizationに既に Microsoft Purview アカウントがある場合、organizationに既に複数のアカウントがあり、まだ既存のクォータの下にない限り、新しい Microsoft Purview アカウントを作成することはできません。 詳細については、FAQ を参照してください。

このクイック スタートでは、 .NET SDK を使用して Microsoft Purview (旧称 Azure Purview) アカウントを作成します。

Microsoft Purview ガバナンス ポータルには、データランドスケープの管理と管理に役立つMicrosoft Purview データ マップやMicrosoft Purview データ カタログなどのツールが表示されます。 オンプレミス、マルチクラウド、およびサービスとしてのソフトウェア (SaaS) ソース間でデータに接続することで、Microsoft Purview データ マップは情報の最新のマップを作成します。 機密性の高いデータを識別して分類し、エンドツーエンドの言語を提供します。 データ コンシューマーは、organization全体でデータを検出でき、データ管理者はデータの監査、セキュリティ保護、および適切な使用を確保できます。

Microsoft Purview の従来のガバナンス機能の詳細については、 ガバナンス ソリューションの概要ページを参照してください。

前提条件

• Azure サブスクリプションをお持ちでない場合は、開始する前に 無料のサブスクリプション を作成してください。

• サブスクリプションに関連付けられているMicrosoft Entra テナント。

• Azure へのサインインに使用するユーザー アカウントは、 共同作成者 または 所有者 ロールのメンバー、または Azure サブスクリプションの 管理者 である必要があります。 サブスクリプションに含まれているアクセス許可を表示するには、次の手順に従います。

  1. Azure portalに移動します
  2. 右上隅でユーザー名を選択します。
  3. その他のオプションについては、省略記号ボタン ("...") を選択します。
  4. 次 に、[マイ アクセス許可] を選択します。
  5. 複数のサブスクリプションにアクセスできる場合は、適切なサブスクリプションを選択します。

Azure にサインインする

Azure アカウントでAzure portalにサインインします。

Visual Studio

この記事のチュートリアルでは、Visual Studio 2019 を使用します。 Visual Studio 2013、2015、または 2017 の手順は若干異なる場合があります。

Azure .NET SDK

マシンに Azure .NET SDK をダウンロードしてインストールします。

Microsoft Entra IDでアプリケーションを作成する

1. [Microsoft Entra アプリケーションの作成] で、このチュートリアルで作成する .NET アプリケーションを表すアプリケーションを作成します。 サインオン URL には、記事 (https://contoso.org/exampleapp) に示すようにダミー URL を指定できます。
2. [ サインインの値を取得する] で、 アプリケーション ID と テナント ID を取得し、このチュートリアルの後半で使用するこれらの値をメモします。
3. [ 証明書とシークレット] で 認証キーを取得し、このチュートリアルの後半で使用するこの値をメモします。
4. [ ロールにアプリケーションを割り当てる] で、アプリケーションをサブスクリプション レベルで 共同作成者 ロールに割り当てて、アプリケーションがサブスクリプションにデータ ファクトリを作成できるようにします。

Visual Studio プロジェクトを作成する

次に、Visual Studio で C# .NET コンソール アプリケーションを作成します。

1. Visual Studio を起動します。
2. [スタート] ウィンドウで、[新しいプロジェクトの作成>Console App (.NET Framework) を選択します。 .NET バージョン 4.5.2 以降が必要です。
3. [ プロジェクト名] に「 PurviewQuickStart」と入力します。
4. [ 作成] を 選択してプロジェクトを作成します。

NuGet パッケージをインストールする

1. [ ツール>NuGet パッケージ マネージャー>Package Manager コンソール] を選択します。

2. [ パッケージ マネージャー コンソール ] ウィンドウで、次のコマンドを実行してパッケージをインストールします。 詳細については、「 Microsoft.Azure.Management.Purview NuGet パッケージ」を参照してください。

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

ヒント

パッケージ <パッケージ名>が次のプライマリ ソースに見つからないというエラーが発生し、ローカル フォルダーが一覧表示されている場合は、Nuget サイトをオンライン ソースとして含むように Visual Studio でパッケージ ソースを更新する必要があります。

1. [ツール] に移動します
2. NuGet パッケージ マネージャーを選択する
3. [ パッケージの管理設定] を選択します
4. パッケージ ソースの選択
5. ソースとして https://nuget.org/api/v2/ を追加します。

Microsoft Purview クライアントを作成する

1. Program.csを開き、次のステートメントを含め、名前空間への参照を追加します。

   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. 変数を設定する Main メソッドに次のコードを追加します。 プレースホルダーを独自の値に置き換えます。 Microsoft Purview が現在利用できる Azure リージョンの一覧については、 Microsoft Purview で検索し、次のページで関心のあるリージョンを選択します。 リージョン別に利用可能な製品。

   // 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. PurviewManagementClient クラスのインスタンスを作成する Main メソッドに次のコードを追加します。 このオブジェクトを使用して、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           
   };
   

アカウントの作成

Microsoft Purview アカウントを作成する Main メソッドに次のコードを追加します。

// 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();

コードを実行する

アプリケーションをビルドして起動し、実行を確認します。

コンソールは、Microsoft Purview アカウントの作成の進行状況を出力します。

出力例

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

Press any key to exit...

出力を確認する

Azure portalの [Microsoft Purview アカウント] ページに移動し、上記のコードを使用して作成されたアカウントを確認します。

Microsoft Purview アカウントを削除する

プログラムによって Microsoft Purview アカウントを削除するには、次のコード行をプログラムに追加します。

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

Microsoft Purview アカウント名が使用可能かどうかを確認する

purview アカウントの可用性をチェックするには、次のコードを使用します。

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

上記のコードは、名前が使用可能な場合は 'True'、名前が使用できない場合は 'False' を出力します。

次の手順

このクイック スタートでは、Microsoft Purview (旧称 Azure Purview) アカウントを作成し、アカウントを削除し、名前を利用できるようにチェックする方法について説明しました。 .NET SDK をダウンロードし、Microsoft Purview アカウントに対して実行できるその他のリソース プロバイダー アクションについて学習できるようになりました。

次の記事に従って、Microsoft Purview ガバナンス ポータルを移動し、コレクションを作成し、Microsoft Purview ガバナンス ポータルへのアクセスを許可する方法について説明します。

• Microsoft Purview ガバナンス ポータルを使用する方法
• ガバナンス ポータルへのアクセス許可をユーザーに付与する
• コレクションを作成する