Microsoft.DevCenter 專案/集區
Bicep 資源定義
專案/集區資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.DevCenter/projects/pools 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.DevCenter/projects/pools@2024-10-01-preview' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
devBoxDefinition: {
imageReference: {
id: 'string'
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
}
devBoxDefinitionName: 'string'
devBoxDefinitionType: 'string'
displayName: 'string'
licenseType: 'string'
localAdministrator: 'string'
managedVirtualNetworkRegions: [
'string'
]
networkConnectionName: 'string'
singleSignOnStatus: 'string'
stopOnDisconnect: {
gracePeriodMinutes: int
status: 'string'
}
stopOnNoConnect: {
gracePeriodMinutes: int
status: 'string'
}
virtualNetworkType: 'string'
}
tags: {
{customized property}: 'string'
}
}
屬性值
ImageReference
| 名字 | 描述 | 價值 |
|---|---|---|
| id | 映射標識碼或映像版本標識碼。 提供映像標識符時，將會使用其最新版本。 | 字串 |
Microsoft.DevCenter/projects/pools
| 名字 | 描述 | 價值 |
|---|---|---|
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 3 最大長度 = 63 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ （必要） |
| 父母 | 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。 |
類型資源的符號名稱：專案 |
| 性能 | 集區屬性 | PoolProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
PoolDevBoxDefinition
| 名字 | 描述 | 價值 |
|---|---|---|
| imageReference | 影像參考資訊。 | ImageReference |
| sku | 從集區建立之開發方塊的 SKU。 | Sku |
PoolProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| devBoxDefinition | 從這個集區建立之機器的定義。 如果 devBoxDefinitionType 是 Reference 或未提供，則會忽略。 | PoolDevBoxDefinition |
| devBoxDefinitionName | 此集區父專案中的 Dev Box 定義名稱。 如果 devBoxDefinitionType 為 Value，將會忽略。 | 字串 |
| devBoxDefinitionType | 指出集區是從現有的開發箱定義建立，還是直接提供集區。 | 'Reference' 'Value' |
| displayName | 集區的顯示名稱。 | 字串 |
| licenseType | 指定授權類型，指出呼叫端已取得即將建立之開發方塊的授權。 | 'Windows_Client' |
| localAdministrator | 指出此集區中的開發方塊擁有者是否新增為開發人員 Box 上的本機系統管理員。 | 'Disabled' 'Enabled' |
| managedVirtualNetworkRegions | 受控虛擬網路的區域（ManagedNetworkType 為 Managed 時需要）。 | string[] |
| networkConnectionName | 此集區父專案中的網路連線名稱 | 字串 |
| singleSignOnStatus | 指出是否在此集區中建立已啟用單一登錄的開發人員方塊。 也需要在租用戶上啟用單一登錄。 | 'Disabled' 'Enabled' |
| stopOnDisconnect | 停止在此集區中建立之開發方塊的中斷聯機組態設定。 | StopOnDisconnectConfiguration |
| stopOnNoConnect | 停止在此集區中建立之開發方塊的聯機組態設定。 | StopOnNoConnectConfiguration |
| virtualNetworkType | 指出集區使用由 Microsoft 或客戶提供的網路所管理的虛擬網路。 | 'Managed' 'Unmanaged' |
Sku
| 名字 | 描述 | 價值 |
|---|---|---|
| 能力 | 如果 SKU 支援相應放大/縮小，則應該包含容量整數。 如果資源無法相應放大/縮小，可能會省略此專案。 | int |
| 家庭 | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| 名字 | SKU 的名稱。 例如 P3。 通常是字母+數位碼 | 字串 （必要） |
| 大小 | SKU 大小。 當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。 | 字串 |
| 層 | 如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。 | 'Basic' 'Free' 'Premium' 'Standard' |
StopOnDisconnectConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| gracePeriodMinutes | 偵測到中斷連線之後，在停止開發方塊之前所要等候的指定時間。 | int |
| 地位 | 啟用寬限期后，是否要在中斷連線時停止開發方塊的功能。 | 'Disabled' 'Enabled' |
StopOnNoConnectConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| gracePeriodMinutes | 如果未建立任何連線，則會在停止開發方塊之前等候的指定時間。 | int |
| 地位 | 啟用此功能在未連線到時停止啟動的開發方塊，一旦寬限期結束。 | 'Disabled' 'Enabled' |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
快速入門範例
下列快速入門範例會部署此資源類型。
| 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/pools 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.DevCenter/projects/pools",
"apiVersion": "2024-10-01-preview",
"name": "string",
"location": "string",
"properties": {
"devBoxDefinition": {
"imageReference": {
"id": "string"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
}
},
"devBoxDefinitionName": "string",
"devBoxDefinitionType": "string",
"displayName": "string",
"licenseType": "string",
"localAdministrator": "string",
"managedVirtualNetworkRegions": [ "string" ],
"networkConnectionName": "string",
"singleSignOnStatus": "string",
"stopOnDisconnect": {
"gracePeriodMinutes": "int",
"status": "string"
},
"stopOnNoConnect": {
"gracePeriodMinutes": "int",
"status": "string"
},
"virtualNetworkType": "string"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
ImageReference
| 名字 | 描述 | 價值 |
|---|---|---|
| id | 映射標識碼或映像版本標識碼。 提供映像標識符時，將會使用其最新版本。 | 字串 |
Microsoft.DevCenter/projects/pools
| 名字 | 描述 | 價值 |
|---|---|---|
| apiVersion | API 版本 | '2024-10-01-preview' |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 3 最大長度 = 63 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ （必要） |
| 性能 | 集區屬性 | PoolProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 類型 | 資源類型 | 'Microsoft.DevCenter/projects/pools' |
PoolDevBoxDefinition
| 名字 | 描述 | 價值 |
|---|---|---|
| imageReference | 影像參考資訊。 | ImageReference |
| sku | 從集區建立之開發方塊的 SKU。 | Sku |
PoolProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| devBoxDefinition | 從這個集區建立之機器的定義。 如果 devBoxDefinitionType 是 Reference 或未提供，則會忽略。 | PoolDevBoxDefinition |
| devBoxDefinitionName | 此集區父專案中的 Dev Box 定義名稱。 如果 devBoxDefinitionType 為 Value，將會忽略。 | 字串 |
| devBoxDefinitionType | 指出集區是從現有的開發箱定義建立，還是直接提供集區。 | 'Reference' 'Value' |
| displayName | 集區的顯示名稱。 | 字串 |
| licenseType | 指定授權類型，指出呼叫端已取得即將建立之開發方塊的授權。 | 'Windows_Client' |
| localAdministrator | 指出此集區中的開發方塊擁有者是否新增為開發人員 Box 上的本機系統管理員。 | 'Disabled' 'Enabled' |
| managedVirtualNetworkRegions | 受控虛擬網路的區域（ManagedNetworkType 為 Managed 時需要）。 | string[] |
| networkConnectionName | 此集區父專案中的網路連線名稱 | 字串 |
| singleSignOnStatus | 指出是否在此集區中建立已啟用單一登錄的開發人員方塊。 也需要在租用戶上啟用單一登錄。 | 'Disabled' 'Enabled' |
| stopOnDisconnect | 停止在此集區中建立之開發方塊的中斷聯機組態設定。 | StopOnDisconnectConfiguration |
| stopOnNoConnect | 停止在此集區中建立之開發方塊的聯機組態設定。 | StopOnNoConnectConfiguration |
| virtualNetworkType | 指出集區使用由 Microsoft 或客戶提供的網路所管理的虛擬網路。 | 'Managed' 'Unmanaged' |
Sku
| 名字 | 描述 | 價值 |
|---|---|---|
| 能力 | 如果 SKU 支援相應放大/縮小，則應該包含容量整數。 如果資源無法相應放大/縮小，可能會省略此專案。 | int |
| 家庭 | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| 名字 | SKU 的名稱。 例如 P3。 通常是字母+數位碼 | 字串 （必要） |
| 大小 | SKU 大小。 當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。 | 字串 |
| 層 | 如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。 | 'Basic' 'Free' 'Premium' 'Standard' |
StopOnDisconnectConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| gracePeriodMinutes | 偵測到中斷連線之後，在停止開發方塊之前所要等候的指定時間。 | int |
| 地位 | 啟用寬限期后，是否要在中斷連線時停止開發方塊的功能。 | 'Disabled' 'Enabled' |
StopOnNoConnectConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| gracePeriodMinutes | 如果未建立任何連線，則會在停止開發方塊之前等候的指定時間。 | int |
| 地位 | 啟用此功能在未連線到時停止啟動的開發方塊，一旦寬限期結束。 | 'Disabled' 'Enabled' |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
設定開發箱服務
|
此範本會根據 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/pools 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevCenter/projects/pools@2024-10-01-preview"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
devBoxDefinition = {
imageReference = {
id = "string"
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
devBoxDefinitionName = "string"
devBoxDefinitionType = "string"
displayName = "string"
licenseType = "string"
localAdministrator = "string"
managedVirtualNetworkRegions = [
"string"
]
networkConnectionName = "string"
singleSignOnStatus = "string"
stopOnDisconnect = {
gracePeriodMinutes = int
status = "string"
}
stopOnNoConnect = {
gracePeriodMinutes = int
status = "string"
}
virtualNetworkType = "string"
}
})
}
屬性值
ImageReference
| 名字 | 描述 | 價值 |
|---|---|---|
| id | 映射標識碼或映像版本標識碼。 提供映像標識符時，將會使用其最新版本。 | 字串 |
Microsoft.DevCenter/projects/pools
| 名字 | 描述 | 價值 |
|---|---|---|
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最小長度 = 3 最大長度 = 63 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ （必要） |
| parent_id | 此資源為父系之資源的標識碼。 | 類型的資源標識碼：專案 |
| 性能 | 集區屬性 | PoolProperties |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 |
| 類型 | 資源類型 | “Microsoft.DevCenter/projects/pools@2024-10-01-preview” |
PoolDevBoxDefinition
| 名字 | 描述 | 價值 |
|---|---|---|
| imageReference | 影像參考資訊。 | ImageReference |
| sku | 從集區建立之開發方塊的 SKU。 | Sku |
PoolProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| devBoxDefinition | 從這個集區建立之機器的定義。 如果 devBoxDefinitionType 是 Reference 或未提供，則會忽略。 | PoolDevBoxDefinition |
| devBoxDefinitionName | 此集區父專案中的 Dev Box 定義名稱。 如果 devBoxDefinitionType 為 Value，將會忽略。 | 字串 |
| devBoxDefinitionType | 指出集區是從現有的開發箱定義建立，還是直接提供集區。 | 'Reference' 'Value' |
| displayName | 集區的顯示名稱。 | 字串 |
| licenseType | 指定授權類型，指出呼叫端已取得即將建立之開發方塊的授權。 | 'Windows_Client' |
| localAdministrator | 指出此集區中的開發方塊擁有者是否新增為開發人員 Box 上的本機系統管理員。 | 'Disabled' 'Enabled' |
| managedVirtualNetworkRegions | 受控虛擬網路的區域（ManagedNetworkType 為 Managed 時需要）。 | string[] |
| networkConnectionName | 此集區父專案中的網路連線名稱 | 字串 |
| singleSignOnStatus | 指出是否在此集區中建立已啟用單一登錄的開發人員方塊。 也需要在租用戶上啟用單一登錄。 | 'Disabled' 'Enabled' |
| stopOnDisconnect | 停止在此集區中建立之開發方塊的中斷聯機組態設定。 | StopOnDisconnectConfiguration |
| stopOnNoConnect | 停止在此集區中建立之開發方塊的聯機組態設定。 | StopOnNoConnectConfiguration |
| virtualNetworkType | 指出集區使用由 Microsoft 或客戶提供的網路所管理的虛擬網路。 | 'Managed' 'Unmanaged' |
Sku
| 名字 | 描述 | 價值 |
|---|---|---|
| 能力 | 如果 SKU 支援相應放大/縮小，則應該包含容量整數。 如果資源無法相應放大/縮小，可能會省略此專案。 | int |
| 家庭 | 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 | 字串 |
| 名字 | SKU 的名稱。 例如 P3。 通常是字母+數位碼 | 字串 （必要） |
| 大小 | SKU 大小。 當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。 | 字串 |
| 層 | 如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。 | 'Basic' 'Free' 'Premium' 'Standard' |
StopOnDisconnectConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| gracePeriodMinutes | 偵測到中斷連線之後，在停止開發方塊之前所要等候的指定時間。 | int |
| 地位 | 啟用寬限期后，是否要在中斷連線時停止開發方塊的功能。 | 'Disabled' 'Enabled' |
StopOnNoConnectConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| gracePeriodMinutes | 如果未建立任何連線，則會在停止開發方塊之前等候的指定時間。 | int |
| 地位 | 啟用此功能在未連線到時停止啟動的開發方塊，一旦寬限期結束。 | 'Disabled' 'Enabled' |
TrackedResourceTags
| 名字 | 描述 | 價值 |
|---|