Microsoft.DevCenter プロジェクト

2025-05-14

Bicep リソース定義

プロジェクトリソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevCenter/projects リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.DevCenter/projects@2025-04-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    azureAiServicesSettings: {
      azureAiServicesMode: 'string'
    }
    catalogSettings: {
      catalogItemSyncTypes: [
        'string'
      ]
    }
    customizationSettings: {
      identities: [
        {
          identityResourceId: 'string'
          identityType: 'string'
        }
      ]
      userCustomizationsEnableStatus: 'string'
    }
    description: 'string'
    devBoxAutoDeleteSettings: {
      deleteMode: 'string'
      gracePeriod: 'string'
      inactiveThreshold: 'string'
    }
    devCenterId: 'string'
    displayName: 'string'
    maxDevBoxesPerUser: int
    serverlessGpuSessionsSettings: {
      maxConcurrentSessionsPerProject: int
      serverlessGpuSessionsMode: 'string'
    }
    workspaceStorageSettings: {
      workspaceStorageMode: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

プロパティ値

Microsoft.DevCenter/プロジェクト

名前	形容	価値
同一性	マネージド ID のプロパティ	ManagedServiceIdentity の
場所	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 3 最大長 = 63 パターン = `^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$` (必須)
プロパティ	プロジェクトのプロパティ。	プロジェクトプロパティ
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください

AzureAiServices設定

名前	形容	価値
azureAiServicesMode	このプロパティは、Azure AI サービスが有効になっているかどうかを示します。	「自動デプロイ」「無効」

DevBoxAutoDelete設定

名前	形容	価値
削除モード	このプロジェクト内の Dev Box の削除モードを示します。	「オート」「マニュアル」
猶予期間	開発ボックスが削除される前に削除対象としてマークされるために必要な期間ISO8601。 ISO8601形式 PT[n]H[n]M[n]S	糸
非アクティブしきい値	ISO8601 開発ボックスが削除のスケジュールされる前に非アクティブにならないために必要な期間。 ISO8601形式 PT[n]H[n]M[n]S	糸

マネージドサービスアイデンティティ

名前	形容	価値
種類	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の

ProjectCatalogSettings (プロジェクトカタログ設定)

名前	形容	価値
catalogItemSyncTypes (カタログアイテムシンクタイプ)	同期できるカタログアイテムの種類を示します。	次のいずれかを含む文字列配列: 「環境定義」 'ImageDefinition' (画像定義)

プロジェクトカスタマイズ管理アイデンティティ

名前	形容	価値
アイデンティティリソースID	例: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<リソースグループ>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。 identityType systemAssignedIdentity と相互に排他的です。	糸
アイデンティティタイプ	systemAssignedIdentity または userAssignedIdentity の値を指定できます。	'systemAssignedIdentity' 'userAssignedIdentity'

プロジェクトカスタマイズ設定

名前	形容	価値
ids	カスタマイズシナリオで使用できる ID。たとえば、リポジトリをクローンする場合などです。	ProjectCustomizationManagedIdentity[]
userCustomizationsEnableStatus	ユーザーのカスタマイズが有効になっているかどうかを示します。	「無効」「有効」

プロジェクトプロパティ

名前	形容	価値
azureAiServicesの設定	プロジェクトに対して Azure AI サービスが有効になっているかどうかを示します。	AzureAiServices設定
catalog設定	プロジェクトをカタログに関連付けるときに使用する設定。	ProjectCatalogSettings (プロジェクトカタログ設定)
customizationSettings (カスタマイズ設定)	カスタマイズに使用する設定。	プロジェクトカスタマイズ設定
形容	プロジェクトの説明。	糸
devBoxAutoDelete設定	Dev Box の自動削除設定。	DevBoxAutoDelete設定
devCenterId(デブセンターイド)	関連付けられている DevCenter のリソース ID	糸
ディスプレイ名	プロジェクトの表示名。	糸
maxDevBoxesPerUser	指定した場合、1 人のユーザーがプロジェクト内のすべてのプールで作成できる開発ボックスの最大数を制限します。これは、縮小しても既存の開発ボックスには影響しません。	int 制約：最小値 = 0
サーバーレスGpuSessionsSettings	サーバーレス GPU に使用する設定。	ServerlessGpuSessions設定
workspaceStorage設定	ワークスペースのストレージに使用する設定。	WorkspaceStorage設定

ServerlessGpuSessions設定

名前	形容	価値
maxConcurrentSessionsPerProject	指定すると、プロジェクト内のすべてのプールで同時セッションの最大数が制限されます。	int 制約：最小値 = 1
サーバーレスGpuSessionsMode	このプロパティは、プロジェクトでサーバーレス GPU アクセスが有効になっているかどうかを示します。	「自動デプロイ」「無効」

追跡リソースタグ

名前	形容	価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前	形容	価値

ユーザー割り当て識別子

名前	形容	価値

WorkspaceStorage設定

名前	形容	価値
ワークスペースストレージモード	ワークスペースストレージが有効になっているかどうかを示します。	「自動デプロイ」「無効」

使用例

Azure クイックスタートのサンプル

次 Azure クイックスタートテンプレート、このリソースの種類をデプロイするための Bicep サンプルが含まれています。

Bicep ファイル	形容
展開環境サービスの構成	このテンプレートは、デプロイ環境を構成する方法を提供します。
Dev Box サービスの構成	このテンプレートでは、Dev Box クイックスタートガイド (/azure/dev-box/quickstart-create-dev-box) に従って、すべての Dev Box 管理リソースが作成されます。作成されたすべてのリソースを表示することも、DevPortal.microsoft.com に直接移動して最初の Dev Box を作成することもできます。
Dev Box Service をデプロイする	このテンプレートは、Dev Box の作成に必要なすべてのリソースを構成する方法を提供します。
組み込みのイメージを使用して Dev Box Service をデプロイする	このテンプレートは、組み込みのイメージを使用して Dev Box サービスをデプロイする方法を提供します。

ARM テンプレートリソース定義

プロジェクトリソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループの - リソースグループのデプロイコマンド参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevCenter/projects リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.DevCenter/projects",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "azureAiServicesSettings": {
      "azureAiServicesMode": "string"
    },
    "catalogSettings": {
      "catalogItemSyncTypes": [ "string" ]
    },
    "customizationSettings": {
      "identities": [
        {
          "identityResourceId": "string",
          "identityType": "string"
        }
      ],
      "userCustomizationsEnableStatus": "string"
    },
    "description": "string",
    "devBoxAutoDeleteSettings": {
      "deleteMode": "string",
      "gracePeriod": "string",
      "inactiveThreshold": "string"
    },
    "devCenterId": "string",
    "displayName": "string",
    "maxDevBoxesPerUser": "int",
    "serverlessGpuSessionsSettings": {
      "maxConcurrentSessionsPerProject": "int",
      "serverlessGpuSessionsMode": "string"
    },
    "workspaceStorageSettings": {
      "workspaceStorageMode": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

プロパティ値

Microsoft.DevCenter/プロジェクト

名前	形容	価値
apiVersion (英語)	API のバージョン	「2025-04-01-プレビュー」
同一性	マネージド ID のプロパティ	ManagedServiceIdentity の
場所	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 3 最大長 = 63 パターン = `^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$` (必須)
プロパティ	プロジェクトのプロパティ。	プロジェクトプロパティ
タグ	リソースタグ	タグ名と値のディクショナリ。テンプレートのタグを参照してください
種類	リソースの種類	'Microsoft.DevCenter/projects'

AzureAiServices設定

名前	形容	価値
azureAiServicesMode	このプロパティは、Azure AI サービスが有効になっているかどうかを示します。	「自動デプロイ」「無効」

DevBoxAutoDelete設定

名前	形容	価値
削除モード	このプロジェクト内の Dev Box の削除モードを示します。	「オート」「マニュアル」
猶予期間	開発ボックスが削除される前に削除対象としてマークされるために必要な期間ISO8601。 ISO8601形式 PT[n]H[n]M[n]S	糸
非アクティブしきい値	ISO8601 開発ボックスが削除のスケジュールされる前に非アクティブにならないために必要な期間。 ISO8601形式 PT[n]H[n]M[n]S	糸

マネージドサービスアイデンティティ

名前	形容	価値
種類	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の

ProjectCatalogSettings (プロジェクトカタログ設定)

名前	形容	価値
catalogItemSyncTypes (カタログアイテムシンクタイプ)	同期できるカタログアイテムの種類を示します。	次のいずれかを含む文字列配列: 「環境定義」 'ImageDefinition' (画像定義)

プロジェクトカスタマイズ管理アイデンティティ

名前	形容	価値
アイデンティティリソースID	例: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<リソースグループ>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。 identityType systemAssignedIdentity と相互に排他的です。	糸
アイデンティティタイプ	systemAssignedIdentity または userAssignedIdentity の値を指定できます。	'systemAssignedIdentity' 'userAssignedIdentity'

プロジェクトカスタマイズ設定

名前	形容	価値
ids	カスタマイズシナリオで使用できる ID。たとえば、リポジトリをクローンする場合などです。	ProjectCustomizationManagedIdentity[]
userCustomizationsEnableStatus	ユーザーのカスタマイズが有効になっているかどうかを示します。	「無効」「有効」

プロジェクトプロパティ

名前	形容	価値
azureAiServicesの設定	プロジェクトに対して Azure AI サービスが有効になっているかどうかを示します。	AzureAiServices設定
catalog設定	プロジェクトをカタログに関連付けるときに使用する設定。	ProjectCatalogSettings (プロジェクトカタログ設定)
customizationSettings (カスタマイズ設定)	カスタマイズに使用する設定。	プロジェクトカスタマイズ設定
形容	プロジェクトの説明。	糸
devBoxAutoDelete設定	Dev Box の自動削除設定。	DevBoxAutoDelete設定
devCenterId(デブセンターイド)	関連付けられている DevCenter のリソース ID	糸
ディスプレイ名	プロジェクトの表示名。	糸
maxDevBoxesPerUser	指定した場合、1 人のユーザーがプロジェクト内のすべてのプールで作成できる開発ボックスの最大数を制限します。これは、縮小しても既存の開発ボックスには影響しません。	int 制約：最小値 = 0
サーバーレスGpuSessionsSettings	サーバーレス GPU に使用する設定。	ServerlessGpuSessions設定
workspaceStorage設定	ワークスペースのストレージに使用する設定。	WorkspaceStorage設定

ServerlessGpuSessions設定

名前	形容	価値
maxConcurrentSessionsPerProject	指定すると、プロジェクト内のすべてのプールで同時セッションの最大数が制限されます。	int 制約：最小値 = 1
サーバーレスGpuSessionsMode	このプロパティは、プロジェクトでサーバーレス GPU アクセスが有効になっているかどうかを示します。	「自動デプロイ」「無効」

追跡リソースタグ

名前	形容	価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前	形容	価値

ユーザー割り当て識別子

名前	形容	価値

WorkspaceStorage設定

名前	形容	価値
ワークスペースストレージモード	ワークスペースストレージが有効になっているかどうかを示します。	「自動デプロイ」「無効」

使用例

Azure クイックスタートテンプレート

このリソースの種類デプロイする Azure クイックスタートテンプレート次に示します。

テンプレート	形容
展開環境サービスの構成 Azure にデプロイする	このテンプレートは、デプロイ環境を構成する方法を提供します。
Dev Box サービスの構成 Azure にデプロイする	このテンプレートでは、Dev Box クイックスタートガイド (/azure/dev-box/quickstart-create-dev-box) に従って、すべての Dev Box 管理リソースが作成されます。作成されたすべてのリソースを表示することも、DevPortal.microsoft.com に直接移動して最初の Dev Box を作成することもできます。
Dev Box Service をデプロイする Azure にデプロイする	このテンプレートは、Dev Box の作成に必要なすべてのリソースを構成する方法を提供します。
組み込みのイメージを使用して Dev Box Service をデプロイする Azure にデプロイする	このテンプレートは、組み込みのイメージを使用して Dev Box サービスをデプロイする方法を提供します。

Terraform (AzAPI プロバイダー) リソース定義

プロジェクトリソースの種類は、次をターゲットとする操作でデプロイできます。

リソースグループの

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.DevCenter/projects リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      azureAiServicesSettings = {
        azureAiServicesMode = "string"
      }
      catalogSettings = {
        catalogItemSyncTypes = [
          "string"
        ]
      }
      customizationSettings = {
        identities = [
          {
            identityResourceId = "string"
            identityType = "string"
          }
        ]
        userCustomizationsEnableStatus = "string"
      }
      description = "string"
      devBoxAutoDeleteSettings = {
        deleteMode = "string"
        gracePeriod = "string"
        inactiveThreshold = "string"
      }
      devCenterId = "string"
      displayName = "string"
      maxDevBoxesPerUser = int
      serverlessGpuSessionsSettings = {
        maxConcurrentSessionsPerProject = int
        serverlessGpuSessionsMode = "string"
      }
      workspaceStorageSettings = {
        workspaceStorageMode = "string"
      }
    }
  }
}

プロパティ値

Microsoft.DevCenter/プロジェクト

名前	形容	価値
同一性	マネージド ID のプロパティ	ManagedServiceIdentity の
場所	リソースが存在する地理的な場所	string (必須)
名前	リソース名	糸制約：最小長 = 3 最大長 = 63 パターン = `^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$` (必須)
プロパティ	プロジェクトのプロパティ。	プロジェクトプロパティ
タグ	リソースタグ	タグ名と値のディクショナリ。
種類	リソースの種類	「Microsoft.DevCenter/projects@2025-04-01-preview」

AzureAiServices設定

名前	形容	価値
azureAiServicesMode	このプロパティは、Azure AI サービスが有効になっているかどうかを示します。	「自動デプロイ」「無効」

DevBoxAutoDelete設定

名前	形容	価値
削除モード	このプロジェクト内の Dev Box の削除モードを示します。	「オート」「マニュアル」
猶予期間	開発ボックスが削除される前に削除対象としてマークされるために必要な期間ISO8601。 ISO8601形式 PT[n]H[n]M[n]S	糸
非アクティブしきい値	ISO8601 開発ボックスが削除のスケジュールされる前に非アクティブにならないために必要な期間。 ISO8601形式 PT[n]H[n]M[n]S	糸

マネージドサービスアイデンティティ

名前	形容	価値
種類	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。	「なし」 'システム割り当て' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須)
userAssignedIdentities (ユーザー割り当て済みアイデンティティ)	リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。	UserAssignedIdentities の

ProjectCatalogSettings (プロジェクトカタログ設定)

名前	形容	価値
catalogItemSyncTypes (カタログアイテムシンクタイプ)	同期できるカタログアイテムの種類を示します。	次のいずれかを含む文字列配列: 「環境定義」 'ImageDefinition' (画像定義)

プロジェクトカスタマイズ管理アイデンティティ

名前	形容	価値
アイデンティティリソースID	例: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<リソースグループ>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。 identityType systemAssignedIdentity と相互に排他的です。	糸
アイデンティティタイプ	systemAssignedIdentity または userAssignedIdentity の値を指定できます。	'systemAssignedIdentity' 'userAssignedIdentity'

プロジェクトカスタマイズ設定

名前	形容	価値
ids	カスタマイズシナリオで使用できる ID。たとえば、リポジトリをクローンする場合などです。	ProjectCustomizationManagedIdentity[]
userCustomizationsEnableStatus	ユーザーのカスタマイズが有効になっているかどうかを示します。	「無効」「有効」

プロジェクトプロパティ

名前	形容	価値
azureAiServicesの設定	プロジェクトに対して Azure AI サービスが有効になっているかどうかを示します。	AzureAiServices設定
catalog設定	プロジェクトをカタログに関連付けるときに使用する設定。	ProjectCatalogSettings (プロジェクトカタログ設定)
customizationSettings (カスタマイズ設定)	カスタマイズに使用する設定。	プロジェクトカスタマイズ設定
形容	プロジェクトの説明。	糸
devBoxAutoDelete設定	Dev Box の自動削除設定。	DevBoxAutoDelete設定
devCenterId(デブセンターイド)	関連付けられている DevCenter のリソース ID	糸
ディスプレイ名	プロジェクトの表示名。	糸
maxDevBoxesPerUser	指定した場合、1 人のユーザーがプロジェクト内のすべてのプールで作成できる開発ボックスの最大数を制限します。これは、縮小しても既存の開発ボックスには影響しません。	int 制約：最小値 = 0
サーバーレスGpuSessionsSettings	サーバーレス GPU に使用する設定。	ServerlessGpuSessions設定
workspaceStorage設定	ワークスペースのストレージに使用する設定。	WorkspaceStorage設定

ServerlessGpuSessions設定

名前	形容	価値
maxConcurrentSessionsPerProject	指定すると、プロジェクト内のすべてのプールで同時セッションの最大数が制限されます。	int 制約：最小値 = 1
サーバーレスGpuSessionsMode	このプロパティは、プロジェクトでサーバーレス GPU アクセスが有効になっているかどうかを示します。	「自動デプロイ」「無効」

追跡リソースタグ

名前	形容	価値

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

名前	形容	価値

ユーザー割り当て識別子

名前	形容	価値

WorkspaceStorage設定

名前	形容	価値
ワークスペースストレージモード	ワークスペースストレージが有効になっているかどうかを示します。	「自動デプロイ」「無効」

次の方法で共有

Microsoft.DevCenter プロジェクト

Bicep リソース定義

リソースの形式

プロパティ値

Microsoft.DevCenter/プロジェクト

AzureAiServices設定

DevBoxAutoDelete設定

マネージドサービスアイデンティティ

ProjectCatalogSettings (プロジェクトカタログ設定)

プロジェクトカスタマイズ管理アイデンティティ

プロジェクトカスタマイズ設定

プロジェクトプロパティ

ServerlessGpuSessions設定

追跡リソースタグ

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

ユーザー割り当て識別子

WorkspaceStorage設定

使用例

Azure クイック スタートのサンプル

ARM テンプレート リソース定義

リソースの形式

プロパティ値

Microsoft.DevCenter/プロジェクト

AzureAiServices設定

DevBoxAutoDelete設定

マネージドサービスアイデンティティ

ProjectCatalogSettings (プロジェクトカタログ設定)

プロジェクトカスタマイズ管理アイデンティティ

プロジェクトカスタマイズ設定

プロジェクトプロパティ

ServerlessGpuSessions設定

追跡リソースタグ

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

ユーザー割り当て識別子

WorkspaceStorage設定

使用例

Azure クイック スタート テンプレート

Terraform (AzAPI プロバイダー) リソース定義

リソースの形式

プロパティ値

Microsoft.DevCenter/プロジェクト

AzureAiServices設定

DevBoxAutoDelete設定

マネージドサービスアイデンティティ

ProjectCatalogSettings (プロジェクトカタログ設定)

プロジェクトカスタマイズ管理アイデンティティ

プロジェクトカスタマイズ設定

プロジェクトプロパティ

ServerlessGpuSessions設定

追跡リソースタグ

UserAssignedIdentities (ユーザー割り当てアイデンティティ)

ユーザー割り当て識別子

WorkspaceStorage設定

フィードバック

その他のリソース

Azure クイックスタートのサンプル

ARM テンプレートリソース定義

Azure クイックスタートテンプレート