Gallery Images - Create Or Update
Vytvořte nebo aktualizujte definici image galerie.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}?api-version=2023-07-03
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
gallery
|
path | True |
string |
Název definice image galerie, která se má vytvořit nebo aktualizovat. Povolené znaky jsou abecedy a čísla s tečkami, pomlčkami a tečkami povolenými uprostřed. Maximální délka je 80 znaků. |
gallery
|
path | True |
string |
Název Shared Image Gallery, ve kterém má být vytvořena definice image. |
resource
|
path | True |
string |
Název skupiny prostředků. |
subscription
|
path | True |
string |
Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
location | True |
string |
Umístění prostředku |
properties.identifier | True |
Toto je identifikátor definice image galerie. |
|
properties.osState | True |
Tato vlastnost umožňuje uživateli určit, jestli jsou virtuální počítače vytvořené v rámci této image generalizované nebo specializované. |
|
properties.osType | True |
Tato vlastnost umožňuje zadat typ operačního systému, který je součástí disku při vytváření virtuálního počítače ze spravované image. Možné hodnoty jsou: Windows,Linux. |
|
properties.architecture |
Architektura image. Platí jenom pro disky s operačním systémem. |
||
properties.description |
string |
Popis tohoto prostředku definice image galerie. Tato vlastnost je aktualizovatelná. |
|
properties.disallowed |
Popisuje nepovolené typy disků. |
||
properties.endOfLifeDate |
string |
Datum konce životnosti definice obrázku galerie. Tuto vlastnost lze použít pro účely vyřazení z provozu. Tato vlastnost je aktualizovatelná. |
|
properties.eula |
string |
Smlouva Eula pro definici obrázku galerie. |
|
properties.features |
Seznam funkcí imagí v galerii |
||
properties.hyperVGeneration |
Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. |
||
properties.privacyStatementUri |
string |
Identifikátor URI prohlášení o zásadách ochrany osobních údajů. |
|
properties.purchasePlan |
Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace. |
||
properties.recommended |
Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti se dají aktualizovat. |
||
properties.releaseNoteUri |
string |
Identifikátor URI poznámky k verzi |
|
tags |
object |
Značky prostředků |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Vytvořeno |
|
202 Accepted |
Přijato |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Create or update a simple gallery image.
Ukázkový požadavek
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"
}
}
}
Ukázková odpověď
{
"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"
}
Definice
Name | Description |
---|---|
Api |
Chyba rozhraní API |
Api |
Základ chyb rozhraní API. |
Architecture |
Architektura image. Platí jenom pro disky s operačním systémem. |
Cloud |
Chybová odpověď ze služby Compute. |
Disallowed |
Popisuje nepovolené typy disků. |
Gallery |
Určuje informace o definici image galerie, kterou chcete vytvořit nebo aktualizovat. |
Gallery |
Funkce obrázku v galerii. |
Gallery |
Toto je identifikátor definice image galerie. |
Gallery |
Aktuální stav galerie nebo artefaktu galerie. |
Hyper |
Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. |
Image |
Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace. |
Inner |
Podrobnosti o vnitřní chybě. |
Operating |
Tato vlastnost umožňuje uživateli určit, jestli jsou virtuální počítače vytvořené v rámci této image generalizované nebo specializované. |
Operating |
Tato vlastnost umožňuje zadat podporovaný typ operačního systému, pro který je aplikace vytvořena. Možné hodnoty jsou: Windows,Linux. |
Recommended |
Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti se dají aktualizovat. |
Resource |
Popisuje rozsah prostředků. |
ApiError
Chyba rozhraní API
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě rozhraní API |
|
innererror |
Vnitřní chyba rozhraní API |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl konkrétní chyby. |
ApiErrorBase
Základ chyb rozhraní API.
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
message |
string |
Chybová zpráva |
target |
string |
Cíl konkrétní chyby. |
Architecture
Architektura image. Platí jenom pro disky s operačním systémem.
Name | Typ | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
CloudError
Chybová odpověď ze služby Compute.
Name | Typ | Description |
---|---|---|
error |
Chyba rozhraní API |
Disallowed
Popisuje nepovolené typy disků.
Name | Typ | Description |
---|---|---|
diskTypes |
string[] |
Seznam typů disků. |
GalleryImage
Určuje informace o definici image galerie, kterou chcete vytvořit nebo aktualizovat.
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku |
location |
string |
Umístění prostředku |
name |
string |
Název prostředku |
properties.architecture |
Architektura image. Platí jenom pro disky s operačním systémem. |
|
properties.description |
string |
Popis tohoto prostředku definice image galerie. Tato vlastnost je aktualizovatelná. |
properties.disallowed |
Popisuje nepovolené typy disků. |
|
properties.endOfLifeDate |
string |
Datum konce životnosti definice obrázku galerie. Tuto vlastnost lze použít pro účely vyřazení z provozu. Tato vlastnost je aktualizovatelná. |
properties.eula |
string |
Smlouva Eula pro definici obrázku galerie. |
properties.features |
Seznam funkcí imagí v galerii |
|
properties.hyperVGeneration |
Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem. |
|
properties.identifier |
Toto je identifikátor definice image galerie. |
|
properties.osState |
Tato vlastnost umožňuje uživateli určit, jestli jsou virtuální počítače vytvořené v rámci této image generalizované nebo specializované. |
|
properties.osType |
Tato vlastnost umožňuje zadat typ operačního systému, který je součástí disku při vytváření virtuálního počítače ze spravované image. Možné hodnoty jsou: Windows,Linux. |
|
properties.privacyStatementUri |
string |
Identifikátor URI prohlášení o zásadách ochrany osobních údajů. |
properties.provisioningState |
Aktuální stav galerie nebo artefaktu galerie. |
|
properties.purchasePlan |
Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace. |
|
properties.recommended |
Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti se dají aktualizovat. |
|
properties.releaseNoteUri |
string |
Identifikátor URI poznámky k verzi |
tags |
object |
Značky prostředků |
type |
string |
Typ prostředku |
GalleryImageFeature
Funkce obrázku v galerii.
Name | Typ | Description |
---|---|---|
name |
string |
Název funkce obrázku galerie. |
value |
string |
Hodnota funkce obrázku galerie. |
GalleryImageIdentifier
Toto je identifikátor definice image galerie.
Name | Typ | Description |
---|---|---|
offer |
string |
Název nabídky definic imagí galerie. |
publisher |
string |
Název vydavatele definice image galerie. |
sku |
string |
Název skladové položky definice image galerie. |
GalleryProvisioningState
Aktuální stav galerie nebo artefaktu galerie.
Name | Typ | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Migrating |
string |
|
Succeeded |
string |
|
Updating |
string |
HyperVGeneration
Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem.
Name | Typ | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace.
Name | Typ | Description |
---|---|---|
name |
string |
ID plánu |
product |
string |
ID produktu. |
publisher |
string |
ID vydavatele. |
InnerError
Podrobnosti o vnitřní chybě.
Name | Typ | Description |
---|---|---|
errordetail |
string |
Vnitřní chybová zpráva nebo výpis výjimky. |
exceptiontype |
string |
Typ výjimky. |
OperatingSystemStateTypes
Tato vlastnost umožňuje uživateli určit, jestli jsou virtuální počítače vytvořené v rámci této image generalizované nebo specializované.
Name | Typ | Description |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
Tato vlastnost umožňuje zadat podporovaný typ operačního systému, pro který je aplikace vytvořena. Možné hodnoty jsou: Windows,Linux.
Name | Typ | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti se dají aktualizovat.
Name | Typ | Description |
---|---|---|
memory |
Popisuje rozsah prostředků. |
|
vCPUs |
Popisuje rozsah prostředků. |
ResourceRange
Popisuje rozsah prostředků.
Name | Typ | Description |
---|---|---|
max |
integer |
Maximální počet prostředků. |
min |
integer |
Minimální počet prostředků. |