Microsoft.Compute 資源庫/images 2021-07-01
Bicep 資源定義
資源庫/映射資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Compute/galleries/images 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.Compute/galleries/images@2021-07-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
description: 'string'
disallowed: {
diskTypes: [
'string'
]
}
endOfLifeDate: 'string'
eula: 'string'
features: [
{
name: 'string'
value: 'string'
}
]
hyperVGeneration: 'string'
identifier: {
offer: 'string'
publisher: 'string'
sku: 'string'
}
osState: 'string'
osType: 'string'
privacyStatementUri: 'string'
purchasePlan: {
name: 'string'
product: 'string'
publisher: 'string'
}
recommended: {
memory: {
max: int
min: int
}
vCPUs: {
max: int
min: int
}
}
releaseNoteUri: 'string'
}
}
屬性值
galleries/images
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 資源名稱 請參閱如何在 Bicep 中設定子資源的名稱和類型。 |
字串 （必要） 字元限制：1-80 合法字元： 英數位元、底線、連字元和句號。 以英數位元開頭和結尾。 |
| 位置 | 資源位置 | 字串 （必要） |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 父母 | 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。 |
類型的資源符號名稱：資源庫 |
| 性能 | 描述資源庫映像定義的屬性。 | GalleryImageProperties |
GalleryImageProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 描述 | 此資源庫映像定義資源的描述。 這個屬性是可更新的。 | 字串 |
| 禁止 | 描述不允許的磁碟類型。 | 不允許的 |
| endOfLifeDate | 資源庫映像定義的生命週期結束日期。 這個屬性可用於解除委任用途。 這個屬性是可更新的。 | 字串 |
| eula | 資源庫映像定義的 Eula 合約。 | 字串 |
| 特徵 | 資源庫映像功能的清單。 | GalleryImageFeature[] |
| hyperVGeneration | 虛擬機的 Hypervisor 產生。 僅適用於OS磁碟。 | 'V1' 'V2' |
| 標識碼 | 這是資源庫映像定義標識碼。 | GalleryImageIdentifier （必要） |
| osState | 此屬性可讓使用者指定在此映射下建立的虛擬機是「一般化」或「特製化」。 | 'Generalized' '特製化' （必要） |
| osType | 這個屬性可讓您指定從受控映射建立 VM 時，磁碟中包含的 OS 類型。 可能的值為： Windows Linux |
'Linux' 'Windows' （必要） |
| privacyStatementUri | 隱私聲明 URI。 | 字串 |
| purchasePlan | 描述資源庫映像定義購買方案。 Marketplace 映射會使用此映像。 | ImagePurchasePlan |
| 推薦 | 這些屬性描述此映像定義的建議機器組態。 這些屬性是可更新的。 | RecommendedMachineConfiguration |
| releaseNoteUri | 版本附註 URI。 | 字串 |
禁止
| 名字 | 描述 | 價值 |
|---|---|---|
| diskTypes | 磁碟類型的清單。 | string[] |
GalleryImageFeature
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 資源庫映像功能的名稱。 | 字串 |
| 價值 | 資源庫映像功能的值。 | 字串 |
GalleryImageIdentifier
| 名字 | 描述 | 價值 |
|---|---|---|
| 提供 | 資源庫映像定義供應項目的名稱。 | 字串 （必要） |
| 發行人 | 資源庫映像定義發行者的名稱。 | 字串 （必要） |
| sku | 資源庫映像定義 SKU 的名稱。 | 字串 （必要） |
ImagePurchasePlan
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 方案標識碼。 | 字串 |
| 產品 | 產品標識碼。 | 字串 |
| 發行人 | 發行者標識碼。 | 字串 |
RecommendedMachineConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| 記憶 | 描述資源範圍。 | ResourceRange |
| vCPU | 描述資源範圍。 | ResourceRange |
ResourceRange
| 名字 | 描述 | 價值 |
|---|---|---|
| 麥克斯 | 資源的最大數目。 | int |
| min | 資源數目下限。 | int |
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
使用 Azure Windows 基準 
|
建立 Azure Image Builder 環境，並建置已套用最新 Windows Update 和 Azure Windows 基準的 Windows Server 映射。 |
|
在 Azure 計算資源庫中建立映像定義
|
此範本可讓您在 Azure 計算資源庫中建立簡單的映像定義。 部署此專案之前，請確定您已執行共用映像庫 101 範本。 |
|
設定開發箱服務
|
此範本會根據 Dev Box 快速入門指南建立所有 Dev Box 系統管理員資源（https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box）。 您可以檢視所有建立的資源，或直接移至 DevPortal.microsoft.com 來建立您的第一個開發方塊。 |
ARM 樣本資源定義
資源庫/映射資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Compute/galleries/images 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.Compute/galleries/images",
"apiVersion": "2021-07-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"description": "string",
"disallowed": {
"diskTypes": [ "string" ]
},
"endOfLifeDate": "string",
"eula": "string",
"features": [
{
"name": "string",
"value": "string"
}
],
"hyperVGeneration": "string",
"identifier": {
"offer": "string",
"publisher": "string",
"sku": "string"
},
"osState": "string",
"osType": "string",
"privacyStatementUri": "string",
"purchasePlan": {
"name": "string",
"product": "string",
"publisher": "string"
},
"recommended": {
"memory": {
"max": "int",
"min": "int"
},
"vCPUs": {
"max": "int",
"min": "int"
}
},
"releaseNoteUri": "string"
}
}
屬性值
galleries/images
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 資源類型 | 'Microsoft.Compute/galleries/images' |
| apiVersion | 資源 API 版本 | '2021-07-01' |
| 名字 | 資源名稱 請參閱如何在 |
字串 （必要） 字元限制：1-80 合法字元： 英數位元、底線、連字元和句號。 以英數位元開頭和結尾。 |
| 位置 | 資源位置 | 字串 （必要） |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
| 性能 | 描述資源庫映像定義的屬性。 | GalleryImageProperties |
GalleryImageProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 描述 | 此資源庫映像定義資源的描述。 這個屬性是可更新的。 | 字串 |
| 禁止 | 描述不允許的磁碟類型。 | 不允許的 |
| endOfLifeDate | 資源庫映像定義的生命週期結束日期。 這個屬性可用於解除委任用途。 這個屬性是可更新的。 | 字串 |
| eula | 資源庫映像定義的 Eula 合約。 | 字串 |
| 特徵 | 資源庫映像功能的清單。 | GalleryImageFeature[] |
| hyperVGeneration | 虛擬機的 Hypervisor 產生。 僅適用於OS磁碟。 | 'V1' 'V2' |
| 標識碼 | 這是資源庫映像定義標識碼。 | GalleryImageIdentifier （必要） |
| osState | 此屬性可讓使用者指定在此映射下建立的虛擬機是「一般化」或「特製化」。 | 'Generalized' '特製化' （必要） |
| osType | 這個屬性可讓您指定從受控映射建立 VM 時，磁碟中包含的 OS 類型。 可能的值為： Windows Linux |
'Linux' 'Windows' （必要） |
| privacyStatementUri | 隱私聲明 URI。 | 字串 |
| purchasePlan | 描述資源庫映像定義購買方案。 Marketplace 映射會使用此映像。 | ImagePurchasePlan |
| 推薦 | 這些屬性描述此映像定義的建議機器組態。 這些屬性是可更新的。 | RecommendedMachineConfiguration |
| releaseNoteUri | 版本附註 URI。 | 字串 |
禁止
| 名字 | 描述 | 價值 |
|---|---|---|
| diskTypes | 磁碟類型的清單。 | string[] |
GalleryImageFeature
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 資源庫映像功能的名稱。 | 字串 |
| 價值 | 資源庫映像功能的值。 | 字串 |
GalleryImageIdentifier
| 名字 | 描述 | 價值 |
|---|---|---|
| 提供 | 資源庫映像定義供應項目的名稱。 | 字串 （必要） |
| 發行人 | 資源庫映像定義發行者的名稱。 | 字串 （必要） |
| sku | 資源庫映像定義 SKU 的名稱。 | 字串 （必要） |
ImagePurchasePlan
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 方案標識碼。 | 字串 |
| 產品 | 產品標識碼。 | 字串 |
| 發行人 | 發行者標識碼。 | 字串 |
RecommendedMachineConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| 記憶 | 描述資源範圍。 | ResourceRange |
| vCPU | 描述資源範圍。 | ResourceRange |
ResourceRange
| 名字 | 描述 | 價值 |
|---|---|---|
| 麥克斯 | 資源的最大數目。 | int |
| min | 資源數目下限。 | int |
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
| 使用 Azure Windows 基準
|
建立 Azure Image Builder 環境，並建置已套用最新 Windows Update 和 Azure Windows 基準的 Windows Server 映射。 |
|
在 Azure 計算資源庫中建立映像定義
|
此範本可讓您在 Azure 計算資源庫中建立簡單的映像定義。 部署此專案之前，請確定您已執行共用映像庫 101 範本。 |
|
設定開發箱服務
|
此範本會根據 Dev Box 快速入門指南建立所有 Dev Box 系統管理員資源（https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box）。 您可以檢視所有建立的資源，或直接移至 DevPortal.microsoft.com 來建立您的第一個開發方塊。 |
Terraform （AzAPI 提供者） 資源定義
資源庫/映射資源類型可以使用目標作業來部署：
- 資源群組
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.Compute/galleries/images 資源，請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/images@2021-07-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
description = "string"
disallowed = {
diskTypes = [
"string"
]
}
endOfLifeDate = "string"
eula = "string"
features = [
{
name = "string"
value = "string"
}
]
hyperVGeneration = "string"
identifier = {
offer = "string"
publisher = "string"
sku = "string"
}
osState = "string"
osType = "string"
privacyStatementUri = "string"
purchasePlan = {
name = "string"
product = "string"
publisher = "string"
}
recommended = {
memory = {
max = int
min = int
}
vCPUs = {
max = int
min = int
}
}
releaseNoteUri = "string"
}
})
}
屬性值
galleries/images
| 名字 | 描述 | 價值 |
|---|---|---|
| 類型 | 資源類型 | “Microsoft.Compute/galleries/images@2021-07-01” |
| 名字 | 資源名稱 | 字串 （必要） 字元限制：1-80 合法字元： 英數位元、底線、連字元和句號。 以英數位元開頭和結尾。 |
| 位置 | 資源位置 | 字串 （必要） |
| parent_id | 此資源為父系之資源的標識碼。 | 類型的資源標識碼：資源庫 |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 |
| 性能 | 描述資源庫映像定義的屬性。 | GalleryImageProperties |
GalleryImageProperties
| 名字 | 描述 | 價值 |
|---|---|---|
| 描述 | 此資源庫映像定義資源的描述。 這個屬性是可更新的。 | 字串 |
| 禁止 | 描述不允許的磁碟類型。 | 不允許的 |
| endOfLifeDate | 資源庫映像定義的生命週期結束日期。 這個屬性可用於解除委任用途。 這個屬性是可更新的。 | 字串 |
| eula | 資源庫映像定義的 Eula 合約。 | 字串 |
| 特徵 | 資源庫映像功能的清單。 | GalleryImageFeature[] |
| hyperVGeneration | 虛擬機的 Hypervisor 產生。 僅適用於OS磁碟。 | “V1” “V2” |
| 標識碼 | 這是資源庫映像定義標識碼。 | GalleryImageIdentifier （必要） |
| osState | 此屬性可讓使用者指定在此映射下建立的虛擬機是「一般化」或「特製化」。 | “一般化” “特製化”（必要） |
| osType | 這個屬性可讓您指定從受控映射建立 VM 時，磁碟中包含的 OS 類型。 可能的值為： Windows Linux |
“Linux” “Windows” （必要） |
| privacyStatementUri | 隱私聲明 URI。 | 字串 |
| purchasePlan | 描述資源庫映像定義購買方案。 Marketplace 映射會使用此映像。 | ImagePurchasePlan |
| 推薦 | 這些屬性描述此映像定義的建議機器組態。 這些屬性是可更新的。 | RecommendedMachineConfiguration |
| releaseNoteUri | 版本附註 URI。 | 字串 |
禁止
| 名字 | 描述 | 價值 |
|---|---|---|
| diskTypes | 磁碟類型的清單。 | string[] |
GalleryImageFeature
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 資源庫映像功能的名稱。 | 字串 |
| 價值 | 資源庫映像功能的值。 | 字串 |
GalleryImageIdentifier
| 名字 | 描述 | 價值 |
|---|---|---|
| 提供 | 資源庫映像定義供應項目的名稱。 | 字串 （必要） |
| 發行人 | 資源庫映像定義發行者的名稱。 | 字串 （必要） |
| sku | 資源庫映像定義 SKU 的名稱。 | 字串 （必要） |
ImagePurchasePlan
| 名字 | 描述 | 價值 |
|---|---|---|
| 名字 | 方案標識碼。 | 字串 |
| 產品 | 產品標識碼。 | 字串 |
| 發行人 | 發行者標識碼。 | 字串 |
RecommendedMachineConfiguration
| 名字 | 描述 | 價值 |
|---|---|---|
| 記憶 | 描述資源範圍。 | ResourceRange |
| vCPU | 描述資源範圍。 | ResourceRange |
ResourceRange
| 名字 | 描述 | 價值 |
|---|---|---|
| 麥克斯 | 資源的最大數目。 | int |
| min | 資源數目下限。 | int |