Restore Point Collections - Update

Referencia

Servicio:: Compute

Versión de la API:: 2024-07-01

Operación para actualizar la colección de puntos de restauración.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}?api-version=2024-07-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos.
restorePointCollectionName	path	True	string	Nombre de la colección de puntos de restauración.
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
api-version	query	True	string	Versión de api de cliente.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties.source	RestorePointCollectionSourceProperties	Las propiedades del recurso de origen a partir de las que se crea esta colección de puntos de restauración.
tags	object	Etiquetas de recursos

Respuestas

Nombre	Tipo	Description
200 OK	RestorePointCollection	De acuerdo
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

RestorePointCollection_Update_MaximumSet_Gen

RestorePointCollection_Update_MinimumSet_Gen

RestorePointCollection_Update_MaximumSet_Gen

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/restorePointCollections/aaaaaaaaaaaaaaaaaaaa?api-version=2024-07-01

{
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"
    }
  },
  "tags": {
    "key8536": "aaaaaaaaaaaaaaaaaaa"
  }
}


import com.azure.resourcemanager.compute.models.RestorePointCollectionSourceProperties;
import com.azure.resourcemanager.compute.models.RestorePointCollectionUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for RestorePointCollections Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * restorePointExamples/RestorePointCollection_Update_MaximumSet_Gen.json
     */
    /**
     * Sample code: RestorePointCollection_Update_MaximumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void restorePointCollectionUpdateMaximumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePointCollections().updateWithResponse("rgcompute",
            "aaaaaaaaaaaaaaaaaaaa",
            new RestorePointCollectionUpdate().withTags(mapOf("key8536", "fakeTokenPlaceholder"))
                .withSource(new RestorePointCollectionSourceProperties().withId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python restore_point_collection_update_maximum_set_gen.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.restore_point_collections.update(
        resource_group_name="rgcompute",
        restore_point_collection_name="aaaaaaaaaaaaaaaaaaaa",
        parameters={
            "properties": {
                "source": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"
                }
            },
            "tags": {"key8536": "aaaaaaaaaaaaaaaaaaa"},
        },
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MaximumSet_Gen.json
if __name__ == "__main__":
    main()

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MaximumSet_Gen.json
func ExampleRestorePointCollectionsClient_Update_restorePointCollectionUpdateMaximumSetGen() {
	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)
	}
	res, err := clientFactory.NewRestorePointCollectionsClient().Update(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaa", armcompute.RestorePointCollectionUpdate{
		Tags: map[string]*string{
			"key8536": to.Ptr("aaaaaaaaaaaaaaaaaaa"),
		},
		Properties: &armcompute.RestorePointCollectionProperties{
			Source: &armcompute.RestorePointCollectionSourceProperties{
				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.RestorePointCollection = armcompute.RestorePointCollection{
	// 	Name: to.Ptr("myRpc"),
	// 	Type: to.Ptr("Microsoft.Compute/restorePointCollections"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc"),
	// 	Location: to.Ptr("norwayeast"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armcompute.RestorePointCollectionProperties{
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		RestorePointCollectionID: to.Ptr("638f052b-a7c2-450c-89e7-6a3b8f1d6a7c"),
	// 		RestorePoints: []*armcompute.RestorePoint{
	// 			{
	// 				Name: to.Ptr("aaaaaaaaaaaaaaaaaa"),
	// 				Type: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 				ID: to.Ptr("aaaaaaaaaaa"),
	// 				Properties: &armcompute.RestorePointProperties{
	// 					ConsistencyMode: to.Ptr(armcompute.ConsistencyModeTypesCrashConsistent),
	// 					ExcludeDisks: []*armcompute.APIEntityReference{
	// 						{
	// 							ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f_22b4bdfe-6c54-4f72-84d8-85d8860f0c57"),
	// 					}},
	// 					ProvisioningState: to.Ptr("Succeeded"),
	// 					SourceMetadata: &armcompute.RestorePointSourceMetadata{
	// 						DiagnosticsProfile: &armcompute.DiagnosticsProfile{
	// 							BootDiagnostics: &armcompute.BootDiagnostics{
	// 								Enabled: to.Ptr(true),
	// 								StorageURI: to.Ptr("aaaaaaaaaaaaaaaaaaa"),
	// 							},
	// 						},
	// 						HardwareProfile: &armcompute.HardwareProfile{
	// 							VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardB1S),
	// 							VMSizeProperties: &armcompute.VMSizeProperties{
	// 								VCPUsAvailable: to.Ptr[int32](9),
	// 								VCPUsPerCore: to.Ptr[int32](12),
	// 							},
	// 						},
	// 						LicenseType: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 						Location: to.Ptr("westus"),
	// 						OSProfile: &armcompute.OSProfile{
	// 							AdminUsername: to.Ptr("admin"),
	// 							AllowExtensionOperations: to.Ptr(true),
	// 							ComputerName: to.Ptr("computerName"),
	// 							CustomData: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 							LinuxConfiguration: &armcompute.LinuxConfiguration{
	// 								DisablePasswordAuthentication: to.Ptr(true),
	// 								PatchSettings: &armcompute.LinuxPatchSettings{
	// 									AssessmentMode: to.Ptr(armcompute.LinuxPatchAssessmentModeImageDefault),
	// 									PatchMode: to.Ptr(armcompute.LinuxVMGuestPatchModeImageDefault),
	// 								},
	// 								ProvisionVMAgent: to.Ptr(true),
	// 								SSH: &armcompute.SSHConfiguration{
	// 									PublicKeys: []*armcompute.SSHPublicKey{
	// 										{
	// 											Path: to.Ptr("aaa"),
	// 											KeyData: to.Ptr("aaaaaa"),
	// 									}},
	// 								},
	// 							},
	// 							RequireGuestProvisionSignal: to.Ptr(true),
	// 							Secrets: []*armcompute.VaultSecretGroup{
	// 								{
	// 									SourceVault: &armcompute.SubResource{
	// 										ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"),
	// 									},
	// 									VaultCertificates: []*armcompute.VaultCertificate{
	// 										{
	// 											CertificateStore: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 											CertificateURL: to.Ptr("aaaaaaa"),
	// 									}},
	// 							}},
	// 							WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 								AdditionalUnattendContent: []*armcompute.AdditionalUnattendContent{
	// 									{
	// 										ComponentName: to.Ptr("Microsoft-Windows-Shell-Setup"),
	// 										Content: to.Ptr("aaaaaaaaaaaaaaaaaaaa"),
	// 										PassName: to.Ptr("OobeSystem"),
	// 										SettingName: to.Ptr(armcompute.SettingNamesAutoLogon),
	// 								}},
	// 								EnableAutomaticUpdates: to.Ptr(true),
	// 								PatchSettings: &armcompute.PatchSettings{
	// 									AssessmentMode: to.Ptr(armcompute.WindowsPatchAssessmentModeImageDefault),
	// 									EnableHotpatching: to.Ptr(true),
	// 									PatchMode: to.Ptr(armcompute.WindowsVMGuestPatchModeManual),
	// 								},
	// 								ProvisionVMAgent: to.Ptr(true),
	// 								TimeZone: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 								WinRM: &armcompute.WinRMConfiguration{
	// 									Listeners: []*armcompute.WinRMListener{
	// 										{
	// 											CertificateURL: to.Ptr("aaaaaaaaaaaaaaaaaaaaaa"),
	// 											Protocol: to.Ptr(armcompute.ProtocolTypesHTTP),
	// 									}},
	// 								},
	// 							},
	// 						},
	// 						SecurityProfile: &armcompute.SecurityProfile{
	// 							EncryptionAtHost: to.Ptr(true),
	// 							SecurityType: to.Ptr(armcompute.SecurityTypesTrustedLaunch),
	// 							UefiSettings: &armcompute.UefiSettings{
	// 								SecureBootEnabled: to.Ptr(true),
	// 								VTpmEnabled: to.Ptr(true),
	// 							},
	// 						},
	// 						StorageProfile: &armcompute.RestorePointSourceVMStorageProfile{
	// 							DataDisks: []*armcompute.RestorePointSourceVMDataDisk{
	// 								{
	// 									Name: to.Ptr("testingexcludedisk_DataDisk_1"),
	// 									Caching: to.Ptr(armcompute.CachingTypesNone),
	// 									DiskRestorePoint: &armcompute.DiskRestorePointAttributes{
	// 										ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_DataDisk_1_68785190-1acb-4d5e-a8ae-705b45f3dca5"),
	// 									},
	// 									DiskSizeGB: to.Ptr[int32](24),
	// 									Lun: to.Ptr[int32](1),
	// 									ManagedDisk: &armcompute.ManagedDiskParameters{
	// 										ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/testingexcludedisk_DataDisk_1"),
	// 										DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
	// 											ID: to.Ptr("aaaaaaaaaaaa"),
	// 										},
	// 										StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 									},
	// 							}},
	// 							DiskControllerType: to.Ptr(armcompute.DiskControllerTypesNVMe),
	// 							OSDisk: &armcompute.RestorePointSourceVMOSDisk{
	// 								Name: to.Ptr("testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f"),
	// 								Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 								DiskRestorePoint: &armcompute.DiskRestorePointAttributes{
	// 									ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f_22b4bdfe-6c54-4f72-84d8-85d8860f0c57"),
	// 								},
	// 								DiskSizeGB: to.Ptr[int32](3),
	// 								EncryptionSettings: &armcompute.DiskEncryptionSettings{
	// 									DiskEncryptionKey: &armcompute.KeyVaultSecretReference{
	// 										SecretURL: to.Ptr("aaaaaaaa"),
	// 										SourceVault: &armcompute.SubResource{
	// 											ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"),
	// 										},
	// 									},
	// 									Enabled: to.Ptr(true),
	// 									KeyEncryptionKey: &armcompute.KeyVaultKeyReference{
	// 										KeyURL: to.Ptr("aaaaaaaaaaaaaa"),
	// 										SourceVault: &armcompute.SubResource{
	// 											ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"),
	// 										},
	// 									},
	// 								},
	// 								ManagedDisk: &armcompute.ManagedDiskParameters{
	// 									ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f"),
	// 									DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
	// 										ID: to.Ptr("aaaaaaaaaaaa"),
	// 									},
	// 									StorageAccountType: to.Ptr(armcompute.StorageAccountTypesStandardLRS),
	// 								},
	// 								OSType: to.Ptr(armcompute.OperatingSystemTypeWindows),
	// 							},
	// 						},
	// 						VMID: to.Ptr("76d6541e-80bd-4dc1-932b-3cae4cfb80e7"),
	// 					},
	// 					TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T12:58:26.593Z"); return t}()),
	// 				},
	// 		}},
	// 		Source: &armcompute.RestorePointCollectionSourceProperties{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 			Location: to.Ptr("eastus"),
	// 		},
	// 	},
	// }
}

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 The operation to update the restore point collection.
 *
 * @summary The operation to update the restore point collection.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MaximumSet_Gen.json
 */
async function restorePointCollectionUpdateMaximumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const restorePointCollectionName = "aaaaaaaaaaaaaaaaaaaa";
  const parameters = {
    source: {
      id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
    },
    tags: { key8536: "aaaaaaaaaaaaaaaaaaa" },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePointCollections.update(
    resourceGroupName,
    restorePointCollectionName,
    parameters,
  );
  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 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/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MaximumSet_Gen.json
// this example is just showing the usage of "RestorePointCollections_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 RestorePointGroupResource created on azure
// for more information of creating RestorePointGroupResource, please refer to the document of RestorePointGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string restorePointGroupName = "aaaaaaaaaaaaaaaaaaaa";
ResourceIdentifier restorePointGroupResourceId = RestorePointGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, restorePointGroupName);
RestorePointGroupResource restorePointGroup = client.GetRestorePointGroupResource(restorePointGroupResourceId);

// invoke the operation
RestorePointGroupPatch patch = new RestorePointGroupPatch
{
    Source = new RestorePointGroupSource
    {
        Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
    },
    Tags =
    {
    ["key8536"] = "aaaaaaaaaaaaaaaaaaa"
    },
};
RestorePointGroupResource result = await restorePointGroup.UpdateAsync(patch);

// 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
RestorePointGroupData 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

Respuesta de muestra

status code:: 200

{
  "location": "norwayeast",
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
      "location": "eastus"
    },
    "provisioningState": "Successful",
    "restorePointCollectionId": "638f052b-a7c2-450c-89e7-6a3b8f1d6a7c",
    "restorePoints": [
      {
        "properties": {
          "excludeDisks": [
            {
              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f_22b4bdfe-6c54-4f72-84d8-85d8860f0c57"
            }
          ],
          "sourceMetadata": {
            "hardwareProfile": {
              "vmSize": "Standard_B1s",
              "vmSizeProperties": {
                "vCPUsAvailable": 9,
                "vCPUsPerCore": 12
              }
            },
            "storageProfile": {
              "osDisk": {
                "osType": "Windows",
                "encryptionSettings": {
                  "diskEncryptionKey": {
                    "secretUrl": "aaaaaaaa",
                    "sourceVault": {
                      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
                    }
                  },
                  "keyEncryptionKey": {
                    "keyUrl": "aaaaaaaaaaaaaa",
                    "sourceVault": {
                      "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
                    }
                  },
                  "enabled": true
                },
                "name": "testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f",
                "caching": "ReadWrite",
                "diskSizeGB": 3,
                "managedDisk": {
                  "storageAccountType": "Standard_LRS",
                  "diskEncryptionSet": {
                    "id": "aaaaaaaaaaaa"
                  },
                  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f"
                },
                "diskRestorePoint": {
                  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f_22b4bdfe-6c54-4f72-84d8-85d8860f0c57"
                }
              },
              "dataDisks": [
                {
                  "lun": 1,
                  "name": "testingexcludedisk_DataDisk_1",
                  "caching": "None",
                  "managedDisk": {
                    "storageAccountType": "Standard_LRS",
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/testingexcludedisk_DataDisk_1",
                    "diskEncryptionSet": {
                      "id": "aaaaaaaaaaaa"
                    }
                  },
                  "diskRestorePoint": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_DataDisk_1_68785190-1acb-4d5e-a8ae-705b45f3dca5"
                  },
                  "diskSizeGB": 24
                }
              ],
              "diskControllerType": "NVMe"
            },
            "osProfile": {
              "computerName": "computerName",
              "adminUsername": "admin",
              "customData": "aaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "windowsConfiguration": {
                "provisionVMAgent": true,
                "enableAutomaticUpdates": true,
                "timeZone": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "additionalUnattendContent": [
                  {
                    "passName": "OobeSystem",
                    "componentName": "Microsoft-Windows-Shell-Setup",
                    "settingName": "AutoLogon",
                    "content": "aaaaaaaaaaaaaaaaaaaa"
                  }
                ],
                "patchSettings": {
                  "patchMode": "Manual",
                  "enableHotpatching": true,
                  "assessmentMode": "ImageDefault"
                },
                "winRM": {
                  "listeners": [
                    {
                      "protocol": "Http",
                      "certificateUrl": "aaaaaaaaaaaaaaaaaaaaaa"
                    }
                  ]
                }
              },
              "linuxConfiguration": {
                "disablePasswordAuthentication": true,
                "ssh": {
                  "publicKeys": [
                    {
                      "path": "aaa",
                      "keyData": "aaaaaa"
                    }
                  ]
                },
                "provisionVMAgent": true,
                "patchSettings": {
                  "patchMode": "ImageDefault",
                  "assessmentMode": "ImageDefault"
                }
              },
              "secrets": [
                {
                  "sourceVault": {
                    "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/availabilitySets/{availabilitySetName}"
                  },
                  "vaultCertificates": [
                    {
                      "certificateUrl": "aaaaaaa",
                      "certificateStore": "aaaaaaaaaaaaaaaaaaaaaaaaa"
                    }
                  ]
                }
              ],
              "allowExtensionOperations": true,
              "requireGuestProvisionSignal": true
            },
            "diagnosticsProfile": {
              "bootDiagnostics": {
                "enabled": true,
                "storageUri": "aaaaaaaaaaaaaaaaaaa"
              }
            },
            "licenseType": "aaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "vmId": "76d6541e-80bd-4dc1-932b-3cae4cfb80e7",
            "securityProfile": {
              "uefiSettings": {
                "secureBootEnabled": true,
                "vTpmEnabled": true
              },
              "encryptionAtHost": true,
              "securityType": "TrustedLaunch"
            },
            "location": "westus"
          },
          "provisioningState": "aaaaaaaaaaaaaaaaa",
          "consistencyMode": "CrashConsistent",
          "timeCreated": "2021-11-30T12:58:26.593Z"
        },
        "id": "aaaaaaaaaaa",
        "name": "aaaaaaaaaaaaaaaaaa",
        "type": "aaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ]
  },
  "tags": {},
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
  "name": "myRpc",
  "type": "Microsoft.Compute/restorePointCollections"
}

RestorePointCollection_Update_MinimumSet_Gen

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/restorePointCollections/aaaaaaaaaaaaaaaaaa?api-version=2024-07-01

{}


import com.azure.resourcemanager.compute.models.RestorePointCollectionUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for RestorePointCollections Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * restorePointExamples/RestorePointCollection_Update_MinimumSet_Gen.json
     */
    /**
     * Sample code: RestorePointCollection_Update_MinimumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void restorePointCollectionUpdateMinimumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePointCollections().updateWithResponse("rgcompute",
            "aaaaaaaaaaaaaaaaaa", new RestorePointCollectionUpdate(), com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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/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/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MinimumSet_Gen.json
func ExampleRestorePointCollectionsClient_Update_restorePointCollectionUpdateMinimumSetGen() {
	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)
	}
	res, err := clientFactory.NewRestorePointCollectionsClient().Update(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaa", armcompute.RestorePointCollectionUpdate{}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.RestorePointCollection = armcompute.RestorePointCollection{
	// 	Location: to.Ptr("norwayeast"),
	// }
}

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 The operation to update the restore point collection.
 *
 * @summary The operation to update the restore point collection.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MinimumSet_Gen.json
 */
async function restorePointCollectionUpdateMinimumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const restorePointCollectionName = "aaaaaaaaaaaaaaaaaa";
  const parameters = {};
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePointCollections.update(
    resourceGroupName,
    restorePointCollectionName,
    parameters,
  );
  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 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/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Update_MinimumSet_Gen.json
// this example is just showing the usage of "RestorePointCollections_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 RestorePointGroupResource created on azure
// for more information of creating RestorePointGroupResource, please refer to the document of RestorePointGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string restorePointGroupName = "aaaaaaaaaaaaaaaaaa";
ResourceIdentifier restorePointGroupResourceId = RestorePointGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, restorePointGroupName);
RestorePointGroupResource restorePointGroup = client.GetRestorePointGroupResource(restorePointGroupResourceId);

// invoke the operation
RestorePointGroupPatch patch = new RestorePointGroupPatch();
RestorePointGroupResource result = await restorePointGroup.UpdateAsync(patch);

// 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
RestorePointGroupData 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

Respuesta de muestra

status code:: 200

{
  "location": "norwayeast"
}

Definiciones

Nombre	Description
AdditionalUnattendContent	Especifica información adicional con formato XML que se puede incluir en el archivo Unattend.xml, que usa el programa de instalación de Windows. El contenido se define estableciendo el nombre, el nombre del componente y el paso en el que se aplica el contenido.
ApiEntityReference	Referencia de entidad de API.
ApiError	Error de API.
ApiErrorBase	Base de errores de api.
BootDiagnostics	El diagnóstico de arranque es una característica de depuración que permite ver la salida de la consola y la captura de pantalla para diagnosticar el estado de la máquina virtual. Puede ver fácilmente la salida del registro de consola. Azure también le permite ver una captura de pantalla de la máquina virtual desde el hipervisor.
CachingTypes	Obtiene el tipo de almacenamiento en caché.
CloudError	Respuesta de error del servicio Compute.
ComponentNames	Nombre del componente. Actualmente, el único valor permitido es Microsoft-Windows-Shell-Setup.
ConsistencyModeTypes	ConsistencyMode de RestorePoint. Se puede especificar en la entrada al crear un punto de restauración. Por ahora, solo CrashConsistent se acepta como entrada válida. Consulte https://aka.ms/RestorePoints para obtener más información.
DiagnosticsProfile	Especifica el estado de configuración de diagnóstico de arranque. Versión mínima de api: 2015-06-15.
DiskControllerTypes	Obtiene el tipo de controlador de disco de la máquina virtual capturada en el momento de la creación del punto de restauración.
DiskEncryptionSetParameters	Describe el parámetro del identificador de recurso del conjunto de cifrado de disco administrado por el cliente que se puede especificar para el disco. Nota: El identificador de recurso del conjunto de cifrado de disco solo se puede especificar para el disco administrado. Consulte https://aka.ms/mdssewithcmkoverview para obtener más información.
DiskEncryptionSettings	Describe una configuración de cifrado para un disco
DiskRestorePointAttributes	Detalles del punto de restauración de disco.
DiskRestorePointInstanceView	Vista de instancia de un punto de restauración de disco.
DiskRestorePointReplicationStatus	Vista de instancia de un punto de restauración de disco.
EncryptionIdentity	Especifica la identidad administrada usada por ADE para obtener el token de acceso para las operaciones de keyvault.
HardwareProfile	Especifica la configuración de hardware de la máquina virtual.
HyperVGenerationTypes	HyperVGeneration de la máquina virtual de origen para la que se captura el punto de restauración.
InnerError	Detalles del error interno.
InstanceViewStatus	Estado de la vista de instancia.
KeyVaultKeyReference	Describe una referencia a la clave de Key Vault.
KeyVaultSecretReference	Describe una referencia al secreto de Key Vault.
LinuxConfiguration	Especifica la configuración del sistema operativo Linux en la máquina virtual. Para obtener una lista de las distribuciones de Linux admitidas, consulte Linux on Azure-Endorsed Distributions.
LinuxPatchAssessmentMode	Especifica el modo de evaluación de revisiones de invitado de máquina virtual para la máquina virtual IaaS. Los valores posibles son: ImageDefault: controla el tiempo de las evaluaciones de revisiones en una máquina virtual. AutomaticByPlatform: la plataforma desencadenará evaluaciones periódicas de revisiones. La propiedad provisionVMAgent debe ser true.
LinuxPatchSettings	Especifica la configuración relacionada con la aplicación de revisiones de invitado de máquina virtual en Linux.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Especifica la configuración de reinicio para todas las operaciones de instalación de revisiones AutomaticByPlatform.
LinuxVMGuestPatchAutomaticByPlatformSettings	Especifica la configuración adicional que se va a aplicar cuando el modo de revisión AutomaticByPlatform está seleccionado en la configuración de revisión de Linux.
LinuxVMGuestPatchMode	Especifica el modo de aplicación de revisiones de invitado de máquina virtual a máquinas virtuales iaaS o máquinas virtuales asociadas al conjunto de escalado de máquinas virtuales con OrchestrationMode como flexible. Los valores posibles son: imageDefault: se usa la configuración de aplicación de revisiones predeterminada de la máquina virtual. AutomaticByPlatform: la plataforma actualizará automáticamente la máquina virtual. La propiedad provisionVMAgent debe ser true
ManagedDiskParameters	Parámetros de un disco administrado.
Mode	Especifica el modo en el que se ejecutará ProxyAgent si la característica está habilitada. ProxyAgent comenzará a auditar o supervisar, pero no aplicará el control de acceso sobre las solicitudes a los puntos de conexión host en modo auditoría, mientras que en el modo Aplicar aplicará el control de acceso. El valor predeterminado es Aplicar modo.
OperatingSystemType	Obtiene el tipo de sistema operativo.
OSProfile	Especifica la configuración del sistema operativo para la máquina virtual. Algunas de las opciones de configuración no se pueden cambiar una vez que se aprovisiona la máquina virtual.
PassNames	Nombre del pase. Actualmente, el único valor permitido es OobeSystem.
PatchSettings	Especifica la configuración relacionada con la aplicación de revisiones de invitado de máquina virtual en Windows.
ProtocolTypes	Especifica el protocolo del agente de escucha winRM. Los valores posibles son: http,https.
ProxyAgentSettings	Especifica la configuración de ProxyAgent al crear la máquina virtual. Versión mínima de api: 2023-09-01.
RestorePoint	Detalles del punto de restauración.
RestorePointCollection	Cree o actualice los parámetros de la colección Restore Point.
RestorePointCollectionSourceProperties	Las propiedades del recurso de origen a partir de las que se crea esta colección de puntos de restauración.
RestorePointCollectionUpdate	Actualice los parámetros de la colección De punto de restauración.
RestorePointEncryption	Configuración de cifrado en reposo para el punto de restauración de disco. Es una propiedad opcional que se puede especificar en la entrada al crear un punto de restauración.
RestorePointEncryptionType	Tipo de clave que se usa para cifrar los datos del punto de restauración de disco.
RestorePointInstanceView	Vista de instancia de un punto de restauración.
RestorePointSourceMetadata	Describe las propiedades de la máquina virtual para la que se creó el punto de restauración. Las propiedades proporcionadas son un subconjunto y la instantánea de las propiedades generales de la máquina virtual capturadas en el momento de la creación del punto de restauración.
RestorePointSourceVMDataDisk	Describe un disco de datos.
RestorePointSourceVMOSDisk	Describe un disco del sistema operativo.
RestorePointSourceVMStorageProfile	Describe el perfil de almacenamiento.
securityEncryptionTypes	Especifica encryptionType del disco administrado. Se establece en DiskWithVMGuestState para el cifrado del disco administrado junto con el blob VMGuestState, VMGuestStateOnly para el cifrado de solo el blob VMGuestState y NonPersistedTPM para no conservar el estado de firmware en el blob VMGuestState. Nota: Solo se puede establecer para máquinas virtuales confidenciales.
SecurityProfile	Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales.
SecurityTypes	Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. El comportamiento predeterminado es: UefiSettings no se habilitará a menos que se establezca esta propiedad.
SettingNames	Especifica el nombre de la configuración a la que se aplica el contenido. Los valores posibles son: FirstLogonCommands y AutoLogon.
SshConfiguration	Configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure
SshPublicKey	Contiene información sobre la clave pública del certificado SSH y la ruta de acceso en la máquina virtual Linux donde se coloca la clave pública.
StatusLevelTypes	Código de nivel.
StorageAccountTypes	Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con disco del sistema operativo.
SubResource
UefiSettings	Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. Versión mínima de api: 2020-12-01.
VaultCertificate	Describe una sola referencia de certificado en un almacén de claves y dónde debe residir el certificado en la máquina virtual.
VaultSecretGroup	Describe un conjunto de certificados que están todos en la misma instancia de Key Vault.
VirtualMachineSizeTypes	Especifica el tamaño de la máquina virtual. El tipo de datos de enumeración está actualmente en desuso y se quitará el 23 de diciembre de 2023. La manera recomendada de obtener la lista de tamaños disponibles es usar estas API: Enumerar todos los tamaños de máquina virtual disponibles en un conjunto de disponibilidad, Enumerar todos los tamaños de máquina virtual disponibles en una región, Enumerar todos los tamaños de máquina virtual disponibles para cambiar el tamaño. Para obtener más información sobre los tamaños de máquina virtual, consulte tamaños de para máquinas virtuales. Los tamaños de máquina virtual disponibles dependen de la región y el conjunto de disponibilidad.
VMDiskSecurityProfile	Especifica la configuración del perfil de seguridad para el disco administrado. Nota: Solo se puede establecer para máquinas virtuales confidenciales.
VMSizeProperties	Especifica la configuración de la propiedad tamaño de máquina virtual en la máquina virtual.
WindowsConfiguration	Especifica la configuración del sistema operativo Windows en la máquina virtual.
WindowsPatchAssessmentMode	Especifica el modo de evaluación de revisiones de invitado de máquina virtual para la máquina virtual IaaS. Los valores posibles son: ImageDefault: controla el tiempo de las evaluaciones de revisiones en una máquina virtual. AutomaticByPlatform: la plataforma desencadenará evaluaciones periódicas de revisiones. La propiedad provisionVMAgent debe ser true.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Especifica la configuración de reinicio para todas las operaciones de instalación de revisiones AutomaticByPlatform.
WindowsVMGuestPatchAutomaticByPlatformSettings	Especifica la configuración adicional que se va a aplicar cuando el modo de revisión AutomaticByPlatform está seleccionado en la configuración de revisión de Windows.
WindowsVMGuestPatchMode	Especifica el modo de aplicación de revisiones de invitado de máquina virtual a máquinas virtuales iaaS o máquinas virtuales asociadas al conjunto de escalado de máquinas virtuales con OrchestrationMode como flexible. Los valores posibles son: Manual: controla la aplicación de revisiones en una máquina virtual. Para ello, aplique revisiones manualmente dentro de la máquina virtual. En este modo, las actualizaciones automáticas están deshabilitadas; La propiedad WindowsConfiguration.enableAutomaticUpdates debe ser false AutomaticByOS: el sistema operativo actualizará automáticamente la máquina virtual. La propiedad WindowsConfiguration.enableAutomaticUpdates debe ser true. AutomaticByPlatform: la máquina virtual actualizará automáticamente la plataforma. Las propiedades provisionVMAgent y WindowsConfiguration.enableAutomaticUpdates deben ser true.
WinRMConfiguration	Describe la configuración de administración remota de Windows de la máquina virtual.
WinRMListener	Describe el protocolo y la huella digital del agente de escucha de administración remota de Windows.

AdditionalUnattendContent

Especifica información adicional con formato XML que se puede incluir en el archivo Unattend.xml, que usa el programa de instalación de Windows. El contenido se define estableciendo el nombre, el nombre del componente y el paso en el que se aplica el contenido.

Nombre	Tipo	Description
componentName	ComponentNames	Nombre del componente. Actualmente, el único valor permitido es Microsoft-Windows-Shell-Setup.
content	string	Especifica el contenido con formato XML que se agrega al archivo unattend.xml para la ruta de acceso y el componente especificados. El XML debe ser inferior a 4 KB y debe incluir el elemento raíz para la configuración o característica que se está insertando.
passName	PassNames	Nombre del pase. Actualmente, el único valor permitido es OobeSystem.
settingName	SettingNames	Especifica el nombre de la configuración a la que se aplica el contenido. Los valores posibles son: FirstLogonCommands y AutoLogon.

ApiEntityReference

Referencia de entidad de API.

Nombre	Tipo	Description
id	string	Identificador de recurso de ARM en forma de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de api
innererror	InnerError	Error interno de api
message	string	Mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Base de errores de api.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error.
target	string	Destino del error concreto.

BootDiagnostics

El diagnóstico de arranque es una característica de depuración que permite ver la salida de la consola y la captura de pantalla para diagnosticar el estado de la máquina virtual. Puede ver fácilmente la salida del registro de consola. Azure también le permite ver una captura de pantalla de la máquina virtual desde el hipervisor.

Nombre	Tipo	Description
enabled	boolean	Si se deben habilitar los diagnósticos de arranque en la máquina virtual.
storageUri	string	Uri de la cuenta de almacenamiento que se va a usar para colocar la salida y la captura de pantalla de la consola. Si no se especifica storageUri al habilitar los diagnósticos de arranque, se usará el almacenamiento administrado.

CachingTypes

Obtiene el tipo de almacenamiento en caché.

Nombre	Tipo	Description
None	string
ReadOnly	string
ReadWrite	string

CloudError

Respuesta de error del servicio Compute.

Nombre	Tipo	Description
error	ApiError	Error de API.

ComponentNames

Nombre del componente. Actualmente, el único valor permitido es Microsoft-Windows-Shell-Setup.

Nombre	Tipo	Description
Microsoft-Windows-Shell-Setup	string

ConsistencyModeTypes

ConsistencyMode de RestorePoint. Se puede especificar en la entrada al crear un punto de restauración. Por ahora, solo CrashConsistent se acepta como entrada válida. Consulte https://aka.ms/RestorePoints para obtener más información.

Nombre	Tipo	Description
ApplicationConsistent	string
CrashConsistent	string
FileSystemConsistent	string

DiagnosticsProfile

Especifica el estado de configuración de diagnóstico de arranque. Versión mínima de api: 2015-06-15.

Nombre	Tipo	Description
bootDiagnostics	BootDiagnostics	El diagnóstico de arranque es una característica de depuración que permite ver la salida de la consola y la captura de pantalla para diagnosticar el estado de la máquina virtual. NOTA: si se especifica storageUri, asegúrese de que la cuenta de almacenamiento esté en la misma región y suscripción que la máquina virtual. Puede ver fácilmente la salida del registro de consola. Azure también le permite ver una captura de pantalla de la máquina virtual desde el hipervisor.

DiskControllerTypes

Obtiene el tipo de controlador de disco de la máquina virtual capturada en el momento de la creación del punto de restauración.

Nombre	Tipo	Description
NVMe	string
SCSI	string

DiskEncryptionSetParameters

Describe el parámetro del identificador de recurso del conjunto de cifrado de disco administrado por el cliente que se puede especificar para el disco. Nota: El identificador de recurso del conjunto de cifrado de disco solo se puede especificar para el disco administrado. Consulte https://aka.ms/mdssewithcmkoverview para obtener más información.

Nombre	Tipo	Description
id	string	Identificador de recurso

DiskEncryptionSettings

Describe una configuración de cifrado para un disco

Nombre	Tipo	Description
diskEncryptionKey	KeyVaultSecretReference	Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault.
enabled	boolean	Especifica si se debe habilitar el cifrado de disco en la máquina virtual.
keyEncryptionKey	KeyVaultKeyReference	Especifica la ubicación de la clave de cifrado de claves en Key Vault.

DiskRestorePointAttributes

Detalles del punto de restauración de disco.

Nombre	Tipo	Description
encryption	RestorePointEncryption	Configuración de cifrado en reposo para el punto de restauración de disco. Es una propiedad opcional que se puede especificar en la entrada al crear un punto de restauración.
id	string	Identificador de recurso
sourceDiskRestorePoint	ApiEntityReference	Identificador de recurso del punto de restauración del disco de origen.

DiskRestorePointInstanceView

Vista de instancia de un punto de restauración de disco.

Nombre	Tipo	Description
id	string	Identificador de punto de restauración de disco.
replicationStatus	DiskRestorePointReplicationStatus	Información de estado de replicación del punto de restauración de disco.

DiskRestorePointReplicationStatus

Vista de instancia de un punto de restauración de disco.

Nombre	Tipo	Description
completionPercent	integer	Porcentaje de finalización de replicación.
status	InstanceViewStatus	Información de estado del recurso.

EncryptionIdentity

Especifica la identidad administrada usada por ADE para obtener el token de acceso para las operaciones de keyvault.

Nombre	Tipo	Description
userAssignedIdentityResourceId	string	Especifica el identificador de recurso de ARM de una de las identidades de usuario asociadas a la máquina virtual.

HardwareProfile

Especifica la configuración de hardware de la máquina virtual.

Nombre	Tipo	Description
vmSize	VirtualMachineSizeTypes	Especifica el tamaño de la máquina virtual. El tipo de datos de enumeración está actualmente en desuso y se quitará el 23 de diciembre de 2023. La manera recomendada de obtener la lista de tamaños disponibles es usar estas API: Enumerar todos los tamaños de máquina virtual disponibles en un conjunto de disponibilidad, Enumerar todos los tamaños de máquina virtual disponibles en una región, Enumerar todos los tamaños de máquina virtual disponibles para cambiar el tamaño. Para obtener más información sobre los tamaños de máquina virtual, consulte tamaños de para máquinas virtuales. Los tamaños de máquina virtual disponibles dependen de la región y el conjunto de disponibilidad.
vmSizeProperties	VMSizeProperties	Especifica las propiedades para personalizar el tamaño de la máquina virtual. Versión mínima de api: 2021-07-01. Esta característica sigue en modo de vista previa y no se admite para VirtualMachineScaleSet. Siga las instrucciones de personalización de máquina virtual para obtener más información.

HyperVGenerationTypes

HyperVGeneration de la máquina virtual de origen para la que se captura el punto de restauración.

Nombre	Tipo	Description
V1	string
V2	string

InnerError

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	Mensaje de error interno o volcado de memoria de excepciones.
exceptiontype	string	Tipo de excepción.

InstanceViewStatus

Estado de la vista de instancia.

Nombre	Tipo	Description
code	string	Código de estado.
displayStatus	string	Etiqueta localizable corta para el estado.
level	StatusLevelTypes	Código de nivel.
message	string	Mensaje de estado detallado, incluido para alertas y mensajes de error.
time	string	Hora del estado.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault.

Nombre	Tipo	Description
keyUrl	string	Dirección URL que hace referencia a una clave de cifrado de claves en Key Vault.
sourceVault	SubResource	Dirección URL relativa del almacén de claves que contiene la clave.

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault.

Nombre	Tipo	Description
secretUrl	string	Dirección URL que hace referencia a un secreto en un almacén de claves.
sourceVault	SubResource	Dirección URL relativa del almacén de claves que contiene el secreto.

LinuxConfiguration

Especifica la configuración del sistema operativo Linux en la máquina virtual. Para obtener una lista de las distribuciones de Linux admitidas, consulte Linux on Azure-Endorsed Distributions.

Nombre	Tipo	Description
disablePasswordAuthentication	boolean	Especifica si se debe deshabilitar la autenticación de contraseña.
enableVMAgentPlatformUpdates	boolean	Indica si las actualizaciones de la plataforma VMAgent están habilitadas para la máquina virtual Linux. El valor predeterminado es false.
patchSettings	LinuxPatchSettings	[Característica de vista previa] Especifica la configuración relacionada con la aplicación de revisiones de invitado de máquina virtual en Linux.
provisionVMAgent	boolean	Indica si se debe aprovisionar el agente de máquina virtual en la máquina virtual. Cuando esta propiedad no se especifica en el cuerpo de la solicitud, el comportamiento predeterminado es establecerla en true. Esto garantizará que el agente de máquina virtual esté instalado en la máquina virtual para que las extensiones se puedan agregar a la máquina virtual más adelante.
ssh	SshConfiguration	Especifica la configuración de clave ssh para un sistema operativo Linux.

LinuxPatchAssessmentMode

Especifica el modo de evaluación de revisiones de invitado de máquina virtual para la máquina virtual IaaS.

Los valores posibles son:

ImageDefault: controla el tiempo de las evaluaciones de revisiones en una máquina virtual.

AutomaticByPlatform: la plataforma desencadenará evaluaciones periódicas de revisiones. La propiedad provisionVMAgent debe ser true.

Nombre	Tipo	Description
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

Especifica la configuración relacionada con la aplicación de revisiones de invitado de máquina virtual en Linux.

Nombre	Tipo	Description
assessmentMode	LinuxPatchAssessmentMode	Especifica el modo de evaluación de revisiones de invitado de máquina virtual para la máquina virtual IaaS. Los valores posibles son: ImageDefault: controla el tiempo de las evaluaciones de revisiones en una máquina virtual. AutomaticByPlatform: la plataforma desencadenará evaluaciones periódicas de revisiones. La propiedad provisionVMAgent debe ser true.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Especifica la configuración adicional para el modo de revisión AutomaticByPlatform en la aplicación de revisiones de invitado de máquina virtual en Linux.
patchMode	LinuxVMGuestPatchMode	Especifica el modo de aplicación de revisiones de invitado de máquina virtual a máquinas virtuales iaaS o máquinas virtuales asociadas al conjunto de escalado de máquinas virtuales con OrchestrationMode como flexible. Los valores posibles son: imageDefault: se usa la configuración de aplicación de revisiones predeterminada de la máquina virtual. AutomaticByPlatform: la plataforma actualizará automáticamente la máquina virtual. La propiedad provisionVMAgent debe ser true

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Especifica la configuración de reinicio para todas las operaciones de instalación de revisiones AutomaticByPlatform.

Nombre	Tipo	Description
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Especifica la configuración adicional que se va a aplicar cuando el modo de revisión AutomaticByPlatform está seleccionado en la configuración de revisión de Linux.

Nombre	Tipo	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	Permite al cliente programar la aplicación de revisiones sin actualizaciones accidentales
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Especifica la configuración de reinicio para todas las operaciones de instalación de revisiones AutomaticByPlatform.

LinuxVMGuestPatchMode

Nombre	Tipo	Description
AutomaticByPlatform	string
ImageDefault	string

ManagedDiskParameters

Parámetros de un disco administrado.

Nombre	Tipo	Description
diskEncryptionSet	DiskEncryptionSetParameters	Especifica el identificador de recurso del conjunto de cifrado de disco administrado del cliente para el disco administrado.
id	string	Identificador de recurso
securityProfile	VMDiskSecurityProfile	Especifica el perfil de seguridad del disco administrado.
storageAccountType	StorageAccountTypes	Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con disco del sistema operativo.

Mode

Especifica el modo en el que se ejecutará ProxyAgent si la característica está habilitada. ProxyAgent comenzará a auditar o supervisar, pero no aplicará el control de acceso sobre las solicitudes a los puntos de conexión host en modo auditoría, mientras que en el modo Aplicar aplicará el control de acceso. El valor predeterminado es Aplicar modo.

Nombre	Tipo	Description
Audit	string
Enforce	string

OperatingSystemType

Obtiene el tipo de sistema operativo.

Nombre	Tipo	Description
Linux	string
Windows	string

OSProfile

Especifica la configuración del sistema operativo para la máquina virtual. Algunas de las opciones de configuración no se pueden cambiar una vez que se aprovisiona la máquina virtual.

Nombre	Tipo	Description
adminPassword	string	Especifica la contraseña de la cuenta de administrador. longitud mínima (Windows): 8 caracteres longitud mínima (Linux): 6 caracteres longitud máxima (Windows): 123 caracteres longitud máxima (Linux): 72 caracteres requisitos de complejidad: 3 de 4 condiciones siguientes deben cumplirse. Tiene caracteres inferiores Tiene caracteres superiores Tiene un dígito Tiene un carácter especial (coincidencia regex [\W_]) valores no permitidos: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" Para restablecer la contraseña, consulte restablecimiento del servicio Escritorio remoto o su contraseña de inicio de sesión en una máquina virtual Windows Para restablecer la contraseña raíz, consulte Administración de usuarios, SSH y comprobación o reparación de discos en máquinas virtuales Linux de Azure mediante la extensión VMAccess
adminUsername	string	Especifica el nombre de la cuenta de administrador. Esta propiedad no se puede actualizar después de crear la máquina virtual. restricción solo de Windows: No se puede terminar en "." valores no permitidos: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm" ", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". longitud mínima (Linux): 1 carácter longitud máxima (Linux): 64 caracteres longitud máxima (Windows): 20 caracteres.
allowExtensionOperations	boolean	Especifica si se deben permitir operaciones de extensión en la máquina virtual. Esto solo se puede establecer en False cuando no hay extensiones presentes en la máquina virtual.
computerName	string	Especifica el nombre del sistema operativo host de la máquina virtual. Este nombre no se puede actualizar después de crear la máquina virtual. longitud máxima (Windows): 15 caracteres. longitud máxima (Linux): 64 caracteres. Para conocer las convenciones de nomenclatura y las restricciones, consulte directrices de implementación de servicios de infraestructura de Azure.
customData	string	Especifica una cadena codificada en base 64 de datos personalizados. La cadena codificada en base 64 se descodifica en una matriz binaria que se guarda como un archivo en la máquina virtual. La longitud máxima de la matriz binaria es de 65535 bytes. Nota: No pase secretos ni contraseñas en la propiedad customData. Esta propiedad no se puede actualizar después de crear la máquina virtual. La propiedad "customData" se pasa a la máquina virtual que se va a guardar como un archivo, para obtener más información, consulte Datos personalizados en máquinas virtuales de Azure. Para usar cloud-init para la máquina virtual Linux, consulte Uso de cloud-init para personalizar una máquina virtual Linux durante la creación.
linuxConfiguration	LinuxConfiguration	Especifica la configuración del sistema operativo Linux en la máquina virtual. Para obtener una lista de las distribuciones de Linux admitidas, consulte Linux on Azure-Endorsed Distributions.
requireGuestProvisionSignal	boolean	Propiedad opcional que debe establecerse en True o omitirse.
secrets	VaultSecretGroup[]	Especifica el conjunto de certificados que se deben instalar en la máquina virtual. Para instalar certificados en una máquina virtual, se recomienda usar la extensión de máquina virtual de Azure Key Vault de para Linux o la extensión de máquina virtual de Azure Key Vault de para Windows.
windowsConfiguration	WindowsConfiguration	Especifica la configuración del sistema operativo Windows en la máquina virtual.

PassNames

Nombre del pase. Actualmente, el único valor permitido es OobeSystem.

Nombre	Tipo	Description
OobeSystem	string

PatchSettings

Especifica la configuración relacionada con la aplicación de revisiones de invitado de máquina virtual en Windows.

Nombre	Tipo	Description
assessmentMode	WindowsPatchAssessmentMode	Especifica el modo de evaluación de revisiones de invitado de máquina virtual para la máquina virtual IaaS. Los valores posibles son: ImageDefault: controla el tiempo de las evaluaciones de revisiones en una máquina virtual. AutomaticByPlatform: la plataforma desencadenará evaluaciones periódicas de revisiones. La propiedad provisionVMAgent debe ser true.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Especifica la configuración adicional para el modo de revisión AutomaticByPlatform en la aplicación de revisiones de invitado de máquina virtual en Windows.
enableHotpatching	boolean	Permite a los clientes aplicar revisiones a sus máquinas virtuales de Azure sin necesidad de reiniciar. Para enableHotpatching, el "provisionVMAgent" debe establecerse en true y "patchMode" debe establecerse en "AutomaticByPlatform".
patchMode	WindowsVMGuestPatchMode	Especifica el modo de aplicación de revisiones de invitado de máquina virtual a máquinas virtuales iaaS o máquinas virtuales asociadas al conjunto de escalado de máquinas virtuales con OrchestrationMode como flexible. Los valores posibles son: Manual: controla la aplicación de revisiones en una máquina virtual. Para ello, aplique revisiones manualmente dentro de la máquina virtual. En este modo, las actualizaciones automáticas están deshabilitadas; La propiedad WindowsConfiguration.enableAutomaticUpdates debe ser false AutomaticByOS: el sistema operativo actualizará automáticamente la máquina virtual. La propiedad WindowsConfiguration.enableAutomaticUpdates debe ser true. AutomaticByPlatform: la máquina virtual actualizará automáticamente la plataforma. Las propiedades provisionVMAgent y WindowsConfiguration.enableAutomaticUpdates deben ser true.

ProtocolTypes

Especifica el protocolo del agente de escucha winRM. Los valores posibles son: http,https.

Nombre	Tipo	Description
Http	string
Https	string

ProxyAgentSettings

Especifica la configuración de ProxyAgent al crear la máquina virtual. Versión mínima de api: 2023-09-01.

Nombre	Tipo	Description
enabled	boolean	Especifica si la característica ProxyAgent debe estar habilitada en la máquina virtual o en el conjunto de escalado de máquinas virtuales.
keyIncarnationId	integer	Aumentar el valor de esta propiedad permite al usuario restablecer la clave utilizada para proteger el canal de comunicación entre invitado y host.
mode	Mode	Especifica el modo en el que se ejecutará ProxyAgent si la característica está habilitada. ProxyAgent comenzará a auditar o supervisar, pero no aplicará el control de acceso sobre las solicitudes a los puntos de conexión host en modo auditoría, mientras que en el modo Aplicar aplicará el control de acceso. El valor predeterminado es Aplicar modo.

RestorePoint

Detalles del punto de restauración.

Nombre	Tipo	Description
id	string	Identificador de recurso
name	string	Nombre del recurso
properties.consistencyMode	ConsistencyModeTypes	ConsistencyMode de RestorePoint. Se puede especificar en la entrada al crear un punto de restauración. Por ahora, solo CrashConsistent se acepta como entrada válida. Consulte https://aka.ms/RestorePoints para obtener más información.
properties.excludeDisks	ApiEntityReference[]	Lista de identificadores de recursos de disco que el cliente desea excluir del punto de restauración. Si no se especifica ningún disco, se incluirán todos los discos.
properties.instanceView	RestorePointInstanceView	Vista de instancia del punto de restauración.
properties.provisioningState	string	Obtiene el estado de aprovisionamiento del punto de restauración.
properties.sourceMetadata	RestorePointSourceMetadata	Obtiene los detalles de la máquina virtual capturada en el momento de la creación del punto de restauración.
properties.sourceRestorePoint	ApiEntityReference	Identificador de recurso del punto de restauración de origen desde el que se debe crear una copia.
properties.timeCreated	string	Obtiene la hora de creación del punto de restauración.
type	string	Tipo de recurso

RestorePointCollection

Cree o actualice los parámetros de la colección Restore Point.

Nombre	Tipo	Description
id	string	Identificador de recurso
location	string	Ubicación del recurso
name	string	Nombre del recurso
properties.provisioningState	string	Estado de aprovisionamiento de la colección de puntos de restauración.
properties.restorePointCollectionId	string	Identificador único de la colección de puntos de restauración.
properties.restorePoints	RestorePoint[]	Lista que contiene todos los puntos de restauración creados en esta colección de puntos de restauración.
properties.source	RestorePointCollectionSourceProperties	Las propiedades del recurso de origen a partir de las que se crea esta colección de puntos de restauración.
tags	object	Etiquetas de recursos
type	string	Tipo de recurso

RestorePointCollectionSourceProperties

Las propiedades del recurso de origen a partir de las que se crea esta colección de puntos de restauración.

Nombre	Tipo	Description
id	string	Identificador de recurso del recurso de origen usado para crear esta colección de puntos de restauración
location	string	Ubicación del recurso de origen usado para crear esta colección de puntos de restauración.

RestorePointCollectionUpdate

Actualice los parámetros de la colección De punto de restauración.

Nombre	Tipo	Description
properties.provisioningState	string	Estado de aprovisionamiento de la colección de puntos de restauración.
properties.restorePointCollectionId	string	Identificador único de la colección de puntos de restauración.
properties.restorePoints	RestorePoint[]	Lista que contiene todos los puntos de restauración creados en esta colección de puntos de restauración.
properties.source	RestorePointCollectionSourceProperties	Las propiedades del recurso de origen a partir de las que se crea esta colección de puntos de restauración.
tags	object	Etiquetas de recursos

RestorePointEncryption

Configuración de cifrado en reposo para el punto de restauración de disco. Es una propiedad opcional que se puede especificar en la entrada al crear un punto de restauración.

Nombre	Tipo	Description
diskEncryptionSet	DiskEncryptionSetParameters	Describe el parámetro del identificador de recurso del conjunto de cifrado de disco administrado por el cliente que se puede especificar para el disco. Nota: El identificador de recurso del conjunto de cifrado de disco solo se puede especificar para el disco administrado. Consulte https://aka.ms/mdssewithcmkoverview para obtener más información.
type	RestorePointEncryptionType	Tipo de clave que se usa para cifrar los datos del punto de restauración de disco.

RestorePointEncryptionType

Tipo de clave que se usa para cifrar los datos del punto de restauración de disco.

Nombre	Tipo	Description
EncryptionAtRestWithCustomerKey	string	El punto de restauración de disco se cifra en reposo con la clave administrada por el cliente que un cliente puede cambiar y revocar.
EncryptionAtRestWithPlatformAndCustomerKeys	string	El punto de restauración de disco se cifra en reposo con 2 capas de cifrado. Una de las claves es Customer managed (Administrado por el cliente) y la otra clave es Platform managed (Administrada por la plataforma).
EncryptionAtRestWithPlatformKey	string	El punto de restauración de disco se cifra en reposo con la clave administrada por la plataforma.

RestorePointInstanceView

Vista de instancia de un punto de restauración.

Nombre	Tipo	Description
diskRestorePoints	DiskRestorePointInstanceView[]	La información de puntos de restauración de disco.
statuses	InstanceViewStatus[]	Información de estado del recurso.

RestorePointSourceMetadata

Describe las propiedades de la máquina virtual para la que se creó el punto de restauración. Las propiedades proporcionadas son un subconjunto y la instantánea de las propiedades generales de la máquina virtual capturadas en el momento de la creación del punto de restauración.

Nombre	Tipo	Description
diagnosticsProfile	DiagnosticsProfile	Obtiene el perfil de diagnóstico.
hardwareProfile	HardwareProfile	Obtiene el perfil de hardware.
hyperVGeneration	HyperVGenerationTypes	HyperVGeneration de la máquina virtual de origen para la que se captura el punto de restauración.
licenseType	string	Obtiene el tipo de licencia, que es para traiga su propio escenario de licencia.
location	string	Ubicación de la máquina virtual desde la que se creó el punto de restauración.
osProfile	OSProfile	Obtiene el perfil del sistema operativo.
securityProfile	SecurityProfile	Obtiene el perfil de seguridad.
storageProfile	RestorePointSourceVMStorageProfile	Obtiene el perfil de almacenamiento.
userData	string	UserData asociado a la máquina virtual de origen para la que se captura el punto de restauración, que es un valor codificado en base 64.
vmId	string	Obtiene el identificador único de la máquina virtual.

RestorePointSourceVMDataDisk

Describe un disco de datos.

Nombre	Tipo	Description
caching	CachingTypes	Obtiene el tipo de almacenamiento en caché.
diskRestorePoint	DiskRestorePointAttributes	Contiene las propiedades del punto de restauración de disco.
diskSizeGB	integer	Obtiene el tamaño de disco inicial en GB para los discos de datos en blanco y el nuevo tamaño deseado para los discos de datos y sistema operativo existentes.
lun	integer	Obtiene el número de unidad lógica.
managedDisk	ManagedDiskParameters	Contiene los detalles del disco administrado.
name	string	Obtiene el nombre del disco.
writeAcceleratorEnabled	boolean	Muestra true si el disco está habilitado para el acelerador de escritura.

RestorePointSourceVMOSDisk

Describe un disco del sistema operativo.

Nombre	Tipo	Description
caching	CachingTypes	Obtiene el tipo de almacenamiento en caché.
diskRestorePoint	DiskRestorePointAttributes	Contiene las propiedades del punto de restauración de disco.
diskSizeGB	integer	Obtiene el tamaño del disco en GB.
encryptionSettings	DiskEncryptionSettings	Obtiene la configuración de cifrado de disco.
managedDisk	ManagedDiskParameters	Obtiene los detalles del disco administrado.
name	string	Obtiene el nombre del disco.
osType	OperatingSystemType	Obtiene el tipo de sistema operativo.
writeAcceleratorEnabled	boolean	Muestra true si el disco está habilitado para el acelerador de escritura.

RestorePointSourceVMStorageProfile

Describe el perfil de almacenamiento.

Nombre	Tipo	Description
dataDisks	RestorePointSourceVMDataDisk[]	Obtiene los discos de datos de la máquina virtual capturadas en el momento de la creación del punto de restauración.
diskControllerType	DiskControllerTypes	Obtiene el tipo de controlador de disco de la máquina virtual capturada en el momento de la creación del punto de restauración.
osDisk	RestorePointSourceVMOSDisk	Obtiene el disco del sistema operativo de la máquina virtual capturada en el momento de la creación del punto de restauración.

securityEncryptionTypes

Especifica encryptionType del disco administrado. Se establece en DiskWithVMGuestState para el cifrado del disco administrado junto con el blob VMGuestState, VMGuestStateOnly para el cifrado de solo el blob VMGuestState y NonPersistedTPM para no conservar el estado de firmware en el blob VMGuestState. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

Nombre	Tipo	Description
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales.

Nombre	Tipo	Description
encryptionAtHost	boolean	El usuario puede usar esta propiedad en la solicitud para habilitar o deshabilitar el cifrado de host para la máquina virtual o el conjunto de escalado de máquinas virtuales. Esto habilitará el cifrado para todos los discos, incluido el recurso o el disco temporal en el propio host. El comportamiento predeterminado es: el cifrado en el host se deshabilitará a menos que esta propiedad esté establecida en true para el recurso.
encryptionIdentity	EncryptionIdentity	Especifica la identidad administrada usada por ADE para obtener el token de acceso para las operaciones de keyvault.
proxyAgentSettings	ProxyAgentSettings	Especifica la configuración de ProxyAgent al crear la máquina virtual. Versión mínima de api: 2023-09-01.
securityType	SecurityTypes	Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. El comportamiento predeterminado es: UefiSettings no se habilitará a menos que se establezca esta propiedad.
uefiSettings	UefiSettings	Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. Versión mínima de api: 2020-12-01.

SecurityTypes

Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. El comportamiento predeterminado es: UefiSettings no se habilitará a menos que se establezca esta propiedad.

Nombre	Tipo	Description
ConfidentialVM	string
TrustedLaunch	string

SettingNames

Especifica el nombre de la configuración a la que se aplica el contenido. Los valores posibles son: FirstLogonCommands y AutoLogon.

Nombre	Tipo	Description
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

Configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure

Nombre	Tipo	Description
publicKeys	SshPublicKey[]	Lista de claves públicas SSH que se usan para autenticarse con máquinas virtuales basadas en Linux.

SshPublicKey

Contiene información sobre la clave pública del certificado SSH y la ruta de acceso en la máquina virtual Linux donde se coloca la clave pública.

Nombre	Tipo	Description
keyData	string	Certificado de clave pública SSH que se usa para autenticarse con la máquina virtual mediante ssh. La clave debe tener al menos 2048 bits y en formato ssh-rsa. Para crear claves SSH, consulte [Creación de claves SSH en máquinas virtuales Linux y Mac para Linux en Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Especifica la ruta de acceso completa en la máquina virtual creada donde se almacena la clave pública ssh. Si el archivo ya existe, la clave especificada se anexa al archivo. Ejemplo: /home/user/.ssh/authorized_keys

StatusLevelTypes

Código de nivel.

Nombre	Tipo	Description
Error	string
Info	string
Warning	string

StorageAccountTypes

Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con disco del sistema operativo.

Nombre	Tipo	Description
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

SubResource

Nombre	Tipo	Description
id	string	Identificador de recurso

UefiSettings

Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. Versión mínima de api: 2020-12-01.

Nombre	Tipo	Description
secureBootEnabled	boolean	Especifica si se debe habilitar el arranque seguro en la máquina virtual. Versión mínima de api: 2020-12-01.
vTpmEnabled	boolean	Especifica si vTPM debe estar habilitado en la máquina virtual. Versión mínima de api: 2020-12-01.

VaultCertificate

Describe una sola referencia de certificado en un almacén de claves y dónde debe residir el certificado en la máquina virtual.

Nombre	Tipo	Description
certificateStore	string	En el caso de las máquinas virtuales Windows, especifica el almacén de certificados en la máquina virtual a la que se debe agregar el certificado. El almacén de certificados especificado se encuentra implícitamente en la cuenta localMachine. En el caso de las máquinas virtuales Linux, el archivo de certificado se coloca en el directorio /var/lib/waagent, con el nombre de archivo <UppercaseThumbprint>.crt para el archivo de certificado X509 y <UppercaseThumbprint>.prv para la clave privada. Ambos archivos tienen formato .pem.
certificateUrl	string	Esta es la dirección URL de un certificado que se ha cargado en Key Vault como secreto. Para agregar un secreto a Key Vault, consulte Agregar una clave o un secreto al almacén de claves. En este caso, el certificado debe ser La codificación Base64 del siguiente objeto JSON que se codifica en UTF-8: { "data":"", "dataType":"pfx", "password":"" } Para instalar certificados en una máquina virtual, se recomienda usar la extensión de máquina virtual de Azure Key Vault de para Linux o la extensión de máquina virtual de Azure Key Vault de para Windows.

VaultSecretGroup

Describe un conjunto de certificados que están todos en la misma instancia de Key Vault.

Nombre	Tipo	Description
sourceVault	SubResource	Dirección URL relativa del almacén de claves que contiene todos los certificados de VaultCertificates.
vaultCertificates	VaultCertificate[]	Lista de referencias del almacén de claves en SourceVault que contienen certificados.

VirtualMachineSizeTypes

Especifica el tamaño de la máquina virtual. El tipo de datos de enumeración está actualmente en desuso y se quitará el 23 de diciembre de 2023. La manera recomendada de obtener la lista de tamaños disponibles es usar estas API: Enumerar todos los tamaños de máquina virtual disponibles en un conjunto de disponibilidad, Enumerar todos los tamaños de máquina virtual disponibles en una región, Enumerar todos los tamaños de máquina virtual disponibles para cambiar el tamaño. Para obtener más información sobre los tamaños de máquina virtual, consulte tamaños de para máquinas virtuales. Los tamaños de máquina virtual disponibles dependen de la región y el conjunto de disponibilidad.

Nombre	Tipo	Description
Basic_A0	string
Basic_A1	string
Basic_A2	string
Basic_A3	string
Basic_A4	string
Standard_A0	string
Standard_A1	string
Standard_A10	string
Standard_A11	string
Standard_A1_v2	string
Standard_A2	string
Standard_A2_v2	string
Standard_A2m_v2	string
Standard_A3	string
Standard_A4	string
Standard_A4_v2	string
Standard_A4m_v2	string
Standard_A5	string
Standard_A6	string
Standard_A7	string
Standard_A8	string
Standard_A8_v2	string
Standard_A8m_v2	string
Standard_A9	string
Standard_B1ms	string
Standard_B1s	string
Standard_B2ms	string
Standard_B2s	string
Standard_B4ms	string
Standard_B8ms	string
Standard_D1	string
Standard_D11	string
Standard_D11_v2	string
Standard_D12	string
Standard_D12_v2	string
Standard_D13	string
Standard_D13_v2	string
Standard_D14	string
Standard_D14_v2	string
Standard_D15_v2	string
Standard_D16_v3	string
Standard_D16s_v3	string
Standard_D1_v2	string
Standard_D2	string
Standard_D2_v2	string
Standard_D2_v3	string
Standard_D2s_v3	string
Standard_D3	string
Standard_D32_v3	string
Standard_D32s_v3	string
Standard_D3_v2	string
Standard_D4	string
Standard_D4_v2	string
Standard_D4_v3	string
Standard_D4s_v3	string
Standard_D5_v2	string
Standard_D64_v3	string
Standard_D64s_v3	string
Standard_D8_v3	string
Standard_D8s_v3	string
Standard_DS1	string
Standard_DS11	string
Standard_DS11_v2	string
Standard_DS12	string
Standard_DS12_v2	string
Standard_DS13	string
Standard_DS13-2_v2	string
Standard_DS13-4_v2	string
Standard_DS13_v2	string
Standard_DS14	string
Standard_DS14-4_v2	string
Standard_DS14-8_v2	string
Standard_DS14_v2	string
Standard_DS15_v2	string
Standard_DS1_v2	string
Standard_DS2	string
Standard_DS2_v2	string
Standard_DS3	string
Standard_DS3_v2	string
Standard_DS4	string
Standard_DS4_v2	string
Standard_DS5_v2	string
Standard_E16_v3	string
Standard_E16s_v3	string
Standard_E2_v3	string
Standard_E2s_v3	string
Standard_E32-16_v3	string
Standard_E32-8s_v3	string
Standard_E32_v3	string
Standard_E32s_v3	string
Standard_E4_v3	string
Standard_E4s_v3	string
Standard_E64-16s_v3	string
Standard_E64-32s_v3	string
Standard_E64_v3	string
Standard_E64s_v3	string
Standard_E8_v3	string
Standard_E8s_v3	string
Standard_F1	string
Standard_F16	string
Standard_F16s	string
Standard_F16s_v2	string
Standard_F1s	string
Standard_F2	string
Standard_F2s	string
Standard_F2s_v2	string
Standard_F32s_v2	string
Standard_F4	string
Standard_F4s	string
Standard_F4s_v2	string
Standard_F64s_v2	string
Standard_F72s_v2	string
Standard_F8	string
Standard_F8s	string
Standard_F8s_v2	string
Standard_G1	string
Standard_G2	string
Standard_G3	string
Standard_G4	string
Standard_G5	string
Standard_GS1	string
Standard_GS2	string
Standard_GS3	string
Standard_GS4	string
Standard_GS4-4	string
Standard_GS4-8	string
Standard_GS5	string
Standard_GS5-16	string
Standard_GS5-8	string
Standard_H16	string
Standard_H16m	string
Standard_H16mr	string
Standard_H16r	string
Standard_H8	string
Standard_H8m	string
Standard_L16s	string
Standard_L32s	string
Standard_L4s	string
Standard_L8s	string
Standard_M128-32ms	string
Standard_M128-64ms	string
Standard_M128ms	string
Standard_M128s	string
Standard_M64-16ms	string
Standard_M64-32ms	string
Standard_M64ms	string
Standard_M64s	string
Standard_NC12	string
Standard_NC12s_v2	string
Standard_NC12s_v3	string
Standard_NC24	string
Standard_NC24r	string
Standard_NC24rs_v2	string
Standard_NC24rs_v3	string
Standard_NC24s_v2	string
Standard_NC24s_v3	string
Standard_NC6	string
Standard_NC6s_v2	string
Standard_NC6s_v3	string
Standard_ND12s	string
Standard_ND24rs	string
Standard_ND24s	string
Standard_ND6s	string
Standard_NV12	string
Standard_NV24	string
Standard_NV6	string

VMDiskSecurityProfile

Especifica la configuración del perfil de seguridad para el disco administrado. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

Nombre	Tipo	Description
diskEncryptionSet	DiskEncryptionSetParameters	Especifica el identificador de recurso del conjunto de cifrado de disco administrado del cliente para el disco administrado que se usa para el disco de sistema operativo ConfidentialVM cifrado con clave administrada por el cliente y el blob vmGuest.
securityEncryptionType	securityEncryptionTypes	Especifica encryptionType del disco administrado. Se establece en DiskWithVMGuestState para el cifrado del disco administrado junto con el blob VMGuestState, VMGuestStateOnly para el cifrado de solo el blob VMGuestState y NonPersistedTPM para no conservar el estado de firmware en el blob VMGuestState. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

VMSizeProperties

Especifica la configuración de la propiedad tamaño de máquina virtual en la máquina virtual.

Nombre	Tipo	Description
vCPUsAvailable	integer	Especifica el número de vCPU disponibles para la máquina virtual. Cuando esta propiedad no se especifica en el cuerpo de la solicitud, el comportamiento predeterminado es establecerlo en el valor de las vCPU disponibles para ese tamaño de máquina virtual expuesto en la respuesta de api de Enumerar todos los tamaños de máquina virtual disponibles en una región.
vCPUsPerCore	integer	Especifica la relación de núcleos físicos de vCPU. Cuando esta propiedad no se especifica en el cuerpo de la solicitud, el comportamiento predeterminado se establece en el valor de vCPUsPerCore para el tamaño de máquina virtual expuesto en la respuesta de api de Enumerar todos los tamaños de máquina virtual disponibles en una región. Establecer esta propiedad en 1 también significa que el hyper-threading está deshabilitado.

WindowsConfiguration

Especifica la configuración del sistema operativo Windows en la máquina virtual.

Nombre	Tipo	Description
additionalUnattendContent	AdditionalUnattendContent[]	Especifica información con formato XML codificado en base 64 adicional que se puede incluir en el archivo Unattend.xml, que usa el programa de instalación de Windows.
enableAutomaticUpdates	boolean	Indica si las actualizaciones automáticas están habilitadas para la máquina virtual Windows. El valor predeterminado es true. En el caso de los conjuntos de escalado de máquinas virtuales, esta propiedad se puede actualizar y las actualizaciones surtirán efecto en el reaprovisionamiento del sistema operativo.
enableVMAgentPlatformUpdates	boolean	Indica si las actualizaciones de la plataforma VMAgent están habilitadas para la máquina virtual Windows.
patchSettings	PatchSettings	[Característica de vista previa] Especifica la configuración relacionada con la aplicación de revisiones de invitado de máquina virtual en Windows.
provisionVMAgent	boolean	Indica si se debe aprovisionar el agente de máquina virtual en la máquina virtual. Cuando esta propiedad no se especifica en el cuerpo de la solicitud, se establece en true de forma predeterminada. Esto garantizará que el agente de máquina virtual esté instalado en la máquina virtual para que las extensiones se puedan agregar a la máquina virtual más adelante.
timeZone	string	Especifica la zona horaria de la máquina virtual. Por ejemplo, "Hora estándar del Pacífico". Los valores posibles se pueden TimeZoneInfo.Id valor de las zonas horarias devueltas por TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Especifica los agentes de escucha de administración remota de Windows. Esto habilita Windows PowerShell remoto.

WindowsPatchAssessmentMode

Nombre	Tipo	Description
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Especifica la configuración de reinicio para todas las operaciones de instalación de revisiones AutomaticByPlatform.

Nombre	Tipo	Description
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Especifica la configuración adicional que se va a aplicar cuando el modo de revisión AutomaticByPlatform está seleccionado en la configuración de revisión de Windows.

Nombre	Tipo	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	Permite al cliente programar la aplicación de revisiones sin actualizaciones accidentales
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Especifica la configuración de reinicio para todas las operaciones de instalación de revisiones AutomaticByPlatform.

WindowsVMGuestPatchMode

Especifica el modo de aplicación de revisiones de invitado de máquina virtual a máquinas virtuales iaaS o máquinas virtuales asociadas al conjunto de escalado de máquinas virtuales con OrchestrationMode como flexible.

Los valores posibles son:

Manual: controla la aplicación de revisiones en una máquina virtual. Para ello, aplique revisiones manualmente dentro de la máquina virtual. En este modo, las actualizaciones automáticas están deshabilitadas; La propiedad WindowsConfiguration.enableAutomaticUpdates debe ser false

AutomaticByOS: el sistema operativo actualizará automáticamente la máquina virtual. La propiedad WindowsConfiguration.enableAutomaticUpdates debe ser true.

AutomaticByPlatform: la máquina virtual actualizará automáticamente la plataforma. Las propiedades provisionVMAgent y WindowsConfiguration.enableAutomaticUpdates deben ser true.

Nombre	Tipo	Description
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

Describe la configuración de administración remota de Windows de la máquina virtual.

Nombre	Tipo	Description
listeners	WinRMListener[]	Lista de agentes de escucha de administración remota de Windows

WinRMListener

Describe el protocolo y la huella digital del agente de escucha de administración remota de Windows.

Nombre	Tipo	Description
certificateUrl	string	Esta es la dirección URL de un certificado que se ha cargado en Key Vault como secreto. Para agregar un secreto a Key Vault, consulte Agregar una clave o un secreto al almacén de claves. En este caso, el certificado debe ser la codificación Base64 del siguiente objeto JSON que se codifica en UTF-8: { "data":"", "dataType":"pfx", "password":"" } Para instalar certificados en una máquina virtual, se recomienda usar la extensión de máquina virtual de Azure Key Vault de para Linux o la extensión de máquina virtual de Azure Key Vault de para Windows.
protocol	ProtocolTypes	Especifica el protocolo del agente de escucha winRM. Los valores posibles son: http,https.

Compartir a través de

Restore Point Collections - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

RestorePointCollection_Update_MaximumSet_Gen

Solicitud de ejemplo

Respuesta de muestra

RestorePointCollection_Update_MinimumSet_Gen

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AdditionalUnattendContent

ApiEntityReference

ApiError

ApiErrorBase

BootDiagnostics

CachingTypes

CloudError

ComponentNames

ConsistencyModeTypes

DiagnosticsProfile

DiskControllerTypes

DiskEncryptionSetParameters

DiskEncryptionSettings

DiskRestorePointAttributes

DiskRestorePointInstanceView

DiskRestorePointReplicationStatus

EncryptionIdentity

HardwareProfile

HyperVGenerationTypes

InnerError

InstanceViewStatus

KeyVaultKeyReference

KeyVaultSecretReference

LinuxConfiguration

LinuxPatchAssessmentMode

LinuxPatchSettings

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

LinuxVMGuestPatchAutomaticByPlatformSettings

LinuxVMGuestPatchMode

ManagedDiskParameters

Mode

OperatingSystemType

OSProfile

PassNames

PatchSettings

ProtocolTypes

ProxyAgentSettings

RestorePoint

RestorePointCollection

RestorePointCollectionSourceProperties

RestorePointCollectionUpdate

RestorePointEncryption

RestorePointEncryptionType

RestorePointInstanceView

RestorePointSourceMetadata

RestorePointSourceVMDataDisk

RestorePointSourceVMOSDisk

RestorePointSourceVMStorageProfile

securityEncryptionTypes

SecurityProfile

SecurityTypes

SettingNames

SshConfiguration

SshPublicKey

StatusLevelTypes

StorageAccountTypes

SubResource

UefiSettings

VaultCertificate

VaultSecretGroup

VirtualMachineSizeTypes

VMDiskSecurityProfile

VMSizeProperties

WindowsConfiguration