Freigeben über

Microsoft.Compute-Kataloge/Anwendungen/Versionen 2022-08-03

  • Artikel

Bicep-Ressourcendefinition

Der Ressourcentyp "Kataloge/Anwendungen/Versionen" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

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

Ressourcenformat

Um eine Ressource "Microsoft.Compute/gallerys/applications/versions" zu erstellen, fügen Sie Ihrer Vorlage die folgende Bicep hinzu.

resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2022-08-03' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

DataDiskImageEncryption

Name Beschreibung Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Schnur
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 eindeutig sein, der an den virtuellen Computer angefügt ist. int (erforderlich)

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

GalleryApplicationCustomAction

Name Beschreibung Wert
Beschreibung Beschreibung, die den Benutzern hilft, zu verstehen, was diese benutzerdefinierte Aktion bewirkt. Schnur
Name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
Parameter Die Parameter, die von dieser benutzerdefinierten Aktion verwendet werden GalleryApplicationCustomActionParameter[]
Skript 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 Schnur
Beschreibung Eine Beschreibung, mit der Benutzer verstehen können, was dieser Parameter bedeutet Schnur
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
Art Gibt den Typ des benutzerdefinierten Aktionsparameters an. Mögliche Werte sind: String, ConfigurationDataBlob oder LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

GalleryApplicationVersionProperties

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

GalleryApplicationVersionPublishingProfile

Name Beschreibung Wert
advancedSettings Wahlfrei. Zusätzliche Einstellungen, die an die Erweiterung vm-application-manager übergeben werden sollen. Nur für die erweiterte Verwendung. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Eine Liste der benutzerdefinierten Aktionen, die mit dieser Kataloganwendungsversion ausgeführt werden können. GalleryApplicationCustomAction[]
enableHealthCheck Wahlfrei. Gibt an, ob diese Anwendung den Status meldet. Bool
endOfLifeDate Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Schnur
excludeFromLatest Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht. Bool
manageActions UserArtifactManage
replicaCount Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. 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. "Vollständig"
"Flach"
Einstellungen Zusätzliche Einstellungen für die VM-App, die das Zielpaket und den Konfigurationsdateinamen enthält, wenn sie für die Ziel-VM- oder VM-Skalierungsgruppe bereitgestellt wird. UserArtifactSettings
Quelle Das Quellbild, aus dem die Bildversion erstellt werden soll. UserArtifactSource- (erforderlich)
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Die erweiterten Zielspeicherorte, an denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. GalleryTargetExtendedLocation[]
targetRegions Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion-[]

GalleryApplicationVersionPublishingProfileAdvancedSettings

Name Beschreibung Wert

GalleryApplicationVersionSafetyProfile

Name Beschreibung Wert
allowDeletionOfReplicatedLocations Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist. Bool

GalleryExtendedLocation

Name Beschreibung Wert
Name Schnur
Art Es ist der Typ des erweiterten Speicherorts. "EdgeZone"
"Unbekannt"

GalleryTargetExtendedLocation

Name Beschreibung Wert
Verschlüsselung Wahlfrei. Ermöglicht Es Benutzern, vom Kunden 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 Bildversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar. Int
Name Der Name der Region. Schnur
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

Microsoft.Compute/gallerys/applications/versions

Name Beschreibung Wert
Ort Ressourcenspeicherort Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil 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 Die Ressource des Typs: Kataloge/Anwendungen
Eigenschaften Beschreibt die Eigenschaften einer Katalogbildversion. GalleryApplicationVersionProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

OSDiskImageEncryption

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

OSDiskImageSecurityProfile

Name Beschreibung Wert
confidentialVMEncryptionType Vertrauliche VM-Verschlüsselungstypen "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId Verschlüsselungssatz-ID für sichere VM-Datenträger Schnur

ResourceTags

Name Beschreibung Wert

TargetRegion

Name Beschreibung Wert
Verschlüsselung Wahlfrei. Ermöglicht Es Benutzern, vom Kunden verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. EncryptionImages-
excludeFromLatest Enthält die Kennzeichnungseinstellung, um ein Bild auszublenden, wenn Benutzer version='latest' angeben. Bool
Name Der Name der Region. Zeichenfolge (erforderlich)
regionalReplicaCount Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. Int
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

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)
aktualisieren Wahlfrei. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Aktualisierungsvorgang den Befehl "Entfernen" in der vorherigen Version und den Installationsbefehl in der aktuellen Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt. Schnur

UserArtifactSettings

Name Beschreibung Wert
configFileName Wahlfrei. Der Name zum Zuweisen der heruntergeladenen Konfigurationsdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei mit dem Namen der Kataloganwendung benannt, der mit "_config" angefügt wird. Schnur
packageFileName Wahlfrei. Der Name zum Zuweisen der heruntergeladenen Paketdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Paketdatei mit dem Namen der Kataloganwendung benannt. Schnur

UserArtifactSource

Name Beschreibung Wert
defaultConfigurationLink Wahlfrei. Der defaultConfigurationLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein. Schnur
mediaLink Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein. Zeichenfolge (erforderlich)

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Kataloge/Anwendungen/Versionen" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

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

Ressourcenformat

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

{
  "type": "Microsoft.Compute/galleries/applications/versions",
  "apiVersion": "2022-08-03",
  "name": "string",
  "location": "string",
  "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"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

DataDiskImageEncryption

Name Beschreibung Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Schnur
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 eindeutig sein, der an den virtuellen Computer angefügt ist. int (erforderlich)

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

GalleryApplicationCustomAction

Name Beschreibung Wert
Beschreibung Beschreibung, die den Benutzern hilft, zu verstehen, was diese benutzerdefinierte Aktion bewirkt. Schnur
Name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
Parameter Die Parameter, die von dieser benutzerdefinierten Aktion verwendet werden GalleryApplicationCustomActionParameter[]
Skript 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 Schnur
Beschreibung Eine Beschreibung, mit der Benutzer verstehen können, was dieser Parameter bedeutet Schnur
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
Art Gibt den Typ des benutzerdefinierten Aktionsparameters an. Mögliche Werte sind: String, ConfigurationDataBlob oder LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

GalleryApplicationVersionProperties

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

GalleryApplicationVersionPublishingProfile

Name Beschreibung Wert
advancedSettings Wahlfrei. Zusätzliche Einstellungen, die an die Erweiterung vm-application-manager übergeben werden sollen. Nur für die erweiterte Verwendung. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Eine Liste der benutzerdefinierten Aktionen, die mit dieser Kataloganwendungsversion ausgeführt werden können. GalleryApplicationCustomAction[]
enableHealthCheck Wahlfrei. Gibt an, ob diese Anwendung den Status meldet. Bool
endOfLifeDate Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Schnur
excludeFromLatest Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht. Bool
manageActions UserArtifactManage
replicaCount Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. 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. "Vollständig"
"Flach"
Einstellungen Zusätzliche Einstellungen für die VM-App, die das Zielpaket und den Konfigurationsdateinamen enthält, wenn sie für die Ziel-VM- oder VM-Skalierungsgruppe bereitgestellt wird. UserArtifactSettings
Quelle Das Quellbild, aus dem die Bildversion erstellt werden soll. UserArtifactSource- (erforderlich)
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Die erweiterten Zielspeicherorte, an denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. GalleryTargetExtendedLocation[]
targetRegions Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion-[]

GalleryApplicationVersionPublishingProfileAdvancedSettings

Name Beschreibung Wert

GalleryApplicationVersionSafetyProfile

Name Beschreibung Wert
allowDeletionOfReplicatedLocations Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist. Bool

GalleryExtendedLocation

Name Beschreibung Wert
Name Schnur
Art Es ist der Typ des erweiterten Speicherorts. "EdgeZone"
"Unbekannt"

GalleryTargetExtendedLocation

Name Beschreibung Wert
Verschlüsselung Wahlfrei. Ermöglicht Es Benutzern, vom Kunden 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 Bildversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar. Int
Name Der Name der Region. Schnur
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

Microsoft.Compute/gallerys/applications/versions

Name Beschreibung Wert
apiVersion Die API-Version '2022-08-03'
Ort Ressourcenspeicherort Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Beschreibt die Eigenschaften einer Katalogbildversion. GalleryApplicationVersionProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.Compute/gallerys/applications/versions"

OSDiskImageEncryption

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

OSDiskImageSecurityProfile

Name Beschreibung Wert
confidentialVMEncryptionType Vertrauliche VM-Verschlüsselungstypen "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId Verschlüsselungssatz-ID für sichere VM-Datenträger Schnur

ResourceTags

Name Beschreibung Wert

TargetRegion

Name Beschreibung Wert
Verschlüsselung Wahlfrei. Ermöglicht Es Benutzern, vom Kunden verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. EncryptionImages-
excludeFromLatest Enthält die Kennzeichnungseinstellung, um ein Bild auszublenden, wenn Benutzer version='latest' angeben. Bool
Name Der Name der Region. Zeichenfolge (erforderlich)
regionalReplicaCount Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. Int
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

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)
aktualisieren Wahlfrei. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Aktualisierungsvorgang den Befehl "Entfernen" in der vorherigen Version und den Installationsbefehl in der aktuellen Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt. Schnur

UserArtifactSettings

Name Beschreibung Wert
configFileName Wahlfrei. Der Name zum Zuweisen der heruntergeladenen Konfigurationsdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei mit dem Namen der Kataloganwendung benannt, der mit "_config" angefügt wird. Schnur
packageFileName Wahlfrei. Der Name zum Zuweisen der heruntergeladenen Paketdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Paketdatei mit dem Namen der Kataloganwendung benannt. Schnur

UserArtifactSource

Name Beschreibung Wert
defaultConfigurationLink Wahlfrei. Der defaultConfigurationLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein. Schnur
mediaLink Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein. Zeichenfolge (erforderlich)

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Kataloge/Anwendungen/Versionen" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

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

Ressourcenformat

Um eine Ressource "Microsoft.Compute/gallerys/applications/versions" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/galleries/applications/versions@2022-08-03"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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

DataDiskImageEncryption

Name Beschreibung Wert
diskEncryptionSetId Ein relativer URI, der die Ressourcen-ID des Datenträgerverschlüsselungssatzes enthält. Schnur
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 eindeutig sein, der an den virtuellen Computer angefügt ist. int (erforderlich)

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

GalleryApplicationCustomAction

Name Beschreibung Wert
Beschreibung Beschreibung, die den Benutzern hilft, zu verstehen, was diese benutzerdefinierte Aktion bewirkt. Schnur
Name Der Name der benutzerdefinierten Aktion. Muss innerhalb der Kataloganwendungsversion eindeutig sein. Zeichenfolge (erforderlich)
Parameter Die Parameter, die von dieser benutzerdefinierten Aktion verwendet werden GalleryApplicationCustomActionParameter[]
Skript 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 Schnur
Beschreibung Eine Beschreibung, mit der Benutzer verstehen können, was dieser Parameter bedeutet Schnur
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
Art Gibt den Typ des benutzerdefinierten Aktionsparameters an. Mögliche Werte sind: String, ConfigurationDataBlob oder LogOutputBlob 'ConfigurationDataBlob'
'LogOutputBlob'
'String'

GalleryApplicationVersionProperties

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

GalleryApplicationVersionPublishingProfile

Name Beschreibung Wert
advancedSettings Wahlfrei. Zusätzliche Einstellungen, die an die Erweiterung vm-application-manager übergeben werden sollen. Nur für die erweiterte Verwendung. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Eine Liste der benutzerdefinierten Aktionen, die mit dieser Kataloganwendungsversion ausgeführt werden können. GalleryApplicationCustomAction[]
enableHealthCheck Wahlfrei. Gibt an, ob diese Anwendung den Status meldet. Bool
endOfLifeDate Das Ende des Lebenszyklusdatums der Katalogbildversion. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. Schnur
excludeFromLatest Wenn dieser Wert auf "true" festgelegt ist, verwenden virtuelle Computer, die aus der neuesten Version der Imagedefinition bereitgestellt wurden, diese Imageversion nicht. Bool
manageActions UserArtifactManage
replicaCount Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. 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. "Vollständig"
"Flach"
Einstellungen Zusätzliche Einstellungen für die VM-App, die das Zielpaket und den Konfigurationsdateinamen enthält, wenn sie für die Ziel-VM- oder VM-Skalierungsgruppe bereitgestellt wird. UserArtifactSettings
Quelle Das Quellbild, aus dem die Bildversion erstellt werden soll. UserArtifactSource- (erforderlich)
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Die erweiterten Zielspeicherorte, an denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. GalleryTargetExtendedLocation[]
targetRegions Die Zielbereiche, in denen die Bildversion repliziert werden soll. Diese Eigenschaft ist aktualisierbar. TargetRegion-[]

GalleryApplicationVersionPublishingProfileAdvancedSettings

Name Beschreibung Wert

GalleryApplicationVersionSafetyProfile

Name Beschreibung Wert
allowDeletionOfReplicatedLocations Gibt an, ob das Entfernen dieser Katalogbildversion aus replizierten Regionen zulässig ist. Bool

GalleryExtendedLocation

Name Beschreibung Wert
Name Schnur
Art Es ist der Typ des erweiterten Speicherorts. "EdgeZone"
"Unbekannt"

GalleryTargetExtendedLocation

Name Beschreibung Wert
Verschlüsselung Wahlfrei. Ermöglicht Es Benutzern, vom Kunden 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 Bildversion, die pro erweiterter Speicherort erstellt werden soll. Diese Eigenschaft ist aktualisierbar. Int
Name Der Name der Region. Schnur
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

Microsoft.Compute/gallerys/applications/versions

Name Beschreibung Wert
Ort Ressourcenspeicherort Zeichenfolge (erforderlich)
Name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Kataloge/Anwendungen
Eigenschaften Beschreibt die Eigenschaften einer Katalogbildversion. GalleryApplicationVersionProperties
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.Compute/gallerys/applications/versions@2022-08-03"

OSDiskImageEncryption

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

OSDiskImageSecurityProfile

Name Beschreibung Wert
confidentialVMEncryptionType Vertrauliche VM-Verschlüsselungstypen "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId Verschlüsselungssatz-ID für sichere VM-Datenträger Schnur

ResourceTags

Name Beschreibung Wert

TargetRegion

Name Beschreibung Wert
Verschlüsselung Wahlfrei. Ermöglicht Es Benutzern, vom Kunden verwaltete Schlüssel zum Verschlüsseln des Betriebssystems und der Datenträger im Katalogartefakt bereitzustellen. EncryptionImages-
excludeFromLatest Enthält die Kennzeichnungseinstellung, um ein Bild auszublenden, wenn Benutzer version='latest' angeben. Bool
Name Der Name der Region. Zeichenfolge (erforderlich)
regionalReplicaCount Die Anzahl der Replikate der Bildversion, die pro Region erstellt werden soll. Diese Eigenschaft ist aktualisierbar. Int
storageAccountType Gibt den Speicherkontotyp an, der zum Speichern des Bilds verwendet werden soll. Diese Eigenschaft ist nicht aktualisierbar. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

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)
aktualisieren Wahlfrei. Der Pfad und die Argumente zum Aktualisieren der Kataloganwendung. Wenn nicht vorhanden, ruft der Aktualisierungsvorgang den Befehl "Entfernen" in der vorherigen Version und den Installationsbefehl in der aktuellen Version der Kataloganwendung auf. Dies ist auf 4096 Zeichen beschränkt. Schnur

UserArtifactSettings

Name Beschreibung Wert
configFileName Wahlfrei. Der Name zum Zuweisen der heruntergeladenen Konfigurationsdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Konfigurationsdatei mit dem Namen der Kataloganwendung benannt, der mit "_config" angefügt wird. Schnur
packageFileName Wahlfrei. Der Name zum Zuweisen der heruntergeladenen Paketdatei auf dem virtuellen Computer. Dies ist auf 4096 Zeichen beschränkt. Wenn nicht angegeben, wird die Paketdatei mit dem Namen der Kataloganwendung benannt. Schnur

UserArtifactSource

Name Beschreibung Wert
defaultConfigurationLink Wahlfrei. Der defaultConfigurationLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein. Schnur
mediaLink Erforderlich. Der mediaLink des Artefakts muss ein lesbares Speicherseiten-BLOB sein. Zeichenfolge (erforderlich)