Gallery Images - Create Or Update

Reference

Service:: Compute

API Version:: 2023-07-03

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
galleryImageName	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ů.
galleryName	path	True	string	Název Shared Image Gallery, ve kterém má být vytvořena definice image.
resourceGroupName	path	True	string	Název skupiny prostředků.
subscriptionId	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	GalleryImageIdentifier	Toto je identifikátor definice image galerie.
properties.osState	True	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é.
properties.osType	True	OperatingSystemTypes	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		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		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		GalleryImageFeature[]	Seznam funkcí imagí v galerii
properties.hyperVGeneration		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		ImagePurchasePlan	Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace.
properties.recommended		RecommendedMachineConfiguration	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	GalleryImage	OK
201 Created	GalleryImage	Vytvořeno
202 Accepted	GalleryImage	Přijato
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

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


import com.azure.resourcemanager.compute.fluent.models.GalleryImageInner;
import com.azure.resourcemanager.compute.models.GalleryImageIdentifier;
import com.azure.resourcemanager.compute.models.HyperVGeneration;
import com.azure.resourcemanager.compute.models.OperatingSystemStateTypes;
import com.azure.resourcemanager.compute.models.OperatingSystemTypes;

/**
 * Samples for GalleryImages CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2023-07-03/examples/galleryExamples/
     * GalleryImage_Create.json
     */
    /**
     * Sample code: Create or update a simple gallery image.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateASimpleGalleryImage(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getGalleryImages().createOrUpdate(
            "myResourceGroup", "myGalleryName", "myGalleryImageName", new GalleryImageInner().withLocation("West US")
                .withOsType(OperatingSystemTypes.WINDOWS).withOsState(OperatingSystemStateTypes.GENERALIZED)
                .withHyperVGeneration(HyperVGeneration.V1).withIdentifier(new GalleryImageIdentifier()
                    .withPublisher("myPublisherName").withOffer("myOfferName").withSku("mySkuName")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2023-07-03/examples/galleryExamples/GalleryImage_Create.json
func ExampleGalleryImagesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewGalleryImagesClient().BeginCreateOrUpdate(ctx, "myResourceGroup", "myGalleryName", "myGalleryImageName", armcompute.GalleryImage{
		Location: to.Ptr("West US"),
		Properties: &armcompute.GalleryImageProperties{
			HyperVGeneration: to.Ptr(armcompute.HyperVGenerationV1),
			Identifier: &armcompute.GalleryImageIdentifier{
				Offer:     to.Ptr("myOfferName"),
				Publisher: to.Ptr("myPublisherName"),
				SKU:       to.Ptr("mySkuName"),
			},
			OSState: to.Ptr(armcompute.OperatingSystemStateTypesGeneralized),
			OSType:  to.Ptr(armcompute.OperatingSystemTypesWindows),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.GalleryImage = armcompute.GalleryImage{
	// 	Name: to.Ptr("myGalleryImageName"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/galleries/myGallery/Images/myGalleryImageName"),
	// 	Location: to.Ptr("West US"),
	// 	Properties: &armcompute.GalleryImageProperties{
	// 		HyperVGeneration: to.Ptr(armcompute.HyperVGenerationV1),
	// 		Identifier: &armcompute.GalleryImageIdentifier{
	// 			Offer: to.Ptr("myOfferName"),
	// 			Publisher: to.Ptr("myPublisherName"),
	// 			SKU: to.Ptr("mySkuName"),
	// 		},
	// 		OSState: to.Ptr(armcompute.OperatingSystemStateTypesGeneralized),
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 		ProvisioningState: to.Ptr(armcompute.GalleryProvisioningStateSucceeded),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create or update a gallery image definition.
 *
 * @summary Create or update a gallery image definition.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2023-07-03/examples/galleryExamples/GalleryImage_Create.json
 */
async function createOrUpdateASimpleGalleryImage() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const galleryName = "myGalleryName";
  const galleryImageName = "myGalleryImageName";
  const galleryImage = {
    hyperVGeneration: "V1",
    identifier: {
      offer: "myOfferName",
      publisher: "myPublisherName",
      sku: "mySkuName",
    },
    location: "West US",
    osState: "Generalized",
    osType: "Windows",
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.galleryImages.beginCreateOrUpdateAndWait(
    resourceGroupName,
    galleryName,
    galleryImageName,
    galleryImage,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Compute;
using Azure.ResourceManager.Compute.Models;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2023-07-03/examples/galleryExamples/GalleryImage_Create.json
// this example is just showing the usage of "GalleryImages_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this GalleryResource created on azure
// for more information of creating GalleryResource, please refer to the document of GalleryResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string galleryName = "myGalleryName";
ResourceIdentifier galleryResourceId = GalleryResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, galleryName);
GalleryResource gallery = client.GetGalleryResource(galleryResourceId);

// get the collection of this GalleryImageResource
GalleryImageCollection collection = gallery.GetGalleryImages();

// invoke the operation
string galleryImageName = "myGalleryImageName";
GalleryImageData data = new GalleryImageData(new AzureLocation("West US"))
{
    OSType = SupportedOperatingSystemType.Windows,
    OSState = OperatingSystemStateType.Generalized,
    HyperVGeneration = HyperVGeneration.V1,
    Identifier = new GalleryImageIdentifier("myPublisherName", "myOfferName", "mySkuName"),
};
ArmOperation<GalleryImageResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, galleryImageName, data);
GalleryImageResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
GalleryImageData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

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

Status code:: 201

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

Status code:: 202

{
  "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
ApiError	Chyba rozhraní API
ApiErrorBase	Základ chyb rozhraní API.
Architecture	Architektura image. Platí jenom pro disky s operačním systémem.
CloudError	Chybová odpověď ze služby Compute.
Disallowed	Popisuje nepovolené typy disků.
GalleryImage	Určuje informace o definici image galerie, kterou chcete vytvořit nebo aktualizovat.
GalleryImageFeature	Funkce obrázku v galerii.
GalleryImageIdentifier	Toto je identifikátor definice image galerie.
GalleryProvisioningState	Aktuální stav galerie nebo artefaktu galerie.
HyperVGeneration	Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem.
ImagePurchasePlan	Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace.
InnerError	Podrobnosti o vnitřní chybě.
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é.
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.
RecommendedMachineConfiguration	Vlastnosti popisují doporučenou konfiguraci počítače pro tuto definici image. Tyto vlastnosti se dají aktualizovat.
ResourceRange	Popisuje rozsah prostředků.

ApiError

Chyba rozhraní API

Name	Typ	Description
code	string	Kód chyby
details	ApiErrorBase[]	Podrobnosti o chybě rozhraní API
innererror	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	ApiError	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	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	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	GalleryImageFeature[]	Seznam funkcí imagí v galerii
properties.hyperVGeneration	HyperVGeneration	Generace hypervisoru virtuálního počítače. Platí jenom pro disky s operačním systémem.
properties.identifier	GalleryImageIdentifier	Toto je identifikátor definice image galerie.
properties.osState	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é.
properties.osType	OperatingSystemTypes	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	GalleryProvisioningState	Aktuální stav galerie nebo artefaktu galerie. Stav zřizování, který se zobrazí pouze v odpovědi.
properties.purchasePlan	ImagePurchasePlan	Popisuje plán nákupu definic obrázků galerie. Používají ho image z marketplace.
properties.recommended	RecommendedMachineConfiguration	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	ResourceRange	Popisuje rozsah prostředků.
vCPUs	ResourceRange	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ů.

Sdílet prostřednictvím

Gallery Images - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Scopes

Příklady

Create or update a simple gallery image.

Sample Request

Sample Response

Definice

ApiError

ApiErrorBase

Architecture

CloudError

Disallowed

GalleryImage

GalleryImageFeature

GalleryImageIdentifier

GalleryProvisioningState

HyperVGeneration

ImagePurchasePlan

InnerError

OperatingSystemStateTypes

OperatingSystemTypes

RecommendedMachineConfiguration

ResourceRange

Další materiály