Megosztás a következőn keresztül:


Gallery Script Versions - Update

Frissíts egy galéria szkriptverzióját.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/scripts/{galleryScriptName}/versions/{galleryScriptVersionName}?api-version=2025-03-03

URI-paraméterek

Name In Kötelező Típus Description
galleryName
path True

string

pattern: ^[^_\W][\w-._]{0,79}(?

A megosztott képtár neve.

galleryScriptName
path True

string

pattern: ^[a-zA-Z0-9]+([_]?[a-zA-Z0-9]+)*$

A galéria neve: A Script Definition, amit le kell kérni.

galleryScriptVersionName
path True

string

pattern: ^[0-9]+\.[0-9]+\.[0-9]+$

A galéria neve: A Script Version, amelyet le kell kérni.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
path True

string

minLength: 1

A cél-előfizetés azonosítója.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

Kérelem törzse

Name Kötelező Típus Description
properties.publishingProfile True

GalleryScriptVersionPublishingProfile

A katalógus képverziójának közzétételi profilja.

properties.safetyProfile

GalleryScriptVersionSafetyProfile

A Galéria Szkriptváltozat biztonsági profilja.

tags

object

Erőforráscímkék

Válaszok

Name Típus Description
200 OK

GalleryScriptVersion

Az Azure-művelet sikeresen befejeződött.

202 Accepted

Az erőforrás-frissítési kérelem elfogadva.

Fejlécek

  • Azure-AsyncOperation: string
  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

Mintakérelem

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/galleries/myGalleryName/scripts/myGalleryScriptName/versions/1.0.0?api-version=2025-03-03

{
  "properties": {
    "publishingProfile": {
      "source": {
        "scriptLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/myScript.ps1?{sasKey}",
        "parameters": [
          {
            "name": "location",
            "required": true,
            "defaultValue": "westus",
            "type": "String"
          },
          {
            "name": "myGalleryScriptParameter1",
            "required": true,
            "type": "String",
            "defaultValue": "default value of parameter",
            "description": "description of the parameter"
          },
          {
            "name": "myGalleryScriptParameter2",
            "required": false,
            "type": "String",
            "defaultValue": "default value of parameter",
            "description": "description of the parameter"
          },
          {
            "name": "numberOfUnits",
            "required": true,
            "type": "Int",
            "defaultValue": "3",
            "description": "description of the parameter",
            "minValue": "1",
            "maxValue": "5"
          },
          {
            "name": "weightOfUnit",
            "required": true,
            "type": "Double",
            "defaultValue": "0.6",
            "description": "description of the parameter",
            "minValue": "0.1",
            "maxValue": "2"
          },
          {
            "name": "typeOfProduct",
            "required": false,
            "type": "Enum",
            "defaultValue": "Fruit",
            "description": "description of the parameter",
            "enumValues": [
              "Fruit",
              "Vegetable",
              "Greens",
              "Nuts"
            ]
          }
        ]
      },
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_LRS",
          "excludeFromLatest": false
        }
      ],
      "replicaCount": 2,
      "endOfLifeDate": "2027-07-01T07:00:00Z",
      "storageAccountType": "Standard_LRS"
    },
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": false
    }
  }
}

Mintaválasz

{
  "location": "West US",
  "name": "1.0.0",
  "type": "Microsoft.Compute/galleries/scripts/versions",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/galleries/myGalleryName/scripts/myGalleryScriptName/versions/1.0.0",
  "properties": {
    "publishingProfile": {
      "source": {
        "scriptLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/myScript.ps1",
        "parameters": [
          {
            "name": "location",
            "required": true,
            "defaultValue": "westus",
            "type": "String"
          },
          {
            "name": "myGalleryScriptParameter1",
            "required": true,
            "type": "String",
            "defaultValue": "default value of parameter",
            "description": "description of the parameter"
          },
          {
            "name": "myGalleryScriptParameter2",
            "required": false,
            "type": "String",
            "defaultValue": "default value of parameter",
            "description": "description of the parameter"
          },
          {
            "name": "numberOfUnits",
            "required": true,
            "type": "Int",
            "defaultValue": "3",
            "description": "description of the parameter",
            "minValue": "1",
            "maxValue": "5"
          },
          {
            "name": "weightOfUnit",
            "required": true,
            "type": "Double",
            "defaultValue": "0.6",
            "description": "description of the parameter",
            "minValue": "0.1",
            "maxValue": "2"
          },
          {
            "name": "typeOfProduct",
            "required": false,
            "type": "Enum",
            "defaultValue": "Fruit",
            "description": "description of the parameter",
            "enumValues": [
              "Fruit",
              "Vegetable",
              "Greens",
              "Nuts"
            ]
          }
        ]
      },
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_LRS",
          "excludeFromLatest": false
        }
      ],
      "replicaCount": 2,
      "excludeFromLatest": false,
      "publishedDate": "2025-06-21T17:13:57.5972568+00:00",
      "endOfLifeDate": "2027-07-01T07:00:00+00:00",
      "storageAccountType": "Standard_LRS"
    },
    "safetyProfile": {
      "allowDeletionOfReplicatedLocations": false
    },
    "provisioningState": "Updating"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/000000-8de3-42e7-b00e-8970003527749a/providers/Microsoft.Compute/locations/eastus/capsOperations/0012b61c-2d36-40bc-b7ed-1f0e48757277?api-version=2025-03-03
Location: https://management.azure.com/subscriptions/000000-8de3-42e7-b00e-8970003527749a/providers/Microsoft.Compute/locations/eastus/capsOperations/0012b61c-2d36-40bc-b7ed-1f0e48757277?monitor=true&api-version=2025-03-03

Definíciók

Name Description
AdditionalReplicaSet

A replikakészlet további információinak ismertetése.

AggregatedReplicationState

Ez az összes regionális replikációs állapotjelző alapján összesített replikációs állapot.

ApiError

Api-hiba.

ApiErrorBase

Api-hibabázis.

CloudError

Hibaválasz a Compute szolgáltatástól.

ConfidentialVMEncryptionType

bizalmas virtuálisgép-titkosítási típusok

createdByType

Az erőforrást létrehozó identitás típusa.

DataDiskImageEncryption

Adatlemezkép titkosítási beállításait tartalmazza.

EdgeZoneStorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Ez a tulajdonság nem frissíthető.

EncryptionImages

Opcionális. Lehetővé teszi a felhasználók számára, hogy ügyfél által felügyelt kulcsokat adjanak meg az operációs rendszer és az adatlemezek titkosításához a katalógus összetevőjében.

GalleryExtendedLocation

A kiterjesztett hely neve.

GalleryExtendedLocationType

Ez a kiterjesztett hely típusa.

GalleryProvisioningState

A kiépítési állapot, amely csak a válaszban jelenik meg.

GalleryScriptParameter

Egy olyan paraméter definíciója, amely átadható egy Gallery Script verzió szkriptjének.

GalleryScriptParameterType

Megadja a Galéria Szkript paraméter típusát. Lehetséges értékek: String, Int, Double, Boolean, Enum

GalleryScriptVersion

A konkrét nyomon követett erőforrástípusok úgy hozhatók létre, hogy ezt a típust egy adott tulajdonságtípus használatával aliasként használják.

GalleryScriptVersionProperties

Leírja a galéria szkript verzió tulajdonságait.

GalleryScriptVersionPublishingProfile

A katalógus képverziójának közzétételi profilja.

GalleryScriptVersionSafetyProfile

A Galéria Szkriptváltozat biztonsági profilja.

GalleryScriptVersionUpdate

Megadja az információt a galéria Script Version-ról, amelyet frissíteni szeretnél.

GalleryTargetExtendedLocation
InnerError

Belső hiba részletei.

OSDiskImageEncryption

Az operációsrendszer-lemezkép titkosítási beállításait tartalmazza.

OSDiskImageSecurityProfile

Operációsrendszer-lemezkép biztonsági profilját tartalmazza.

RegionalReplicationStatus

Ez a regionális replikáció állapota.

ReplicationMode

Nem kötelező paraméter, amely megadja a replikációhoz használandó módot. Ez a tulajdonság nem frissíthető.

ReplicationState

Ez a regionális replikáció állapota.

ReplicationStatus

Ez a katalógus képverziójának replikációs állapota.

ScriptSource

Az a forrásszkript, amelyből a Script Verziót fogják létrehozni.

StorageAccountStrategy

Megadja a stratégiát a tárolószámla típusának kiválasztásakor. Nem lehet a storageAccountType mellett megadni, de régiónként felülírható a targetRegions[].storageAccountType megadásával. Ez a tulajdonság nem frissíthető.

StorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Ez a tulajdonság nem frissíthető.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

TargetRegion

A célrégió adatait ismerteti.

AdditionalReplicaSet

A replikakészlet további információinak ismertetése.

Name Típus Description
regionalReplicaCount

integer (int32)

A létrehozandó képverzió közvetlen meghajtóreplikáinak száma. Ez a tulajdonság frissíthető

storageAccountType

StorageAccountType

Megadja a közvetlen meghajtóreplikák létrehozásához használandó tárfiók típusát

AggregatedReplicationState

Ez az összes regionális replikációs állapotjelző alapján összesített replikációs állapot.

Érték Description
Unknown
InProgress
Completed
Failed

ApiError

Api-hiba.

Name Típus Description
code

string

A hibakód.

details

ApiErrorBase[]

Az API-hiba részletei

innererror

InnerError

Az Api belső hibája

message

string

A hibaüzenet.

target

string

Az adott hiba célja.

ApiErrorBase

Api-hibabázis.

Name Típus Description
code

string

A hibakód.

message

string

A hibaüzenet.

target

string

Az adott hiba célja.

CloudError

Hibaválasz a Compute szolgáltatástól.

Name Típus Description
error

ApiError

Api-hiba.

ConfidentialVMEncryptionType

bizalmas virtuálisgép-titkosítási típusok

Érték Description
EncryptedVMGuestStateOnlyWithPmk
EncryptedWithPmk
EncryptedWithCmk
NonPersistedTPM

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
User
Application
ManagedIdentity
Key

DataDiskImageEncryption

Adatlemezkép titkosítási beállításait tartalmazza.

Name Típus Description
diskEncryptionSetId

string

A lemeztitkosítási csoport erőforrás-azonosítóját tartalmazó relatív URI.

lun

integer (int32)

Ez a tulajdonság az adatlemez logikai egységszámát adja meg. Ez az érték a virtuális gépen belüli adatlemezek azonosítására szolgál, ezért egyedinek kell lennie a virtuális géphez csatlakoztatott minden adatlemez esetében.

EdgeZoneStorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Ez a tulajdonság nem frissíthető.

Érték Description
Standard_LRS
Standard_ZRS
StandardSSD_LRS
Premium_LRS

EncryptionImages

Opcionális. Lehetővé teszi a felhasználók számára, hogy ügyfél által felügyelt kulcsokat adjanak meg az operációs rendszer és az adatlemezek titkosításához a katalógus összetevőjében.

Name Típus Description
dataDiskImages

DataDiskImageEncryption[]

Az adatlemezképek titkosítási specifikációinak listája.

osDiskImage

OSDiskImageEncryption

Az operációsrendszer-lemezkép titkosítási beállításait tartalmazza.

GalleryExtendedLocation

A kiterjesztett hely neve.

Name Típus Description
name

string

type

GalleryExtendedLocationType

Ez a kiterjesztett hely típusa.

GalleryExtendedLocationType

Ez a kiterjesztett hely típusa.

Érték Description
EdgeZone
Unknown

GalleryProvisioningState

A kiépítési állapot, amely csak a válaszban jelenik meg.

Érték Description
Creating
Updating
Failed
Succeeded
Deleting
Migrating

GalleryScriptParameter

Egy olyan paraméter definíciója, amely átadható egy Gallery Script verzió szkriptjének.

Name Típus Description
defaultValue

string

A paraméter alapértelmezett értéke csak a string típusokra vonatkozik.

description

string

Leírás, amely segít a felhasználóknak megérteni, mit jelent ez a paraméter

enumValues

string[]

Egy lista a megengedett értékekről. Csak az alkalmazható értékek a 'GalleryScriptParameter' által definiált 'enum' értékekből származnak.

maxValue

string

A paraméter minimális értéke.

minValue

string

A paraméter minimális értéke.

name

string

A paraméter neve.

required

boolean

Jelzi, hogy ezt a paramétert át kell adni.

type

GalleryScriptParameterType

Megadja a Galéria Szkript paraméter típusát. Lehetséges értékek: String, Int, Double, Boolean, Enum

GalleryScriptParameterType

Megadja a Galéria Szkript paraméter típusát. Lehetséges értékek: String, Int, Double, Boolean, Enum

Érték Description
String

Stringgaléria szkript paramétertípus

Int

Int galéria szkript paramétertípus

Double

Dupla galéria szkript paramétertípus

Boolean

Boolean galéria szkript paramétertípus

Enum

Enum galéria szkript paramétertípus

GalleryScriptVersion

A konkrét nyomon követett erőforrástípusok úgy hozhatók létre, hogy ezt a típust egy adott tulajdonságtípus használatával aliasként használják.

Name Típus Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Example - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Az a földrajzi hely, ahol az erőforrás él

name

string

Az erőforrás neve

properties

GalleryScriptVersionProperties

Leírja a galéria szkriptverziójának tulajdonságait.

systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

tags

object

Erőforráscímkék.

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

GalleryScriptVersionProperties

Leírja a galéria szkript verzió tulajdonságait.

Name Típus Description
provisioningState

GalleryProvisioningState

A kiépítési állapot, amely csak a válaszban jelenik meg.

publishingProfile

GalleryScriptVersionPublishingProfile

A katalógus képverziójának közzétételi profilja.

replicationStatus

ReplicationStatus

Ez a katalógus képverziójának replikációs állapota.

safetyProfile

GalleryScriptVersionSafetyProfile

A Galéria Szkriptváltozat biztonsági profilja.

GalleryScriptVersionPublishingProfile

A katalógus képverziójának közzétételi profilja.

Name Típus Description
endOfLifeDate

string (date-time)

A katalógus képverziójának lejárati dátuma. Ez a tulajdonság leszerelési célokra használható. Ez a tulajdonság frissíthető.

excludeFromLatest

boolean

Ha igaz értékre van állítva, a rendszerképdefiníció legújabb verziójából üzembe helyezett virtuális gépek ezt a rendszerképverziót nem fogják használni.

publishedDate

string (date-time)

A katalógus képverziójának közzétételének időbélyege.

replicaCount

integer (int32)

A létrehozandó képverzió replikáinak száma régiónként. Ez a tulajdonság akkor lép érvénybe egy régióban, ha a regionalReplicaCount nincs megadva. Ez a tulajdonság frissíthető.

replicationMode

ReplicationMode

Nem kötelező paraméter, amely megadja a replikációhoz használandó módot. Ez a tulajdonság nem frissíthető.

source

ScriptSource

Az a forrásszkript, amelyből a Script Verziót fogják létrehozni.

storageAccountStrategy

StorageAccountStrategy

Megadja a stratégiát a tárolószámla típusának kiválasztásakor. Nem lehet a storageAccountType mellett megadni, de régiónként felülírható a targetRegions[].storageAccountType megadásával. Ez a tulajdonság nem frissíthető.

storageAccountType

StorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Nem lehet megadni a storageAccountStrategy mellett. Ez a tulajdonság nem frissíthető.

targetExtendedLocations

GalleryTargetExtendedLocation[]

A célként megadott kiterjesztett helyek, ahová a rendszerképverzió replikálva lesz. Ez a tulajdonság frissíthető.

targetRegions

TargetRegion[]

Azok a célrégiók, amelyekbe a rendszerképverzió replikálva lesz. Ez a tulajdonság frissíthető.

GalleryScriptVersionSafetyProfile

A Galéria Szkriptváltozat biztonsági profilja.

Name Típus Description
allowDeletionOfReplicatedLocations

boolean

Azt jelzi, hogy engedélyezett-e a katalógus képverziója eltávolítása a replikált régiókból.

GalleryScriptVersionUpdate

Megadja az információt a galéria Script Version-ról, amelyet frissíteni szeretnél.

Name Típus Description
id

string

Erőforrás-azonosító

name

string

Erőforrás neve

properties.provisioningState

GalleryProvisioningState

A kiépítési állapot, amely csak a válaszban jelenik meg.

properties.publishingProfile

GalleryScriptVersionPublishingProfile

A katalógus képverziójának közzétételi profilja.

properties.replicationStatus

ReplicationStatus

Ez a katalógus képverziójának replikációs állapota.

properties.safetyProfile

GalleryScriptVersionSafetyProfile

A Galéria Szkriptváltozat biztonsági profilja.

tags

object

Erőforráscímkék

type

string

Erőforrás típusa

GalleryTargetExtendedLocation

Name Típus Description
encryption

EncryptionImages

Opcionális. Lehetővé teszi a felhasználók számára, hogy ügyfél által felügyelt kulcsokat adjanak meg az operációs rendszer és az adatlemezek titkosításához a katalógus összetevőjében.

extendedLocation

GalleryExtendedLocation

A kiterjesztett hely neve.

extendedLocationReplicaCount

integer (int32)

A kiterjesztett helyenkénti létrehozandó képverzió replikáinak száma. Ez a tulajdonság frissíthető.

name

string

A régió neve.

storageAccountType

EdgeZoneStorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Ez a tulajdonság nem frissíthető.

InnerError

Belső hiba részletei.

Name Típus Description
errordetail

string

A belső hibaüzenet vagy kivételkép.

exceptiontype

string

A kivétel típusa.

OSDiskImageEncryption

Az operációsrendszer-lemezkép titkosítási beállításait tartalmazza.

Name Típus Description
diskEncryptionSetId

string

A lemeztitkosítási csoport erőforrás-azonosítóját tartalmazó relatív URI.

securityProfile

OSDiskImageSecurityProfile

Ez a tulajdonság egy operációsrendszer-lemezkép biztonsági profilját adja meg.

OSDiskImageSecurityProfile

Operációsrendszer-lemezkép biztonsági profilját tartalmazza.

Name Típus Description
confidentialVMEncryptionType

ConfidentialVMEncryptionType

bizalmas virtuálisgép-titkosítási típusok

secureVMDiskEncryptionSetId

string

biztonságos virtuálisgép-lemeztitkosítási csoport azonosítója

RegionalReplicationStatus

Ez a regionális replikáció állapota.

Name Típus Description
details

string

A replikáció állapotának részletei.

progress

integer (int32)

A replikációs feladat előrehaladását jelzi.

region

string

Az a régió, amelyre a katalógus képverziója replikálva van.

state

ReplicationState

Ez a regionális replikáció állapota.

ReplicationMode

Nem kötelező paraméter, amely megadja a replikációhoz használandó módot. Ez a tulajdonság nem frissíthető.

Érték Description
Full
Shallow

ReplicationState

Ez a regionális replikáció állapota.

Érték Description
Unknown
Replicating
Completed
Failed

ReplicationStatus

Ez a katalógus képverziójának replikációs állapota.

Name Típus Description
aggregatedState

AggregatedReplicationState

Ez az összes regionális replikációs állapotjelző alapján összesített replikációs állapot.

summary

RegionalReplicationStatus[]

Ez az egyes régiók replikációs állapotának összegzése.

ScriptSource

Az a forrásszkript, amelyből a Script Verziót fogják létrehozni.

Name Típus Description
parameters

GalleryScriptParameter[]

Opcionális. Bármilyen bemeneti paraméter, amelyet át kell adni a szkriptnek, és amelyeket a szkriptben elérhetők a végrehajtáshoz.

scriptLink

string

Szükséges. A forrásszkript linkje egy olvasható tároló tömbnek kell lennie, amelyen SAS URI vagy nyilvánosan elérhető URI vagy menedzselt identitás van engedélyezve.

StorageAccountStrategy

Megadja a stratégiát a tárolószámla típusának kiválasztásakor. Nem lehet a storageAccountType mellett megadni, de régiónként felülírható a targetRegions[].storageAccountType megadásával. Ez a tulajdonság nem frissíthető.

Érték Description
PreferStandard_ZRS

Válassz Standard_ZRS tárhelyet, ha a régió támogatja, különben válassz Standard_LRS tárhelyet, hacsak nem írod felül a regionális storageAccountType megadásával. Ha nincs megadva storageAccountStrategy, ez az alapértelmezett stratégia (az API verzió 2025-03-03-tól kezdve).

DefaultStandard_LRS

Válassz Standard_LRS tárhelyet, hacsak nem írják felül a regionális storageAccountType meghatározással.

StorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Ez a tulajdonság nem frissíthető.

Érték Description
Standard_LRS
Standard_ZRS
Premium_LRS
PremiumV2_LRS

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.

TargetRegion

A célrégió adatait ismerteti.

Name Típus Description
additionalReplicaSets

AdditionalReplicaSet[]

A közvetlen meghajtóreplikák létrehozásához használható tárváltozatok listája replikák számával.

encryption

EncryptionImages

Opcionális. Lehetővé teszi a felhasználók számára, hogy ügyfél által felügyelt kulcsokat adjanak meg az operációs rendszer és az adatlemezek titkosításához a katalógus összetevőjében.

excludeFromLatest

boolean

A rendszerkép elrejtésére szolgáló jelölőbeállítást tartalmazza, amikor a felhasználók a version='latest' értéket adják meg

name

string

A régió neve.

regionalReplicaCount

integer (int32)

A létrehozandó képverzió replikáinak száma régiónként. Ez a tulajdonság frissíthető.

storageAccountType

StorageAccountType

Megadja a rendszerkép tárolásához használandó tárfiók típusát. Ez a tulajdonság nem frissíthető.