Udostępnij za pośrednictwem

Microsoft.Compute gallerys/applications/versions 2022-08-03

  • Artykuł

Definicja zasobu Bicep

Galerie/aplikacje/wersje typu zasobu można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika 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@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'
  }
}

Wartości właściwości

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. struna
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)

EncryptionImages

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

GalleryApplicationCustomAction

Nazwa Opis Wartość
opis Opis ułatwiając użytkownikom zrozumienie, co robi ta akcja niestandardowa. struna
nazwa Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
Parametry 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 struna
opis Opis ułatwiając użytkownikom zrozumienie, co oznacza ten parametr struna
nazwa 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"

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 Fakultatywny. Dodatkowe ustawienia przekazywane do rozszerzenia vm-application-manager. Tylko do użytku zaawansowanego. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Lista akcji niestandardowych, które można wykonać za pomocą tej wersji aplikacji galerii. GalleryApplicationCustomAction[]
enableHealthCheck Fakultatywny. 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. struna
excludeFromLatest Jeśli ustawiono wartość true, maszyny wirtualne 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 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
źródło Obraz źródłowy, z którego zostanie 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 aktualizowalna. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Docelowe lokalizacje rozszerzone, w których wersja obrazu ma zostać zreplikowana. 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[]

GalleryApplicationVersionPublishingProfileAdvancedSettings

Nazwa Opis Wartość

GalleryApplicationVersionSafetyProfile

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

GalleryExtendedLocation

Nazwa Opis Wartość
nazwa struna
typ Jest to typ lokalizacji rozszerzonej. "EdgeZone"
"Nieznany"

GalleryTargetExtendedLocation

Nazwa Opis Wartość
szyfrowanie Fakultatywny. 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 w poszczególnych lokalizacjach rozszerzonych. Ta właściwość jest aktualizowalna. Int
nazwa Nazwa regionu. struna
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"

Microsoft.Compute/gallerys/applications/versions

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
rodzic W 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.		 Nazwa symboliczna zasobu typu: galerie/aplikacje
Właściwości Opisuje właściwości wersji obrazu galerii. GalleryApplicationVersionProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. struna
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 struna

Tagi zasobów

Nazwa Opis Wartość

TargetRegion

Nazwa Opis Wartość
szyfrowanie Fakultatywny. 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 ukrywania obrazu, gdy użytkownicy określają wersję='latest' Bool
nazwa Nazwa regionu. ciąg (wymagany)
regionalNareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. 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"

UserArtifactManage

Nazwa Opis Wartość
instalować Wymagane. Ścieżka i argumenty do zainstalowania aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
usunąć Wymagane. Ścieżka i argumenty do usunięcia aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
aktualizacja Fakultatywny. Ś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. struna

UserArtifactSettings

Nazwa Opis Wartość
configFileName Fakultatywny. 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ą aplikacji galerii dołączona z ciągiem "_config". struna
packageFileName Fakultatywny. 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. struna

UserArtifactSource

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

Definicja zasobu szablonu usługi ARM

Galerie/aplikacje/wersje typu zasobu można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika 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": "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"
  }
}

Wartości właściwości

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. struna
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)

EncryptionImages

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

GalleryApplicationCustomAction

Nazwa Opis Wartość
opis Opis ułatwiając użytkownikom zrozumienie, co robi ta akcja niestandardowa. struna
nazwa Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
Parametry 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 struna
opis Opis ułatwiając użytkownikom zrozumienie, co oznacza ten parametr struna
nazwa 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"

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 Fakultatywny. Dodatkowe ustawienia przekazywane do rozszerzenia vm-application-manager. Tylko do użytku zaawansowanego. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Lista akcji niestandardowych, które można wykonać za pomocą tej wersji aplikacji galerii. GalleryApplicationCustomAction[]
enableHealthCheck Fakultatywny. 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. struna
excludeFromLatest Jeśli ustawiono wartość true, maszyny wirtualne 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 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
źródło Obraz źródłowy, z którego zostanie 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 aktualizowalna. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Docelowe lokalizacje rozszerzone, w których wersja obrazu ma zostać zreplikowana. 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[]

GalleryApplicationVersionPublishingProfileAdvancedSettings

Nazwa Opis Wartość

GalleryApplicationVersionSafetyProfile

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

GalleryExtendedLocation

Nazwa Opis Wartość
nazwa struna
typ Jest to typ lokalizacji rozszerzonej. "EdgeZone"
"Nieznany"

GalleryTargetExtendedLocation

Nazwa Opis Wartość
szyfrowanie Fakultatywny. 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 w poszczególnych lokalizacjach rozszerzonych. Ta właściwość jest aktualizowalna. Int
nazwa Nazwa regionu. struna
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"

Microsoft.Compute/gallerys/applications/versions

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2022-08-03'
lokalizacja Lokalizacja zasobu ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Opisuje właściwości wersji obrazu galerii. GalleryApplicationVersionProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Compute/gallerys/applications/versions"

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. struna
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 struna

Tagi zasobów

Nazwa Opis Wartość

TargetRegion

Nazwa Opis Wartość
szyfrowanie Fakultatywny. 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 ukrywania obrazu, gdy użytkownicy określają wersję='latest' Bool
nazwa Nazwa regionu. ciąg (wymagany)
regionalNareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. 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"

UserArtifactManage

Nazwa Opis Wartość
instalować Wymagane. Ścieżka i argumenty do zainstalowania aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
usunąć Wymagane. Ścieżka i argumenty do usunięcia aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
aktualizacja Fakultatywny. Ś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. struna

UserArtifactSettings

Nazwa Opis Wartość
configFileName Fakultatywny. 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ą aplikacji galerii dołączona z ciągiem "_config". struna
packageFileName Fakultatywny. 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. struna

UserArtifactSource

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

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Galerie/aplikacje/wersje typu zasobu można wdrożyć przy użyciu operacji docelowych:

  • grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika 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@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
      }
    }
  })
}

Wartości właściwości

DataDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. struna
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)

EncryptionImages

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

GalleryApplicationCustomAction

Nazwa Opis Wartość
opis Opis ułatwiając użytkownikom zrozumienie, co robi ta akcja niestandardowa. struna
nazwa Nazwa akcji niestandardowej. Musi być unikatowa w wersji aplikacji galerii. ciąg (wymagany)
Parametry 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 struna
opis Opis ułatwiając użytkownikom zrozumienie, co oznacza ten parametr struna
nazwa 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"

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 Fakultatywny. Dodatkowe ustawienia przekazywane do rozszerzenia vm-application-manager. Tylko do użytku zaawansowanego. GalleryApplicationVersionPublishingProfileAdvancedSettings
customActions Lista akcji niestandardowych, które można wykonać za pomocą tej wersji aplikacji galerii. GalleryApplicationCustomAction[]
enableHealthCheck Fakultatywny. 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. struna
excludeFromLatest Jeśli ustawiono wartość true, maszyny wirtualne 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 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
źródło Obraz źródłowy, z którego zostanie 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 aktualizowalna. "Premium_LRS"
"Standard_LRS"
"Standard_ZRS"
targetExtendedLocations Docelowe lokalizacje rozszerzone, w których wersja obrazu ma zostać zreplikowana. 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[]

GalleryApplicationVersionPublishingProfileAdvancedSettings

Nazwa Opis Wartość

GalleryApplicationVersionSafetyProfile

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

GalleryExtendedLocation

Nazwa Opis Wartość
nazwa struna
typ Jest to typ lokalizacji rozszerzonej. "EdgeZone"
"Nieznany"

GalleryTargetExtendedLocation

Nazwa Opis Wartość
szyfrowanie Fakultatywny. 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 w poszczególnych lokalizacjach rozszerzonych. Ta właściwość jest aktualizowalna. Int
nazwa Nazwa regionu. struna
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"

Microsoft.Compute/gallerys/applications/versions

Nazwa Opis Wartość
lokalizacja Lokalizacja zasobu ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: galerie /aplikacje
Właściwości Opisuje właściwości wersji obrazu galerii. GalleryApplicationVersionProperties
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Compute/gallerys/applications/versions@2022-08-03"

OSDiskImageEncryption

Nazwa Opis Wartość
diskEncryptionSetId Względny identyfikator URI zawierający identyfikator zasobu zestawu szyfrowania dysku. struna
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 struna

Tagi zasobów

Nazwa Opis Wartość

TargetRegion

Nazwa Opis Wartość
szyfrowanie Fakultatywny. 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 ukrywania obrazu, gdy użytkownicy określają wersję='latest' Bool
nazwa Nazwa regionu. ciąg (wymagany)
regionalNareplicaCount Liczba replik wersji obrazu do utworzenia w poszczególnych regionach. 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"

UserArtifactManage

Nazwa Opis Wartość
instalować Wymagane. Ścieżka i argumenty do zainstalowania aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
usunąć Wymagane. Ścieżka i argumenty do usunięcia aplikacji galerii. Jest to ograniczone do 4096 znaków. ciąg (wymagany)
aktualizacja Fakultatywny. Ś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. struna

UserArtifactSettings

Nazwa Opis Wartość
configFileName Fakultatywny. 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ą aplikacji galerii dołączona z ciągiem "_config". struna
packageFileName Fakultatywny. 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. struna

UserArtifactSource

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