Gallery Images - Create Or Update
Erstellen oder Aktualisieren einer Katalogbilddefinition.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2024-03-03
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
gallery
|
path | True |
string |
Der Name der Katalogbilddefinition, die erstellt oder aktualisiert werden soll. Die zulässigen Zeichen sind Alphabete und Zahlen mit Punkten, Strichen und Punkten, die in der Mitte zulässig sind. Die maximale Länge beträgt 80 Zeichen. |
gallery
|
path | True |
string |
Der Name des freigegebenen Bildkatalogs, in dem die Bilddefinition 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 "Generalisiert" oder "Spezialisiert" sind. |
|
properties.osType | True |
Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das beim Erstellen eines virtuellen Computers aus einem verwalteten Image auf dem Datenträger enthalten ist. Mögliche Werte sind: Windows,Linux. |
|
properties.allowUpdateImage |
boolean |
Wahlfrei. Muss auf "true" festgelegt sein, wenn die Katalogbildfeatures aktualisiert werden. |
|
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 unzulässigen Datenträgertypen. |
||
properties.endOfLifeDate |
string |
Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. |
|
properties.eula |
string |
Der Eula-Vertrag für die Katalogbilddefinition. |
|
properties.features |
Eine Liste der Katalogbildfeatures. |
||
properties.hyperVGeneration |
Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. |
||
properties.privacyStatementUri |
string |
Der Datenschutzbestimmungen-URI. |
|
properties.purchasePlan |
Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 Versionshinweise-URI. |
|
tags |
object |
Ressourcentags |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OKAY |
|
201 Created |
Erstellt |
|
202 Accepted |
Angenommen |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
Create or update a simple gallery image.
Beispielanforderung
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGalleryName/images/myGalleryImageName?api-version=2024-03-03
{
"location": "West US",
"properties": {
"osType": "Windows",
"osState": "Generalized",
"hyperVGeneration": "V1",
"identifier": {
"publisher": "myPublisherName",
"offer": "myOfferName",
"sku": "mySkuName"
}
}
}
Beispiel für eine Antwort
{
"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 unzulässigen Datenträgertypen. |
Gallery |
Gibt Informationen zur Katalogbilddefinition an, die Sie erstellen oder aktualisieren möchten. |
Gallery |
Ein Feature für das Katalogbild. |
Gallery |
Dies ist der Katalogbilddefinitionsbezeichner. |
Gallery |
Der aktuelle Status des Katalog- oder Katalogartefaktes. |
Hyper |
Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger. |
Image |
Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 "Generalisiert" oder "Spezialisiert" sind. |
Operating |
Mit dieser Eigenschaft können Sie den unterstützten Typ des Betriebssystems angeben, für das die Anwendung erstellt wurde. 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 |
Die API-Fehlerdetails |
|
innererror |
Interner API-Fehler |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Ziel des bestimmten Fehlers. |
ApiErrorBase
API-Fehlerbasis.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
message |
string |
Die Fehlermeldung. |
target |
string |
Das Ziel des bestimmten 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 unzulässigen Datenträgertypen.
Name | Typ | Beschreibung |
---|---|---|
diskTypes |
string[] |
Eine Liste der Datenträgertypen. |
GalleryImage
Gibt Informationen zur Katalogbilddefinition an, die Sie erstellen oder aktualisieren möchten.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
location |
string |
Ressourcenspeicherort |
name |
string |
Ressourcenname |
properties.allowUpdateImage |
boolean |
Wahlfrei. Muss auf "true" festgelegt sein, wenn die Katalogbildfeatures aktualisiert werden. |
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 unzulässigen Datenträgertypen. |
|
properties.endOfLifeDate |
string |
Das Ende des Lebenszyklusdatums der Katalogbilddefinition. Diese Eigenschaft kann für Außerbetriebnahmezwecke verwendet werden. Diese Eigenschaft ist aktualisierbar. |
properties.eula |
string |
Der Eula-Vertrag für die Katalogbilddefinition. |
properties.features |
Eine Liste der Katalogbildfeatures. |
|
properties.hyperVGeneration |
Die Hypervisorgenerierung 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 "Generalisiert" oder "Spezialisiert" sind. |
|
properties.osType |
Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das beim Erstellen eines virtuellen Computers aus einem verwalteten Image auf dem Datenträger enthalten ist. Mögliche Werte sind: Windows,Linux. |
|
properties.privacyStatementUri |
string |
Der Datenschutzbestimmungen-URI. |
properties.provisioningState |
Der aktuelle Status des Katalog- oder Katalogartefaktes. |
|
properties.purchasePlan |
Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 Versionshinweise-URI. |
tags |
object |
Ressourcentags |
type |
string |
Ressourcentyp |
GalleryImageFeature
Ein Feature für das Katalogbild.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name des Katalogbildfeatures. |
startsAtVersion |
string |
Die Mindestbildversion des Katalogs, die dieses Feature unterstützt. |
value |
string |
Der Wert des Katalogbildfeatures. |
GalleryImageIdentifier
Dies ist der Katalogbilddefinitionsbezeichner.
Name | Typ | Beschreibung |
---|---|---|
offer |
string |
Der Name des Katalogbilddefinitionsangebots. |
publisher |
string |
Der Name des Herausgebers der Katalogbilddefinition. |
sku |
string |
Der Name der SKU der Katalogbilddefinition. |
GalleryProvisioningState
Der aktuelle Status des Katalog- oder Katalogartefaktes.
Name | Typ | Beschreibung |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Migrating |
string |
|
Succeeded |
string |
|
Updating |
string |
HyperVGeneration
Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.
Name | Typ | Beschreibung |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
Beschreibt den Kaufplan für Katalogbilderdefinitionen. 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 |
Die interne Fehlermeldung oder das Ausnahmeabbild. |
exceptiontype |
string |
Der Ausnahmetyp. |
OperatingSystemStateTypes
Mit dieser Eigenschaft kann der Benutzer angeben, ob die unter diesem Image erstellten virtuellen Computer "Generalisiert" oder "Spezialisiert" 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 wurde. 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. |