クイック スタート: 最初の Foundry リソースを設定する

前提条件

• 有効なAzure サブスクリプション - 無料。
• Azure RBAC ロールによってリソースを作成する。 Azure サブスクリプションまたはリソース グループに割り当てられている次のいずれかのロールが必要です。
  • 投稿者
  • オーナー
  • Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタム ロール

新しい Microsoft Foundry リソースを作成する

組織で、別名、セキュリティコントロール、コスト タグなどのカスタマイズされたAzure構成が必要な場合は、組織のAzure Policyコンプライアンスに準拠するために、Azure portal または template オプションを使用する必要があります。

Foundry リソースは、Azure portalの Foundry>Foundry の下に表示されます。 API の種類は AIServices です。 次に示すロゴを探します。

Azure portalで Foundry リソースを作成するには、次の手順に従います。

1. 次の Foundry リソース リンクを選択します: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

2. [作成] ページで、次の情報を指定します。

   Projectの詳細	説明
   サブスクリプション	使用可能なAzureサブスクリプションのいずれかを選択します。
   リソース グループ	Foundry リソースを含むAzure リソース グループ。 新しいグループを作成したり、既存のグループに追加したりできます。
   リージョン	Foundry Tool インスタンスの場所。 別の場所を選択すると待機時間が生じる可能性がありますが、リソースのランタイムの可用性には影響しません。
   名前	Foundry リソースのわかりやすい名前。 たとえば、MyAIServicesResource。

3. 必要に応じてリソースの他の設定を構成し、条件を読み取って同意し (該当する場合)、[Review + create(確認と作成) ] を選択します。

リソースをクリーンアップする

Foundry リソースをクリーンアップして削除する場合は、リソースまたはリソース グループを削除できます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。

1. Azure portalで、左側のメニューを展開してサービスのメニューを開き、Resource Groups を選択してリソース グループの一覧を表示します。
2. 削除するリソースが含まれているリソース グループを見つけます。
3. リソース グループ全体を削除する場合は、リソース グループ名を選択します。 次のページで [リソース グループの削除] を選択し、確認します。
4. Foundry リソースのみを削除する場合は、リソース グループを選択して、その中のすべてのリソースを表示します。 次のページで、削除するリソースを選択し、その行の省略記号メニューを選択して、[削除] を選択します。

このクイック スタートでは、Azure Command-Line インターフェイス (CLI) コマンドを使用して Foundry リソースを作成します。

前提条件

• 有効なAzure サブスクリプション - Create one 無料。
• Azure CLI バージョン 2.0 以降。
• Azure RBAC ロールによってリソースを作成する。 Azure サブスクリプションまたはリソース グループに割り当てられている次のいずれかのロールが必要です。
  • 投稿者
  • オーナー
  • Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタム ロール

Azure CLIをインストールしてサインインする

Azure CLIをインストールします。 CLI のローカル インストールにサインインするには、az login コマンドを実行します。

az login

新しいリソース グループを作成する

Foundry リソースを作成する前に、リソースを格納するAzureリソース グループが必要です。 新しいリソースを作成するときは、新しいリソース グループを作成するか、既存のものを使用できます。 この記事では、新しいリソース グループを作成する方法を示します。

リソースを作成するには、サブスクリプションで使用可能なAzureの場所のいずれかが必要です。 使用可能な場所の一覧は、az アカウントの list-locations コマンドを使用して取得できます。 ほとんどの Foundry Tools には、複数の場所からアクセスできます。 お客様に最も近いものを選択するか、サービスに使用できる場所を確認します。

az account list-locations --query "[].{Region:name}" --out table

Azureの場所を作成したら、az group create コマンドを使用してAzure CLIに新しいリソース グループを作成します。 次の例では、Azureの場所 westus2 を、サブスクリプションで使用可能なAzureの場所のいずれかに置き換えます。

az group create --name ai-services-resource-group --location westus2

Foundry リソースを作成する

新しい Foundry リソースを作成してサブスクライブするには、az cognitiveservices account create コマンドを使用します。 このコマンドで、以前に作成したリソース グループに新しい課金対象リソースが追加されます。 新しいリソースを作成するときは、使用するサービスの種類と、その価格レベル (SKU) とAzureの場所を把握する必要があります。

次のコマンドを使用して、 foundry-multi-service-resource という名前の Foundry リソースを作成できます。

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

現在のリソースのクォータ使用量を取得する

az cognitiveservices account list-usage コマンドを使用して、リソースの使用状況を取得します。

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

リソースをクリーンアップする

Foundry リソースをクリーンアップして削除する場合は、そのリソースまたはリソース グループを削除できます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。

リソース グループとそれに関連付けられているリソースを削除するには、az group delete command を使用します。

az group delete --name ai-services-resource-group

このクイック スタートでは、Azure PowerShell コマンドを使用して Foundry リソースを作成します。

前提条件

• 有効なAzure サブスクリプション - Create one 無料。
• Azure PowerShell バージョン 5.0 以降。
• Azure RBAC ロールによってリソースを作成する。 Azure サブスクリプションまたはリソース グループに割り当てられている次のいずれかのロールが必要です。
  • 投稿者
  • オーナー
  • Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタム ロール

Azure PowerShellをインストールしてサインインする

Azure PowerShellをインストールします。 サインインするには、Connect-AzAccount コマンドを実行します。

Connect-AzAccount

新しい Microsoft Foundry リソース グループを作成する

Foundry リソースを作成する前に、リソースを格納するAzureリソース グループが必要です。 新しいリソースを作成するときは、新しいリソース グループを作成するか、既存のものを使用できます。 この記事では、新しいリソース グループを作成する方法を示します。

リソースを作成するには、サブスクリプションで使用可能なAzureの場所のいずれかが必要です。 Get-AzLocation コマンドを使って、使用できる場所の一覧を取得できます。 ほとんどの Foundry Tools には、複数の場所からアクセスできます。 お客様に最も近いものを選択するか、サービスに使用できる場所を確認します。

Get-AzLocation | Select-Object -Property Location, DisplayName

Azureの場所を取得したら、New-AzResourceGroup コマンドを使用してAzure PowerShellに新しいリソース グループを作成します。 次の例では、Azureの場所 westus2 を、サブスクリプションで使用可能なAzureの場所のいずれかに置き換えます。

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Foundry リソースを作成する

新しい Foundry リソースを作成してサブスクライブするには、 New-AzCognitiveServicesAccount コマンドを使用します。 このコマンドで、以前に作成したリソース グループに新しい課金対象リソースが追加されます。 新しいリソースを作成するときは、使用するサービスの "種類" と、その価格レベル (SKU) とAzureの場所を把握する必要があります。

次のコマンドを使用して、 foundry-multi-service-resource という名前の Foundry リソースを作成できます。

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

現在のリソースのクォータ使用量を取得する

リソースの使用状況を取得するには、Get-AzCognitiveServicesAccountUsage コマンドを使います。

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

リソースをクリーンアップする

Foundry リソースをクリーンアップして削除する場合は、そのリソースまたはリソース グループを削除できます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。

リソース グループとそれに関連付けられているリソースを削除するには、Remove-AzResourceGroup コマンドを使います。

Remove-AzResourceGroup -Name ai-services-resource-group