Microsoft.DevCenter devcenters

發行項
2025-05-08

Bicep 資源定義

devcenters 資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DevCenter/devcenters 資源，請將下列 Bicep 新增至您的範本。

resource symbolicname 'Microsoft.DevCenter/devcenters@2025-04-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    devBoxProvisioningSettings: {
      installAzureMonitorAgentEnableStatus: 'string'
    }
    displayName: 'string'
    encryption: {
      customerManagedKeyEncryption: {
        keyEncryptionKeyIdentity: {
          delegatedIdentityClientId: 'string'
          identityType: 'string'
          userAssignedIdentityResourceId: 'string'
        }
        keyEncryptionKeyUrl: 'string'
      }
    }
    networkSettings: {
      microsoftHostedNetworkEnableStatus: 'string'
    }
    projectCatalogSettings: {
      catalogItemSyncEnableStatus: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

屬性值

CustomerManagedKeyEncryption

名字	描述	價值
keyEncryptionKeyIdentity	客戶管理的金鑰設定的所有身分識別組態，定義應用來驗證 Key Vault 的身分識別。	CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl	金鑰加密金鑰 URL、版本設定或非版本設定。例如：https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 或 https://contosovault.vault.azure.net/keys/contosokek。	字串

CustomerManagedKeyEncryptionKeyIdentity

名字	描述	價值
委託身份ClientId	用來存取金鑰加密金鑰 URL 的委派身分識別。例如：/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<資源群組>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。與 identityType systemAssignedIdentity 和 userAssignedIdentity 互斥 - 僅供內部使用。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
身份類型	值可以是 systemAssignedIdentity 或 userAssignedIdentity	“委託資源標識” 'systemAssignedIdentity' 'userAssignedIdentity'
userAssignedIdentityResourceId	使用者指派的身分識別可用來存取金鑰加密金鑰 URL。例如：/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<資源群組>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。與 identityType systemAssignedIdentity 和 delegatedResourceIdentity 互斥。	字串

DevBoxProvisioningSettings

名字	描述	價值
installAzureMonitorAgentEnableStatus	是否可以將此開發人員中心與專案相關聯的專案目錄設定為同步目錄專案。	'Disabled' 'Enabled'

DevCenterNetwork設置

名字	描述	價值
microsoftHostedNetworkEnableStatus	指出此開發人員中心中的集區是否可以使用 Microsoft 託管網路。如果未設定，則預設為 [已啟用]。	'Disabled' 'Enabled'

DevCenterProjectCatalog設置

名字	描述	價值
catalogItemSyncEnableStatus	是否可以將此開發人員中心與專案相關聯的專案目錄設定為同步目錄專案。	'Disabled' 'Enabled'

DevCenterProperties

名字	描述	價值
devBoxProvisioningSettings	要用於布建屬於此開發人員中心之所有開發人員方塊的設定。	DevBoxProvisioningSettings
顯示名稱	devcenter 的顯示名稱。	字串
加密	用於專屬內容的伺服器端加密加密設定（例如目錄、記錄、自定義）。	加密
網路設置	將在與開發人員中心相關聯的網路資源上強制執行的網路設定。	DevCenterNetwork設置
projectCatalog設置	將專案與目錄產生關聯時要使用的開發人員中心設定。	DevCenterProjectCatalog設置

加密

名字	描述	價值
customerManagedKeyEncryption	資源的所有客戶自控金鑰加密屬性。	CustomerManagedKeyEncryption

ManagedServiceIdentity

名字	描述	價值
類型	受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。	“無” “系統分配” 'SystemAssigned， UserAssigned' 'UserAssigned' （必要）
使用者指派的身份	與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。	UserAssignedIdentities

Microsoft.DevCenter/devcenters

名字	描述	價值
身份	受控識別屬性	ManagedServiceIdentity
位置	資源所在的地理位置	字串（必要）
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 26 模式 = `^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$` （必要）
性能	DevCenter 屬性	DevCenterProperties
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤

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 樣本資源定義

devcenters 資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DevCenter/devcenters 資源，請將下列 JSON 新增至範本。

{
  "type": "Microsoft.DevCenter/devcenters",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "devBoxProvisioningSettings": {
      "installAzureMonitorAgentEnableStatus": "string"
    },
    "displayName": "string",
    "encryption": {
      "customerManagedKeyEncryption": {
        "keyEncryptionKeyIdentity": {
          "delegatedIdentityClientId": "string",
          "identityType": "string",
          "userAssignedIdentityResourceId": "string"
        },
        "keyEncryptionKeyUrl": "string"
      }
    },
    "networkSettings": {
      "microsoftHostedNetworkEnableStatus": "string"
    },
    "projectCatalogSettings": {
      "catalogItemSyncEnableStatus": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

CustomerManagedKeyEncryption

名字	描述	價值
keyEncryptionKeyIdentity	客戶管理的金鑰設定的所有身分識別組態，定義應用來驗證 Key Vault 的身分識別。	CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl	金鑰加密金鑰 URL、版本設定或非版本設定。例如：https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 或 https://contosovault.vault.azure.net/keys/contosokek。	字串

CustomerManagedKeyEncryptionKeyIdentity

名字	描述	價值
委託身份ClientId	用來存取金鑰加密金鑰 URL 的委派身分識別。例如：/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<資源群組>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。與 identityType systemAssignedIdentity 和 userAssignedIdentity 互斥 - 僅供內部使用。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
身份類型	值可以是 systemAssignedIdentity 或 userAssignedIdentity	“委託資源標識” 'systemAssignedIdentity' 'userAssignedIdentity'
userAssignedIdentityResourceId	使用者指派的身分識別可用來存取金鑰加密金鑰 URL。例如：/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<資源群組>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。與 identityType systemAssignedIdentity 和 delegatedResourceIdentity 互斥。	字串

DevBoxProvisioningSettings

名字	描述	價值
installAzureMonitorAgentEnableStatus	是否可以將此開發人員中心與專案相關聯的專案目錄設定為同步目錄專案。	'Disabled' 'Enabled'

DevCenterNetwork設置

名字	描述	價值
microsoftHostedNetworkEnableStatus	指出此開發人員中心中的集區是否可以使用 Microsoft 託管網路。如果未設定，則預設為 [已啟用]。	'Disabled' 'Enabled'

DevCenterProjectCatalog設置

名字	描述	價值
catalogItemSyncEnableStatus	是否可以將此開發人員中心與專案相關聯的專案目錄設定為同步目錄專案。	'Disabled' 'Enabled'

DevCenterProperties

名字	描述	價值
devBoxProvisioningSettings	要用於布建屬於此開發人員中心之所有開發人員方塊的設定。	DevBoxProvisioningSettings
顯示名稱	devcenter 的顯示名稱。	字串
加密	用於專屬內容的伺服器端加密加密設定（例如目錄、記錄、自定義）。	加密
網路設置	將在與開發人員中心相關聯的網路資源上強制執行的網路設定。	DevCenterNetwork設置
projectCatalog設置	將專案與目錄產生關聯時要使用的開發人員中心設定。	DevCenterProjectCatalog設置

加密

名字	描述	價值
customerManagedKeyEncryption	資源的所有客戶自控金鑰加密屬性。	CustomerManagedKeyEncryption

ManagedServiceIdentity

名字	描述	價值
類型	受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。	“無” “系統分配” 'SystemAssigned， UserAssigned' 'UserAssigned' （必要）
使用者指派的身份	與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。	UserAssignedIdentities

Microsoft.DevCenter/devcenters

名字	描述	價值
apiVersion	API 版本	'2025-04-01-preview'
身份	受控識別屬性	ManagedServiceIdentity
位置	資源所在的地理位置	字串（必要）
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 26 模式 = `^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$` （必要）
性能	DevCenter 屬性	DevCenterProperties
標籤	資源標籤	標記名稱和值的字典。請參閱範本中的標籤
類型	資源類型	“Microsoft.DevCenter/devcenters”

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 提供者）資源定義

devcenters 資源類型可以使用目標作業來部署：

資源群組

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DevCenter/devcenters 資源，請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      devBoxProvisioningSettings = {
        installAzureMonitorAgentEnableStatus = "string"
      }
      displayName = "string"
      encryption = {
        customerManagedKeyEncryption = {
          keyEncryptionKeyIdentity = {
            delegatedIdentityClientId = "string"
            identityType = "string"
            userAssignedIdentityResourceId = "string"
          }
          keyEncryptionKeyUrl = "string"
        }
      }
      networkSettings = {
        microsoftHostedNetworkEnableStatus = "string"
      }
      projectCatalogSettings = {
        catalogItemSyncEnableStatus = "string"
      }
    }
  }
}

屬性值

CustomerManagedKeyEncryption

名字	描述	價值
keyEncryptionKeyIdentity	客戶管理的金鑰設定的所有身分識別組態，定義應用來驗證 Key Vault 的身分識別。	CustomerManagedKeyEncryptionKeyIdentity
keyEncryptionKeyUrl	金鑰加密金鑰 URL、版本設定或非版本設定。例如：https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 或 https://contosovault.vault.azure.net/keys/contosokek。	字串

CustomerManagedKeyEncryptionKeyIdentity

名字	描述	價值
委託身份ClientId	用來存取金鑰加密金鑰 URL 的委派身分識別。例如：/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<資源群組>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。與 identityType systemAssignedIdentity 和 userAssignedIdentity 互斥 - 僅供內部使用。	字串約束：最小長度 = 36 最大長度 = 36 Pattern = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
身份類型	值可以是 systemAssignedIdentity 或 userAssignedIdentity	“委託資源標識” 'systemAssignedIdentity' 'userAssignedIdentity'
userAssignedIdentityResourceId	使用者指派的身分識別可用來存取金鑰加密金鑰 URL。例如：/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<資源群組>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId。與 identityType systemAssignedIdentity 和 delegatedResourceIdentity 互斥。	字串

DevBoxProvisioningSettings

名字	描述	價值
installAzureMonitorAgentEnableStatus	是否可以將此開發人員中心與專案相關聯的專案目錄設定為同步目錄專案。	'Disabled' 'Enabled'

DevCenterNetwork設置

名字	描述	價值
microsoftHostedNetworkEnableStatus	指出此開發人員中心中的集區是否可以使用 Microsoft 託管網路。如果未設定，則預設為 [已啟用]。	'Disabled' 'Enabled'

DevCenterProjectCatalog設置

名字	描述	價值
catalogItemSyncEnableStatus	是否可以將此開發人員中心與專案相關聯的專案目錄設定為同步目錄專案。	'Disabled' 'Enabled'

DevCenterProperties

名字	描述	價值
devBoxProvisioningSettings	要用於布建屬於此開發人員中心之所有開發人員方塊的設定。	DevBoxProvisioningSettings
顯示名稱	devcenter 的顯示名稱。	字串
加密	用於專屬內容的伺服器端加密加密設定（例如目錄、記錄、自定義）。	加密
網路設置	將在與開發人員中心相關聯的網路資源上強制執行的網路設定。	DevCenterNetwork設置
projectCatalog設置	將專案與目錄產生關聯時要使用的開發人員中心設定。	DevCenterProjectCatalog設置

加密

名字	描述	價值
customerManagedKeyEncryption	資源的所有客戶自控金鑰加密屬性。	CustomerManagedKeyEncryption

ManagedServiceIdentity

名字	描述	價值
類型	受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。	“無” “系統分配” 'SystemAssigned， UserAssigned' 'UserAssigned' （必要）
使用者指派的身份	與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。	UserAssignedIdentities

Microsoft.DevCenter/devcenters

名字	描述	價值
身份	受控識別屬性	ManagedServiceIdentity
位置	資源所在的地理位置	字串（必要）
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 26 模式 = `^[a-zA-Z0-9][a-zA-Z0-9-]{2,25}$` （必要）
性能	DevCenter 屬性	DevCenterProperties
標籤	資源標籤	標記名稱和值的字典。
類型	資源類型	“Microsoft.DevCenter/devcenters@2025-04-01-preview”

TrackedResourceTags

名字	描述	價值

UserAssignedIdentities

名字	描述	價值

UserAssignedIdentity

名字	描述	價值

使用範例

Azure 已驗證的模組

下列 Azure 驗證模組可用來部署此資源類型。

模組	描述
開發人員中心	開發人員中心的AVM資源模組

共用方式為

Microsoft.DevCenter devcenters

Bicep 資源定義

資源格式

屬性值

CustomerManagedKeyEncryption

CustomerManagedKeyEncryptionKeyIdentity

DevBoxProvisioningSettings

DevCenterNetwork設置

DevCenterProjectCatalog設置

DevCenterProperties

加密

ManagedServiceIdentity

Microsoft.DevCenter/devcenters

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

使用範例

Azure 快速入門範例

ARM 樣本資源定義

資源格式

屬性值

CustomerManagedKeyEncryption

CustomerManagedKeyEncryptionKeyIdentity

DevBoxProvisioningSettings

DevCenterNetwork設置

DevCenterProjectCatalog設置

DevCenterProperties

加密

ManagedServiceIdentity

Microsoft.DevCenter/devcenters

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

使用範例

Azure 快速入門範本

Terraform （AzAPI 提供者） 資源定義

資源格式

屬性值

CustomerManagedKeyEncryption

CustomerManagedKeyEncryptionKeyIdentity

DevBoxProvisioningSettings

DevCenterNetwork設置

DevCenterProjectCatalog設置

DevCenterProperties

加密

ManagedServiceIdentity

Microsoft.DevCenter/devcenters

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

使用範例

Azure 已驗證的模組

意見反應

其他資源

Terraform （AzAPI 提供者）資源定義