Gallery Images - Create Or Update
Erstellen oder aktualisieren Sie eine Katalogimagedefinition.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2023-07-03
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
gallery
|
path | True |
string |
Der Name der Katalogimagedefinition, die erstellt oder aktualisiert werden soll. Die zulässigen Zeichen sind Alphabete und Zahlen, deren Punkte, Bindestriche und Punkte in der Mitte zulässig sind. Die maximale Länge beträgt 80 Zeichen. |
gallery
|
path | True |
string |
Der Name des Shared Image Gallery, in dem die Imagedefinition erstellt werden soll. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
api-version
|
query | True |
string |
Client-API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
location | True |
string |
Ressourcenspeicherort |
properties.identifier | True |
Dies ist der Katalogbilddefinitionsbezeichner. |
|
properties.osState | True |
Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind. |
|
properties.osType | True |
Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem verwalteten Image erstellen. Mögliche Werte sind: Windows,Linux. |
|
properties.architecture |
Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger. |
||
properties.description |
string |
Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar. |
|
properties.disallowed |
Beschreibt die nicht zulässigen Datenträgertypen. |
||
properties.endOfLifeDate |
string |
Das Datum des Lebenszyklusendes der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. |
|
properties.eula |
string |
Die Eula-Vereinbarung für die Katalogbilddefinition. |
|
properties.features |
Eine Liste der Features des Katalogimages. |
||
properties.hyperVGeneration |
Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. |
||
properties.privacyStatementUri |
string |
Die Datenschutzerklärung uri. |
|
properties.purchasePlan |
Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet. |
||
properties.recommended |
Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar. |
||
properties.releaseNoteUri |
string |
Der Releasenoten-URI. |
|
tags |
object |
Ressourcentags |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
201 Created |
Erstellt |
|
202 Accepted |
Akzeptiert |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Create or update a simple gallery image.
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2023-07-03
{
"location": "West US",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
}
}
}
Sample Response
{
"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"
}
Definitionen
Name | Beschreibung |
---|---|
Api |
API-Fehler. |
Api |
API-Fehlerbasis. |
Architecture |
Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger. |
Cloud |
Eine Fehlerantwort des Computediensts. |
Disallowed |
Beschreibt die nicht zulässigen Datenträgertypen. |
Gallery |
Gibt Informationen zur Katalogimagedefinition an, die Sie erstellen oder aktualisieren möchten. |
Gallery |
Ein Feature für das Katalogbild. |
Gallery |
Dies ist der Katalogbilddefinitionsbezeichner. |
Gallery |
Der aktuelle Zustand des Katalog- oder Katalogartefakts. |
Hyper |
Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. |
Image |
Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet. |
Inner |
Innere Fehlerdetails. |
Operating |
Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind. |
Operating |
Mit dieser Eigenschaft können Sie den unterstützten Typ des Betriebssystems angeben, für das die Anwendung erstellt wird. Mögliche Werte sind: Windows,Linux. |
Recommended |
Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar. |
Resource |
Beschreibt den Ressourcenbereich. |
ApiError
API-Fehler.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
details |
Api-Fehlerdetails |
|
innererror |
Der innere Api-Fehler |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Ziel des jeweiligen Fehlers. |
ApiErrorBase
API-Fehlerbasis.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
message |
string |
Die Fehlermeldung. |
target |
string |
Das Ziel des jeweiligen Fehlers. |
Architecture
Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger.
Name | Typ | Beschreibung |
---|---|---|
Arm64 |
string |
|
x64 |
string |
CloudError
Eine Fehlerantwort des Computediensts.
Name | Typ | Beschreibung |
---|---|---|
error |
API-Fehler. |
Disallowed
Beschreibt die nicht zulässigen Datenträgertypen.
Name | Typ | Beschreibung |
---|---|---|
diskTypes |
string[] |
Eine Liste von Datenträgertypen. |
GalleryImage
Gibt Informationen zur Katalogimagedefinition an, die Sie erstellen oder aktualisieren möchten.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
location |
string |
Ressourcenspeicherort |
name |
string |
Ressourcenname |
properties.architecture |
Die Architektur des Bilds. Gilt nur für Betriebssystemdatenträger. |
|
properties.description |
string |
Die Beschreibung dieser Katalogbilddefinitionsressource. Diese Eigenschaft ist aktualisierbar. |
properties.disallowed |
Beschreibt die nicht zulässigen Datenträgertypen. |
|
properties.endOfLifeDate |
string |
Das Datum des Lebenszyklusendes der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. |
properties.eula |
string |
Die Eula-Vereinbarung für die Katalogbilddefinition. |
properties.features |
Eine Liste der Features des Katalogimages. |
|
properties.hyperVGeneration |
Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. |
|
properties.identifier |
Dies ist der Katalogbilddefinitionsbezeichner. |
|
properties.osState |
Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind. |
|
properties.osType |
Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem verwalteten Image erstellen. Mögliche Werte sind: Windows,Linux. |
|
properties.privacyStatementUri |
string |
Die Datenschutzerklärung uri. |
properties.provisioningState |
Der aktuelle Zustand des Katalog- oder Katalogartefakts. |
|
properties.purchasePlan |
Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet. |
|
properties.recommended |
Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar. |
|
properties.releaseNoteUri |
string |
Der Releasenoten-URI. |
tags |
object |
Ressourcentags |
type |
string |
Ressourcentyp |
GalleryImageFeature
Ein Feature für das Katalogbild.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name des Katalogimagefeatures. |
value |
string |
Der Wert des Katalogimagefeatures. |
GalleryImageIdentifier
Dies ist der Katalogbilddefinitionsbezeichner.
Name | Typ | Beschreibung |
---|---|---|
offer |
string |
Der Name des Katalogimagedefinitionsangebots. |
publisher |
string |
Der Name des Katalogimagedefinitionsherausgebers. |
sku |
string |
Der Name der Katalogimagedefinitions-SKU. |
GalleryProvisioningState
Der aktuelle Zustand des Katalog- oder Katalogartefakts.
Name | Typ | Beschreibung |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Migrating |
string |
|
Succeeded |
string |
|
Updating |
string |
HyperVGeneration
Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.
Name | Typ | Beschreibung |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
Beschreibt den Katalogabbildungsabbildungskaufplan. Dies wird von Marketplace-Images verwendet.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Die Plan-ID. |
product |
string |
Die Produkt-ID |
publisher |
string |
Die Herausgeber-ID. |
InnerError
Innere Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
errordetail |
string |
Das interne Fehlermeldungs- oder Ausnahmedump. |
exceptiontype |
string |
Der Ausnahmetyp. |
OperatingSystemStateTypes
Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalized" oder "Specialized" sind.
Name | Typ | Beschreibung |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
Mit dieser Eigenschaft können Sie den unterstützten Typ des Betriebssystems angeben, für das die Anwendung erstellt wird. Mögliche Werte sind: Windows,Linux.
Name | Typ | Beschreibung |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
Die Eigenschaften beschreiben die empfohlene Computerkonfiguration für diese Imagedefinition. Diese Eigenschaften sind aktualisierbar.
Name | Typ | Beschreibung |
---|---|---|
memory |
Beschreibt den Ressourcenbereich. |
|
vCPUs |
Beschreibt den Ressourcenbereich. |
ResourceRange
Beschreibt den Ressourcenbereich.
Name | Typ | Beschreibung |
---|---|---|
max |
integer |
Die maximale Anzahl der Ressource. |
min |
integer |
Die Mindestanzahl der Ressource. |