Freigeben über

Microsoft.Compute galleries/applications/versions

  • Artikel

Bicep-Ressourcendefinition

Der Ressourcentyp galleries/applications/versions kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Compute/galleries/applications/versions-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2023-07-03' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    publishingProfile: {
      advancedSettings: {
        {customized property}: 'string'
      }
      customActions: [
        {
          description: 'string'
          name: 'string'
          parameters: [
            {
              defaultValue: 'string'
              description: 'string'
              name: 'string'
              required: bool
              type: 'string'
            }
          ]
          script: 'string'
        }
      ]
      enableHealthCheck: bool
      endOfLifeDate: 'string'
      excludeFromLatest: bool
      manageActions: {
        install: 'string'
        remove: 'string'
        update: 'string'
      }
      replicaCount: int
      replicationMode: 'string'
      settings: {
        configFileName: 'string'
        packageFileName: 'string'
      }
      source: {
        defaultConfigurationLink: 'string'
        mediaLink: 'string'
      }
      storageAccountType: 'string'
      targetExtendedLocations: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          extendedLocation: {
            name: 'string'
            type: 'string'
          }
          extendedLocationReplicaCount: int
          name: 'string'
          storageAccountType: 'string'
        }
      ]
      targetRegions: [
        {
          encryption: {
            dataDiskImages: [
              {
                diskEncryptionSetId: 'string'
                lun: int
              }
            ]
            osDiskImage: {
              diskEncryptionSetId: 'string'
              securityProfile: {
                confidentialVMEncryptionType: 'string'
                secureVMDiskEncryptionSetId: 'string'
              }
            }
          }
          excludeFromLatest: bool
          name: 'string'
          regionalReplicaCount: int
          storageAccountType: 'string'
        }
      ]
    }
    safetyProfile: {
      allowDeletionOfReplicatedLocations: bool
    }
  }
}

Eigenschaftswerte

galleries/applications/versions

Name BESCHREIBUNG Wert
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep festlegen.		 Zeichenfolge (erforderlich)

Zeichenlimit: 32-Bit-Ganzzahl

Gültige Zeichen:
Zahlen und Punkte.
(Jedes Segment wird in „int32“ konvertiert. Daher hat jedes Segment einen maximalen Wert von 2.147.483.647.)
location Ressourcenspeicherort Zeichenfolge (erforderlich)
tags Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
parent In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.		 Symbolischer Name für Ressource vom Typ: Anwendungen
properties Beschreibt die Eigenschaften einer Katalogimageversion. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Name BESCHREIBUNG Wert
publishingProfile Das Veröffentlichungsprofil einer Katalogimageversion. GalleryApplicationVersionPublishingProfile (erforderlich)
safetyProfile Das Sicherheitsprofil der Kataloganwendungsversion. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Name BESCHREIBUNG Wert
advancedSettings Optional. Zusätzliche Einstellungen, die an die Vm-application-manager-Erweiterung übergeben werden sollen. Nur für die erweiterte Verwendung. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions Eine Liste der benutzerdefinierten Aktionen, die mit dieser Kataloganwendungsversion ausgeführt werden können. GalleryApplicationCustomAction[]
enableHealthCheck Optional. Gibt an, ob diese Anwendung die Integrität meldet oder nicht. bool
endOfLifeDate Das Datum des Lebenszyklusendes der Katalogimageversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
excludeFromLatest Wenn true festgelegt ist, verwenden Virtual Machines, die mit der neuesten Version der Imagedefinition bereitgestellt werden, diese Imageversion nicht. bool
manageActions UserArtifactManage
replicaCount Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden sollen. Diese Eigenschaft wird für eine Region wirksam, wenn regionalReplicaCount nicht angegeben wird. Diese Eigenschaft ist aktualisierbar. INT
replicationMode Optionaler Parameter, der den modus angibt, der für die Replikation verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. 'Full'
"Flach"
settings Zusätzliche Einstellungen für die VM-App, die das Zielpaket und den Namen der Konfigurationsdatei enthält, wenn sie für die Ziel-VM oder VM-Skalierungsgruppe bereitgestellt wird. UserArtifactSettings
source Das Quellimage, aus dem die Imageversion erstellt wird. UserArtifactSource (erforderlich)
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Die erweiterten Zielspeicherorte, an die die Imageversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. GalleryTargetExtendedLocation[]
targetRegions Die Zielregionen, in die die Imageversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Name BESCHREIBUNG Wert
{angepasste Eigenschaft} Zeichenfolge

GalleryApplicationCustomAction

Name BESCHREIBUNG Wert
description Beschreibung, um den Benutzern zu helfen, zu verstehen, was diese benutzerdefinierte Aktion bewirkt. Zeichenfolge
name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Version der Kataloganwendung eindeutig sein. Zeichenfolge (erforderlich)
parameters Die Parameter, die von dieser benutzerdefinierten Aktion verwendet werden GalleryApplicationCustomActionParameter[]
script Das Skript, das beim Ausführen dieser benutzerdefinierten Aktion ausgeführt werden soll. Zeichenfolge (erforderlich)

GalleryApplicationCustomActionParameter

Name BESCHREIBUNG Wert
defaultValue Der Standardwert des Parameters. Gilt nur für Zeichenfolgentypen. Zeichenfolge
description Eine Beschreibung, die Benutzern hilft zu verstehen, was dieser Parameter bedeutet. Zeichenfolge
name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Version der Kataloganwendung eindeutig sein. Zeichenfolge (erforderlich)
Erforderlich Gibt an, ob dieser Parameter beim Ausführen der benutzerdefinierten Aktion übergeben werden muss. bool
Typ Gibt den Typ des benutzerdefinierten Aktionsparameters an. Mögliche Werte sind: String, ConfigurationDataBlob oder LogOutputBlob "ConfigurationDataBlob"
'LogOutputBlob'
"String"

UserArtifactManage

Name BESCHREIBUNG Wert
Installieren Erforderlich. Der Pfad und die Argumente zum Installieren der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge (erforderlich)
Entfernen Erforderlich. Der Pfad und die Argumente zum Entfernen der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge (erforderlich)
Update Optional. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Updatevorgang den Befehl remove für die vorherige Version und den Installationsbefehl für die aktuelle Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge

UserArtifactSettings

Name BESCHREIBUNG Wert
configFileName Optional. Der Name, der die heruntergeladene Konfigurationsdatei auf dem virtuellen Computer zuweisen soll. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei als Name der Kataloganwendung benannt, der mit "_config" angefügt wird. Zeichenfolge
packageFileName Optional. Der Name, der die heruntergeladene Paketdatei auf dem virtuellen Computer zuweisen soll. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Paketdatei mit dem Namen der Kataloganwendung benannt. Zeichenfolge

UserArtifactSource

Name BESCHREIBUNG Wert
defaultConfigurationLink Optional. Der defaultConfigurationLink des Artefakts muss ein lesbares Speicherseitenblob sein. Zeichenfolge
mediaLink Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseitenblob sein. Zeichenfolge (erforderlich)

GalleryTargetExtendedLocation

Name BESCHREIBUNG Wert
Verschlüsselung Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. EncryptionImages
extendedLocation Der Name des erweiterten Speicherorts. GalleryExtendedLocation
extendedLocationReplicaCount Die Anzahl der Replikate der Imageversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar. INT
name Der Name der Region. Zeichenfolge
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Name BESCHREIBUNG Wert
dataDiskImages Eine Liste der Verschlüsselungsspezifikationen für Datenträgerimages. DataDiskImageEncryption[]
osDiskImage Enthält Verschlüsselungseinstellungen für ein Betriebssystemdatenträgerimage. OSDiskImageEncryption

DataDiskImageEncryption

Name BESCHREIBUNG Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Zeichenfolge
lun Diese Eigenschaft gibt die Nummer der logischen Einheit des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. int (erforderlich)

OSDiskImageEncryption

Name BESCHREIBUNG Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Zeichenfolge
securityProfile Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Name BESCHREIBUNG Wert
confidentialVMEncryptionType Verschlüsselungstypen vertraulicher VIRTUELLER Computer "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId Verschlüsselungsgruppen-ID für sichere VM-Datenträger Zeichenfolge

GalleryExtendedLocation

Name BESCHREIBUNG Wert
name Zeichenfolge
type Dabei handelt es sich um den Typ des erweiterten Standorts. "EdgeZone"
"Unbekannt"

TargetRegion

Name BESCHREIBUNG Wert
Verschlüsselung Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. EncryptionImages
excludeFromLatest Enthält die Flageinstellung zum Ausblenden eines Images, wenn Benutzer version='latest' angeben. bool
name Der Name der Region. Zeichenfolge (erforderlich)
regionalReplicaCount Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. INT
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryApplicationVersionSafetyProfile

Name BESCHREIBUNG Wert
allowDeletionOfReplicatedLocations Gibt an, ob das Entfernen dieser Katalogimageversion aus replizierten Regionen zulässig ist. bool

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp galleries/applications/versions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Compute/galleries/applications/versions-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Compute/galleries/applications/versions",
  "apiVersion": "2023-07-03",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "publishingProfile": {
      "advancedSettings": {
        "{customized property}": "string"
      },
      "customActions": [
        {
          "description": "string",
          "name": "string",
          "parameters": [
            {
              "defaultValue": "string",
              "description": "string",
              "name": "string",
              "required": "bool",
              "type": "string"
            }
          ],
          "script": "string"
        }
      ],
      "enableHealthCheck": "bool",
      "endOfLifeDate": "string",
      "excludeFromLatest": "bool",
      "manageActions": {
        "install": "string",
        "remove": "string",
        "update": "string"
      },
      "replicaCount": "int",
      "replicationMode": "string",
      "settings": {
        "configFileName": "string",
        "packageFileName": "string"
      },
      "source": {
        "defaultConfigurationLink": "string",
        "mediaLink": "string"
      },
      "storageAccountType": "string",
      "targetExtendedLocations": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "extendedLocation": {
            "name": "string",
            "type": "string"
          },
          "extendedLocationReplicaCount": "int",
          "name": "string",
          "storageAccountType": "string"
        }
      ],
      "targetRegions": [
        {
          "encryption": {
            "dataDiskImages": [
              {
                "diskEncryptionSetId": "string",
                "lun": "int"
              }
            ],
            "osDiskImage": {
              "diskEncryptionSetId": "string",
              "securityProfile": {
                "confidentialVMEncryptionType": "string",
                "secureVMDiskEncryptionSetId": "string"
              }
            }
          },
          "excludeFromLatest": "bool",
          "name": "string",
          "regionalReplicaCount": "int",
          "storageAccountType": "string"
        }
      ]
    },
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": "bool"
    }
  }
}

Eigenschaftswerte

galleries/applications/versions

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Compute/galleries/applications/versions"
apiVersion Die Version der Ressourcen-API '2023-07-03'
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen.		 Zeichenfolge (erforderlich)

Zeichenlimit: 32-Bit-Ganzzahl

Gültige Zeichen:
Zahlen und Punkte.
(Jedes Segment wird in „int32“ konvertiert. Daher hat jedes Segment einen maximalen Wert von 2.147.483.647.)
location Ressourcenspeicherort Zeichenfolge (erforderlich)
tags Ressourcentags Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties Beschreibt die Eigenschaften einer Katalogimageversion. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Name BESCHREIBUNG Wert
publishingProfile Das Veröffentlichungsprofil einer Katalogimageversion. GalleryApplicationVersionPublishingProfile (erforderlich)
safetyProfile Das Sicherheitsprofil der Version der Kataloganwendung. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Name BESCHREIBUNG Wert
advancedSettings Optional. Zusätzliche Einstellungen, die an die vm-application-manager-Erweiterung übergeben werden sollen. Nur für die erweiterte Verwendung. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions Eine Liste der benutzerdefinierten Aktionen, die mit dieser Version der Kataloganwendung ausgeführt werden können. GalleryApplicationCustomAction[]
enableHealthCheck Optional. Gibt an, ob diese Anwendung integritätsberichtet. bool
endOfLifeDate Das Enddatum der Version des Katalogimages. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
excludeFromLatest Wenn dieser Wert auf TRUE festgelegt ist, verwenden Virtual Machines, die mit der neuesten Version der Imagedefinition bereitgestellt werden, diese Imageversion nicht. bool
manageActions UserArtifactManage
replicaCount Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden soll. Diese Eigenschaft wird für eine Region wirksam, wenn "regionalReplicaCount" nicht angegeben ist. Diese Eigenschaft ist aktualisierbar. INT
replicationMode Optionaler Parameter, der den für die Replikation zu verwendenden Modus angibt. Diese Eigenschaft ist nicht aktualisierbar. 'Full'
"Flach"
settings Zusätzliche Einstellungen für die VM-App, die das Zielpaket und den Namen der Konfigurationsdatei enthält, wenn sie auf der Ziel-VM oder VM-Skalierungsgruppe bereitgestellt wird. UserArtifactSettings
source Das Quellimage, aus dem die Imageversion erstellt wird. UserArtifactSource (erforderlich)
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Die erweiterten Zielspeicherorte, an denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. GalleryTargetExtendedLocation[]
targetRegions Die Zielregionen, in denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Name BESCHREIBUNG Wert
{angepasste Eigenschaft} Zeichenfolge

GalleryApplicationCustomAction

Name BESCHREIBUNG Wert
description Beschreibung, um den Benutzern zu helfen, die Funktionsweise dieser benutzerdefinierten Aktion zu verstehen. Zeichenfolge
name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
parameters Die Parameter, die diese benutzerdefinierte Aktion verwendet GalleryApplicationCustomActionParameter[]
script Das Skript, das beim Ausführen dieser benutzerdefinierten Aktion ausgeführt werden soll. Zeichenfolge (erforderlich)

GalleryApplicationCustomActionParameter

Name BESCHREIBUNG Wert
defaultValue Der Standardwert des Parameters. Gilt nur für Zeichenfolgentypen Zeichenfolge
description Eine Beschreibung, die Benutzern hilft, zu verstehen, was dieser Parameter bedeutet. Zeichenfolge
name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
Erforderlich Gibt an, ob dieser Parameter beim Ausführen der benutzerdefinierten Aktion übergeben werden muss. bool
Typ Gibt den Typ des benutzerdefinierten Aktionsparameters an. Mögliche Werte sind: String, ConfigurationDataBlob oder LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'Zeichenfolge'

UserArtifactManage

Name BESCHREIBUNG Wert
Installieren Erforderlich. Der Pfad und die Argumente zum Installieren der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge (erforderlich)
Entfernen Erforderlich. Der Pfad und die Argumente zum Entfernen der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge (erforderlich)
Update Optional. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Updatevorgang den Befehl remove für die vorherige Version und den Installationsbefehl für die aktuelle Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge

UserArtifactSettings

Name BESCHREIBUNG Wert
configFileName Optional. Der Name, um die heruntergeladene Konfigurationsdatei auf dem virtuellen Computer zuzuweisen. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei als Kataloganwendungsname benannt, der mit "_config" angefügt wird. Zeichenfolge
packageFileName Optional. Der Name, um die heruntergeladene Paketdatei auf dem virtuellen Computer zuzuweisen. Dies ist auf 4096 Zeichen beschränkt. Wenn dies nicht angegeben ist, wird die Paketdatei mit dem Namen der Kataloganwendung benannt. Zeichenfolge

UserArtifactSource

Name BESCHREIBUNG Wert
defaultConfigurationLink Optional. Der defaultConfigurationLink des Artefakts muss ein lesbares Speicherseitenblob sein. Zeichenfolge
mediaLink Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseitenblob sein. Zeichenfolge (erforderlich)

GalleryTargetExtendedLocation

Name BESCHREIBUNG Wert
Verschlüsselung Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. EncryptionImages
extendedLocation Der Name des erweiterten Speicherorts. GalleryExtendedLocation
extendedLocationReplicaCount Die Anzahl der Replikate der Imageversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar. INT
name Der Name der Region. Zeichenfolge
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Name BESCHREIBUNG Wert
dataDiskImages Eine Liste der Verschlüsselungsspezifikationen für Datenträgerimages. DataDiskImageEncryption[]
osDiskImage Enthält Verschlüsselungseinstellungen für ein Betriebssystemdatenträgerimage. OSDiskImageEncryption

DataDiskImageEncryption

Name BESCHREIBUNG Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Zeichenfolge
lun Diese Eigenschaft gibt die Nummer der logischen Einheit des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. int (erforderlich)

OSDiskImageEncryption

Name BESCHREIBUNG Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Zeichenfolge
securityProfile Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Name BESCHREIBUNG Wert
confidentialVMEncryptionType Verschlüsselungstypen vertraulicher VIRTUELLER Computer "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId Verschlüsselungsgruppen-ID für sichere VM-Datenträger Zeichenfolge

GalleryExtendedLocation

Name BESCHREIBUNG Wert
name Zeichenfolge
type Dabei handelt es sich um den Typ des erweiterten Standorts. "EdgeZone"
"Unbekannt"

TargetRegion

Name BESCHREIBUNG Wert
Verschlüsselung Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. EncryptionImages
excludeFromLatest Enthält die Flageinstellung zum Ausblenden eines Images, wenn Benutzer version='latest' angeben. bool
name Der Name der Region. Zeichenfolge (erforderlich)
regionalReplicaCount Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. INT
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryApplicationVersionSafetyProfile

Name BESCHREIBUNG Wert
allowDeletionOfReplicatedLocations Gibt an, ob das Entfernen dieser Katalogimageversion aus replizierten Regionen zulässig ist. bool

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp galleries/applications/versions kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Compute/galleries/applications/versions-Ressource zu erstellen, fügen Sie der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/applications/versions@2023-07-03"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      publishingProfile = {
        advancedSettings = {
          {customized property} = "string"
        }
        customActions = [
          {
            description = "string"
            name = "string"
            parameters = [
              {
                defaultValue = "string"
                description = "string"
                name = "string"
                required = bool
                type = "string"
              }
            ]
            script = "string"
          }
        ]
        enableHealthCheck = bool
        endOfLifeDate = "string"
        excludeFromLatest = bool
        manageActions = {
          install = "string"
          remove = "string"
          update = "string"
        }
        replicaCount = int
        replicationMode = "string"
        settings = {
          configFileName = "string"
          packageFileName = "string"
        }
        source = {
          defaultConfigurationLink = "string"
          mediaLink = "string"
        }
        storageAccountType = "string"
        targetExtendedLocations = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            extendedLocation = {
              name = "string"
              type = "string"
            }
            extendedLocationReplicaCount = int
            name = "string"
            storageAccountType = "string"
          }
        ]
        targetRegions = [
          {
            encryption = {
              dataDiskImages = [
                {
                  diskEncryptionSetId = "string"
                  lun = int
                }
              ]
              osDiskImage = {
                diskEncryptionSetId = "string"
                securityProfile = {
                  confidentialVMEncryptionType = "string"
                  secureVMDiskEncryptionSetId = "string"
                }
              }
            }
            excludeFromLatest = bool
            name = "string"
            regionalReplicaCount = int
            storageAccountType = "string"
          }
        ]
      }
      safetyProfile = {
        allowDeletionOfReplicatedLocations = bool
      }
    }
  })
}

Eigenschaftswerte

galleries/applications/versions

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.Compute/galleries/applications/versions@2023-07-03"
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 32-Bit-Ganzzahl

Gültige Zeichen:
Zahlen und Punkte.
(Jedes Segment wird in „int32“ konvertiert. Daher hat jedes Segment einen maximalen Wert von 2.147.483.647.)
location Ressourcenspeicherort Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Anwendungen
tags Ressourcentags Wörterbuch der Tagnamen und -werte.
properties Beschreibt die Eigenschaften einer Katalogimageversion. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Name BESCHREIBUNG Wert
publishingProfile Das Veröffentlichungsprofil einer Katalogimageversion. GalleryApplicationVersionPublishingProfile (erforderlich)
safetyProfile Das Sicherheitsprofil der Version der Kataloganwendung. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Name BESCHREIBUNG Wert
advancedSettings Optional. Zusätzliche Einstellungen, die an die vm-application-manager-Erweiterung übergeben werden sollen. Nur für die erweiterte Verwendung. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions Eine Liste der benutzerdefinierten Aktionen, die mit dieser Version der Kataloganwendung ausgeführt werden können. GalleryApplicationCustomAction[]
enableHealthCheck Optional. Gibt an, ob diese Anwendung integritätsberichtet. bool
endOfLifeDate Das Enddatum der Version des Katalogimages. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Zeichenfolge
excludeFromLatest Wenn dieser Wert auf TRUE festgelegt ist, verwenden Virtual Machines, die mit der neuesten Version der Imagedefinition bereitgestellt werden, diese Imageversion nicht. bool
manageActions UserArtifactManage
replicaCount Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden soll. Diese Eigenschaft wird für eine Region wirksam, wenn "regionalReplicaCount" nicht angegeben ist. Diese Eigenschaft ist aktualisierbar. INT
replicationMode Optionaler Parameter, der den für die Replikation zu verwendenden Modus angibt. Diese Eigenschaft ist nicht aktualisierbar. "Vollständig"
"Flach"
settings Zusätzliche Einstellungen für die VM-App, die das Zielpaket und den Namen der Konfigurationsdatei enthält, wenn sie für die Ziel-VM oder VM-Skalierungsgruppe bereitgestellt wird. UserArtifactSettings
source Das Quellimage, aus dem die Imageversion erstellt wird. UserArtifactSource (erforderlich)
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. „Premium_LRS“
„Standard_LRS“
„Standard_ZRS“
targetExtendedLocations Die erweiterten Zielspeicherorte, an denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. GalleryTargetExtendedLocation[]
targetRegions Die Zielregionen, in denen die Imageversion repliziert wird. Diese Eigenschaft ist aktualisierbar. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Name BESCHREIBUNG Wert
{angepasste Eigenschaft} Zeichenfolge

GalleryApplicationCustomAction

Name BESCHREIBUNG Wert
description Beschreibung, um den Benutzern zu helfen, die Funktionsweise dieser benutzerdefinierten Aktion zu verstehen. Zeichenfolge
name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
parameters Die Parameter, die diese benutzerdefinierte Aktion verwendet GalleryApplicationCustomActionParameter[]
script Das Skript, das beim Ausführen dieser benutzerdefinierten Aktion ausgeführt werden soll. Zeichenfolge (erforderlich)

GalleryApplicationCustomActionParameter

Name BESCHREIBUNG Wert
defaultValue Der Standardwert des Parameters. Gilt nur für Zeichenfolgentypen Zeichenfolge
description Eine Beschreibung, die Benutzern hilft, zu verstehen, was dieser Parameter bedeutet. Zeichenfolge
name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
Erforderlich Gibt an, ob dieser Parameter beim Ausführen der benutzerdefinierten Aktion übergeben werden muss. bool
Typ Gibt den Typ des benutzerdefinierten Aktionsparameters an. Mögliche Werte sind: String, ConfigurationDataBlob oder LogOutputBlob "ConfigurationDataBlob"
"LogOutputBlob"
"String"

UserArtifactManage

Name BESCHREIBUNG Wert
Installieren Erforderlich. Der Pfad und die Argumente zum Installieren der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge (erforderlich)
Entfernen Erforderlich. Der Pfad und die Argumente zum Entfernen der Kataloganwendung. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge (erforderlich)
Update Optional. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Updatevorgang den Befehl remove für die vorherige Version und den Installationsbefehl für die aktuelle Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt. Zeichenfolge

UserArtifactSettings

Name BESCHREIBUNG Wert
configFileName Optional. Der Name, um die heruntergeladene Konfigurationsdatei auf dem virtuellen Computer zuzuweisen. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei als Kataloganwendungsname benannt, der mit "_config" angefügt wird. Zeichenfolge
packageFileName Optional. Der Name, um die heruntergeladene Paketdatei auf dem virtuellen Computer zuzuweisen. Dies ist auf 4096 Zeichen beschränkt. Wenn dies nicht angegeben ist, wird die Paketdatei mit dem Namen der Kataloganwendung benannt. Zeichenfolge

UserArtifactSource

Name BESCHREIBUNG Wert
defaultConfigurationLink Optional. DefaultConfigurationLink des Artefakts muss ein lesbares Speicherseitenblob sein. Zeichenfolge
mediaLink Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseitenblob sein. Zeichenfolge (erforderlich)

GalleryTargetExtendedLocation

Name BESCHREIBUNG Wert
Verschlüsselung Optional. Ermöglicht Benutzern, kundenseitig verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. EncryptionImages
extendedLocation Der Name des erweiterten Speicherorts. GalleryExtendedLocation
extendedLocationReplicaCount Die Anzahl der Replikate der Imageversion, die pro erweitertem Speicherort erstellt werden sollen. Diese Eigenschaft ist aktualisierbar. INT
name Der Name der Region. Zeichenfolge
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. „Premium_LRS“
„StandardSSD_LRS“
„Standard_LRS“
„Standard_ZRS“

EncryptionImages

Name BESCHREIBUNG Wert
dataDiskImages Eine Liste der Verschlüsselungsspezifikationen für Datenträgerimages. DataDiskImageEncryption[]
osDiskImage Enthält Verschlüsselungseinstellungen für ein Betriebssystemdatenträgerimage. OSDiskImageEncryption

DataDiskImageEncryption

Name BESCHREIBUNG Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Zeichenfolge
lun Diese Eigenschaft gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden Datenträger, der an den virtuellen Computer angefügt ist, eindeutig sein. int (erforderlich)

OSDiskImageEncryption

Name BESCHREIBUNG Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Zeichenfolge
securityProfile Diese Eigenschaft gibt das Sicherheitsprofil eines Betriebssystemdatenträgerimages an. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Name BESCHREIBUNG Wert
confidentialVMEncryptionType Verschlüsselungstypen vertraulicher VM "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId Verschlüsselungssatz-ID für sichere VM-Datenträger Zeichenfolge

GalleryExtendedLocation

Name BESCHREIBUNG Wert
name Zeichenfolge
type Dabei handelt es sich um den Typ des erweiterten Speicherorts. "EdgeZone"
"Unbekannt"

TargetRegion

Name BESCHREIBUNG Wert
Verschlüsselung Optional. Ermöglicht Benutzern die Bereitstellung von kundenseitig verwalteten Schlüsseln zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt. EncryptionImages
excludeFromLatest Enthält die Flageinstellung zum Ausblenden eines Images, wenn Benutzer version='latest' angeben. bool
name Der Name der Region. Zeichenfolge (erforderlich)
regionalReplicaCount Die Anzahl der Replikate der Imageversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. INT
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Images verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. „Premium_LRS“
„Standard_LRS“
„Standard_ZRS“

GalleryApplicationVersionSafetyProfile

Name BESCHREIBUNG Wert
allowDeletionOfReplicatedLocations Gibt an, ob das Entfernen dieser Katalogimageversion aus replizierten Regionen zulässig ist. bool