Bagikan melalui


Gallery Script Versions - Update

Perbarui Versi Skrip galeri.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
galleryName
path True

string

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

Nama Shared Image Gallery.

galleryScriptName
path True

string

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

Nama galeri Definisi skrip yang akan diambil.

galleryScriptVersionName
path True

string

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

Nama galeri Versi Skrip yang akan diambil.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
path True

string

minLength: 1

ID langganan target.

api-version
query True

string

minLength: 1

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
properties.publishingProfile True

GalleryScriptVersionPublishingProfile

Profil penerbitan versi gambar galeri.

properties.safetyProfile

GalleryScriptVersionSafetyProfile

Profil keamanan Versi Skrip Galeri.

tags

object

Tag sumber daya

Respons

Nama Jenis Deskripsi
200 OK

GalleryScriptVersion

Operasi Azure berhasil diselesaikan.

202 Accepted

Permintaan pembaruan sumber daya diterima.

Header

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

CloudError

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Permintaan sampel

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

Respon sampel

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

Definisi

Nama Deskripsi
AdditionalReplicaSet

Menjelaskan informasi set replika tambahan.

AggregatedReplicationState

Ini adalah status replikasi agregat berdasarkan semua bendera status replikasi regional.

ApiError

Kesalahan api.

ApiErrorBase

Basis kesalahan api.

CloudError

Respons kesalahan dari layanan Komputasi.

ConfidentialVMEncryptionType

Jenis enkripsi VM rahasia

createdByType

Jenis identitas yang membuat sumber daya.

DataDiskImageEncryption

Berisi pengaturan enkripsi untuk citra disk data.

EdgeZoneStorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Properti ini tidak dapat diperbarui.

EncryptionImages

Optional. Memungkinkan pengguna untuk menyediakan kunci yang dikelola pelanggan untuk mengenkripsi OS dan disk data dalam artefak galeri.

GalleryExtendedLocation

Nama lokasi yang diperluas.

GalleryExtendedLocationType

Ini adalah jenis lokasi yang diperluas.

GalleryProvisioningState

Status provisi, yang hanya muncul dalam respons.

GalleryScriptParameter

Definisi parameter yang dapat diteruskan ke skrip Versi Skrip Galeri.

GalleryScriptParameterType

Menentukan jenis parameter Skrip Galeri. Nilai yang mungkin adalah: String, Int, Double, Boolean, Enum

GalleryScriptVersion

Jenis sumber daya terlacak konkret dapat dibuat dengan alias jenis ini menggunakan jenis properti tertentu.

GalleryScriptVersionProperties

Menjelaskan properti versi skrip galeri.

GalleryScriptVersionPublishingProfile

Profil penerbitan versi gambar galeri.

GalleryScriptVersionSafetyProfile

Profil keamanan Versi Skrip Galeri.

GalleryScriptVersionUpdate

Menentukan informasi tentang galeri Versi Skrip yang ingin Anda perbarui.

GalleryTargetExtendedLocation
InnerError

Detail kesalahan dalam.

OSDiskImageEncryption

Berisi pengaturan enkripsi untuk citra disk OS.

OSDiskImageSecurityProfile

Berisi profil keamanan untuk citra disk OS.

RegionalReplicationStatus

Ini adalah status replikasi regional.

ReplicationMode

Parameter opsional yang menentukan mode yang akan digunakan untuk replikasi. Properti ini tidak dapat diperbarui.

ReplicationState

Ini adalah status replikasi regional.

ReplicationStatus

Ini adalah status replikasi versi gambar galeri.

ScriptSource

Skrip sumber dari mana Versi Skrip akan dibuat.

StorageAccountStrategy

Menentukan strategi yang akan digunakan saat memilih jenis akun penyimpanan. Tidak dapat ditentukan bersama dengan storageAccountType, tetapi dapat ditimpa per wilayah dengan menentukan targetRegions[].storageAccountType. Properti ini tidak dapat diperbarui.

StorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Properti ini tidak dapat diperbarui.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

TargetRegion

Menjelaskan informasi wilayah target.

AdditionalReplicaSet

Menjelaskan informasi set replika tambahan.

Nama Jenis Deskripsi
regionalReplicaCount

integer (int32)

Jumlah replika drive langsung dari Versi Gambar yang akan dibuat. Properti ini dapat diperbarui

storageAccountType

StorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk membuat replika drive langsung

AggregatedReplicationState

Ini adalah status replikasi agregat berdasarkan semua bendera status replikasi regional.

Nilai Deskripsi
Unknown
InProgress
Completed
Failed

ApiError

Kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

details

ApiErrorBase[]

Detail kesalahan Api

innererror

InnerError

Kesalahan dalam Api

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

ApiErrorBase

Basis kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

CloudError

Respons kesalahan dari layanan Komputasi.

Nama Jenis Deskripsi
error

ApiError

Kesalahan api.

ConfidentialVMEncryptionType

Jenis enkripsi VM rahasia

Nilai Deskripsi
EncryptedVMGuestStateOnlyWithPmk
EncryptedWithPmk
EncryptedWithCmk
NonPersistedTPM

createdByType

Jenis identitas yang membuat sumber daya.

Nilai Deskripsi
User
Application
ManagedIdentity
Key

DataDiskImageEncryption

Berisi pengaturan enkripsi untuk citra disk data.

Nama Jenis Deskripsi
diskEncryptionSetId

string

URI relatif yang berisi ID sumber daya dari set enkripsi disk.

lun

integer (int32)

Properti ini menentukan nomor unit logis disk data. Nilai ini digunakan untuk mengidentifikasi disk data dalam Komputer Virtual dan oleh karena itu harus unik untuk setiap disk data yang terpasang pada Komputer Virtual.

EdgeZoneStorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Properti ini tidak dapat diperbarui.

Nilai Deskripsi
Standard_LRS
Standard_ZRS
StandardSSD_LRS
Premium_LRS

EncryptionImages

Optional. Memungkinkan pengguna untuk menyediakan kunci yang dikelola pelanggan untuk mengenkripsi OS dan disk data dalam artefak galeri.

Nama Jenis Deskripsi
dataDiskImages

DataDiskImageEncryption[]

Daftar spesifikasi enkripsi untuk gambar disk data.

osDiskImage

OSDiskImageEncryption

Berisi pengaturan enkripsi untuk citra disk OS.

GalleryExtendedLocation

Nama lokasi yang diperluas.

Nama Jenis Deskripsi
name

string

type

GalleryExtendedLocationType

Ini adalah jenis lokasi yang diperluas.

GalleryExtendedLocationType

Ini adalah jenis lokasi yang diperluas.

Nilai Deskripsi
EdgeZone
Unknown

GalleryProvisioningState

Status provisi, yang hanya muncul dalam respons.

Nilai Deskripsi
Creating
Updating
Failed
Succeeded
Deleting
Migrating

GalleryScriptParameter

Definisi parameter yang dapat diteruskan ke skrip Versi Skrip Galeri.

Nama Jenis Deskripsi
defaultValue

string

Nilai default parameter, hanya berlaku untuk jenis string.

description

string

Deskripsi untuk membantu pengguna memahami arti parameter ini

enumValues

string[]

Daftar nilai yang diizinkan. Hanya nilai yang berlaku dari nilai 'enum' yang ditentukan dalam 'GalleryScriptParameter'.

maxValue

string

Nilai minimum parameter.

minValue

string

Nilai minimum parameter.

name

string

Nama parameter.

required

boolean

Menunjukkan apakah parameter ini harus diteruskan.

type

GalleryScriptParameterType

Menentukan jenis parameter Skrip Galeri. Nilai yang mungkin adalah: String, Int, Double, Boolean, Enum

GalleryScriptParameterType

Menentukan jenis parameter Skrip Galeri. Nilai yang mungkin adalah: String, Int, Double, Boolean, Enum

Nilai Deskripsi
String

Jenis parameter skrip galeri string

Int

Jenis parameter skrip galeri Int

Double

Jenis parameter skrip galeri ganda

Boolean

Jenis parameter skrip galeri Boolean

Enum

Jenis parameter skrip galeri enum

GalleryScriptVersion

Jenis sumber daya terlacak konkret dapat dibuat dengan alias jenis ini menggunakan jenis properti tertentu.

Nama Jenis Deskripsi
id

string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya

properties

GalleryScriptVersionProperties

Menjelaskan properti galeri Versi Skrip.

systemData

systemData

Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

GalleryScriptVersionProperties

Menjelaskan properti versi skrip galeri.

Nama Jenis Deskripsi
provisioningState

GalleryProvisioningState

Status provisi, yang hanya muncul dalam respons.

publishingProfile

GalleryScriptVersionPublishingProfile

Profil penerbitan versi gambar galeri.

replicationStatus

ReplicationStatus

Ini adalah status replikasi versi gambar galeri.

safetyProfile

GalleryScriptVersionSafetyProfile

Profil keamanan Versi Skrip Galeri.

GalleryScriptVersionPublishingProfile

Profil penerbitan versi gambar galeri.

Nama Jenis Deskripsi
endOfLifeDate

string (date-time)

Tanggal akhir masa pakai versi gambar galeri. Properti ini dapat digunakan untuk tujuan penonaktifan. Properti ini dapat diperbarui.

excludeFromLatest

boolean

Jika diatur ke true, Komputer Virtual yang disebarkan dari versi terbaru Definisi Gambar tidak akan menggunakan Versi Gambar ini.

publishedDate

string (date-time)

Tanda waktu saat versi gambar galeri diterbitkan.

replicaCount

integer (int32)

Jumlah replika Versi Gambar yang akan dibuat per wilayah. Properti ini akan berlaku untuk wilayah ketika regionalReplicaCount tidak ditentukan. Properti ini dapat diperbarui.

replicationMode

ReplicationMode

Parameter opsional yang menentukan mode yang akan digunakan untuk replikasi. Properti ini tidak dapat diperbarui.

source

ScriptSource

Skrip sumber dari mana Versi Skrip akan dibuat.

storageAccountStrategy

StorageAccountStrategy

Menentukan strategi yang akan digunakan saat memilih jenis akun penyimpanan. Tidak dapat ditentukan bersama dengan storageAccountType, tetapi dapat ditimpa per wilayah dengan menentukan targetRegions[].storageAccountType. Properti ini tidak dapat diperbarui.

storageAccountType

StorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Tidak dapat ditentukan bersama dengan storageAccountStrategy. Properti ini tidak dapat diperbarui.

targetExtendedLocations

GalleryTargetExtendedLocation[]

Lokasi yang diperluas target tempat Versi Gambar akan direplikasi. Properti ini dapat diperbarui.

targetRegions

TargetRegion[]

Wilayah target tempat Versi Gambar akan direplikasi. Properti ini dapat diperbarui.

GalleryScriptVersionSafetyProfile

Profil keamanan Versi Skrip Galeri.

Nama Jenis Deskripsi
allowDeletionOfReplicatedLocations

boolean

Menunjukkan apakah Versi Gambar Galeri ini diizinkan atau tidak menghapus Versi Gambar Galeri ini dari wilayah yang direplikasi.

GalleryScriptVersionUpdate

Menentukan informasi tentang galeri Versi Skrip yang ingin Anda perbarui.

Nama Jenis Deskripsi
id

string

Id Sumber Daya

name

string

Nama sumber daya

properties.provisioningState

GalleryProvisioningState

Status provisi, yang hanya muncul dalam respons.

properties.publishingProfile

GalleryScriptVersionPublishingProfile

Profil penerbitan versi gambar galeri.

properties.replicationStatus

ReplicationStatus

Ini adalah status replikasi versi gambar galeri.

properties.safetyProfile

GalleryScriptVersionSafetyProfile

Profil keamanan Versi Skrip Galeri.

tags

object

Tag sumber daya

type

string

Jenis sumber daya

GalleryTargetExtendedLocation

Nama Jenis Deskripsi
encryption

EncryptionImages

Optional. Memungkinkan pengguna untuk menyediakan kunci yang dikelola pelanggan untuk mengenkripsi OS dan disk data dalam artefak galeri.

extendedLocation

GalleryExtendedLocation

Nama lokasi yang diperluas.

extendedLocationReplicaCount

integer (int32)

Jumlah replika Versi Gambar yang akan dibuat per lokasi yang diperluas. Properti ini dapat diperbarui.

name

string

Nama wilayah.

storageAccountType

EdgeZoneStorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Properti ini tidak dapat diperbarui.

InnerError

Detail kesalahan dalam.

Nama Jenis Deskripsi
errordetail

string

Pesan kesalahan internal atau cadangan pengecualian.

exceptiontype

string

Jenis pengecualian.

OSDiskImageEncryption

Berisi pengaturan enkripsi untuk citra disk OS.

Nama Jenis Deskripsi
diskEncryptionSetId

string

URI relatif yang berisi ID sumber daya dari set enkripsi disk.

securityProfile

OSDiskImageSecurityProfile

Properti ini menentukan profil keamanan citra disk OS.

OSDiskImageSecurityProfile

Berisi profil keamanan untuk citra disk OS.

Nama Jenis Deskripsi
confidentialVMEncryptionType

ConfidentialVMEncryptionType

Jenis enkripsi VM rahasia

secureVMDiskEncryptionSetId

string

id set enkripsi disk VM aman

RegionalReplicationStatus

Ini adalah status replikasi regional.

Nama Jenis Deskripsi
details

string

Detail status replikasi.

progress

integer (int32)

Ini menunjukkan kemajuan pekerjaan replikasi.

region

string

Wilayah tempat versi gambar galeri sedang direplikasi.

state

ReplicationState

Ini adalah status replikasi regional.

ReplicationMode

Parameter opsional yang menentukan mode yang akan digunakan untuk replikasi. Properti ini tidak dapat diperbarui.

Nilai Deskripsi
Full
Shallow

ReplicationState

Ini adalah status replikasi regional.

Nilai Deskripsi
Unknown
Replicating
Completed
Failed

ReplicationStatus

Ini adalah status replikasi versi gambar galeri.

Nama Jenis Deskripsi
aggregatedState

AggregatedReplicationState

Ini adalah status replikasi agregat berdasarkan semua bendera status replikasi regional.

summary

RegionalReplicationStatus[]

Ini adalah ringkasan status replikasi untuk setiap wilayah.

ScriptSource

Skrip sumber dari mana Versi Skrip akan dibuat.

Nama Jenis Deskripsi
parameters

GalleryScriptParameter[]

Optional. Setiap parameter input yang perlu diteruskan ke skrip dan diakses dalam skrip untuk eksekusinya.

scriptLink

string

Dibutuhkan. Tautan skrip sumber, itu harus berupa blob penyimpanan yang dapat dibaca dengan URI SAS atau URI yang dapat diakses publik atau identitas terkelola diaktifkan.

StorageAccountStrategy

Menentukan strategi yang akan digunakan saat memilih jenis akun penyimpanan. Tidak dapat ditentukan bersama dengan storageAccountType, tetapi dapat ditimpa per wilayah dengan menentukan targetRegions[].storageAccountType. Properti ini tidak dapat diperbarui.

Nilai Deskripsi
PreferStandard_ZRS

Pilih penyimpanan Standard_ZRS jika wilayah mendukungnya, jika tidak, pilih penyimpanan Standard_LRS, kecuali ditimpa dengan menentukan storageAccountType regional. Jika tidak ada storageAccountStrategy yang ditentukan, ini adalah strategi default (mulai API versi 2025-03-03 dan seterusnya).

DefaultStandard_LRS

Pilih penyimpanan Standard_LRS kecuali ditimpa dengan menentukan storageAccountType regional.

StorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Properti ini tidak dapat diperbarui.

Nilai Deskripsi
Standard_LRS
Standard_ZRS
Premium_LRS
PremiumV2_LRS

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string (date-time)

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string (date-time)

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.

TargetRegion

Menjelaskan informasi wilayah target.

Nama Jenis Deskripsi
additionalReplicaSets

AdditionalReplicaSet[]

Daftar sku penyimpanan dengan jumlah replika untuk membuat replika drive langsung.

encryption

EncryptionImages

Optional. Memungkinkan pengguna untuk menyediakan kunci yang dikelola pelanggan untuk mengenkripsi OS dan disk data dalam artefak galeri.

excludeFromLatest

boolean

Berisi pengaturan bendera untuk menyembunyikan gambar saat pengguna menentukan version='latest'

name

string

Nama wilayah.

regionalReplicaCount

integer (int32)

Jumlah replika Versi Gambar yang akan dibuat per wilayah. Properti ini dapat diperbarui.

storageAccountType

StorageAccountType

Menentukan jenis akun penyimpanan yang akan digunakan untuk menyimpan gambar. Properti ini tidak dapat diperbarui.