Gallery Images - Create Or Update

Skapa eller uppdatera en galleribilddefinition.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2025-03-03

URI-parametrar

Name I Obligatorisk Typ Description
galleryImageName
path True

string

Namnet på den galleribilddefinition som ska hämtas.

galleryName
path True

string

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

Namnet på Shared Image Gallery.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

minLength: 1

ID för målprenumerationen.

api-version
query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
location True

string

Den geo-plats där resursen finns

properties.identifier True

GalleryImageIdentifier

Det här är galleribildens definitionsidentifierare.

properties.osState True

OperatingSystemStateTypes

Med den här egenskapen kan användaren ange om de virtuella datorer som skapas under den här avbildningen är "Generaliserade" eller "Specialiserade".

properties.osType True

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken när du skapar en virtuell dator från en hanterad avbildning. Möjliga värden är: Windows,Linux.

properties.allowUpdateImage

boolean

Valfritt. Måste anges till sant om galleribildfunktionerna uppdateras.

properties.architecture

Architecture

Bildens arkitektur. Gäller endast os-diskar.

properties.description

string

Beskrivningen av den här galleribilddefinitionsresursen. Den här egenskapen är uppdaterad.

properties.disallowed

Disallowed

Beskriver de otillåtna disktyperna.

properties.endOfLifeDate

string (date-time)

Slutdatumet för galleribilddefinitionen. Den här egenskapen kan användas för avaktivering. Den här egenskapen är uppdaterad.

properties.eula

string

Eula-avtalet för galleribilddefinitionen.

properties.features

GalleryImageFeature[]

En lista över galleribildfunktioner.

properties.hyperVGeneration

HyperVGeneration

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar.

properties.privacyStatementUri

string

Sekretesspolicyns URI.

properties.purchasePlan

ImagePurchasePlan

Beskriver köpplanen för galleribildens definition. Detta används av Marketplace-avbildningar.

properties.recommended

RecommendedMachineConfiguration

Egenskaperna beskriver den rekommenderade datorkonfigurationen för den här bilddefinitionen. De här egenskaperna är uppdaterade.

properties.releaseNoteUri

string

Versionsantecknings-URI:n.

tags

object

Resursetiketter.

Svar

Name Typ Description
200 OK

GalleryImage

Resursens uppdateringsåtgärd "GalleryImage" har slutförts

201 Created

GalleryImage

Resursen GalleryImage-skapandeåtgärden lyckades

Sidhuvuden

  • Location: string
  • Retry-After: integer
202 Accepted

GalleryImage

Begäran har godkänts för bearbetning, men bearbetningen har ännu inte slutförts.

Sidhuvuden

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

CloudError

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Exempelbegäran

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2025-03-03

{
  "location": "West US",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    }
  }
}

Exempelsvar

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Creating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName",
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "myGalleryImageName"
}

Definitioner

Name Description
ApiError

API-fel.

ApiErrorBase

bas för API-fel.

Architecture

Bildens arkitektur. Gäller endast os-diskar.

CloudError

Ett felsvar från beräkningstjänsten.

createdByType

Den typ av identitet som skapade resursen.

Disallowed

Beskriver de otillåtna disktyperna.

GalleryImage

Anger information om den galleribilddefinition som du vill skapa eller uppdatera.

GalleryImageFeature

En funktion för galleribild.

GalleryImageIdentifier

Det här är galleribildens definitionsidentifierare.

GalleryProvisioningState

Etableringstillståndet, som bara visas i svaret.

HyperVGeneration

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar.

ImagePurchasePlan

Beskriver köpplanen för galleribildens definition. Detta används av Marketplace-avbildningar.

InnerError

Inre felinformation.

OperatingSystemStateTypes

Med den här egenskapen kan användaren ange om de virtuella datorer som skapas under den här avbildningen är "Generaliserade" eller "Specialiserade".

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken när du skapar en virtuell dator från en hanterad avbildning. Möjliga värden är: Windows,Linux.

RecommendedMachineConfiguration

Egenskaperna beskriver den rekommenderade datorkonfigurationen för den här bilddefinitionen. De här egenskaperna är uppdaterade.

ResourceRange

Beskriver resursintervallet.

systemData

Metadata som rör skapande och senaste ändring av resursen.

ApiError

API-fel.

Name Typ Description
code

string

Felkoden.

details

ApiErrorBase[]

Information om API-fel

innererror

InnerError

Det inre API-felet

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

ApiErrorBase

bas för API-fel.

Name Typ Description
code

string

Felkoden.

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

Architecture

Bildens arkitektur. Gäller endast os-diskar.

Värde Description
x64
Arm64

CloudError

Ett felsvar från beräkningstjänsten.

Name Typ Description
error

ApiError

API-fel.

createdByType

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

Disallowed

Beskriver de otillåtna disktyperna.

Name Typ Description
diskTypes

string[]

En lista över disktyper.

GalleryImage

Anger information om den galleribilddefinition som du vill skapa eller uppdatera.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.allowUpdateImage

boolean

Valfritt. Måste anges till sant om galleribildfunktionerna uppdateras.

properties.architecture

Architecture

Bildens arkitektur. Gäller endast os-diskar.

properties.description

string

Beskrivningen av den här galleribilddefinitionsresursen. Den här egenskapen är uppdaterad.

properties.disallowed

Disallowed

Beskriver de otillåtna disktyperna.

properties.endOfLifeDate

string (date-time)

Slutdatumet för galleribilddefinitionen. Den här egenskapen kan användas för avaktivering. Den här egenskapen är uppdaterad.

properties.eula

string

Eula-avtalet för galleribilddefinitionen.

properties.features

GalleryImageFeature[]

En lista över galleribildfunktioner.

properties.hyperVGeneration

HyperVGeneration

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar.

properties.identifier

GalleryImageIdentifier

Det här är galleribildens definitionsidentifierare.

properties.osState

OperatingSystemStateTypes

Med den här egenskapen kan användaren ange om de virtuella datorer som skapas under den här avbildningen är "Generaliserade" eller "Specialiserade".

properties.osType

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken när du skapar en virtuell dator från en hanterad avbildning. Möjliga värden är: Windows,Linux.

properties.privacyStatementUri

string

Sekretesspolicyns URI.

properties.provisioningState

GalleryProvisioningState

Etableringstillståndet, som bara visas i svaret.

properties.purchasePlan

ImagePurchasePlan

Beskriver köpplanen för galleribildens definition. Detta används av Marketplace-avbildningar.

properties.recommended

RecommendedMachineConfiguration

Egenskaperna beskriver den rekommenderade datorkonfigurationen för den här bilddefinitionen. De här egenskaperna är uppdaterade.

properties.releaseNoteUri

string

Versionsantecknings-URI:n.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

tags

object

Resursetiketter.

type

string

Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts"

GalleryImageFeature

En funktion för galleribild.

Name Typ Description
name

string

Namnet på galleribildfunktionen.

startsAtVersion

string

Den lägsta galleribildversionen som stöder den här funktionen.

value

string

Värdet för galleribildfunktionen.

GalleryImageIdentifier

Det här är galleribildens definitionsidentifierare.

Name Typ Description
offer

string

Namnet på galleriets bilddefinitionserbjudande.

publisher

string

Namnet på galleriets bilddefinitions-publisher.

sku

string

Namnet på galleribilddefinitionens SKU.

GalleryProvisioningState

Etableringstillståndet, som bara visas i svaret.

Värde Description
Creating
Updating
Failed
Succeeded
Deleting
Migrating

HyperVGeneration

Hypervisor-genereringen av den virtuella datorn. Gäller endast os-diskar.

Värde Description
V1
V2

ImagePurchasePlan

Beskriver köpplanen för galleribildens definition. Detta används av Marketplace-avbildningar.

Name Typ Description
name

string

Plan-ID:t.

product

string

Produkt-id.

publisher

string

Utgivarens ID.

InnerError

Inre felinformation.

Name Typ Description
errordetail

string

Det interna felmeddelandet eller undantagsdumpen.

exceptiontype

string

Typen av undantag.

OperatingSystemStateTypes

Med den här egenskapen kan användaren ange om de virtuella datorer som skapas under den här avbildningen är "Generaliserade" eller "Specialiserade".

Värde Description
Generalized

Generaliserad bild. Måste etableras under distributionstiden.

Specialized

Specialiserad bild. Innehåller redan etablerad OS-disk.

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken när du skapar en virtuell dator från en hanterad avbildning. Möjliga värden är: Windows,Linux.

Värde Description
Windows
Linux

RecommendedMachineConfiguration

Egenskaperna beskriver den rekommenderade datorkonfigurationen för den här bilddefinitionen. De här egenskaperna är uppdaterade.

Name Typ Description
memory

ResourceRange

Beskriver resursintervallet.

vCPUs

ResourceRange

Beskriver resursintervallet.

ResourceRange

Beskriver resursintervallet.

Name Typ Description
max

integer (int32)

Det maximala antalet resurser.

min

integer (int32)

Resursens minsta antal.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för senaste ändring av resurs (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.