Microsoft Foundry (クラシック) 用のプロジェクトを作成する

• ポータルを使用する場合は、他の前提条件は必要ありません。

• 開発環境を設定します。

• コードを実行する前に、環境内で az login または az login --use-device-code を実行します。

• パッケージのインストール: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0。 ノートブック セルを使用している場合は、代わりに %pip install を使用します。

• pip show azure-mgmt-cognitiveservicesを使用して、バージョンが 13.7 以上であることを確認します。

• クイック検証: プロジェクトを作成する前に、クライアントをテストして SDK と認証を確認します。

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  # Test authentication by instantiating the client
  credential = DefaultAzureCredential()
  subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
  client = CognitiveServicesManagementClient(credential, subscription_id)
  print("✓ Authentication successful! Ready to create a project.")
  

• 次のコードでスクリプトを開始し、この記事全体で使用される client 接続と変数を作成します。 この例では、米国東部にプロジェクトを作成します。

  from azure.identity import DefaultAzureCredential
  from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
  
  subscription_id = 'your-subscription-id'
  resource_group_name = 'your-resource-group-name'
  foundry_resource_name = 'your-foundry-resource-name'
  foundry_project_name = 'your-foundry-project-name'
  location = 'eastus'
  
  client = CognitiveServicesManagementClient(
      credential=DefaultAzureCredential(), 
      subscription_id=subscription_id,
      api_version="2025-04-01-preview"
  )
  

• (省略可能)複数のアカウントがある場合は、使用するMicrosoft Entra IDのテナント ID を DefaultAzureCredential に追加します。

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• (省略可能)Azure Government - US または 21Vianet リージョンによって運用される Azure で作業している場合は、認証するリージョンを指定します。 この例では、Azure Government - 米国リージョンに対して認証を行います。

  from azure.identity import AzureAuthorityHosts
  DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
  

• Azure CLIをインストールします。
• subscriptionの既定値を設定します。

# Set your default subscription
az account set --subscription "{subscription-name}"

これらの手順では、基本的な既定の設定を使用して新しいAzure リソースを作成する方法を提供します。

Foundry プロジェクトを作成するには、次の手順に従います。

1. Microsoft Foundry にサインイン>。 「New Foundry」トグルがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。

   

2. 次に何を行うかは、あなたがいる場所によって異なります。

   • プロジェクトに参加していない場合、またはプロジェクトがまだない場合: 右上の [ 新規作成 ] を選択して新しい Foundry プロジェクトを作成します

     

   • 現在プロジェクトにいる場合: プロジェクトのパンくずリストを選択し、[ 新しいリソースの作成] を選択します。

     

3. Foundry リソースを選択し、[次へ] を選択します。

4. プロジェクトの名前を指定し、[ 作成] を選択します。 または、詳細オプションについては、次のセクションを参照してください。

詳細オプション

1. Foundry リソースに Foundry プロジェクトを作成します。 プロジェクトを作成すると、ポータルによってこのリソースが自動的に作成されます。 使用する既存の リソース グループ を選択するか、既定値のままにして新しいリソース グループを作成します。

   ヒント

   特に作業を開始するには、プロジェクトの新しいリソース グループを作成します。 リソース グループを使用すると、プロジェクトとそのすべてのリソースをまとめて簡単に管理できます。

2. 場所を選択するか、既定値を使用します。 場所は、プロジェクト リソースがホストされているリージョンです。

3. 作成 を選択します。 リソースの作成の進行状況が表示されます。 プロジェクトは、プロセスが完了すると作成されます。

Foundry プロジェクトを作成するには:

• 次のコードを追加して、前提条件セクションの変数と client 接続を使用して Foundry プロジェクトを作成します。

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  参照: CognitiveServicesManagementClient。

1. リソース グループを作成するか、既存のものを使用します。 たとえば、my-foundry-rgでeastusを作成します。

   az group create --name my-foundry-rg --location eastus
   

2. Foundry リソースを作成します。 たとえば、my-foundry-resource リソース グループにmy-foundry-rgを作成します。

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku s0 \
       --location eastus \
      --allow-project-management
   

   --allow-project-management フラグを使用すると、このリソース内でプロジェクトを作成できます。

3. リソースのカスタム サブドメインを作成します。 カスタム ドメイン名はグローバルに一意である必要があります。 my-foundry-resource取得した場合は、より一意の名前を試してください。

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. プロジェクトを作成します。 たとえば、my-foundry-projectでmy-foundry-resourceを作成します。

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

5. プロジェクトが作成されたことを確認します。

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project
   

   出力には、リソース ID を含むプロジェクトのプロパティが表示されます。

リファレンス: az cognitiveservices account

[ ホーム プロジェクト] ページには、プロジェクトに関する情報が表示されます。

• 名前: プロジェクトの名前が左上隅に表示されます。
• サブスクリプション: プロジェクトをホストするリソースをホストするサブスクリプション。
• リソース グループ: プロジェクトをホストするリソースをホストするリソース グループ。

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

参照: CognitiveServicesManagementClient。

プロジェクトの設定を表示するには、 az cognitiveservices account project show コマンドを使用します。 例えば：

az cognitiveservices account project show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

1. Microsoft Foundry にサインイン>。 「New Foundry」トグルがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。
2. プロジェクトを開きます。
3. 管理センターを選択します。
4. [ リソース] で [ 概要] を選択します。
5. 保持しなくなったプロジェクトを選択します。
6. [ プロジェクトの削除] を選択します。

Foundry リソースとそのすべてのプロジェクトを削除するには:

1. 管理センターで、[概要] セクションからリソース名を選択して、Azure ポータルに移動します。
2. Azure ポータルで、Delete を選択して、リソースとそれに関連付けられているすべてのプロジェクトを削除します。

このコードでは、前提条件からの変数と client 接続を使用します。 1 つのプロジェクトを削除するには:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

参照: CognitiveServicesManagementClient。

Foundry リソースとそのすべてのプロジェクトを削除します。

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

参照: CognitiveServicesManagementClient。

次のコマンドを実行します。

az cognitiveservices account project delete \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

参照: az cognitiveservices account project delete.