共用方式為


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

部署至 Azure
建立 Azure Image Builder 環境,並建置已套用最新 Windows Update 和 Azure Windows 基準的 Windows Server 映射。
在 Azure 計算資源庫中建立映像定義

部署至 Azure
此範本可讓您在 Azure 計算資源庫中建立簡單的映像定義。 部署此專案之前,請確定您已執行共用映像庫 101 範本。
設定開發箱服務

部署至 Azure
此範本會根據 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'
名字 資源名稱

請參閱如何在JSON ARM 範本中設定子資源的名稱和類型。
字串 (必要)

字元限制: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

部署至 Azure
建立 Azure Image Builder 環境,並建置已套用最新 Windows Update 和 Azure Windows 基準的 Windows Server 映射。
在 Azure 計算資源庫中建立映像定義

部署至 Azure
此範本可讓您在 Azure 計算資源庫中建立簡單的映像定義。 部署此專案之前,請確定您已執行共用映像庫 101 範本。
設定開發箱服務

部署至 Azure
此範本會根據 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