Gallery Image Versions - Update

Serviço:

Compute

Versão da API:

2024-03-03

Atualize uma versão da imagem da galeria.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
galleryImageName	path	True	string	O nome da definição da imagem da galeria a ser recuperada.
galleryImageVersionName	path	True	string	O nome da versão da imagem da galeria a ser recuperada.
galleryName	path	True	string	O nome da Galeria de Imagens Compartilhadas.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
properties.storageProfile	True	GalleryImageVersionStorageProfile	Este é o perfil de armazenamento de uma versão de imagem da galeria.
properties.publishingProfile		GalleryImageVersionPublishingProfile	O perfil de publicação de uma imagem de galeria Versão.
properties.restore		boolean	Indica se esta é uma solicitação de restauração de recurso de exclusão suave.
properties.safetyProfile		GalleryImageVersionSafetyProfile	Este é o perfil de segurança da Versão Imagem da Galeria.
properties.securityProfile		ImageVersionSecurityProfile	O perfil de segurança de uma versão de imagem de galeria
tags		object	Etiquetas de recursos

Respostas

Name	Tipo	Description
200 OK	GalleryImageVersion	O pedido foi bem-sucedido. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Restore a Soft Deleted Gallery Image Version

Update a simple Gallery Image Version (Managed Image as source).

Update a simple Gallery Image Version without source id.

Restore a Soft Deleted Gallery Image Version

Pedido de amostra

HTTP

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

{
  "properties": {
    "restore": true,
    "storageProfile": {}
  }
}

Java

import com.azure.resourcemanager.compute.models.GalleryImageVersionStorageProfile;
import com.azure.resourcemanager.compute.models.GalleryImageVersionUpdate;

/**
 * Samples for GalleryImageVersions Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/
     * GalleryImageVersion_Update_RestoreSoftDeleted.json
     */
    /**
     * Sample code: Restore a Soft Deleted Gallery Image Version.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void restoreASoftDeletedGalleryImageVersion(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getGalleryImageVersions().update("myResourceGroup",
            "myGalleryName", "myGalleryImageName", "1.0.0", new GalleryImageVersionUpdate()
                .withStorageProfile(new GalleryImageVersionStorageProfile()).withRestore(true),
            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

Go

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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update_RestoreSoftDeleted.json
func ExampleGalleryImageVersionsClient_BeginUpdate_restoreASoftDeletedGalleryImageVersion() {
	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.NewGalleryImageVersionsClient().BeginUpdate(ctx, "myResourceGroup", "myGalleryName", "myGalleryImageName", "1.0.0", armcompute.GalleryImageVersionUpdate{
		Properties: &armcompute.GalleryImageVersionProperties{
			Restore:        to.Ptr(true),
			StorageProfile: &armcompute.GalleryImageVersionStorageProfile{},
		},
	}, 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.GalleryImageVersion = armcompute.GalleryImageVersion{
	// 	Name: to.Ptr("1.0.0"),
	// 	Location: to.Ptr("West US"),
	// 	Properties: &armcompute.GalleryImageVersionProperties{
	// 		ProvisioningState: to.Ptr(armcompute.GalleryProvisioningStateSucceeded),
	// 		PublishingProfile: &armcompute.GalleryImageVersionPublishingProfile{
	// 			PublishedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-01T00:00:00.000Z"); return t}()),
	// 			ReplicaCount: to.Ptr[int32](1),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardLRS),
	// 			TargetRegions: []*armcompute.TargetRegion{
	// 				{
	// 					Name: to.Ptr("West US"),
	// 					ExcludeFromLatest: to.Ptr(false),
	// 					RegionalReplicaCount: to.Ptr[int32](1),
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardLRS),
	// 				},
	// 				{
	// 					Name: to.Ptr("East US"),
	// 					ExcludeFromLatest: to.Ptr(false),
	// 					RegionalReplicaCount: to.Ptr[int32](2),
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardZRS),
	// 			}},
	// 		},
	// 		StorageProfile: &armcompute.GalleryImageVersionStorageProfile{
	// 			DataDiskImages: []*armcompute.GalleryDataDiskImage{
	// 				{
	// 					HostCaching: to.Ptr(armcompute.HostCachingNone),
	// 					SizeInGB: to.Ptr[int32](10),
	// 					Lun: to.Ptr[int32](1),
	// 			}},
	// 			OSDiskImage: &armcompute.GalleryOSDiskImage{
	// 				HostCaching: to.Ptr(armcompute.HostCachingReadOnly),
	// 				SizeInGB: to.Ptr[int32](10),
	// 			},
	// 			Source: &armcompute.GalleryArtifactVersionFullSource{
	// 				ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to Update a gallery image version.
 *
 * @summary Update a gallery image version.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update_RestoreSoftDeleted.json
 */
async function restoreASoftDeletedGalleryImageVersion() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const galleryName = "myGalleryName";
  const galleryImageName = "myGalleryImageName";
  const galleryImageVersionName = "1.0.0";
  const galleryImageVersion = {
    restore: true,
    storageProfile: {},
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.galleryImageVersions.beginUpdateAndWait(
    resourceGroupName,
    galleryName,
    galleryImageName,
    galleryImageVersionName,
    galleryImageVersion,
  );
  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

dotnet

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update_RestoreSoftDeleted.json
// this example is just showing the usage of "GalleryImageVersions_Update" 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 GalleryImageVersionResource created on azure
// for more information of creating GalleryImageVersionResource, please refer to the document of GalleryImageVersionResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string galleryName = "myGalleryName";
string galleryImageName = "myGalleryImageName";
string galleryImageVersionName = "1.0.0";
ResourceIdentifier galleryImageVersionResourceId = GalleryImageVersionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, galleryName, galleryImageName, galleryImageVersionName);
GalleryImageVersionResource galleryImageVersion = client.GetGalleryImageVersionResource(galleryImageVersionResourceId);

// invoke the operation
GalleryImageVersionPatch patch = new GalleryImageVersionPatch
{
    StorageProfile = new GalleryImageVersionStorageProfile(),
    Restore = true,
};
ArmOperation<GalleryImageVersionResource> lro = await galleryImageVersion.UpdateAsync(WaitUntil.Completed, patch);
GalleryImageVersionResource 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
GalleryImageVersionData 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

Resposta da amostra

Código de estado:

200

{
  "properties": {
    "publishingProfile": {
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1,
          "storageAccountType": "Standard_LRS",
          "excludeFromLatest": false
        },
        {
          "name": "East US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_ZRS",
          "excludeFromLatest": false
        }
      ],
      "replicaCount": 1,
      "publishedDate": "2018-01-01T00:00:00Z",
      "storageAccountType": "Standard_LRS"
    },
    "storageProfile": {
      "source": {
        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"
      },
      "osDiskImage": {
        "sizeInGB": 10,
        "hostCaching": "ReadOnly"
      },
      "dataDiskImages": [
        {
          "lun": 1,
          "sizeInGB": 10,
          "hostCaching": "None"
        }
      ]
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "1.0.0"
}

Update a simple Gallery Image Version (Managed Image as source).

Pedido de amostra

HTTP

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

{
  "properties": {
    "publishingProfile": {
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1
        },
        {
          "name": "East US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_ZRS"
        }
      ]
    },
    "storageProfile": {
      "source": {
        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"
      }
    }
  }
}

Java

import com.azure.resourcemanager.compute.models.GalleryArtifactVersionFullSource;
import com.azure.resourcemanager.compute.models.GalleryImageVersionPublishingProfile;
import com.azure.resourcemanager.compute.models.GalleryImageVersionStorageProfile;
import com.azure.resourcemanager.compute.models.GalleryImageVersionUpdate;
import com.azure.resourcemanager.compute.models.StorageAccountType;
import com.azure.resourcemanager.compute.models.TargetRegion;
import java.util.Arrays;

/**
 * Samples for GalleryImageVersions Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/
     * GalleryImageVersion_Update.json
     */
    /**
     * Sample code: Update a simple Gallery Image Version (Managed Image as source).
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updateASimpleGalleryImageVersionManagedImageAsSource(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getGalleryImageVersions()
            .update("myResourceGroup", "myGalleryName", "myGalleryImageName", "1.0.0", new GalleryImageVersionUpdate()
                .withPublishingProfile(new GalleryImageVersionPublishingProfile()
                    .withTargetRegions(Arrays.asList(new TargetRegion().withName("West US").withRegionalReplicaCount(1),
                        new TargetRegion().withName("East US").withRegionalReplicaCount(2)
                            .withStorageAccountType(StorageAccountType.STANDARD_ZRS))))
                .withStorageProfile(
                    new GalleryImageVersionStorageProfile().withSource(new GalleryArtifactVersionFullSource().withId(
                        "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"))),
                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

Go

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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update.json
func ExampleGalleryImageVersionsClient_BeginUpdate_updateASimpleGalleryImageVersionManagedImageAsSource() {
	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.NewGalleryImageVersionsClient().BeginUpdate(ctx, "myResourceGroup", "myGalleryName", "myGalleryImageName", "1.0.0", armcompute.GalleryImageVersionUpdate{
		Properties: &armcompute.GalleryImageVersionProperties{
			PublishingProfile: &armcompute.GalleryImageVersionPublishingProfile{
				TargetRegions: []*armcompute.TargetRegion{
					{
						Name:                 to.Ptr("West US"),
						RegionalReplicaCount: to.Ptr[int32](1),
					},
					{
						Name:                 to.Ptr("East US"),
						RegionalReplicaCount: to.Ptr[int32](2),
						StorageAccountType:   to.Ptr(armcompute.StorageAccountTypeStandardZRS),
					}},
			},
			StorageProfile: &armcompute.GalleryImageVersionStorageProfile{
				Source: &armcompute.GalleryArtifactVersionFullSource{
					ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"),
				},
			},
		},
	}, 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.GalleryImageVersion = armcompute.GalleryImageVersion{
	// 	Name: to.Ptr("1.0.0"),
	// 	Location: to.Ptr("West US"),
	// 	Properties: &armcompute.GalleryImageVersionProperties{
	// 		ProvisioningState: to.Ptr(armcompute.GalleryProvisioningStateSucceeded),
	// 		PublishingProfile: &armcompute.GalleryImageVersionPublishingProfile{
	// 			PublishedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-01T00:00:00.000Z"); return t}()),
	// 			ReplicaCount: to.Ptr[int32](1),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardLRS),
	// 			TargetRegions: []*armcompute.TargetRegion{
	// 				{
	// 					Name: to.Ptr("West US"),
	// 					Encryption: &armcompute.EncryptionImages{
	// 						DataDiskImages: []*armcompute.DataDiskImageEncryption{
	// 							{
	// 								DiskEncryptionSetID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"),
	// 								Lun: to.Ptr[int32](1),
	// 						}},
	// 						OSDiskImage: &armcompute.OSDiskImageEncryption{
	// 							DiskEncryptionSetID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"),
	// 						},
	// 					},
	// 					ExcludeFromLatest: to.Ptr(false),
	// 					RegionalReplicaCount: to.Ptr[int32](1),
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardLRS),
	// 				},
	// 				{
	// 					Name: to.Ptr("East US"),
	// 					ExcludeFromLatest: to.Ptr(false),
	// 					RegionalReplicaCount: to.Ptr[int32](2),
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardZRS),
	// 			}},
	// 		},
	// 		StorageProfile: &armcompute.GalleryImageVersionStorageProfile{
	// 			DataDiskImages: []*armcompute.GalleryDataDiskImage{
	// 				{
	// 					HostCaching: to.Ptr(armcompute.HostCachingNone),
	// 					SizeInGB: to.Ptr[int32](10),
	// 					Lun: to.Ptr[int32](1),
	// 			}},
	// 			OSDiskImage: &armcompute.GalleryOSDiskImage{
	// 				HostCaching: to.Ptr(armcompute.HostCachingReadOnly),
	// 				SizeInGB: to.Ptr[int32](10),
	// 			},
	// 			Source: &armcompute.GalleryArtifactVersionFullSource{
	// 				ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to Update a gallery image version.
 *
 * @summary Update a gallery image version.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update.json
 */
async function updateASimpleGalleryImageVersionManagedImageAsSource() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const galleryName = "myGalleryName";
  const galleryImageName = "myGalleryImageName";
  const galleryImageVersionName = "1.0.0";
  const galleryImageVersion = {
    publishingProfile: {
      targetRegions: [
        { name: "West US", regionalReplicaCount: 1 },
        {
          name: "East US",
          regionalReplicaCount: 2,
          storageAccountType: "Standard_ZRS",
        },
      ],
    },
    storageProfile: {
      source: {
        id: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}",
      },
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.galleryImageVersions.beginUpdateAndWait(
    resourceGroupName,
    galleryName,
    galleryImageName,
    galleryImageVersionName,
    galleryImageVersion,
  );
  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

dotnet

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update.json
// this example is just showing the usage of "GalleryImageVersions_Update" 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 GalleryImageVersionResource created on azure
// for more information of creating GalleryImageVersionResource, please refer to the document of GalleryImageVersionResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string galleryName = "myGalleryName";
string galleryImageName = "myGalleryImageName";
string galleryImageVersionName = "1.0.0";
ResourceIdentifier galleryImageVersionResourceId = GalleryImageVersionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, galleryName, galleryImageName, galleryImageVersionName);
GalleryImageVersionResource galleryImageVersion = client.GetGalleryImageVersionResource(galleryImageVersionResourceId);

// invoke the operation
GalleryImageVersionPatch patch = new GalleryImageVersionPatch
{
    PublishingProfile = new GalleryImageVersionPublishingProfile
    {
        TargetRegions = {new TargetRegion("West US")
        {
        RegionalReplicaCount = 1,
        }, new TargetRegion("East US")
        {
        RegionalReplicaCount = 2,
        StorageAccountType = ImageStorageAccountType.StandardZrs,
        }},
    },
    StorageProfile = new GalleryImageVersionStorageProfile
    {
        GallerySource = new GalleryArtifactVersionFullSource
        {
            Id = new ResourceIdentifier("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"),
        },
    },
};
ArmOperation<GalleryImageVersionResource> lro = await galleryImageVersion.UpdateAsync(WaitUntil.Completed, patch);
GalleryImageVersionResource 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
GalleryImageVersionData 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

Resposta da amostra

Código de estado:

200

{
  "properties": {
    "publishingProfile": {
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1,
          "storageAccountType": "Standard_LRS",
          "encryption": {
            "osDiskImage": {
              "diskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"
            },
            "dataDiskImages": [
              {
                "lun": 1,
                "diskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"
              }
            ]
          },
          "excludeFromLatest": false
        },
        {
          "name": "East US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_ZRS",
          "excludeFromLatest": false
        }
      ],
      "replicaCount": 1,
      "publishedDate": "2018-01-01T00:00:00Z",
      "storageAccountType": "Standard_LRS"
    },
    "storageProfile": {
      "source": {
        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"
      },
      "osDiskImage": {
        "sizeInGB": 10,
        "hostCaching": "ReadOnly"
      },
      "dataDiskImages": [
        {
          "lun": 1,
          "sizeInGB": 10,
          "hostCaching": "None"
        }
      ]
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "1.0.0"
}

Update a simple Gallery Image Version without source id.

Pedido de amostra

HTTP

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

{
  "properties": {
    "publishingProfile": {
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1
        },
        {
          "name": "East US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_ZRS"
        }
      ]
    },
    "storageProfile": {}
  }
}

Java

import com.azure.resourcemanager.compute.models.GalleryImageVersionPublishingProfile;
import com.azure.resourcemanager.compute.models.GalleryImageVersionStorageProfile;
import com.azure.resourcemanager.compute.models.GalleryImageVersionUpdate;
import com.azure.resourcemanager.compute.models.StorageAccountType;
import com.azure.resourcemanager.compute.models.TargetRegion;
import java.util.Arrays;

/**
 * Samples for GalleryImageVersions Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/
     * GalleryImageVersion_Update_WithoutSourceId.json
     */
    /**
     * Sample code: Update a simple Gallery Image Version without source id.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updateASimpleGalleryImageVersionWithoutSourceId(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getGalleryImageVersions()
            .update("myResourceGroup", "myGalleryName", "myGalleryImageName", "1.0.0", new GalleryImageVersionUpdate()
                .withPublishingProfile(new GalleryImageVersionPublishingProfile()
                    .withTargetRegions(Arrays.asList(new TargetRegion().withName("West US").withRegionalReplicaCount(1),
                        new TargetRegion().withName("East US").withRegionalReplicaCount(2)
                            .withStorageAccountType(StorageAccountType.STANDARD_ZRS))))
                .withStorageProfile(new GalleryImageVersionStorageProfile()), 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

Go

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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update_WithoutSourceId.json
func ExampleGalleryImageVersionsClient_BeginUpdate_updateASimpleGalleryImageVersionWithoutSourceId() {
	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.NewGalleryImageVersionsClient().BeginUpdate(ctx, "myResourceGroup", "myGalleryName", "myGalleryImageName", "1.0.0", armcompute.GalleryImageVersionUpdate{
		Properties: &armcompute.GalleryImageVersionProperties{
			PublishingProfile: &armcompute.GalleryImageVersionPublishingProfile{
				TargetRegions: []*armcompute.TargetRegion{
					{
						Name:                 to.Ptr("West US"),
						RegionalReplicaCount: to.Ptr[int32](1),
					},
					{
						Name:                 to.Ptr("East US"),
						RegionalReplicaCount: to.Ptr[int32](2),
						StorageAccountType:   to.Ptr(armcompute.StorageAccountTypeStandardZRS),
					}},
			},
			StorageProfile: &armcompute.GalleryImageVersionStorageProfile{},
		},
	}, 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.GalleryImageVersion = armcompute.GalleryImageVersion{
	// 	Name: to.Ptr("1.0.0"),
	// 	Location: to.Ptr("West US"),
	// 	Properties: &armcompute.GalleryImageVersionProperties{
	// 		ProvisioningState: to.Ptr(armcompute.GalleryProvisioningStateSucceeded),
	// 		PublishingProfile: &armcompute.GalleryImageVersionPublishingProfile{
	// 			PublishedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-01-01T00:00:00.000Z"); return t}()),
	// 			ReplicaCount: to.Ptr[int32](1),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardLRS),
	// 			TargetRegions: []*armcompute.TargetRegion{
	// 				{
	// 					Name: to.Ptr("West US"),
	// 					Encryption: &armcompute.EncryptionImages{
	// 						DataDiskImages: []*armcompute.DataDiskImageEncryption{
	// 							{
	// 								DiskEncryptionSetID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"),
	// 								Lun: to.Ptr[int32](1),
	// 						}},
	// 						OSDiskImage: &armcompute.OSDiskImageEncryption{
	// 							DiskEncryptionSetID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"),
	// 						},
	// 					},
	// 					ExcludeFromLatest: to.Ptr(false),
	// 					RegionalReplicaCount: to.Ptr[int32](1),
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardLRS),
	// 				},
	// 				{
	// 					Name: to.Ptr("East US"),
	// 					ExcludeFromLatest: to.Ptr(false),
	// 					RegionalReplicaCount: to.Ptr[int32](2),
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypeStandardZRS),
	// 			}},
	// 		},
	// 		StorageProfile: &armcompute.GalleryImageVersionStorageProfile{
	// 			DataDiskImages: []*armcompute.GalleryDataDiskImage{
	// 				{
	// 					HostCaching: to.Ptr(armcompute.HostCachingNone),
	// 					SizeInGB: to.Ptr[int32](10),
	// 					Lun: to.Ptr[int32](1),
	// 			}},
	// 			OSDiskImage: &armcompute.GalleryOSDiskImage{
	// 				HostCaching: to.Ptr(armcompute.HostCachingReadOnly),
	// 				SizeInGB: to.Ptr[int32](10),
	// 			},
	// 			Source: &armcompute.GalleryArtifactVersionFullSource{
	// 				ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to Update a gallery image version.
 *
 * @summary Update a gallery image version.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update_WithoutSourceId.json
 */
async function updateASimpleGalleryImageVersionWithoutSourceId() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const galleryName = "myGalleryName";
  const galleryImageName = "myGalleryImageName";
  const galleryImageVersionName = "1.0.0";
  const galleryImageVersion = {
    publishingProfile: {
      targetRegions: [
        { name: "West US", regionalReplicaCount: 1 },
        {
          name: "East US",
          regionalReplicaCount: 2,
          storageAccountType: "Standard_ZRS",
        },
      ],
    },
    storageProfile: {},
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.galleryImageVersions.beginUpdateAndWait(
    resourceGroupName,
    galleryName,
    galleryImageName,
    galleryImageVersionName,
    galleryImageVersion,
  );
  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

dotnet

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

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/GalleryRP/stable/2024-03-03/examples/galleryExamples/GalleryImageVersion_Update_WithoutSourceId.json
// this example is just showing the usage of "GalleryImageVersions_Update" 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 GalleryImageVersionResource created on azure
// for more information of creating GalleryImageVersionResource, please refer to the document of GalleryImageVersionResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string galleryName = "myGalleryName";
string galleryImageName = "myGalleryImageName";
string galleryImageVersionName = "1.0.0";
ResourceIdentifier galleryImageVersionResourceId = GalleryImageVersionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, galleryName, galleryImageName, galleryImageVersionName);
GalleryImageVersionResource galleryImageVersion = client.GetGalleryImageVersionResource(galleryImageVersionResourceId);

// invoke the operation
GalleryImageVersionPatch patch = new GalleryImageVersionPatch
{
    PublishingProfile = new GalleryImageVersionPublishingProfile
    {
        TargetRegions = {new TargetRegion("West US")
        {
        RegionalReplicaCount = 1,
        }, new TargetRegion("East US")
        {
        RegionalReplicaCount = 2,
        StorageAccountType = ImageStorageAccountType.StandardZrs,
        }},
    },
    StorageProfile = new GalleryImageVersionStorageProfile(),
};
ArmOperation<GalleryImageVersionResource> lro = await galleryImageVersion.UpdateAsync(WaitUntil.Completed, patch);
GalleryImageVersionResource 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
GalleryImageVersionData 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

Resposta da amostra

Código de estado:

200

{
  "properties": {
    "publishingProfile": {
      "targetRegions": [
        {
          "name": "West US",
          "regionalReplicaCount": 1,
          "storageAccountType": "Standard_LRS",
          "encryption": {
            "osDiskImage": {
              "diskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"
            },
            "dataDiskImages": [
              {
                "lun": 1,
                "diskEncryptionSetId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSet/myDiskEncryptionSet"
              }
            ]
          },
          "excludeFromLatest": false
        },
        {
          "name": "East US",
          "regionalReplicaCount": 2,
          "storageAccountType": "Standard_ZRS",
          "excludeFromLatest": false
        }
      ],
      "replicaCount": 1,
      "publishedDate": "2018-01-01T00:00:00Z",
      "storageAccountType": "Standard_LRS"
    },
    "storageProfile": {
      "source": {
        "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}"
      },
      "osDiskImage": {
        "sizeInGB": 10,
        "hostCaching": "ReadOnly"
      },
      "dataDiskImages": [
        {
          "lun": 1,
          "sizeInGB": 10,
          "hostCaching": "None"
        }
      ]
    },
    "provisioningState": "Updating"
  },
  "location": "West US",
  "name": "1.0.0"
}

Definições

Name	Description
AdditionalReplicaSet	Descreve as informações adicionais do conjunto de réplicas.
AggregatedReplicationState	Este é o status de replicação agregado com base em todos os sinalizadores de status de replicação regional.
ApiError	Erro de api.
ApiErrorBase	Base de erro da api.
CloudError	Uma resposta de erro do serviço de computação.
ConfidentialVMEncryptionType	tipos de criptografia de VM confidenciais
createdByType	O tipo de identidade que criou o recurso.
DataDiskImageEncryption	Contém configurações de criptografia para uma imagem de disco de dados.
EdgeZoneStorageAccountType	Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.
EncryptionImages	Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria.
ExecutedValidation	Esta é a Validação executada.
GalleryArtifactVersionFullSource	A fonte da versão do artefato da galeria.
GalleryDataDiskImage	Esta é a imagem do disco de dados.
GalleryDiskImageSource	A origem da imagem de disco.
GalleryExtendedLocation	O nome do local estendido.
GalleryExtendedLocationType	É o tipo de local estendido.
GalleryImageVersion	Especifica informações sobre a versão da imagem da galeria que você deseja criar ou atualizar.
GalleryImageVersionPublishingProfile	O perfil de publicação de uma imagem de galeria Versão.
GalleryImageVersionSafetyProfile	Este é o perfil de segurança da Versão Imagem da Galeria.
GalleryImageVersionStorageProfile	Este é o perfil de armazenamento de uma versão de imagem da galeria.
GalleryImageVersionUefiSettings	Contém configurações UEFI para a versão da imagem.
GalleryImageVersionUpdate	Especifica informações sobre a versão da imagem da galeria que você deseja atualizar.
GalleryOSDiskImage	Esta é a imagem de disco do SO.
GalleryProvisioningState	O estado de provisionamento, que só aparece na resposta.
GalleryTargetExtendedLocation
HostCaching	O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'
ImageVersionSecurityProfile	O perfil de segurança de uma versão de imagem de galeria
InnerError	Detalhes do erro interno.
OSDiskImageEncryption	Contém configurações de criptografia para uma imagem de disco do sistema operacional.
OSDiskImageSecurityProfile	Contém perfil de segurança para uma imagem de disco do SO.
PlatformAttribute	Este é o atributo de plataforma da versão da imagem.
PolicyViolation	Uma violação de política relatada contra um artefato de galeria.
PolicyViolationCategory	Descreve a natureza da violação da política.
RegionalReplicationStatus	Este é o status de replicação regional.
ReplicationMode	Parâmetro opcional que especifica o modo a ser usado para replicação. Esta propriedade não é atualizável.
ReplicationState	Este é o estado de replicação regional.
ReplicationStatus	Este é o status de replicação da versão da imagem da galeria.
StorageAccountType	Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.
systemData	Metadados referentes à criação e última modificação do recurso.
TargetRegion	Descreve as informações da região de destino.
UefiKey	Uma assinatura de chave UEFI.
UefiKeySignatures	Assinaturas de chave UEFI adicionais que serão adicionadas à imagem, além dos modelos de assinatura
UefiKeyType	O tipo de assinatura de chave.
UefiSignatureTemplateName	O nome do modelo de assinatura que contém chaves UEFI padrão.
ValidationsProfile	Este é o perfil de validações de uma Versão de Imagem da Galeria.
ValidationStatus	Esta propriedade especifica o status do validationProfile da versão da imagem.

AdditionalReplicaSet

Object

Descreve as informações adicionais do conjunto de réplicas.

Name	Tipo	Description
regionalReplicaCount	integer (int32)	O número de réplicas de unidade direta da Versão da Imagem a ser criada. Esta propriedade é atualizável
storageAccountType	StorageAccountType	Especifica o tipo de conta de armazenamento a ser usado para criar as réplicas de unidade direta

AggregatedReplicationState

Enumeração

Este é o status de replicação agregado com base em todos os sinalizadores de status de replicação regional.

Valor	Description
Unknown
InProgress
Completed
Failed

ApiError

Object

Erro de api.

Name	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro Api
innererror	InnerError	O erro interno da Api
message	string	A mensagem de erro.
target	string	O alvo do erro específico.

ApiErrorBase

Object

Base de erro da api.

Name	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O alvo do erro específico.

CloudError

Object

Uma resposta de erro do serviço de computação.

Name	Tipo	Description
error	ApiError	Erro de api.

ConfidentialVMEncryptionType

Enumeração

tipos de criptografia de VM confidenciais

Valor	Description
EncryptedVMGuestStateOnlyWithPmk
EncryptedWithPmk
EncryptedWithCmk
NonPersistedTPM

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DataDiskImageEncryption

Object

Contém configurações de criptografia para uma imagem de disco de dados.

Name	Tipo	Description
diskEncryptionSetId	string	Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco.
lun	integer (int32)	Esta propriedade especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da Máquina Virtual e, portanto, deve ser exclusivo para cada disco de dados conectado à Máquina Virtual.

EdgeZoneStorageAccountType

Enumeração

Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.

Valor	Description
Standard_LRS
Standard_ZRS
StandardSSD_LRS
Premium_LRS

EncryptionImages

Object

Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria.

Name	Tipo	Description
dataDiskImages	DataDiskImageEncryption[]	Uma lista de especificações de criptografia para imagens de disco de dados.
osDiskImage	OSDiskImageEncryption	Contém configurações de criptografia para uma imagem de disco do sistema operacional.

ExecutedValidation

Object

Esta é a Validação executada.

Name	Tipo	Description
executionTime	string (date-time)	Esta propriedade especifica o carimbo de data/hora inicial.
status	ValidationStatus	Esta propriedade especifica o status do validationProfile da versão da imagem.
type	string	Esta propriedade especifica o tipo de validação da versão da imagem.
version	string	Esta propriedade especifica a versão válida da validação.

GalleryArtifactVersionFullSource

Object

A fonte da versão do artefato da galeria.

Name	Tipo	Description
communityGalleryImageId	string	O ID do recurso da Imagem da Galeria da Comunidade de origem. Apenas necessário ao usar a Imagem da Galeria da Comunidade como fonte.
id	string	A id da fonte da versão do artefato da galeria.
virtualMachineId	string	A ID do recurso da máquina virtual de origem. Apenas necessário ao capturar uma máquina virtual para originar esta versão de imagem da galeria.

GalleryDataDiskImage

Object

Esta é a imagem do disco de dados.

Name	Tipo	Description
hostCaching	HostCaching	O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'
lun	integer (int32)	Esta propriedade especifica o número da unidade lógica do disco de dados. Esse valor é usado para identificar discos de dados dentro da Máquina Virtual e, portanto, deve ser exclusivo para cada disco de dados conectado à Máquina Virtual.
sizeInGB	integer (int32)	Esta propriedade indica o tamanho do VHD a ser criado.
source	GalleryDiskImageSource	A origem da imagem de disco.

GalleryDiskImageSource

Object

A origem da imagem de disco.

Name	Tipo	Description
id	string	A id da fonte da versão do artefato da galeria.
storageAccountId	string	O ID da Conta de Armazenamento que contém o blob vhd que está sendo usado como fonte para esta versão do artefato.
uri	string	O uri da fonte da versão do artefato da galeria. Atualmente usado para especificar a origem vhd/blob.

GalleryExtendedLocation

Object

O nome do local estendido.

Name	Tipo	Description
name	string
type	GalleryExtendedLocationType	É o tipo de local estendido.

GalleryExtendedLocationType

Enumeração

É o tipo de local estendido.

Valor	Description
EdgeZone
Unknown

GalleryImageVersion

Object

Especifica informações sobre a versão da imagem da galeria que você deseja criar ou atualizar.

Name	Tipo	Description
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.provisioningState	GalleryProvisioningState	O estado de provisionamento, que só aparece na resposta.
properties.publishingProfile	GalleryImageVersionPublishingProfile	O perfil de publicação de uma imagem de galeria Versão.
properties.replicationStatus	ReplicationStatus	Este é o status de replicação da versão da imagem da galeria.
properties.restore	boolean	Indica se esta é uma solicitação de restauração de recurso de exclusão suave.
properties.safetyProfile	GalleryImageVersionSafetyProfile	Este é o perfil de segurança da Versão Imagem da Galeria.
properties.securityProfile	ImageVersionSecurityProfile	O perfil de segurança de uma versão de imagem de galeria
properties.storageProfile	GalleryImageVersionStorageProfile	Este é o perfil de armazenamento de uma versão de imagem da galeria.
properties.validationsProfile	ValidationsProfile	Este é o perfil de validações de uma Versão de Imagem da Galeria.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

GalleryImageVersionPublishingProfile

Object

O perfil de publicação de uma imagem de galeria Versão.

Name	Tipo	Description
endOfLifeDate	string (date-time)	A data de fim da vida útil da versão da imagem da galeria. Esta propriedade pode ser usada para fins de descomissionamento. Esta propriedade é atualizável.
excludeFromLatest	boolean	Se definido como true, as Máquinas Virtuais implantadas a partir da versão mais recente da Definição de Imagem não usarão essa Versão de Imagem.
publishedDate	string (date-time)	O carimbo de data/hora para quando a versão da imagem da galeria é publicada.
replicaCount	integer (int32)	O número de réplicas da Versão da Imagem a ser criada por região. Essa propriedade teria efeito para uma região quando regionalReplicaCount não é especificado. Esta propriedade é atualizável.
replicationMode	ReplicationMode	Parâmetro opcional que especifica o modo a ser usado para replicação. Esta propriedade não é atualizável.
storageAccountType	StorageAccountType	Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.
targetExtendedLocations	GalleryTargetExtendedLocation[]	Os locais estendidos de destino para onde a Versão da Imagem será replicada. Esta propriedade é atualizável.
targetRegions	TargetRegion[]	As regiões de destino para as quais a Versão da Imagem será replicada. Esta propriedade é atualizável.

GalleryImageVersionSafetyProfile

Object

Este é o perfil de segurança da Versão Imagem da Galeria.

Name	Tipo	Description
allowDeletionOfReplicatedLocations	boolean	Indica se a remoção desta Versão da Imagem da Galeria das regiões replicadas é permitida ou não.
blockDeletionBeforeEndOfLife	boolean	Indica se a exclusão está ou não bloqueada para esta Versão da Imagem da Galeria se seu Fim da Vida Útil não tiver expirado.
policyViolations	PolicyViolation[]	Uma lista de Violações de Política que foram relatadas para esta Versão de Imagem da Galeria.
reportedForPolicyViolation	boolean	Indica se esta imagem foi denunciada como violando as políticas da Microsoft.

GalleryImageVersionStorageProfile

Object

Este é o perfil de armazenamento de uma versão de imagem da galeria.

Name	Tipo	Description
dataDiskImages	GalleryDataDiskImage[]	Uma lista de imagens de disco de dados.
osDiskImage	GalleryOSDiskImage	Esta é a imagem de disco do SO.
source	GalleryArtifactVersionFullSource	A fonte da versão do artefato da galeria.

GalleryImageVersionUefiSettings

Object

Contém configurações UEFI para a versão da imagem.

Name	Tipo	Description
additionalSignatures	UefiKeySignatures	Assinaturas de chave UEFI adicionais que serão adicionadas à imagem, além dos modelos de assinatura
signatureTemplateNames	UefiSignatureTemplateName[]	O nome do(s) modelo(s) que contém assinaturas de chave UEFI padrão que serão adicionadas à imagem.

GalleryImageVersionUpdate

Object

Especifica informações sobre a versão da imagem da galeria que você deseja atualizar.

Name	Tipo	Description
id	string	ID do recurso
name	string	Nome do recurso
properties.provisioningState	GalleryProvisioningState	O estado de provisionamento, que só aparece na resposta.
properties.publishingProfile	GalleryImageVersionPublishingProfile	O perfil de publicação de uma imagem de galeria Versão.
properties.replicationStatus	ReplicationStatus	Este é o status de replicação da versão da imagem da galeria.
properties.restore	boolean	Indica se esta é uma solicitação de restauração de recurso de exclusão suave.
properties.safetyProfile	GalleryImageVersionSafetyProfile	Este é o perfil de segurança da Versão Imagem da Galeria.
properties.securityProfile	ImageVersionSecurityProfile	O perfil de segurança de uma versão de imagem de galeria
properties.storageProfile	GalleryImageVersionStorageProfile	Este é o perfil de armazenamento de uma versão de imagem da galeria.
properties.validationsProfile	ValidationsProfile	Este é o perfil de validações de uma Versão de Imagem da Galeria.
tags	object	Etiquetas de recursos
type	string	Tipo de recurso

GalleryOSDiskImage

Object

Esta é a imagem de disco do SO.

Name	Tipo	Description
hostCaching	HostCaching	O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'
sizeInGB	integer (int32)	Esta propriedade indica o tamanho do VHD a ser criado.
source	GalleryDiskImageSource	A origem da imagem de disco.

GalleryProvisioningState

Enumeração

O estado de provisionamento, que só aparece na resposta.

Valor	Description
Creating
Updating
Failed
Succeeded
Deleting
Migrating

GalleryTargetExtendedLocation

Object

Name	Tipo	Description
encryption	EncryptionImages	Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria.
extendedLocation	GalleryExtendedLocation	O nome do local estendido.
extendedLocationReplicaCount	integer (int32)	O número de réplicas da Versão da Imagem a ser criada por local estendido. Esta propriedade é atualizável.
name	string	O nome da região.
storageAccountType	EdgeZoneStorageAccountType	Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.

HostCaching

Enumeração

O cache do host do disco. Os valores válidos são 'None', 'ReadOnly' e 'ReadWrite'

Valor	Description
None
ReadOnly
ReadWrite

ImageVersionSecurityProfile

Object

O perfil de segurança de uma versão de imagem de galeria

Name	Tipo	Description
uefiSettings	GalleryImageVersionUefiSettings	Contém configurações UEFI para a versão da imagem.

InnerError

Object

Detalhes do erro interno.

Name	Tipo	Description
errordetail	string	A mensagem de erro interna ou despejo de exceção.
exceptiontype	string	O tipo de exceção.

OSDiskImageEncryption

Object

Contém configurações de criptografia para uma imagem de disco do sistema operacional.

Name	Tipo	Description
diskEncryptionSetId	string	Um URI relativo que contém a ID do recurso do conjunto de criptografia de disco.
securityProfile	OSDiskImageSecurityProfile	Esta propriedade especifica o perfil de segurança de uma imagem de disco do sistema operacional.

OSDiskImageSecurityProfile

Object

Contém perfil de segurança para uma imagem de disco do SO.

Name	Tipo	Description
confidentialVMEncryptionType	ConfidentialVMEncryptionType	tipos de criptografia de VM confidenciais
secureVMDiskEncryptionSetId	string	ID do conjunto de criptografia de disco de VM seguro

PlatformAttribute

Object

Este é o atributo de plataforma da versão da imagem.

Name	Tipo	Description
name	string	Esta propriedade especifica o nome do platformAttribute. Está em modo de leitura.
value	string	Esta propriedade especifica o valor da propriedade name correspondente. Está em modo de leitura.

PolicyViolation

Object

Uma violação de política relatada contra um artefato de galeria.

Name	Tipo	Description
category	PolicyViolationCategory	Descreve a natureza da violação da política.
details	string	Descreve detalhes específicos sobre por que essa violação de política foi relatada.

PolicyViolationCategory

Enumeração

Descreve a natureza da violação da política.

Valor	Description
Other
ImageFlaggedUnsafe
CopyrightValidation
IpTheft

RegionalReplicationStatus

Object

Este é o status de replicação regional.

Name	Tipo	Description
details	string	Os detalhes do status da replicação.
progress	integer (int32)	Ele indica o progresso do trabalho de replicação.
region	string	A região para a qual a versão da imagem da galeria está sendo replicada.
state	ReplicationState	Este é o estado de replicação regional.

ReplicationMode

Enumeração

Parâmetro opcional que especifica o modo a ser usado para replicação. Esta propriedade não é atualizável.

Valor	Description
Full
Shallow

ReplicationState

Enumeração

Este é o estado de replicação regional.

Valor	Description
Unknown
Replicating
Completed
Failed

ReplicationStatus

Object

Este é o status de replicação da versão da imagem da galeria.

Name	Tipo	Description
aggregatedState	AggregatedReplicationState	Este é o status de replicação agregado com base em todos os sinalizadores de status de replicação regional.
summary	RegionalReplicationStatus[]	Este é um resumo do status de replicação para cada região.

StorageAccountType

Enumeração

Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.

Valor	Description
Standard_LRS
Standard_ZRS
Premium_LRS
PremiumV2_LRS

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TargetRegion

Object

Descreve as informações da região de destino.

Name	Tipo	Description
additionalReplicaSets	AdditionalReplicaSet[]	Lista de sku de armazenamento com contagem de réplicas para criar réplicas diretas de drive.
encryption	EncryptionImages	Opcional. Permite que os usuários forneçam chaves gerenciadas pelo cliente para criptografar o sistema operacional e os discos de dados no artefato da galeria.
excludeFromLatest	boolean	Contém a configuração de sinalizador para ocultar uma imagem quando os usuários especificam version='latest'
name	string	O nome da região.
regionalReplicaCount	integer (int32)	O número de réplicas da Versão da Imagem a ser criada por região. Esta propriedade é atualizável.
storageAccountType	StorageAccountType	Especifica o tipo de conta de armazenamento a ser usado para armazenar a imagem. Esta propriedade não é atualizável.

UefiKey

Object

Uma assinatura de chave UEFI.

Name	Tipo	Description
type	UefiKeyType	O tipo de assinatura de chave.
value	string[]	O valor da assinatura de chave.

UefiKeySignatures

Object

Assinaturas de chave UEFI adicionais que serão adicionadas à imagem, além dos modelos de assinatura

Name	Tipo	Description
db	UefiKey[]	O banco de dados de chaves UEFI para esta versão da imagem.
dbx	UefiKey[]	O banco de dados de chaves UEFI revogadas para esta versão da imagem.
kek	UefiKey[]	As chaves de criptografia de chave desta versão de imagem.
pk	UefiKey	A chave de plataforma desta versão da imagem.

UefiKeyType

Enumeração

O tipo de assinatura de chave.

Valor	Description
sha256
x509

UefiSignatureTemplateName

Enumeração

O nome do modelo de assinatura que contém chaves UEFI padrão.

Valor	Description
NoSignatureTemplate
MicrosoftUefiCertificateAuthorityTemplate
MicrosoftWindowsTemplate

ValidationsProfile

Object

Este é o perfil de validações de uma Versão de Imagem da Galeria.

Name	Tipo	Description
executedValidations	ExecutedValidation[]	Esta é a Validação executada.
platformAttributes	PlatformAttribute[]	Isso especifica o pub, offer, sku e versão dos metadados da versão da imagem
validationEtag	string	A hora de publicação da versão da imagem

ValidationStatus

Enumeração

Esta propriedade especifica o status do validationProfile da versão da imagem.

Valor	Description
Unknown
Failed
Succeeded