Microsoft.DevCenter 專案 2024-06-01-preview
Bicep 資源定義
專案資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DevCenter/projects 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.DevCenter/projects@2024-06-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
catalogSettings: {
catalogItemSyncTypes: [
'string'
]
}
description: 'string'
devCenterId: 'string'
displayName: 'string'
maxDevBoxesPerUser: int
}
tags: {
{customized property}: 'string'
}
}
屬性值
ManagedServiceIdentity
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。 | 'None' 'SystemAssigned' 'SystemAssigned， UserAssigned' 'UserAssigned' （必要） |
| userAssignedIdentities | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件（{}）。 | UserAssignedIdentities |
Microsoft.DevCenter/projects
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 受控識別屬性 | ManagedServiceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 3 最大長度 = 63 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ （必要） |
| 性能 | 項目的屬性。 | ProjectProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
ProjectCatalogSettings
| 名字 | 描述 | 價值 |
|---|---|---|
| catalogItemSyncTypes | 指出可以同步處理的目錄項目類型。 | 包含任何的字串數組： 'EnvironmentDefinition' 'ImageDefinition' |
ProjectProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| catalogSettings | 將專案與目錄產生關聯時要使用的設定。 | ProjectCatalogSettings |
| 描述 | 專案的描述。 | 字串 |
| devCenterId | 相關聯DevCenter的資源標識碼 | 字串 |
| displayName | 項目的顯示名稱。 | 字串 |
| maxDevBoxesPerUser | 指定時，限制單一使用者可以在專案中所有集區中建立的開發方塊數目上限。 當減少時，這不會影響現有的開發方塊。 | int 約束： 最小值 = 0 |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
UserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
UserAssignedIdentity
| 名字 | 描述 | 價值 |
|---|
使用範例
Azure 快速入門範例
下列 Azure 快速入門範本 包含用於部署此資源類型的 Bicep 範例。
| Bicep 檔案 | 描述 |
|---|---|
| 設定部署環境服務 | 此範本提供設定部署環境的方式。 |
| 設定開發箱服務 | 此範本會根據 Dev Box 快速入門指南 （/azure/dev-box/quickstart-create-dev-box） 建立所有 Dev Box 管理員資源。 您可以檢視所有建立的資源，或直接移至 DevPortal.microsoft.com 來建立您的第一個開發方塊。 |
| 使用內建映射部署 Dev Box Service | 此範本提供使用內建映射部署Dev Box服務的方式。 |
ARM 樣本資源定義
專案資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DevCenter/projects 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.DevCenter/projects",
"apiVersion": "2024-06-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"catalogSettings": {
"catalogItemSyncTypes": [ "string" ]
},
"description": "string",
"devCenterId": "string",
"displayName": "string",
"maxDevBoxesPerUser": "int"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
ManagedServiceIdentity
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。 | 'None' 'SystemAssigned' 'SystemAssigned， UserAssigned' 'UserAssigned' （必要） |
| userAssignedIdentities | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件（{}）。 | UserAssignedIdentities |
Microsoft.DevCenter/projects
| 名字 | 描述 | 價值 |
|---|---|---|
| apiVersion | API 版本 | '2024-06-01-preview' |
| 身份 | 受控識別屬性 | ManagedServiceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 3 最大長度 = 63 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ （必要） |
| 性能 | 項目的屬性。 | ProjectProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 類型 | 資源類型 | 'Microsoft.DevCenter/projects' |
ProjectCatalogSettings
| 名字 | 描述 | 價值 |
|---|---|---|
| catalogItemSyncTypes | 指出可以同步處理的目錄項目類型。 | 包含任何的字串數組： 'EnvironmentDefinition' 'ImageDefinition' |
ProjectProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| catalogSettings | 將專案與目錄產生關聯時要使用的設定。 | ProjectCatalogSettings |
| 描述 | 專案的描述。 | 字串 |
| devCenterId | 相關聯DevCenter的資源標識碼 | 字串 |
| displayName | 項目的顯示名稱。 | 字串 |
| maxDevBoxesPerUser | 指定時，限制單一使用者可以在專案中所有集區中建立的開發方塊數目上限。 當減少時，這不會影響現有的開發方塊。 | int 約束： 最小值 = 0 |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
UserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
UserAssignedIdentity
| 名字 | 描述 | 價值 |
|---|
使用範例
Azure 快速入門範本
下列 Azure 快速入門範本 部署此資源類型。
| 範本 | 描述 |
|---|---|
設定部署環境服務
|
此範本提供設定部署環境的方式。 |
|
設定開發箱服務
|
此範本會根據 Dev Box 快速入門指南 （/azure/dev-box/quickstart-create-dev-box） 建立所有 Dev Box 管理員資源。 您可以檢視所有建立的資源，或直接移至 DevPortal.microsoft.com 來建立您的第一個開發方塊。 |
|
使用內建映射部署 Dev Box Service
|
此範本提供使用內建映射部署Dev Box服務的方式。 |
Terraform （AzAPI 提供者） 資源定義
專案資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DevCenter/projects 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevCenter/projects@2024-06-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
catalogSettings = {
catalogItemSyncTypes = [
"string"
]
}
description = "string"
devCenterId = "string"
displayName = "string"
maxDevBoxesPerUser = int
}
})
}
屬性值
ManagedServiceIdentity
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。 | 'None' 'SystemAssigned' 'SystemAssigned， UserAssigned' 'UserAssigned' （必要） |
| userAssignedIdentities | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件（{}）。 | UserAssignedIdentities |
Microsoft.DevCenter/projects
| 名字 | 描述 | 價值 |
|---|---|---|
| 身份 | 受控識別屬性 | ManagedServiceIdentity |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 3 最大長度 = 63 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ （必要） |
| 性能 | 項目的屬性。 | ProjectProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 |
| 類型 | 資源類型 | “Microsoft.DevCenter/projects@2024-06-01-preview” |
ProjectCatalogSettings
| 名字 | 描述 | 價值 |
|---|---|---|
| catalogItemSyncTypes | 指出可以同步處理的目錄項目類型。 | 包含任何的字串數組： 'EnvironmentDefinition' 'ImageDefinition' |
ProjectProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| catalogSettings | 將專案與目錄產生關聯時要使用的設定。 | ProjectCatalogSettings |
| 描述 | 專案的描述。 | 字串 |
| devCenterId | 相關聯DevCenter的資源標識碼 | 字串 |
| displayName | 項目的顯示名稱。 | 字串 |
| maxDevBoxesPerUser | 指定時，限制單一使用者可以在專案中所有集區中建立的開發方塊數目上限。 當減少時，這不會影響現有的開發方塊。 | int 約束： 最小值 = 0 |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
UserAssignedIdentities
| 名字 | 描述 | 價值 |
|---|
UserAssignedIdentity
| 名字 | 描述 | 價值 |
|---|