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 CLIをインストールします。
• subscriptionの既定値を設定します。

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

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

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

1. Microsoft Foundry にサインイン>。 新しいファウンドリーのトグルがオンになっていることを確認します。 これらの手順は Foundry (新規) を参照します。

   

2. 作業中のプロジェクトが左上隅に表示されます。

3. 新しいプロジェクトを作成するには、プロジェクト名を選択し、[ 新しいプロジェクトの作成] を選択します。

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

[ ホーム プロジェクト] ページに、プロジェクトのプロジェクト エンドポイントと API キーが表示されます。 Microsoft Entra ID認証を使用する場合、API キーは必要ありません。

# 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. Foundry ポータルで、右上のナビゲーションで [操作 ] を選択します。
2. 左側のウィンドウで [ 管理者 ] を選択します。
3. テーブルでプロジェクト名を選択します。
4. 右上にある [ ユーザーの追加] を選択します。
5. チーム メンバーのメール アドレスを入力します。
6. [追加] を選択します。

チーム メンバーまたはセキュリティ グループごとに、これらの手順を繰り返します。

Azure CLIポータルまたは Foundry ポータルを使用して、ロールの割り当てを管理します。 Python SDK では、ロールの割り当て操作はサポートされていません。

1. プロジェクトのリソース ID を取得します。

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. Foundry ユーザー ロールをチーム メンバーに割り当てます。

   重要

   Foundry RBAC ロールの名前が最近変更されました。 Foundry User, Foundry Owner, Foundry Account Owner、および Foundry Project Manager は、以前は、AZURE AI ユーザー、Azure AI 所有者、Azure AI アカウント所有者、および AZURE AI Project Manager という名前でした。 名前の変更がロールアウトされている間、以前の名前が表示される場合があります。ロール ID とコア アクセス許可は、名前の変更によって変更されません。

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

個々のユーザーではなくセキュリティ グループを追加するには:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. ロールの割り当てを確認します。

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

参照: az ロール割り当て

1. Microsoft Foundry にサインイン>。 新しいファウンドリーのトグルがオンになっていることを確認します。 これらの手順は Foundry (新規) を参照します。
2. 右上のナビゲーションで、[操作] を選択 します。
3. 左側のウィンドウで、[管理者] を選択 します。
4. プロジェクトを選択します。
5. 右上にあるごみ箱アイコンを選択してプロジェクトを削除します。

このコードでは、前提条件からの変数と 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.