Udostępnij za pośrednictwem

Microsoft.Compute gallerys/applications/versions 2023-07-03

  • Artykuł

Definicja zasobu Bicep

Galerie/aplikacje/wersje typu zasobu można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/gallerys/applications/versions, dodaj następujący kod Bicep do szablonu.

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
    }
  }
}

Wartości właściwości

galerie/aplikacje/wersje

Nazwa Opis Wartość
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w aplikacji Bicep.		 ciąg (wymagany)

Limit znaków: 32-bitowa liczba całkowita

Prawidłowe znaki:
Liczby i kropki.
(Każdy segment jest konwertowany na int32. Dlatego każdy segment ma maksymalną wartość 2 147 483 647).
location Lokalizacja zasobu ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
Nadrzędny W pliku Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.		 Symboliczna nazwa zasobu typu: aplikacje
properties Opisuje właściwości wersji obrazu galerii. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Nazwa Opis Wartość
publishingProfile Profil publikowania wersji obrazu galerii. GalleryApplicationVersionPublishingProfile (wymagane)
safetyProfile Profil bezpieczeństwa wersji aplikacji galerii. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Nazwa Opis Wartość
advancedSettings Opcjonalny. Dodatkowe ustawienia, które mają być przekazywane do rozszerzenia vm-application-manager. Tylko do użycia zaawansowanego. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions Lista akcji niestandardowych, które można wykonać za pomocą tej wersji aplikacji galerii. GalleryApplicationCustomAction[]
enableHealthCheck Opcjonalny. Niezależnie od tego, czy ta aplikacja zgłasza kondycję. bool
endOfLifeDate Data zakończenia życia wersji obrazu galerii. Ta właściwość może być używana do celów likwidacji. Ta właściwość jest aktualizowana. ciąg
excludeFromLatest W przypadku ustawienia wartości true Virtual Machines wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu. bool
manageActions UserArtifactManage
replicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość będzie obowiązywać dla regionu, gdy nie określono parametru regionalReplicaCount. Ta właściwość jest aktualizowana. int
replicationMode Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowana. "Pełny"
"Płytkie"
ustawienia Dodatkowe ustawienia aplikacji maszyny wirtualnej zawierającej pakiet docelowy i nazwę pliku konfiguracji podczas wdrażania na docelowej maszynie wirtualnej lub zestawie skalowania maszyn wirtualnych. UserArtifactSettings
source Obraz źródłowy, z którego ma zostać utworzona wersja obrazu. UserArtifactSource (wymagane)
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Docelowe lokalizacje rozszerzone, do których ma zostać zreplikowana wersja obrazu. Ta właściwość jest aktualizowalna. GalleryTargetExtendedLocation[]
targetRegions Regiony docelowe, w których wersja obrazu ma zostać zreplikowana. Ta właściwość jest aktualizowalna. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

GalleryApplicationCustomAction

Nazwa Opis Wartość
description (opis) Opis ułatwiając użytkownikom zrozumienie działania niestandardowego. ciąg
name Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
parameters Parametry używane przez tę akcję niestandardową GalleryApplicationCustomActionParameter[]
skrypt Skrypt do uruchomienia podczas wykonywania tej akcji niestandardowej. ciąg (wymagany)

GalleryApplicationCustomActionParameter

Nazwa Opis Wartość
Defaultvalue Wartość domyślna parametru. Dotyczy tylko typów ciągów ciąg
description (opis) Opis ułatwiając użytkownikom zrozumienie znaczenia tego parametru ciąg
name Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
wymagane Wskazuje, czy ten parametr musi zostać przekazany podczas uruchamiania akcji niestandardowej. bool
typ Określa typ parametru akcji niestandardowej. Możliwe wartości to: String, ConfigurationDataBlob lub LogOutputBlob "ConfigurationDataBlob"
"LogOutputBlob"
"Ciąg"

UserArtifactManage

Nazwa Opis Wartość
install Wymagane. Ścieżka i argumenty do zainstalowania aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
remove Wymagane. Ścieżka i argumenty do usunięcia aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
update Opcjonalny. Ścieżka i argumenty do zaktualizowania aplikacji galerii. Jeśli nie istnieje, operacja aktualizacji wywoła polecenie usuwania w poprzedniej wersji i zainstaluje polecenie w bieżącej wersji aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg

UserArtifactSettings

Nazwa Opis Wartość
configFileName Opcjonalny. Nazwa przypisywania pobranego pliku konfiguracji na maszynie wirtualnej. Jest to ograniczone do 4096 znaków. Jeśli nie zostanie określony, plik konfiguracji będzie miał nazwę aplikacja galerii dołączona z ciągiem "_config". ciąg
packageFileName Opcjonalny. Nazwa przypisywania pobranego pliku pakietu na maszynie wirtualnej. Jest to ograniczone do 4096 znaków. Jeśli nie zostanie określony, plik pakietu będzie miał taką samą nazwę jak nazwa aplikacji galerii. ciąg

UserArtifactSource

Nazwa Opis Wartość
defaultConfigurationLink Opcjonalny. DefaultConfigurationLink artefaktu musi być czytelnym stronicowym obiektem blob magazynu. ciąg
mediaLink Wymagane. MediaLink artefaktu musi być czytelnym stronicowym obiektem blob magazynu. ciąg (wymagany)

GalleryTargetExtendedLocation

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
extendedLocation Nazwa lokalizacji rozszerzonej. GalleryExtendedLocation
extendedLocationReplicaCount Liczba replik wersji obrazu do utworzenia na lokalizację rozszerzoną. Ta właściwość jest aktualizowana. int
name Nazwa regionu. ciąg
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nazwa Opis Wartość
dataDiskImages Lista specyfikacji szyfrowania obrazów dysków danych. DataDiskImageEncryption[]
osDiskImage Zawiera ustawienia szyfrowania obrazu dysku systemu operacyjnego. OSDiskImageEncryption

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
securityProfile Ta właściwość określa profil zabezpieczeń obrazu dysku systemu operacyjnego. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nazwa Opis Wartość
confidentialVMEncryptionType poufne typy szyfrowania maszyn wirtualnych "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId identyfikator zestawu szyfrowania dysków bezpiecznej maszyny wirtualnej ciąg

GalleryExtendedLocation

Nazwa Opis Wartość
name ciąg
typ Jest to typ lokalizacji rozszerzonej. "EdgeZone"
"Nieznany"

TargetRegion

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
excludeFromLatest Zawiera ustawienie flagi, aby ukryć obraz, gdy użytkownicy określają wersję='latest' bool
name Nazwa regionu. ciąg (wymagany)
regionalnareplicaCount Liczba replik wersji obrazu do utworzenia na region. Ta właściwość jest aktualizowalna. int
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowalna. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryApplicationVersionSafetyProfile

Nazwa Opis Wartość
allowDeletionOfReplicatedLocations Wskazuje, czy ta wersja obrazu galerii jest dozwolona z replikowanych regionów. bool

Definicja zasobu szablonu usługi ARM

Galerie/aplikacje/wersje typu zasobu można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/gallerys/applications/versions, dodaj następujący kod JSON do szablonu.

{
  "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"
    }
  }
}

Wartości właściwości

galerie/aplikacje/wersje

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/galleries/applications/versions"
apiVersion Wersja interfejsu API zasobów '2023-07-03'
name Nazwa zasobu

Zobacz, jak ustawić nazwy i typy dla zasobów podrzędnych w szablonach usługi ARM w formacie JSON.		 ciąg (wymagany)

Limit znaków: 32-bitowa liczba całkowita

Prawidłowe znaki:
Liczby i kropki.
(Każdy segment jest konwertowany na int32. Dlatego każdy segment ma maksymalną wartość 2 147 483 647).
location Lokalizacja zasobu ciąg (wymagany)
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz Tagi w szablonach
properties Opisuje właściwości wersji obrazu galerii. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Nazwa Opis Wartość
publishingProfile Profil publikowania wersji obrazu galerii. GalleryApplicationVersionPublishingProfile (wymagane)
safetyProfile Profil bezpieczeństwa wersji aplikacji galerii. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Nazwa Opis Wartość
advancedSettings Opcjonalny. Dodatkowe ustawienia do przekazania do rozszerzenia vm-application-manager. Tylko do użytku zaawansowanego. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions Lista akcji niestandardowych, które można wykonać za pomocą tej wersji aplikacji galerii. GalleryApplicationCustomAction[]
enableHealthCheck Opcjonalny. Określa, czy ta aplikacja zgłasza kondycję. bool
endOfLifeDate Data zakończenia życia wersji obrazu galerii. Tej właściwości można używać do celów likwidowania. Ta właściwość jest aktualizowalna. ciąg
excludeFromLatest W przypadku ustawienia wartości true Virtual Machines wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu. bool
manageActions UserArtifactManage
replicaCount Liczba replik wersji obrazu do utworzenia na region. Ta właściwość zostanie wprowadzona dla regionu, gdy nie określono parametru regionalReplicaCount. Ta właściwość jest aktualizowalna. int
replicationMode Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowalna. "Pełny"
"Płytkie"
ustawienia Dodatkowe ustawienia aplikacji maszyny wirtualnej zawierającej docelowy pakiet i nazwę pliku konfiguracji podczas wdrażania na docelowej maszynie wirtualnej lub w zestawie skalowania maszyn wirtualnych. UserArtifactSettings
source Obraz źródłowy, z którego ma zostać utworzona wersja obrazu. UserArtifactSource (wymagane)
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Docelowe lokalizacje rozszerzone, w których wersja obrazu ma zostać zreplikowana. Ta właściwość jest aktualizowana. GalleryTargetExtendedLocation[]
targetRegions Regiony docelowe, do których ma zostać zreplikowana wersja obrazu. Ta właściwość jest aktualizowana. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

GalleryApplicationCustomAction

Nazwa Opis Wartość
description (opis) Opis ułatwiając użytkownikom zrozumienie, co robi ta akcja niestandardowa. ciąg
name Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
parameters Parametry używane przez tę akcję niestandardową GalleryApplicationCustomActionParameter[]
skrypt Skrypt do uruchomienia podczas wykonywania tej akcji niestandardowej. ciąg (wymagany)

GalleryApplicationCustomActionParameter

Nazwa Opis Wartość
Defaultvalue Wartość domyślna parametru. Dotyczy tylko typów ciągów ciąg
description (opis) Opis ułatwiając użytkownikom zrozumienie tego, co oznacza ten parametr ciąg
name Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
wymagane Wskazuje, czy ten parametr musi zostać przekazany podczas uruchamiania akcji niestandardowej. bool
typ Określa typ parametru akcji niestandardowej. Możliwe wartości to: String, ConfigurationDataBlob lub LogOutputBlob "ConfigurationDataBlob"
"LogOutputBlob"
"Ciąg"

UserArtifactManage

Nazwa Opis Wartość
install Wymagane. Ścieżka i argumenty do zainstalowania aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
remove Wymagane. Ścieżka i argumenty do usunięcia aplikacji z galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
update Opcjonalny. Ścieżka i argumenty do zaktualizowania aplikacji galerii. Jeśli nie istnieje, operacja aktualizacji wywoła polecenie usuń w poprzedniej wersji i zainstaluje polecenie w bieżącej wersji aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg

UserArtifactSettings

Nazwa Opis Wartość
configFileName Opcjonalny. Nazwa do przypisania pobranego pliku konfiguracji na maszynie wirtualnej. Jest to ograniczone do 4096 znaków. Jeśli nie zostanie określony, plik konfiguracji zostanie nazwany nazwą aplikacja galerii dołączona z ciągiem "_config". ciąg
packageFileName Opcjonalny. Nazwa do przypisania pobranego pliku pakietu na maszynie wirtualnej. Jest to ograniczone do 4096 znaków. Jeśli nie zostanie określony, plik pakietu będzie miał taką samą nazwę jak nazwa aplikacji galerii. ciąg

UserArtifactSource

Nazwa Opis Wartość
defaultConfigurationLink Opcjonalny. DefaultConfigurationLink artefaktu musi być czytelnym stronicowym obiektem blob magazynu. ciąg
mediaLink Wymagane. MediaLink artefaktu musi być czytelnym stronicowym obiektem blob magazynu. ciąg (wymagany)

GalleryTargetExtendedLocation

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
extendedLocation Nazwa lokalizacji rozszerzonej. GalleryExtendedLocation
extendedLocationReplicaCount Liczba replik wersji obrazu do utworzenia na lokalizację rozszerzoną. Ta właściwość jest aktualizowalna. int
name Nazwa regionu. ciąg
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowalna. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nazwa Opis Wartość
dataDiskImages Lista specyfikacji szyfrowania obrazów dysków danych. DataDiskImageEncryption[]
osDiskImage Zawiera ustawienia szyfrowania dla obrazu dysku systemu operacyjnego. OSDiskImageEncryption

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych w ramach maszyny wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
securityProfile Ta właściwość określa profil zabezpieczeń obrazu dysku systemu operacyjnego. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nazwa Opis Wartość
confidentialVMEncryptionType poufne typy szyfrowania maszyn wirtualnych "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId identyfikator zestawu szyfrowania dysków maszyny wirtualnej ciąg

GalleryExtendedLocation

Nazwa Opis Wartość
name ciąg
typ Jest to typ lokalizacji rozszerzonej. "EdgeZone"
"Nieznany"

TargetRegion

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
excludeFromLatest Zawiera ustawienie flagi, aby ukryć obraz, gdy użytkownicy określają wersję='latest' bool
name Nazwa regionu. ciąg (wymagany)
regionalnareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość jest aktualizowana. int
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryApplicationVersionSafetyProfile

Nazwa Opis Wartość
allowDeletionOfReplicatedLocations Wskazuje, czy ta wersja obrazu galerii z replikowanych regionów jest dozwolona. bool

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Galerie/aplikacje/wersje typu zasobu można wdrożyć z operacjami docelowymi:

  • Grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Compute/gallerys/applications/versions, dodaj następujący program Terraform do szablonu.

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
      }
    }
  })
}

Wartości właściwości

galerie/aplikacje/wersje

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.Compute/gallerys/applications/versions@2023-07-03"
name Nazwa zasobu ciąg (wymagany)

Limit znaków: 32-bitowa liczba całkowita

Prawidłowe znaki:
Liczby i kropki.
(Każdy segment jest konwertowany na int32. Dlatego każdy segment ma maksymalną wartość 2 147 483 647).
location Lokalizacja zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: aplikacje
tags Tagi zasobów Słownik nazw tagów i wartości.
properties Opisuje właściwości wersji obrazu galerii. GalleryApplicationVersionProperties

GalleryApplicationVersionProperties

Nazwa Opis Wartość
publishingProfile Profil publikowania wersji obrazu galerii. GalleryApplicationVersionPublishingProfile (wymagane)
safetyProfile Profil bezpieczeństwa wersji aplikacji galerii. GalleryApplicationVersionSafetyProfile

GalleryApplicationVersionPublishingProfile

Nazwa Opis Wartość
advancedSettings Opcjonalny. Dodatkowe ustawienia, które mają być przekazywane do rozszerzenia vm-application-manager. Tylko do użycia zaawansowanego. GalleryApplicationVersionPublishingProfileAdvancedSe...
customActions Lista akcji niestandardowych, które można wykonać za pomocą tej wersji aplikacji galerii. GalleryApplicationCustomAction[]
enableHealthCheck Opcjonalny. Niezależnie od tego, czy ta aplikacja zgłasza kondycję. bool
endOfLifeDate Data zakończenia życia wersji obrazu galerii. Ta właściwość może być używana do celów likwidacji. Ta właściwość jest aktualizowana. ciąg
excludeFromLatest W przypadku ustawienia wartości true Virtual Machines wdrożone z najnowszej wersji definicji obrazu nie będą używać tej wersji obrazu. bool
manageActions UserArtifactManage
replicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość będzie obowiązywać dla regionu, gdy nie określono parametru regionalReplicaCount. Ta właściwość jest aktualizowana. int
replicationMode Opcjonalny parametr określający tryb, który ma być używany do replikacji. Ta właściwość nie jest aktualizowana. "Pełny"
"Płytkie"
ustawienia Dodatkowe ustawienia aplikacji maszyny wirtualnej zawierającej pakiet docelowy i nazwę pliku konfiguracji podczas wdrażania na docelowej maszynie wirtualnej lub zestawie skalowania maszyn wirtualnych. UserArtifactSettings
source Obraz źródłowy, z którego ma zostać utworzona wersja obrazu. UserArtifactSource (wymagane)
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Docelowe lokalizacje rozszerzone, w których wersja obrazu ma zostać zreplikowana. Ta właściwość jest aktualizowana. GalleryTargetExtendedLocation[]
targetRegions Regiony docelowe, do których ma zostać zreplikowana wersja obrazu. Ta właściwość jest aktualizowana. TargetRegion[]

GalleryApplicationVersionPublishingProfileAdvancedSe...

Nazwa Opis Wartość
{niestandardowa właściwość} ciąg

GalleryApplicationCustomAction

Nazwa Opis Wartość
description (opis) Opis ułatwiając użytkownikom zrozumienie, co robi ta akcja niestandardowa. ciąg
name Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
parameters Parametry używane przez tę akcję niestandardową GalleryApplicationCustomActionParameter[]
skrypt Skrypt do uruchomienia podczas wykonywania tej akcji niestandardowej. ciąg (wymagany)

GalleryApplicationCustomActionParameter

Nazwa Opis Wartość
Defaultvalue Wartość domyślna parametru. Dotyczy tylko typów ciągów ciąg
description (opis) Opis ułatwiając użytkownikom zrozumienie tego, co oznacza ten parametr ciąg
name Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
wymagane Wskazuje, czy ten parametr musi zostać przekazany podczas uruchamiania akcji niestandardowej. bool
typ Określa typ parametru akcji niestandardowej. Możliwe wartości to: String, ConfigurationDataBlob lub LogOutputBlob "ConfigurationDataBlob"
"LogOutputBlob"
"Ciąg"

UserArtifactManage

Nazwa Opis Wartość
install Wymagane. Ścieżka i argumenty do zainstalowania aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
remove Wymagane. Ścieżka i argumenty do usunięcia aplikacji z galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
update Opcjonalny. Ścieżka i argumenty do zaktualizowania aplikacji galerii. Jeśli nie istnieje, operacja aktualizacji wywoła polecenie usuń w poprzedniej wersji i zainstaluje polecenie w bieżącej wersji aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg

UserArtifactSettings

Nazwa Opis Wartość
configFileName Opcjonalny. Nazwa do przypisania pobranego pliku konfiguracji na maszynie wirtualnej. Jest to ograniczone do 4096 znaków. Jeśli nie zostanie określony, plik konfiguracji zostanie nazwany nazwą aplikacja galerii dołączona z ciągiem "_config". ciąg
packageFileName Opcjonalny. Nazwa przypisywania pobranego pliku pakietu na maszynie wirtualnej. Jest to ograniczone do 4096 znaków. Jeśli nie zostanie określony, plik pakietu będzie miał taką samą nazwę jak nazwa aplikacji galerii. ciąg

UserArtifactSource

Nazwa Opis Wartość
defaultConfigurationLink Opcjonalny. DefaultConfigurationLink artefaktu musi być czytelnym stronicowym obiektem blob magazynu. ciąg
mediaLink Wymagane. MediaLink artefaktu musi być czytelnym stronicowym obiektem blob magazynu. ciąg (wymagany)

GalleryTargetExtendedLocation

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
extendedLocation Nazwa lokalizacji rozszerzonej. GalleryExtendedLocation
extendedLocationReplicaCount Liczba replik wersji obrazu do utworzenia na lokalizację rozszerzoną. Ta właściwość jest aktualizowalna. int
name Nazwa regionu. ciąg
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowalna. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"
"Standard_ZRS"

EncryptionImages

Nazwa Opis Wartość
dataDiskImages Lista specyfikacji szyfrowania obrazów dysków danych. DataDiskImageEncryption[]
osDiskImage Zawiera ustawienia szyfrowania dla obrazu dysku systemu operacyjnego. OSDiskImageEncryption

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
Jednostki lun Ta właściwość określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych w ramach maszyny wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. int (wymagane)

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. ciąg
securityProfile Ta właściwość określa profil zabezpieczeń obrazu dysku systemu operacyjnego. OSDiskImageSecurityProfile

OSDiskImageSecurityProfile

Nazwa Opis Wartość
confidentialVMEncryptionType poufne typy szyfrowania maszyn wirtualnych "EncryptedVMGuestStateOnlyWithPmk"
"EncryptedWithCmk"
"EncryptedWithPmk"
"NonPersistedTPM"
secureVMDiskEncryptionSetId identyfikator zestawu szyfrowania dysków maszyny wirtualnej ciąg

GalleryExtendedLocation

Nazwa Opis Wartość
name ciąg
typ Jest to typ lokalizacji rozszerzonej. "Strefa brzegowa"
"Nieznany"

TargetRegion

Nazwa Opis Wartość
Szyfrowanie Opcjonalny. Umożliwia użytkownikom udostępnianie kluczy zarządzanych przez klienta na potrzeby szyfrowania dysków systemu operacyjnego i danych w artefaktie galerii. EncryptionImages
excludeFromLatest Zawiera ustawienie flagi, aby ukryć obraz, gdy użytkownicy określają wersję='latest' bool
name Nazwa regionu. ciąg (wymagany)
regionalnareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. Ta właściwość jest aktualizowana. int
storageAccountType Określa typ konta magazynu, który ma być używany do przechowywania obrazu. Ta właściwość nie jest aktualizowana. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"

GalleryApplicationVersionSafetyProfile

Nazwa Opis Wartość
allowDeletionOfReplicatedLocations Wskazuje, czy ta wersja obrazu galerii z replikowanych regionów jest dozwolona. bool