Microsoft.Compute-gallerier/program/versioner
Bicep-resursdefinition
Resurstypen gallerier/program/versioner kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Compute/galleries/applications/versionsresurs lägger du till följande Bicep i mallen.
resource symbolicname 'Microsoft.Compute/galleries/applications/versions@2024-03-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'
scriptBehaviorAfterReboot: '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: [
{
additionalReplicaSets: [
{
regionalReplicaCount: int
storageAccountType: 'string'
}
]
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'
}
}
Egenskapsvärden
AdditionalReplicaSet
Namn | Beskrivning | Värde |
---|---|---|
regionalReplicaCount | Antalet direktenhetsrepliker av avbildningsversionen som ska skapas. Den här egenskapen är uppdaterad | Int |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att skapa direktenhetsrepliker | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
DataDiskImageEncryption
Namn | Beskrivning | Värde |
---|---|---|
diskEncryptionSetId | En relativ URI som innehåller resurs-ID för diskkrypteringsuppsättningen. | sträng |
Lun | Den här egenskapen anger datadiskens logiska enhetsnummer. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till den virtuella datorn. | int (krävs) |
EncryptionImages
Namn | Beskrivning | Värde |
---|---|---|
dataDiskImages | En lista över krypteringsspecifikationer för datadiskbilder. | DataDiskImageEncryption[] |
osDiskImage | Innehåller krypteringsinställningar för en OS-diskavbildning. | OSDiskImageEncryption |
GalleryApplicationCustomAction
Namn | Beskrivning | Värde |
---|---|---|
beskrivning | Beskrivning som hjälper användarna att förstå vad den här anpassade åtgärden gör. | sträng |
Namn | Namnet på den anpassade åtgärden. Måste vara unikt i galleriprogramversionen. | sträng (krävs) |
Parametrar | De parametrar som den här anpassade åtgärden använder | GalleryApplicationCustomActionParameter[] |
manus | Skriptet som ska köras när den här anpassade åtgärden körs. | sträng (krävs) |
GalleryApplicationCustomActionParameter
Namn | Beskrivning | Värde |
---|---|---|
defaultValue | Standardvärdet för parametern. Gäller endast för strängtyper | sträng |
beskrivning | En beskrivning som hjälper användarna att förstå vad den här parametern innebär | sträng |
Namn | Namnet på den anpassade åtgärden. Måste vara unikt i galleriprogramversionen. | sträng (krävs) |
krävs | Anger om den här parametern måste skickas när du kör den anpassade åtgärden. | Bool |
typ | Anger typen av parameter för anpassad åtgärd. Möjliga värden är: String, ConfigurationDataBlob eller LogOutputBlob | "ConfigurationDataBlob" "LogOutputBlob" "Sträng" |
GalleryApplicationVersionProperties
Namn | Beskrivning | Värde |
---|---|---|
publishingProfile | Publiceringsprofilen för en galleribildversion. | GalleryApplicationVersionPublishingProfile (krävs) |
safetyProfile | Säkerhetsprofilen för galleriprogramversionen. | GalleryApplicationVersionSafetyProfile |
GalleryApplicationVersionPublishingProfile
Namn | Beskrivning | Värde |
---|---|---|
advancedSettings | Valfri. Ytterligare inställningar för att skicka till tillägget vm-application-manager. Endast för avancerad användning. | GalleryApplicationVersionPublishingProfileAdvancedSettings |
customActions | En lista över anpassade åtgärder som kan utföras med den här galleriprogramversionen. | GalleryApplicationCustomAction[] |
enableHealthCheck | Valfri. Om det här programmet rapporterar hälsotillstånd eller inte. | Bool |
endOfLifeDate | Slutdatumet för galleribildversionen. Den här egenskapen kan användas för avaktivering. Den här egenskapen är uppdaterad. | sträng |
excludeFromLatest | Om värdet är true använder virtuella datorer som distribuerats från den senaste versionen av avbildningsdefinitionen inte den här avbildningsversionen. | Bool |
manageActions | UserArtifactManage | |
replicaCount | Antalet repliker av avbildningsversionen som ska skapas per region. Den här egenskapen träder i kraft för en region när regionalReplicaCount inte har angetts. Den här egenskapen är uppdaterad. | Int |
replicationMode | Valfri parameter som anger det läge som ska användas för replikering. Den här egenskapen är inte uppdaterad. | "Full" "Grunt" |
Inställningar | Ytterligare inställningar för den virtuella datorappen som innehåller målpaketet och konfigurationsfilens namn när den distribueras till mål-VM eller VM-skalningsuppsättning. | UserArtifactSettings |
källa | Källbilden som avbildningsversionen ska skapas från. | UserArtifactSource (krävs) |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
targetExtendedLocations | De utökade målplatserna där avbildningsversionen ska replikeras till. Den här egenskapen är uppdaterad. | GalleryTargetExtendedLocation[] |
targetRegions | Målregionerna där avbildningsversionen ska replikeras till. Den här egenskapen är uppdaterad. | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
Namn | Beskrivning | Värde |
---|
GalleryApplicationVersionSafetyProfile
Namn | Beskrivning | Värde |
---|---|---|
allowDeletionOfReplicatedLocations | Anger om det är tillåtet att ta bort den här galleribildversionen från replikerade regioner. | Bool |
GalleryExtendedLocation
Namn | Beskrivning | Värde |
---|---|---|
Namn | sträng | |
typ | Det är typen av utökad plats. | "EdgeZone" "Okänd" |
GalleryTargetExtendedLocation
Namn | Beskrivning | Värde |
---|---|---|
kryptering | Valfri. Tillåter användare att tillhandahålla kundhanterade nycklar för kryptering av operativsystemet och datadiskarna i galleriartefakten. | EncryptionImages |
extendedLocation | Namnet på den utökade platsen. | GalleryExtendedLocation |
extendedLocationReplicaCount | Antalet repliker av avbildningsversionen som ska skapas per utökad plats. Den här egenskapen är uppdaterad. | Int |
Namn | Namnet på regionen. | sträng |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS" |
Microsoft.Compute/galleries/applications/versions
Namn | Beskrivning | Värde |
---|---|---|
plats | Resursplats | sträng (krävs) |
Namn | Resursnamnet | sträng (krävs) |
förälder | I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen. Mer information finns i Underordnad resurs utanför den överordnade resursen. |
Symboliskt namn för resurs av typen: gallerier/program |
Egenskaper | Beskriver egenskaperna för en galleriavbildningsversion. | GalleryApplicationVersionProperties |
Taggar | Resurstaggar | Ordlista med taggnamn och värden. Se taggar i mallar |
OSDiskImageEncryption
Namn | Beskrivning | Värde |
---|---|---|
diskEncryptionSetId | En relativ URI som innehåller resurs-ID för diskkrypteringsuppsättningen. | sträng |
securityProfile | Den här egenskapen anger säkerhetsprofilen för en OS-diskavbildning. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
Namn | Beskrivning | Värde |
---|---|---|
confidentialVMEncryptionType | krypteringstyper för konfidentiella virtuella datorer | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | skydda ID för VM-diskkrypteringsuppsättning | sträng |
ResourceTags
Namn | Beskrivning | Värde |
---|
TargetRegion
Namn | Beskrivning | Värde |
---|---|---|
additionalReplicaSets | Lista över lagrings-SKU med antal repliker för att skapa direktenhetsrepliker. | AdditionalReplicaSet[] |
kryptering | Valfri. Tillåter användare att tillhandahålla kundhanterade nycklar för kryptering av operativsystemet och datadiskarna i galleriartefakten. | EncryptionImages |
excludeFromLatest | Innehåller flagginställningen för att dölja en bild när användare anger version='senaste' | Bool |
Namn | Namnet på regionen. | sträng (krävs) |
regionalReplicaCount | Antalet repliker av avbildningsversionen som ska skapas per region. Den här egenskapen är uppdaterad. | Int |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
UserArtifactManage
Namn | Beskrivning | Värde |
---|---|---|
installera | Krävs. Sökvägen och argumenten för att installera galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng (krävs) |
avlägsna | Krävs. Sökvägen och argumenten för att ta bort galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng (krävs) |
uppdatera | Valfri. Sökvägen och argumenten för att uppdatera galleriprogrammet. Om den inte finns anropar uppdateringsåtgärden kommandot remove i den tidigare versionen och installerar kommandot på den aktuella versionen av galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng |
UserArtifactSettings
Namn | Beskrivning | Värde |
---|---|---|
configFileName | Valfri. Namnet för att tilldela den nedladdade konfigurationsfilen på den virtuella datorn. Detta är begränsat till 4 096 tecken. Om den inte anges får konfigurationsfilen namnet Galleriprogramnamn som läggs till med "_config". | sträng |
packageFileName | Valfri. Namnet på den nedladdade paketfilen på den virtuella datorn. Detta är begränsat till 4 096 tecken. Om den inte anges namnges paketfilen på samma sätt som namnet på galleriprogrammet. | sträng |
scriptBehaviorAfterReboot | Valfri. Den åtgärd som ska vidtas när det gäller att installera/uppdatera/ta bort galleriprogrammet i händelse av en omstart. | "Ingen" "Kör om" |
UserArtifactSource
Namn | Beskrivning | Värde |
---|---|---|
defaultConfigurationLink | Valfri. DefaultConfigurationLink för artefakten måste vara en läsbar lagringssideblob. | sträng |
mediaLink | Krävs. MediaLink för artefakten måste vara en läsbar lagringssideblob. | sträng (krävs) |
Resursdefinition för ARM-mall
Resurstypen gallerier/program/versioner kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.Compute/galleries/applications/versionsresurs lägger du till följande JSON i mallen.
{
"type": "Microsoft.Compute/galleries/applications/versions",
"apiVersion": "2024-03-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",
"scriptBehaviorAfterReboot": "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": [
{
"additionalReplicaSets": [
{
"regionalReplicaCount": "int",
"storageAccountType": "string"
}
],
"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"
}
}
Egenskapsvärden
AdditionalReplicaSet
Namn | Beskrivning | Värde |
---|---|---|
regionalReplicaCount | Antalet direktenhetsrepliker av avbildningsversionen som ska skapas. Den här egenskapen är uppdaterad | Int |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att skapa direktenhetsrepliker | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
DataDiskImageEncryption
Namn | Beskrivning | Värde |
---|---|---|
diskEncryptionSetId | En relativ URI som innehåller resurs-ID för diskkrypteringsuppsättningen. | sträng |
Lun | Den här egenskapen anger datadiskens logiska enhetsnummer. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till den virtuella datorn. | int (krävs) |
EncryptionImages
Namn | Beskrivning | Värde |
---|---|---|
dataDiskImages | En lista över krypteringsspecifikationer för datadiskbilder. | DataDiskImageEncryption[] |
osDiskImage | Innehåller krypteringsinställningar för en OS-diskavbildning. | OSDiskImageEncryption |
GalleryApplicationCustomAction
Namn | Beskrivning | Värde |
---|---|---|
beskrivning | Beskrivning som hjälper användarna att förstå vad den här anpassade åtgärden gör. | sträng |
Namn | Namnet på den anpassade åtgärden. Måste vara unikt i galleriprogramversionen. | sträng (krävs) |
Parametrar | De parametrar som den här anpassade åtgärden använder | GalleryApplicationCustomActionParameter[] |
manus | Skriptet som ska köras när den här anpassade åtgärden körs. | sträng (krävs) |
GalleryApplicationCustomActionParameter
Namn | Beskrivning | Värde |
---|---|---|
defaultValue | Standardvärdet för parametern. Gäller endast för strängtyper | sträng |
beskrivning | En beskrivning som hjälper användarna att förstå vad den här parametern innebär | sträng |
Namn | Namnet på den anpassade åtgärden. Måste vara unikt i galleriprogramversionen. | sträng (krävs) |
krävs | Anger om den här parametern måste skickas när du kör den anpassade åtgärden. | Bool |
typ | Anger typen av parameter för anpassad åtgärd. Möjliga värden är: String, ConfigurationDataBlob eller LogOutputBlob | "ConfigurationDataBlob" "LogOutputBlob" "Sträng" |
GalleryApplicationVersionProperties
Namn | Beskrivning | Värde |
---|---|---|
publishingProfile | Publiceringsprofilen för en galleribildversion. | GalleryApplicationVersionPublishingProfile (krävs) |
safetyProfile | Säkerhetsprofilen för galleriprogramversionen. | GalleryApplicationVersionSafetyProfile |
GalleryApplicationVersionPublishingProfile
Namn | Beskrivning | Värde |
---|---|---|
advancedSettings | Valfri. Ytterligare inställningar för att skicka till tillägget vm-application-manager. Endast för avancerad användning. | GalleryApplicationVersionPublishingProfileAdvancedSettings |
customActions | En lista över anpassade åtgärder som kan utföras med den här galleriprogramversionen. | GalleryApplicationCustomAction[] |
enableHealthCheck | Valfri. Om det här programmet rapporterar hälsotillstånd eller inte. | Bool |
endOfLifeDate | Slutdatumet för galleribildversionen. Den här egenskapen kan användas för avaktivering. Den här egenskapen är uppdaterad. | sträng |
excludeFromLatest | Om värdet är true använder virtuella datorer som distribuerats från den senaste versionen av avbildningsdefinitionen inte den här avbildningsversionen. | Bool |
manageActions | UserArtifactManage | |
replicaCount | Antalet repliker av avbildningsversionen som ska skapas per region. Den här egenskapen träder i kraft för en region när regionalReplicaCount inte har angetts. Den här egenskapen är uppdaterad. | Int |
replicationMode | Valfri parameter som anger det läge som ska användas för replikering. Den här egenskapen är inte uppdaterad. | "Full" "Grunt" |
Inställningar | Ytterligare inställningar för den virtuella datorappen som innehåller målpaketet och konfigurationsfilens namn när den distribueras till mål-VM eller VM-skalningsuppsättning. | UserArtifactSettings |
källa | Källbilden som avbildningsversionen ska skapas från. | UserArtifactSource (krävs) |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
targetExtendedLocations | De utökade målplatserna där avbildningsversionen ska replikeras till. Den här egenskapen är uppdaterad. | GalleryTargetExtendedLocation[] |
targetRegions | Målregionerna där avbildningsversionen ska replikeras till. Den här egenskapen är uppdaterad. | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
Namn | Beskrivning | Värde |
---|
GalleryApplicationVersionSafetyProfile
Namn | Beskrivning | Värde |
---|---|---|
allowDeletionOfReplicatedLocations | Anger om det är tillåtet att ta bort den här galleribildversionen från replikerade regioner. | Bool |
GalleryExtendedLocation
Namn | Beskrivning | Värde |
---|---|---|
Namn | sträng | |
typ | Det är typen av utökad plats. | "EdgeZone" "Okänd" |
GalleryTargetExtendedLocation
Namn | Beskrivning | Värde |
---|---|---|
kryptering | Valfri. Tillåter användare att tillhandahålla kundhanterade nycklar för kryptering av operativsystemet och datadiskarna i galleriartefakten. | EncryptionImages |
extendedLocation | Namnet på den utökade platsen. | GalleryExtendedLocation |
extendedLocationReplicaCount | Antalet repliker av avbildningsversionen som ska skapas per utökad plats. Den här egenskapen är uppdaterad. | Int |
Namn | Namnet på regionen. | sträng |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS" |
Microsoft.Compute/galleries/applications/versions
Namn | Beskrivning | Värde |
---|---|---|
apiVersion | API-versionen | '2024-03-03' |
plats | Resursplats | sträng (krävs) |
Namn | Resursnamnet | sträng (krävs) |
Egenskaper | Beskriver egenskaperna för en galleriavbildningsversion. | GalleryApplicationVersionProperties |
Taggar | Resurstaggar | Ordlista med taggnamn och värden. Se taggar i mallar |
typ | Resurstypen | "Microsoft.Compute/galleries/applications/versions" |
OSDiskImageEncryption
Namn | Beskrivning | Värde |
---|---|---|
diskEncryptionSetId | En relativ URI som innehåller resurs-ID för diskkrypteringsuppsättningen. | sträng |
securityProfile | Den här egenskapen anger säkerhetsprofilen för en OS-diskavbildning. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
Namn | Beskrivning | Värde |
---|---|---|
confidentialVMEncryptionType | krypteringstyper för konfidentiella virtuella datorer | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | skydda ID för VM-diskkrypteringsuppsättning | sträng |
ResourceTags
Namn | Beskrivning | Värde |
---|
TargetRegion
Namn | Beskrivning | Värde |
---|---|---|
additionalReplicaSets | Lista över lagrings-SKU med antal repliker för att skapa direktenhetsrepliker. | AdditionalReplicaSet[] |
kryptering | Valfri. Tillåter användare att tillhandahålla kundhanterade nycklar för kryptering av operativsystemet och datadiskarna i galleriartefakten. | EncryptionImages |
excludeFromLatest | Innehåller flagginställningen för att dölja en bild när användare anger version='senaste' | Bool |
Namn | Namnet på regionen. | sträng (krävs) |
regionalReplicaCount | Antalet repliker av avbildningsversionen som ska skapas per region. Den här egenskapen är uppdaterad. | Int |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
UserArtifactManage
Namn | Beskrivning | Värde |
---|---|---|
installera | Krävs. Sökvägen och argumenten för att installera galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng (krävs) |
avlägsna | Krävs. Sökvägen och argumenten för att ta bort galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng (krävs) |
uppdatera | Valfri. Sökvägen och argumenten för att uppdatera galleriprogrammet. Om den inte finns anropar uppdateringsåtgärden kommandot remove i den tidigare versionen och installerar kommandot på den aktuella versionen av galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng |
UserArtifactSettings
Namn | Beskrivning | Värde |
---|---|---|
configFileName | Valfri. Namnet för att tilldela den nedladdade konfigurationsfilen på den virtuella datorn. Detta är begränsat till 4 096 tecken. Om den inte anges får konfigurationsfilen namnet Galleriprogramnamn som läggs till med "_config". | sträng |
packageFileName | Valfri. Namnet på den nedladdade paketfilen på den virtuella datorn. Detta är begränsat till 4 096 tecken. Om den inte anges namnges paketfilen på samma sätt som namnet på galleriprogrammet. | sträng |
scriptBehaviorAfterReboot | Valfri. Den åtgärd som ska vidtas när det gäller att installera/uppdatera/ta bort galleriprogrammet i händelse av en omstart. | "Ingen" "Kör om" |
UserArtifactSource
Namn | Beskrivning | Värde |
---|---|---|
defaultConfigurationLink | Valfri. DefaultConfigurationLink för artefakten måste vara en läsbar lagringssideblob. | sträng |
mediaLink | Krävs. MediaLink för artefakten måste vara en läsbar lagringssideblob. | sträng (krävs) |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen gallerier/program/versioner kan distribueras med åtgärder som mål:
- Resursgrupper
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Resurs för Microsoft.Compute/galleries/applications/versions lägger du till följande Terraform i mallen.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/galleries/applications/versions@2024-03-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"
scriptBehaviorAfterReboot = "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 = [
{
additionalReplicaSets = [
{
regionalReplicaCount = int
storageAccountType = "string"
}
]
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
}
}
})
}
Egenskapsvärden
AdditionalReplicaSet
Namn | Beskrivning | Värde |
---|---|---|
regionalReplicaCount | Antalet direktenhetsrepliker av avbildningsversionen som ska skapas. Den här egenskapen är uppdaterad | Int |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att skapa direktenhetsrepliker | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
DataDiskImageEncryption
Namn | Beskrivning | Värde |
---|---|---|
diskEncryptionSetId | En relativ URI som innehåller resurs-ID för diskkrypteringsuppsättningen. | sträng |
Lun | Den här egenskapen anger datadiskens logiska enhetsnummer. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till den virtuella datorn. | int (krävs) |
EncryptionImages
Namn | Beskrivning | Värde |
---|---|---|
dataDiskImages | En lista över krypteringsspecifikationer för datadiskbilder. | DataDiskImageEncryption[] |
osDiskImage | Innehåller krypteringsinställningar för en OS-diskavbildning. | OSDiskImageEncryption |
GalleryApplicationCustomAction
Namn | Beskrivning | Värde |
---|---|---|
beskrivning | Beskrivning som hjälper användarna att förstå vad den här anpassade åtgärden gör. | sträng |
Namn | Namnet på den anpassade åtgärden. Måste vara unikt i galleriprogramversionen. | sträng (krävs) |
Parametrar | De parametrar som den här anpassade åtgärden använder | GalleryApplicationCustomActionParameter[] |
manus | Skriptet som ska köras när den här anpassade åtgärden körs. | sträng (krävs) |
GalleryApplicationCustomActionParameter
Namn | Beskrivning | Värde |
---|---|---|
defaultValue | Standardvärdet för parametern. Gäller endast för strängtyper | sträng |
beskrivning | En beskrivning som hjälper användarna att förstå vad den här parametern innebär | sträng |
Namn | Namnet på den anpassade åtgärden. Måste vara unikt i galleriprogramversionen. | sträng (krävs) |
krävs | Anger om den här parametern måste skickas när du kör den anpassade åtgärden. | Bool |
typ | Anger typen av parameter för anpassad åtgärd. Möjliga värden är: String, ConfigurationDataBlob eller LogOutputBlob | "ConfigurationDataBlob" "LogOutputBlob" "Sträng" |
GalleryApplicationVersionProperties
Namn | Beskrivning | Värde |
---|---|---|
publishingProfile | Publiceringsprofilen för en galleribildversion. | GalleryApplicationVersionPublishingProfile (krävs) |
safetyProfile | Säkerhetsprofilen för galleriprogramversionen. | GalleryApplicationVersionSafetyProfile |
GalleryApplicationVersionPublishingProfile
Namn | Beskrivning | Värde |
---|---|---|
advancedSettings | Valfri. Ytterligare inställningar för att skicka till tillägget vm-application-manager. Endast för avancerad användning. | GalleryApplicationVersionPublishingProfileAdvancedSettings |
customActions | En lista över anpassade åtgärder som kan utföras med den här galleriprogramversionen. | GalleryApplicationCustomAction[] |
enableHealthCheck | Valfri. Om det här programmet rapporterar hälsotillstånd eller inte. | Bool |
endOfLifeDate | Slutdatumet för galleribildversionen. Den här egenskapen kan användas för avaktivering. Den här egenskapen är uppdaterad. | sträng |
excludeFromLatest | Om värdet är true använder virtuella datorer som distribuerats från den senaste versionen av avbildningsdefinitionen inte den här avbildningsversionen. | Bool |
manageActions | UserArtifactManage | |
replicaCount | Antalet repliker av avbildningsversionen som ska skapas per region. Den här egenskapen träder i kraft för en region när regionalReplicaCount inte har angetts. Den här egenskapen är uppdaterad. | Int |
replicationMode | Valfri parameter som anger det läge som ska användas för replikering. Den här egenskapen är inte uppdaterad. | "Full" "Grunt" |
Inställningar | Ytterligare inställningar för den virtuella datorappen som innehåller målpaketet och konfigurationsfilens namn när den distribueras till mål-VM eller VM-skalningsuppsättning. | UserArtifactSettings |
källa | Källbilden som avbildningsversionen ska skapas från. | UserArtifactSource (krävs) |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
targetExtendedLocations | De utökade målplatserna där avbildningsversionen ska replikeras till. Den här egenskapen är uppdaterad. | GalleryTargetExtendedLocation[] |
targetRegions | Målregionerna där avbildningsversionen ska replikeras till. Den här egenskapen är uppdaterad. | TargetRegion[] |
GalleryApplicationVersionPublishingProfileAdvancedSettings
Namn | Beskrivning | Värde |
---|
GalleryApplicationVersionSafetyProfile
Namn | Beskrivning | Värde |
---|---|---|
allowDeletionOfReplicatedLocations | Anger om det är tillåtet att ta bort den här galleribildversionen från replikerade regioner. | Bool |
GalleryExtendedLocation
Namn | Beskrivning | Värde |
---|---|---|
Namn | sträng | |
typ | Det är typen av utökad plats. | "EdgeZone" "Okänd" |
GalleryTargetExtendedLocation
Namn | Beskrivning | Värde |
---|---|---|
kryptering | Valfri. Tillåter användare att tillhandahålla kundhanterade nycklar för kryptering av operativsystemet och datadiskarna i galleriartefakten. | EncryptionImages |
extendedLocation | Namnet på den utökade platsen. | GalleryExtendedLocation |
extendedLocationReplicaCount | Antalet repliker av avbildningsversionen som ska skapas per utökad plats. Den här egenskapen är uppdaterad. | Int |
Namn | Namnet på regionen. | sträng |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "Premium_LRS" "StandardSSD_LRS" "Standard_LRS" "Standard_ZRS" |
Microsoft.Compute/galleries/applications/versions
Namn | Beskrivning | Värde |
---|---|---|
plats | Resursplats | sträng (krävs) |
Namn | Resursnamnet | sträng (krävs) |
parent_id | ID för resursen som är överordnad för den här resursen. | ID för resurs av typen: gallerier/program |
Egenskaper | Beskriver egenskaperna för en galleriavbildningsversion. | GalleryApplicationVersionProperties |
Taggar | Resurstaggar | Ordlista med taggnamn och värden. |
typ | Resurstypen | "Microsoft.Compute/galleries/applications/versions@2024-03-03" |
OSDiskImageEncryption
Namn | Beskrivning | Värde |
---|---|---|
diskEncryptionSetId | En relativ URI som innehåller resurs-ID för diskkrypteringsuppsättningen. | sträng |
securityProfile | Den här egenskapen anger säkerhetsprofilen för en OS-diskavbildning. | OSDiskImageSecurityProfile |
OSDiskImageSecurityProfile
Namn | Beskrivning | Värde |
---|---|---|
confidentialVMEncryptionType | krypteringstyper för konfidentiella virtuella datorer | "EncryptedVMGuestStateOnlyWithPmk" "EncryptedWithCmk" "EncryptedWithPmk" "NonPersistedTPM" |
secureVMDiskEncryptionSetId | skydda ID för VM-diskkrypteringsuppsättning | sträng |
ResourceTags
Namn | Beskrivning | Värde |
---|
TargetRegion
Namn | Beskrivning | Värde |
---|---|---|
additionalReplicaSets | Lista över lagrings-SKU med antal repliker för att skapa direktenhetsrepliker. | AdditionalReplicaSet[] |
kryptering | Valfri. Tillåter användare att tillhandahålla kundhanterade nycklar för kryptering av operativsystemet och datadiskarna i galleriartefakten. | EncryptionImages |
excludeFromLatest | Innehåller flagginställningen för att dölja en bild när användare anger version='senaste' | Bool |
Namn | Namnet på regionen. | sträng (krävs) |
regionalReplicaCount | Antalet repliker av avbildningsversionen som ska skapas per region. Den här egenskapen är uppdaterad. | Int |
storageAccountType | Anger vilken lagringskontotyp som ska användas för att lagra avbildningen. Den här egenskapen är inte uppdaterad. | "PremiumV2_LRS" "Premium_LRS" "Standard_LRS" "Standard_ZRS" |
UserArtifactManage
Namn | Beskrivning | Värde |
---|---|---|
installera | Krävs. Sökvägen och argumenten för att installera galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng (krävs) |
avlägsna | Krävs. Sökvägen och argumenten för att ta bort galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng (krävs) |
uppdatera | Valfri. Sökvägen och argumenten för att uppdatera galleriprogrammet. Om den inte finns anropar uppdateringsåtgärden kommandot remove i den tidigare versionen och installerar kommandot på den aktuella versionen av galleriprogrammet. Detta är begränsat till 4 096 tecken. | sträng |
UserArtifactSettings
Namn | Beskrivning | Värde |
---|---|---|
configFileName | Valfri. Namnet för att tilldela den nedladdade konfigurationsfilen på den virtuella datorn. Detta är begränsat till 4 096 tecken. Om den inte anges får konfigurationsfilen namnet Galleriprogramnamn som läggs till med "_config". | sträng |
packageFileName | Valfri. Namnet på den nedladdade paketfilen på den virtuella datorn. Detta är begränsat till 4 096 tecken. Om den inte anges namnges paketfilen på samma sätt som namnet på galleriprogrammet. | sträng |
scriptBehaviorAfterReboot | Valfri. Den åtgärd som ska vidtas när det gäller att installera/uppdatera/ta bort galleriprogrammet i händelse av en omstart. | "Ingen" "Kör om" |
UserArtifactSource
Namn | Beskrivning | Värde |
---|---|---|
defaultConfigurationLink | Valfri. DefaultConfigurationLink för artefakten måste vara en läsbar lagringssideblob. | sträng |
mediaLink | Krävs. MediaLink för artefakten måste vara en läsbar lagringssideblob. | sträng (krävs) |