Restore Point Collections - Get

參考

服務:: Compute

API 版本:: 2024-07-01

取得還原點集合的作業。

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

含選擇性參數:

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

URI 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string	資源群組的名稱。
restorePointCollectionName	path	True	string	還原點集合的名稱。
subscriptionId	path	True	string	可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。
$expand	query		RestorePointCollectionExpandOptions	要套用至作業的展開表達式。如果 expand=restorePoints，伺服器將會傳回 restorePointCollection 中的所有內含還原點。

回應

名稱	類型	Description
200 OK	RestorePointCollection	還行
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Get a restore point collection, including the restore points contained in the restore point collection

Get a restore point collection (but not the restore points contained in the restore point collection)

Get a restore point collection, including the restore points contained in the restore point collection

範例要求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName?$expand=restorePoints&api-version=2024-07-01


/**
 * Samples for RestorePointCollections GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * restorePointExamples/RestorePointCollection_Get_WithContainedRestorePoints.json
     */
    /**
     * Sample code: Get a restore point collection, including the restore points contained in the restore point
     * collection.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getARestorePointCollectionIncludingTheRestorePointsContainedInTheRestorePointCollection(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePointCollections()
            .getByResourceGroupWithResponse("myResourceGroup", "rpcName", null, com.azure.core.util.Context.NONE);
    }
}

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

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_get_with_contained_restore_points.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.get(
        resource_group_name="myResourceGroup",
        restore_point_collection_name="rpcName",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Get_WithContainedRestorePoints.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/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_Get_WithContainedRestorePoints.json
func ExampleRestorePointCollectionsClient_Get_getARestorePointCollectionIncludingTheRestorePointsContainedInTheRestorePointCollection() {
	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().Get(ctx, "myResourceGroup", "rpcName", &armcompute.RestorePointCollectionsClientGetOptions{Expand: 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("rpcName"),
	// 	Type: to.Ptr("Microsoft.Compute/restorePointCollections"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.RestorePointCollectionProperties{
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		RestorePointCollectionID: to.Ptr("59f04a5d-f783-4200-a1bd-d3f464e8c4b4"),
	// 		RestorePoints: []*armcompute.RestorePoint{
	// 			{
	// 				Name: to.Ptr("restorePointName"),
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName"),
	// 				Properties: &armcompute.RestorePointProperties{
	// 					ConsistencyMode: to.Ptr(armcompute.ConsistencyModeTypesApplicationConsistent),
	// 					ExcludeDisks: []*armcompute.APIEntityReference{
	// 						{
	// 							ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vm8768_disk2_fe6ffde4f69b491ca33fb984d5bcd89f"),
	// 					}},
	// 					ProvisioningState: to.Ptr("Succeeded"),
	// 					SourceMetadata: &armcompute.RestorePointSourceMetadata{
	// 						DiagnosticsProfile: &armcompute.DiagnosticsProfile{
	// 							BootDiagnostics: &armcompute.BootDiagnostics{
	// 								Enabled: to.Ptr(true),
	// 							},
	// 						},
	// 						HardwareProfile: &armcompute.HardwareProfile{
	// 							VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardB1S),
	// 						},
	// 						Location: to.Ptr("westus"),
	// 						OSProfile: &armcompute.OSProfile{
	// 							AdminUsername: to.Ptr("admin"),
	// 							AllowExtensionOperations: to.Ptr(true),
	// 							ComputerName: to.Ptr("computerName"),
	// 							RequireGuestProvisionSignal: to.Ptr(true),
	// 							Secrets: []*armcompute.VaultSecretGroup{
	// 							},
	// 							WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 								EnableAutomaticUpdates: to.Ptr(true),
	// 								ProvisionVMAgent: 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"),
	// 									},
	// 									Lun: to.Ptr[int32](1),
	// 									ManagedDisk: &armcompute.ManagedDiskParameters{
	// 										ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/testingexcludedisk_DataDisk_1"),
	// 										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"),
	// 								},
	// 								ManagedDisk: &armcompute.ManagedDiskParameters{
	// 									ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f"),
	// 									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-01-27T20:35:05.840Z"); 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 get the restore point collection.
 *
 * @summary The operation to get the restore point collection.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Get_WithContainedRestorePoints.json
 */
async function getARestorePointCollectionIncludingTheRestorePointsContainedInTheRestorePointCollection() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "rpcName";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePointCollections.get(
    resourceGroupName,
    restorePointCollectionName,
  );
  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.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Get_WithContainedRestorePoints.json
// this example is just showing the usage of "RestorePointCollections_Get" 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this RestorePointGroupResource
RestorePointGroupCollection collection = resourceGroupResource.GetRestorePointGroups();

// invoke the operation
string restorePointGroupName = "rpcName";
NullableResponse<RestorePointGroupResource> response = await collection.GetIfExistsAsync(restorePointGroupName);
RestorePointGroupResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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

範例回覆

狀態碼:: 200

{
  "name": "rpcName",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName",
  "type": "Microsoft.Compute/restorePointCollections",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
      "location": "eastus"
    },
    "restorePointCollectionId": "59f04a5d-f783-4200-a1bd-d3f464e8c4b4",
    "provisioningState": "Succeeded",
    "restorePoints": [
      {
        "name": "restorePointName",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName",
        "properties": {
          "excludeDisks": [
            {
              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vm8768_disk2_fe6ffde4f69b491ca33fb984d5bcd89f"
            }
          ],
          "sourceMetadata": {
            "vmId": "76d6541e-80bd-4dc1-932b-3cae4cfb80e7",
            "hardwareProfile": {
              "vmSize": "Standard_B1s"
            },
            "storageProfile": {
              "osDisk": {
                "osType": "Windows",
                "name": "testingexcludedisk_OsDisk_1_74cdaedcea50483d9833c96adefa100f",
                "caching": "ReadWrite",
                "managedDisk": {
                  "storageAccountType": "Standard_LRS",
                  "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"
                  },
                  "diskRestorePoint": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/restorePointName/diskRestorePoints/testingexcludedisk_DataDisk_1_68785190-1acb-4d5e-a8ae-705b45f3dca5"
                  }
                }
              ],
              "diskControllerType": "NVMe"
            },
            "osProfile": {
              "computerName": "computerName",
              "adminUsername": "admin",
              "windowsConfiguration": {
                "provisionVMAgent": true,
                "enableAutomaticUpdates": true
              },
              "secrets": [],
              "allowExtensionOperations": true,
              "requireGuestProvisionSignal": true
            },
            "diagnosticsProfile": {
              "bootDiagnostics": {
                "enabled": true
              }
            },
            "location": "westus"
          },
          "provisioningState": "Succeeded",
          "consistencyMode": "ApplicationConsistent",
          "timeCreated": "2021-01-27T20:35:05.8401519+00:00"
        }
      }
    ]
  }
}

Get a restore point collection (but not the restore points contained in the restore point collection)

範例要求

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc?$expand=restorePoints&api-version=2024-07-01


/**
 * Samples for RestorePointCollections GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * restorePointExamples/RestorePointCollection_Get.json
     */
    /**
     * Sample code: Get a restore point collection (but not the restore points contained in the restore point
     * collection).
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getARestorePointCollectionButNotTheRestorePointsContainedInTheRestorePointCollection(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePointCollections()
            .getByResourceGroupWithResponse("myResourceGroup", "myRpc", null, com.azure.core.util.Context.NONE);
    }
}

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

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_get.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.get(
        resource_group_name="myResourceGroup",
        restore_point_collection_name="myRpc",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Get.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/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_Get.json
func ExampleRestorePointCollectionsClient_Get_getARestorePointCollectionButNotTheRestorePointsContainedInTheRestorePointCollection() {
	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().Get(ctx, "myResourceGroup", "myRpc", &armcompute.RestorePointCollectionsClientGetOptions{Expand: 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("westus"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.RestorePointCollectionProperties{
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		RestorePointCollectionID: to.Ptr("59f04a5d-f783-4200-a1bd-d3f464e8c4b4"),
	// 		Source: &armcompute.RestorePointCollectionSourceProperties{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc"),
	// 			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 get the restore point collection.
 *
 * @summary The operation to get the restore point collection.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Get.json
 */
async function getARestorePointCollectionButNotTheRestorePointsContainedInTheRestorePointCollection() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "myRpc";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePointCollections.get(
    resourceGroupName,
    restorePointCollectionName,
  );
  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.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePointCollection_Get.json
// this example is just showing the usage of "RestorePointCollections_Get" 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 ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this RestorePointGroupResource
RestorePointGroupCollection collection = resourceGroupResource.GetRestorePointGroups();

// invoke the operation
string restorePointGroupName = "myRpc";
NullableResponse<RestorePointGroupResource> response = await collection.GetIfExistsAsync(restorePointGroupName);
RestorePointGroupResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // 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

範例回覆

狀態碼:: 200

{
  "name": "myRpc",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
  "type": "Microsoft.Compute/restorePointCollections",
  "location": "westus",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
      "location": "eastus"
    },
    "restorePointCollectionId": "59f04a5d-f783-4200-a1bd-d3f464e8c4b4",
    "provisioningState": "Succeeded"
  }
}

定義

名稱	Description
AdditionalUnattendContent	指定 Windows 安裝程式所使用的 Unattend.xml 檔案中可包含的其他 XML 格式化資訊。內容是透過設定名稱、元件名稱和套用內容的傳遞來定義。
ApiEntityReference	API 實體參考。
ApiError	Api 錯誤。
ApiErrorBase	API 錯誤基底。
BootDiagnostics	開機診斷是一項偵錯功能，可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。您可以輕鬆地檢視主控台記錄的輸出。 Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。
CachingTypes	取得快取類型。
CloudError	來自計算服務的錯誤回應。
ComponentNames	元件名稱。目前，唯一允許的值是 Microsoft-Windows-Shell-Setup。
ConsistencyModeTypes	RestorePoint 的 ConsistencyMode。可以在建立還原點時於輸入中指定。目前，只有 CrashConsistent 會接受為有效的輸入。如需詳細資訊，請參閱 https://aka.ms/RestorePoints。
DiagnosticsProfile	指定開機診斷設定狀態。 API 版本下限：2015-06-15。
DiskControllerTypes	取得還原點建立時所擷取之 VM 的磁碟控制器類型。
DiskEncryptionSetParameters	描述可針對磁碟指定之客戶受控磁碟加密集資源標識符的參數。注意：只能為受控磁碟指定磁碟加密集資源標識符。如需詳細資訊，請參閱 https://aka.ms/mdssewithcmkoverview。
DiskEncryptionSettings	描述磁碟的加密設定
DiskRestorePointAttributes	磁碟還原點詳細數據。
DiskRestorePointInstanceView	磁碟還原點的實例檢視。
DiskRestorePointReplicationStatus	磁碟還原點的實例檢視。
EncryptionIdentity	指定 ADE 用來取得金鑰保存庫作業存取令牌的受控識別。
HardwareProfile	指定虛擬機的硬體設定。
HyperVGenerationTypes	擷取還原點的來源 VM HyperVGeneration。
InnerError	內部錯誤詳細數據。
InstanceViewStatus	實例檢視狀態。
KeyVaultKeyReference	描述 Key Vault 金鑰的參考
KeyVaultSecretReference	描述 Key Vault 秘密的參考
LinuxConfiguration	指定虛擬機上的Linux作業系統設定。如需支援的 Linux 發行版清單，請參閱 Azure-Endorsed 發行版上的 Linux。
LinuxPatchAssessmentMode	指定 IaaS 虛擬機的 VM 客體修補評估模式。可能的值為： ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。 AutomaticByPlatform - 平台將觸發定期修補程序評估。屬性 provisionVMAgent 必須為 true。
LinuxPatchSettings	指定與Linux上的VM客體修補相關的設定。
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。
LinuxVMGuestPatchAutomaticByPlatformSettings	指定在Linux修補程式設定中選取 Patch 模式 AutomaticByPlatform 時要套用的其他設定。
LinuxVMGuestPatchMode	將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。可能的值為： ImageDefault - 會使用虛擬機的預設修補組態。 AutomaticByPlatform - 虛擬機將由平台自動更新。屬性 provisionVMAgent 必須為 true
ManagedDiskParameters	受控磁碟的參數。
Mode	指定如果啟用此功能，ProxyAgent 將會在上執行的模式。 ProxyAgent 會開始稽核或監視，但不會在稽核模式中對主機端點的要求強制執行訪問控制，而在 [強制執行模式] 中，則會強制執行訪問控制。默認值為 [強制] 模式。
OperatingSystemType	取得作業系統類型。
OSProfile	指定虛擬機的作業系統設定。布建 VM 之後，就無法變更某些設定。
PassNames	傳遞名稱。目前唯一允許的值是 OobeSystem。
PatchSettings	指定與 Windows 上的 VM 客體修補相關的設定。
ProtocolTypes	指定 WinRM 接聽程式的通訊協定。可能的值為：HTTP、https。
ProxyAgentSettings	在建立虛擬機時指定 ProxyAgent 設定。 API 版本下限：2023-09-01。
RestorePoint	還原點詳細數據。
RestorePointCollection	建立或更新還原點集合參數。
RestorePointCollectionExpandOptions	要套用至作業的展開表達式。如果 expand=restorePoints，伺服器將會傳回 restorePointCollection 中的所有內含還原點。
RestorePointCollectionSourceProperties	建立此還原點集合的來源資源屬性。
RestorePointEncryption	磁碟還原點的待用加密設定。這是選擇性屬性，可在建立還原點時於輸入中指定。
RestorePointEncryptionType	用來加密磁碟還原點數據的金鑰類型。
RestorePointInstanceView	還原點的實例檢視。
RestorePointSourceMetadata	描述建立還原點之虛擬機的屬性。提供的屬性是還原點建立時所擷取之整體虛擬機屬性的子集和快照集。
RestorePointSourceVMDataDisk	描述數據磁碟。
RestorePointSourceVMOSDisk	描述操作系統磁碟。
RestorePointSourceVMStorageProfile	描述記憶體配置檔。
securityEncryptionTypes	指定受控磁碟的 EncryptionType。它會設定為 DiskWithVMGuestState 來加密受控磁碟以及 VMGuestState Blob、VMGuestStateOnly，以便只加密 VMGuestState Blob，以及 NonPersistedTPM 以在 VMGuestState blob 中保存韌體狀態。注意：只能設定機密 VM。
SecurityProfile	指定虛擬機或虛擬機擴展集的安全性配置檔設定。
SecurityTypes	指定虛擬機的 SecurityType。它必須設定為任何指定的值，才能啟用 UefiSettings。默認行為為：除非設定此屬性，否則不會啟用 UefiSettings。
SettingNames	指定套用內容之設定的名稱。可能的值為：FirstLogonCommands 和 AutoLogon。
SshConfiguration	在 Azure 上執行的 Linux 型 VM 的 SSH 設定
SshPublicKey	包含 SSH 憑證公鑰的相關信息，以及放置公鑰之 Linux VM 上的路徑。
StatusLevelTypes	層級程序代碼。
StorageAccountTypes	指定受控磁碟的記憶體帳戶類型。注意：UltraSSD_LRS只能與數據磁碟搭配使用，因此無法與OS磁碟搭配使用。
SubResource
UefiSettings	指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。 API 版本下限：2020-12-01。
VaultCertificate	描述 Key Vault 中的單一憑證參考，以及憑證應該位於 VM 上的位置。
VaultSecretGroup	描述一組憑證，這些憑證全都位於相同的Key Vault 中。
VirtualMachineSizeTypes	指定虛擬機的大小。列舉數據類型目前已被取代，將於 2023 年 12 月 23 日移除。取得可用大小清單的建議方式是使用這些 API：列出可用性設定組中的所有可用虛擬機大小、列出區域中所有可用的虛擬機大小、列出所有可用的虛擬機大小以重設大小。如需虛擬機器大小的詳細資訊，請參閱虛擬機的大小。可用的 VM 大小取決於區域和可用性設定組。
VMDiskSecurityProfile	指定受控磁碟的安全性配置檔設定。注意：只能針對機密 VM 設定。
VMSizeProperties	指定虛擬機上的 VM 大小屬性設定。
WindowsConfiguration	指定虛擬機上的 Windows 作業系統設定。
WindowsPatchAssessmentMode	指定 IaaS 虛擬機的 VM 客體修補評估模式。可能的值為： ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。 AutomaticByPlatform - 平台將觸發定期修補程序評估。屬性 provisionVMAgent 必須為 true。
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。
WindowsVMGuestPatchAutomaticByPlatformSettings	指定在 Windows 修補程式設定中選取 Patch 模式 AutomaticByPlatform 時要套用的其他設定。
WindowsVMGuestPatchMode	將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。可能的值為：手動 - 您可以控制將修補程式的應用程式套用至虛擬機。您可以手動在 VM 內套用修補程式來執行此動作。在此模式中，會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false AutomaticByOS - 作業系統會自動更新虛擬機。屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。 AutomaticByPlatform - 虛擬機會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 的屬性必須是 true
WinRMConfiguration	描述 VM 的 Windows 遠端管理設定
WinRMListener	描述 Windows 遠端管理接聽程式的通訊協議和指紋

AdditionalUnattendContent

指定 Windows 安裝程式所使用的 Unattend.xml 檔案中可包含的其他 XML 格式化資訊。內容是透過設定名稱、元件名稱和套用內容的傳遞來定義。

名稱	類型	Description
componentName	ComponentNames	元件名稱。目前，唯一允許的值是 Microsoft-Windows-Shell-Setup。
content	string	指定新增至指定路徑和元件之 unattend.xml 檔案的 XML 格式化內容。 XML 必須小於 4KB，而且必須包含要插入之設定或功能的根元素。
passName	PassNames	傳遞名稱。目前唯一允許的值是 OobeSystem。
settingName	SettingNames	指定套用內容之設定的名稱。可能的值為：FirstLogonCommands 和 AutoLogon。

ApiEntityReference

API 實體參考。

名稱	類型	Description
id	string	以 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 格式的 ARM 資源標識符

ApiError

Api 錯誤。

名稱	類型	Description
code	string	錯誤碼。
details	ApiErrorBase[]	Api 錯誤詳細數據
innererror	InnerError	Api 內部錯誤
message	string	錯誤訊息。
target	string	特定錯誤的目標。

ApiErrorBase

API 錯誤基底。

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息。
target	string	特定錯誤的目標。

BootDiagnostics

開機診斷是一項偵錯功能，可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。您可以輕鬆地檢視主控台記錄的輸出。 Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。

名稱	類型	Description
enabled	boolean	是否應在虛擬機上啟用開機診斷。
storageUri	string	用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。如果在啟用開機診斷時未指定 storageUri，則會使用受控記憶體。

CachingTypes

取得快取類型。

名稱	類型	Description
None	string
ReadOnly	string
ReadWrite	string

CloudError

來自計算服務的錯誤回應。

名稱	類型	Description
error	ApiError	Api 錯誤。

ComponentNames

元件名稱。目前，唯一允許的值是 Microsoft-Windows-Shell-Setup。

名稱	類型	Description
Microsoft-Windows-Shell-Setup	string

ConsistencyModeTypes

RestorePoint 的 ConsistencyMode。可以在建立還原點時於輸入中指定。目前，只有 CrashConsistent 會接受為有效的輸入。如需詳細資訊，請參閱 https://aka.ms/RestorePoints。

名稱	類型	Description
ApplicationConsistent	string
CrashConsistent	string
FileSystemConsistent	string

DiagnosticsProfile

指定開機診斷設定狀態。 API 版本下限：2015-06-15。

名稱	類型	Description
bootDiagnostics	BootDiagnostics	開機診斷是一項偵錯功能，可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。 NOTE：如果指定 storageUri，請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。您可以輕鬆地檢視主控台記錄的輸出。 Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。

DiskControllerTypes

取得還原點建立時所擷取之 VM 的磁碟控制器類型。

名稱	類型	Description
NVMe	string
SCSI	string

DiskEncryptionSetParameters

描述可針對磁碟指定之客戶受控磁碟加密集資源標識符的參數。 注意： 只能為受控磁碟指定磁碟加密集資源標識符。如需詳細資訊，請參閱 https://aka.ms/mdssewithcmkoverview。

名稱	類型	Description
id	string	資源標識碼

DiskEncryptionSettings

描述磁碟的加密設定

名稱	類型	Description
diskEncryptionKey	KeyVaultSecretReference	指定磁碟加密密鑰的位置，也就是 Key Vault 秘密。
enabled	boolean	指定是否應在虛擬機上啟用磁碟加密。
keyEncryptionKey	KeyVaultKeyReference	指定 Key Vault 中金鑰加密金鑰的位置。

DiskRestorePointAttributes

磁碟還原點詳細數據。

名稱	類型	Description
encryption	RestorePointEncryption	磁碟還原點的待用加密設定。這是選擇性屬性，可在建立還原點時於輸入中指定。
id	string	資源標識碼
sourceDiskRestorePoint	ApiEntityReference	來源磁碟還原點的資源標識碼。

DiskRestorePointInstanceView

磁碟還原點的實例檢視。

名稱	類型	Description
id	string	磁碟還原點標識碼。
replicationStatus	DiskRestorePointReplicationStatus	磁碟還原點復寫狀態資訊。

DiskRestorePointReplicationStatus

磁碟還原點的實例檢視。

名稱	類型	Description
completionPercent	integer	複寫完成百分比。
status	InstanceViewStatus	資源狀態資訊。

EncryptionIdentity

指定 ADE 用來取得金鑰保存庫作業存取令牌的受控識別。

名稱	類型	Description
userAssignedIdentityResourceId	string	指定與 VM 相關聯的其中一個使用者身分識別的 ARM 資源識別碼。

HardwareProfile

指定虛擬機的硬體設定。

名稱	類型	Description
vmSize	VirtualMachineSizeTypes	指定虛擬機的大小。列舉數據類型目前已被取代，將於 2023 年 12 月 23 日移除。取得可用大小清單的建議方式是使用這些 API：列出可用性設定組中的所有可用虛擬機大小、列出區域中所有可用的虛擬機大小、列出所有可用的虛擬機大小以重設大小。如需虛擬機器大小的詳細資訊，請參閱虛擬機的大小。可用的 VM 大小取決於區域和可用性設定組。
vmSizeProperties	VMSizeProperties	指定自定義虛擬機大小的屬性。 API 版本下限：2021-07-01。此功能仍處於預覽模式，VirtualMachineScaleSet 不支援此功能。如需詳細資訊，請遵循 VM 自定義中的指示。

HyperVGenerationTypes

擷取還原點的來源 VM HyperVGeneration。

名稱	類型	Description
V1	string
V2	string

InnerError

內部錯誤詳細數據。

名稱	類型	Description
errordetail	string	內部錯誤訊息或例外狀況傾印。
exceptiontype	string	例外狀況類型。

InstanceViewStatus

實例檢視狀態。

名稱	類型	Description
code	string	狀態代碼。
displayStatus	string	狀態的簡短可當地語系化標籤。
level	StatusLevelTypes	層級程序代碼。
message	string	詳細的狀態消息，包括警示和錯誤訊息。
time	string	狀態的時間。

KeyVaultKeyReference

描述 Key Vault 金鑰的參考

名稱	類型	Description
keyUrl	string	參考 Key Vault 中金鑰加密金鑰的 URL。
sourceVault	SubResource	包含金鑰之 Key Vault 的相對 URL。

KeyVaultSecretReference

描述 Key Vault 秘密的參考

名稱	類型	Description
secretUrl	string	參考 Key Vault 中秘密的 URL。
sourceVault	SubResource	包含秘密之 Key Vault 的相對 URL。

LinuxConfiguration

指定虛擬機上的Linux作業系統設定。如需支援的 Linux 發行版清單，請參閱 Azure-Endorsed 發行版上的 Linux。

名稱	類型	Description
disablePasswordAuthentication	boolean	指定是否應停用密碼驗證。
enableVMAgentPlatformUpdates	boolean	指出是否為Linux虛擬機啟用VMAgent平臺更新。默認值為 false。
patchSettings	LinuxPatchSettings	[預覽功能]指定與Linux上的VM客體修補相關的設定。
provisionVMAgent	boolean	指出虛擬機器代理程式是否應該佈建在虛擬機上。當要求本文中未指定此屬性時，預設行為是將它設定為 true。這可確保 VM 代理程式已安裝在 VM 上，以便稍後將擴充功能新增至 VM。
ssh	SshConfiguration	指定 Linux OS 的 SSH 金鑰組態。

LinuxPatchAssessmentMode

指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為：

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。屬性 provisionVMAgent 必須為 true。

名稱	類型	Description
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

指定與Linux上的VM客體修補相關的設定。

名稱	類型	Description
assessmentMode	LinuxPatchAssessmentMode	指定 IaaS 虛擬機的 VM 客體修補評估模式。可能的值為： ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。 AutomaticByPlatform - 平台將觸發定期修補程序評估。屬性 provisionVMAgent 必須為 true。
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	在 Linux 上的 VM 客體修補中，指定修補程式模式 AutomaticByPlatform 的其他設定。
patchMode	LinuxVMGuestPatchMode	將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。可能的值為： ImageDefault - 會使用虛擬機的預設修補組態。 AutomaticByPlatform - 虛擬機將由平台自動更新。屬性 provisionVMAgent 必須為 true

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。

名稱	類型	Description
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

指定在Linux修補程式設定中選取 Patch 模式 AutomaticByPlatform 時要套用的其他設定。

名稱	類型	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	讓客戶在不意外升級的情況下排程修補
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。

LinuxVMGuestPatchMode

將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為：

ImageDefault - 會使用虛擬機的預設修補組態。

AutomaticByPlatform - 虛擬機將由平台自動更新。屬性 provisionVMAgent 必須為 true

名稱	類型	Description
AutomaticByPlatform	string
ImageDefault	string

ManagedDiskParameters

受控磁碟的參數。

名稱	類型	Description
diskEncryptionSet	DiskEncryptionSetParameters	指定受控磁碟的客戶受控磁碟加密集資源標識符。
id	string	資源標識碼
securityProfile	VMDiskSecurityProfile	指定受控磁碟的安全性配置檔。
storageAccountType	StorageAccountTypes	指定受控磁碟的記憶體帳戶類型。注意：UltraSSD_LRS只能與數據磁碟搭配使用，因此無法與OS磁碟搭配使用。

Mode

指定如果啟用此功能，ProxyAgent 將會在上執行的模式。 ProxyAgent 會開始稽核或監視，但不會在稽核模式中對主機端點的要求強制執行訪問控制，而在 [強制執行模式] 中，則會強制執行訪問控制。默認值為 [強制] 模式。

名稱	類型	Description
Audit	string
Enforce	string

OperatingSystemType

取得作業系統類型。

名稱	類型	Description
Linux	string
Windows	string

OSProfile

指定虛擬機的作業系統設定。布建 VM 之後，就無法變更某些設定。

名稱	類型	Description
adminPassword	string	指定系統管理員帳戶的密碼。最小長度（Windows）： 8 個字元最小長度（Linux）： 6 個字元長度上限（Windows）： 123 個字元長度上限（Linux）： 72 個字元複雜性需求：需要滿足下列 4 個條件中的 3 個字元較低具有大字元具有數位具有特殊字元（Regex match [\W_]）不允許的值： “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password！”、“Password1”、“Password22”、“iloveyou！” 如需重設密碼，請參閱如何在 Windows VM 中重設遠端桌面服務或其登入密碼如需重設根密碼，請參閱使用 VMAccess 擴充功能管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟
adminUsername	string	指定系統管理員帳戶的名稱。建立 VM 之後，就無法更新此屬性。僅限 Windows 的限制：不能以 “” 結尾。不允許的值： “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”。最小長度（Linux）： 1 個字元最大長度（Linux）： 64 個字元長度上限（Windows）： 20 個字元。
allowExtensionOperations	boolean	指定虛擬機上是否應該允許擴充功能作業。只有在虛擬機上沒有擴充功能時，才會將此選項設定為 False。
computerName	string	指定虛擬機的主機OS名稱。建立 VM 之後，無法更新此名稱。最大長度（Windows）： 15 個字元。長度上限（Linux）： 64 個字元。如需命名慣例和限制，請參閱Azure 基礎結構服務實作指導方針。
customData	string	指定自訂數據的base-64編碼字串。 base-64 編碼字串會譯碼為儲存為虛擬機上檔案的二進位數組。二進位陣列的最大長度為65535個字節。注意：請勿在 customData 屬性中傳遞任何秘密或密碼。建立 VM 之後，就無法更新此屬性。屬性 'customData' 會傳遞至要儲存為檔案的 VM，如需詳細資訊，請參閱 Azure VM 上的自定義數據。如需針對 Linux VM 使用 cloud-init，請參閱在建立期間使用 cloud-init 自定義 Linux VM。
linuxConfiguration	LinuxConfiguration	指定虛擬機上的Linux作業系統設定。如需支援的 Linux 發行版清單，請參閱 Azure-Endorsed 發行版上的 Linux。
requireGuestProvisionSignal	boolean	必須設定為 True 或省略的選擇性屬性。
secrets	VaultSecretGroup[]	指定應該安裝在虛擬機上的憑證集。若要在虛擬機上安裝憑證，建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能，或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
windowsConfiguration	WindowsConfiguration	指定虛擬機上的 Windows 作業系統設定。

PassNames

傳遞名稱。目前唯一允許的值是 OobeSystem。

名稱	類型	Description
OobeSystem	string

PatchSettings

指定與 Windows 上的 VM 客體修補相關的設定。

名稱	類型	Description
assessmentMode	WindowsPatchAssessmentMode	指定 IaaS 虛擬機的 VM 客體修補評估模式。可能的值為： ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。 AutomaticByPlatform - 平台將觸發定期修補程序評估。屬性 provisionVMAgent 必須為 true。
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	指定 Windows 上 VM 客體修補中的 Patch 模式 AutomaticByPlatform 的其他設定。
enableHotpatching	boolean	可讓客戶修補其 Azure VM，而不需要重新啟動。針對 enableHotpatching，'provisionVMAgent' 必須設定為 true，且 'patchMode' 必須設定為 'AutomaticByPlatform'。
patchMode	WindowsVMGuestPatchMode	將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。可能的值為：手動 - 您可以控制將修補程式的應用程式套用至虛擬機。您可以手動在 VM 內套用修補程式來執行此動作。在此模式中，會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false AutomaticByOS - 作業系統會自動更新虛擬機。屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。 AutomaticByPlatform - 虛擬機會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 的屬性必須是 true

ProtocolTypes

指定 WinRM 接聽程式的通訊協定。可能的值為：HTTP、https。

名稱	類型	Description
Http	string
Https	string

ProxyAgentSettings

在建立虛擬機時指定 ProxyAgent 設定。 API 版本下限：2023-09-01。

名稱	類型	Description
enabled	boolean	指定是否應在虛擬機或虛擬機擴展集上啟用 ProxyAgent 功能。
keyIncarnationId	integer	增加此屬性的值可讓使用者重設用來保護客體與主機之間通道的密鑰。
mode	Mode	指定如果啟用此功能，ProxyAgent 將會在上執行的模式。 ProxyAgent 會開始稽核或監視，但不會在稽核模式中對主機端點的要求強制執行訪問控制，而在 [強制執行模式] 中，則會強制執行訪問控制。默認值為 [強制] 模式。

RestorePoint

還原點詳細數據。

名稱	類型	Description
id	string	資源標識碼
name	string	資源名稱
properties.consistencyMode	ConsistencyModeTypes	RestorePoint 的 ConsistencyMode。可以在建立還原點時於輸入中指定。目前，只有 CrashConsistent 會接受為有效的輸入。如需詳細資訊，請參閱 https://aka.ms/RestorePoints。
properties.excludeDisks	ApiEntityReference[]	客戶想要從還原點排除的磁碟資源標識符清單。如果未指定任何磁碟，則會包含所有磁碟。
properties.instanceView	RestorePointInstanceView	還原點實例檢視。
properties.provisioningState	string	取得還原點的布建狀態。
properties.sourceMetadata	RestorePointSourceMetadata	取得還原點建立時所擷取的 VM 詳細數據。
properties.sourceRestorePoint	ApiEntityReference	需要建立複本的來源還原點資源標識碼。
properties.timeCreated	string	取得還原點的建立時間。
type	string	資源類型

RestorePointCollection

建立或更新還原點集合參數。

名稱	類型	Description
id	string	資源標識碼
location	string	資源位置
name	string	資源名稱
properties.provisioningState	string	還原點集合的布建狀態。
properties.restorePointCollectionId	string	還原點集合的唯一標識碼。
properties.restorePoints	RestorePoint[]	清單，包含在此還原點集合下建立的所有還原點。
properties.source	RestorePointCollectionSourceProperties	建立此還原點集合的來源資源屬性。
tags	object	資源標籤
type	string	資源類型

RestorePointCollectionExpandOptions

要套用至作業的展開表達式。如果 expand=restorePoints，伺服器將會傳回 restorePointCollection 中的所有內含還原點。

名稱	類型	Description
restorePoints	string

RestorePointCollectionSourceProperties

建立此還原點集合的來源資源屬性。

名稱	類型	Description
id	string	用來建立此還原點集合的來源資源資源標識碼
location	string	用來建立此還原點集合的來源資源位置。

RestorePointEncryption

磁碟還原點的待用加密設定。這是選擇性屬性，可在建立還原點時於輸入中指定。

名稱	類型	Description
diskEncryptionSet	DiskEncryptionSetParameters	描述可針對磁碟指定之客戶受控磁碟加密集資源標識符的參數。注意：只能為受控磁碟指定磁碟加密集資源標識符。如需詳細資訊，請參閱 https://aka.ms/mdssewithcmkoverview。
type	RestorePointEncryptionType	用來加密磁碟還原點數據的金鑰類型。

RestorePointEncryptionType

用來加密磁碟還原點數據的金鑰類型。

名稱	類型	Description
EncryptionAtRestWithCustomerKey	string	磁碟還原點會使用客戶管理的密鑰進行待用加密，可由客戶變更和撤銷。
EncryptionAtRestWithPlatformAndCustomerKeys	string	磁碟還原點會以 2 層加密進行待用加密。其中一個金鑰是客戶管理，另一個金鑰是平臺管理。
EncryptionAtRestWithPlatformKey	string	磁碟還原點會使用平臺管理的密鑰進行待用加密。

RestorePointInstanceView

還原點的實例檢視。

名稱	類型	Description
diskRestorePoints	DiskRestorePointInstanceView[]	磁碟還原點資訊。
statuses	InstanceViewStatus[]	資源狀態資訊。

RestorePointSourceMetadata

描述建立還原點之虛擬機的屬性。提供的屬性是還原點建立時所擷取之整體虛擬機屬性的子集和快照集。

名稱	類型	Description
diagnosticsProfile	DiagnosticsProfile	取得診斷配置檔。
hardwareProfile	HardwareProfile	取得硬體配置檔。
hyperVGeneration	HyperVGenerationTypes	擷取還原點的來源 VM HyperVGeneration。
licenseType	string	取得授權類型，這是用於自備授權案例。
location	string	建立還原點的來源 VM 位置。
osProfile	OSProfile	取得 OS 設定檔。
securityProfile	SecurityProfile	取得安全性配置檔。
storageProfile	RestorePointSourceVMStorageProfile	取得記憶體配置檔。
userData	string	與擷取還原點的來源 VM 相關聯的 UserData，這是 base-64 編碼的值。
vmId	string	取得虛擬機的唯一標識碼。

RestorePointSourceVMDataDisk

描述數據磁碟。

名稱	類型	Description
caching	CachingTypes	取得快取類型。
diskRestorePoint	DiskRestorePointAttributes	包含磁碟還原點屬性。
diskSizeGB	integer	取得空白數據磁碟的 GB 初始磁碟大小，以及現有 OS 和數據磁碟的新所需大小。
lun	integer	取得邏輯單元編號。
managedDisk	ManagedDiskParameters	包含受控磁碟詳細數據。
name	string	取得磁碟名稱。
writeAcceleratorEnabled	boolean	如果磁碟已啟用寫入加速器，則顯示 true。

RestorePointSourceVMOSDisk

描述操作系統磁碟。

名稱	類型	Description
caching	CachingTypes	取得快取類型。
diskRestorePoint	DiskRestorePointAttributes	包含磁碟還原點屬性。
diskSizeGB	integer	取得以 GB 為單位的磁碟大小。
encryptionSettings	DiskEncryptionSettings	取得磁碟加密設定。
managedDisk	ManagedDiskParameters	取得受控磁碟詳細數據
name	string	取得磁碟名稱。
osType	OperatingSystemType	取得作業系統類型。
writeAcceleratorEnabled	boolean	如果磁碟已啟用寫入加速器，則顯示 true。

RestorePointSourceVMStorageProfile

描述記憶體配置檔。

名稱	類型	Description
dataDisks	RestorePointSourceVMDataDisk[]	取得還原點建立時所擷取之 VM 的數據磁碟。
diskControllerType	DiskControllerTypes	取得還原點建立時所擷取之 VM 的磁碟控制器類型。
osDisk	RestorePointSourceVMOSDisk	取得還原點建立時所擷取之 VM 的 OS 磁碟。

securityEncryptionTypes

指定受控磁碟的 EncryptionType。它會設定為 DiskWithVMGuestState 來加密受控磁碟以及 VMGuestState Blob、VMGuestStateOnly，以便只加密 VMGuestState Blob，以及 NonPersistedTPM 以在 VMGuestState blob 中保存韌體狀態。 注意： 只能設定機密 VM。

名稱	類型	Description
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

指定虛擬機或虛擬機擴展集的安全性配置檔設定。

名稱	類型	Description
encryptionAtHost	boolean	用戶可以在要求中使用這個屬性來啟用或停用虛擬機或虛擬機擴展集的主機加密。這會啟用所有磁碟的加密，包括主機本身的資源/暫存磁碟。默認行為為：除非資源將此屬性設定為 true，否則將會停用主機的加密。
encryptionIdentity	EncryptionIdentity	指定 ADE 用來取得金鑰保存庫作業存取令牌的受控識別。
proxyAgentSettings	ProxyAgentSettings	在建立虛擬機時指定 ProxyAgent 設定。 API 版本下限：2023-09-01。
securityType	SecurityTypes	指定虛擬機的 SecurityType。它必須設定為任何指定的值，才能啟用 UefiSettings。默認行為為：除非設定此屬性，否則不會啟用 UefiSettings。
uefiSettings	UefiSettings	指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。 API 版本下限：2020-12-01。

SecurityTypes

指定虛擬機的 SecurityType。它必須設定為任何指定的值，才能啟用 UefiSettings。默認行為為：除非設定此屬性，否則不會啟用 UefiSettings。

名稱	類型	Description
ConfidentialVM	string
TrustedLaunch	string

SettingNames

指定套用內容之設定的名稱。可能的值為：FirstLogonCommands 和 AutoLogon。

名稱	類型	Description
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

在 Azure 上執行的 Linux 型 VM 的 SSH 設定

名稱	類型	Description
publicKeys	SshPublicKey[]	用來向Linux型VM進行驗證的SSH公鑰清單。

SshPublicKey

包含 SSH 憑證公鑰的相關信息，以及放置公鑰之 Linux VM 上的路徑。

名稱	類型	Description
keyData	string	用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。密鑰至少必須是 2048 位，且格式為 ssh-rsa。如需建立 ssh 金鑰，請參閱 [在 Azure 中建立 Linux 和 Mac 上 Linux VM 的 SSH 金鑰]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	指定已建立 VM 上儲存 SSH 公鑰的完整路徑。如果檔案已經存在，指定的索引鍵會附加至檔案。範例：/home/user/.ssh/authorized_keys

StatusLevelTypes

層級程序代碼。

名稱	類型	Description
Error	string
Info	string
Warning	string

StorageAccountTypes

指定受控磁碟的記憶體帳戶類型。注意：UltraSSD_LRS只能與數據磁碟搭配使用，因此無法與OS磁碟搭配使用。

名稱	類型	Description
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

SubResource

名稱	類型	Description
id	string	資源標識碼

UefiSettings

指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。 API 版本下限：2020-12-01。

名稱	類型	Description
secureBootEnabled	boolean	指定是否應在虛擬機上啟用安全開機。 API 版本下限：2020-12-01。
vTpmEnabled	boolean	指定是否應在虛擬機上啟用 vTPM。 API 版本下限：2020-12-01。

VaultCertificate

描述 Key Vault 中的單一憑證參考，以及憑證應該位於 VM 上的位置。

名稱	類型	Description
certificateStore	string	針對 Windows VM，指定應新增憑證之虛擬機上的證書存儲。指定的證書存儲隱含在 LocalMachine 帳戶中。針對 Linux VM，憑證檔案會放在 /var/lib/waagent 目錄底下，檔名 <X509 憑證檔案的大寫Thumbprint>.crt，並針對私鑰 <大寫Thumbprint>.prv。這兩個檔案都是 .pem 格式。
certificateUrl	string	這是已上傳至 Key Vault 做為秘密之憑證的 URL。如需將秘密新增至 Key Vault，請參閱將金鑰或秘密新增至金鑰保存庫。在此情況下，您的憑證必須是下列 JSON 物件的 Base64 編碼，其編碼方式為 UTF-8： { “data”：“”， “dataType”：“pfx”， “password”：“” } 若要在虛擬機上安裝憑證，建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能，或適用於Windows的 Azure Key Vault 虛擬機擴充功能。

VaultSecretGroup

描述一組憑證，這些憑證全都位於相同的Key Vault 中。

名稱	類型	Description
sourceVault	SubResource	Key Vault 的相對 URL，其中包含 VaultCertificates 中的所有憑證。
vaultCertificates	VaultCertificate[]	SourceVault 中包含憑證的金鑰保存庫參考清單。

VirtualMachineSizeTypes

指定虛擬機的大小。列舉數據類型目前已被取代，將於 2023 年 12 月 23 日移除。取得可用大小清單的建議方式是使用這些 API：列出可用性設定組中的所有可用虛擬機大小、列出區域中所有可用的虛擬機大小、列出所有可用的虛擬機大小以重設大小。如需虛擬機器大小的詳細資訊，請參閱虛擬機的大小。可用的 VM 大小取決於區域和可用性設定組。

名稱	類型	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

指定受控磁碟的安全性配置檔設定。 注意： 只能針對機密 VM 設定。

名稱	類型	Description
diskEncryptionSet	DiskEncryptionSetParameters	針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob 所使用的受控磁碟，指定客戶受控磁碟加密集資源識別碼。
securityEncryptionType	securityEncryptionTypes	指定受控磁碟的 EncryptionType。它會設定為 DiskWithVMGuestState 來加密受控磁碟以及 VMGuestState Blob、VMGuestStateOnly，以便只加密 VMGuestState Blob，以及 NonPersistedTPM 以在 VMGuestState blob 中保存韌體狀態。注意：只能設定機密 VM。

VMSizeProperties

指定虛擬機上的 VM 大小屬性設定。

名稱	類型	Description
vCPUsAvailable	integer	指定 VM 可用的 vCPU 數目。當要求本文中未指定此屬性時，預設行為是將它設定為 api 回應中公開的 vCPU 值，列出區域中所有可用的虛擬機大小。
vCPUsPerCore	integer	指定 vCPU 與實體核心比率。當要求本文中未指定此屬性時，預設行為會針對 api 回應中公開的 VM 大小設定為 vCPUUsPerCore 的值，列出區域中所有可用的虛擬機大小，。將此屬性設定為 1 也表示已停用超線程處理。

WindowsConfiguration

指定虛擬機上的 Windows 作業系統設定。

名稱	類型	Description
additionalUnattendContent	AdditionalUnattendContent[]	指定其他base-64編碼的 XML 格式資訊，這些資訊可以包含在 Windows 安裝程式所使用的 Unattend.xml 檔案中。
enableAutomaticUpdates	boolean	指出是否為 Windows 虛擬機啟用自動更新。默認值為 true。針對虛擬機擴展集，此屬性可以更新，更新將會在OS重新佈建上生效。
enableVMAgentPlatformUpdates	boolean	指出是否為 Windows 虛擬機啟用 VMAgent 平臺更新。
patchSettings	PatchSettings	[預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。
provisionVMAgent	boolean	指出虛擬機器代理程式是否應該佈建在虛擬機上。當要求本文中未指定這個屬性時，預設會設定為 true。這可確保 VM 代理程式已安裝在 VM 上，以便稍後將擴充功能新增至 VM。
timeZone	string	指定虛擬機的時區。例如「太平洋標準時間」。可能的值可以從 TimeZoneInfo.GetSystemTimeZones所傳回的時區 TimeZoneInfo.Id 值。
winRM	WinRMConfiguration	指定 Windows 遠端管理接聽程式。這可啟用遠端 Windows PowerShell。

WindowsPatchAssessmentMode

名稱	類型	Description
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。

名稱	類型	Description
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

指定在 Windows 修補程式設定中選取 Patch 模式 AutomaticByPlatform 時要套用的其他設定。

名稱	類型	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	讓客戶在不意外升級的情況下排程修補
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。

WindowsVMGuestPatchMode

將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為：

手動 - 您可以控制將修補程式的應用程式套用至虛擬機。您可以手動在 VM 內套用修補程式來執行此動作。在此模式中，會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false

AutomaticByOS - 作業系統會自動更新虛擬機。屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。

AutomaticByPlatform - 虛擬機會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 的屬性必須是 true

名稱	類型	Description
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

描述 VM 的 Windows 遠端管理設定

名稱	類型	Description
listeners	WinRMListener[]	Windows 遠端管理接聽程式清單

WinRMListener

描述 Windows 遠端管理接聽程式的通訊協議和指紋

名稱	類型	Description
certificateUrl	string	這是已上傳至 Key Vault 做為秘密之憑證的 URL。如需將秘密新增至 Key Vault，請參閱將金鑰或秘密新增至金鑰保存庫。在此情況下，您的憑證必須是以UTF-8編碼的下列 JSON 物件的Base64編碼： { “data”：“”， “dataType”：“pfx”， “password”：“” } 若要在虛擬機上安裝憑證，建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能，或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
protocol	ProtocolTypes	指定 WinRM 接聽程式的通訊協定。可能的值為：HTTP、https。

共用方式為

Restore Point Collections - Get

URI 參數

回應

安全性

azure_auth

範圍

範例

Get a restore point collection, including the restore points contained in the restore point collection

範例要求

範例回覆

Get a restore point collection (but not the restore points contained in the restore point collection)

範例要求

範例回覆

定義

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

RestorePointCollectionExpandOptions

RestorePointCollectionSourceProperties

RestorePointEncryption

RestorePointEncryptionType

RestorePointInstanceView

RestorePointSourceMetadata

RestorePointSourceVMDataDisk

RestorePointSourceVMOSDisk

RestorePointSourceVMStorageProfile

securityEncryptionTypes

SecurityProfile

SecurityTypes

SettingNames

SshConfiguration

SshPublicKey

StatusLevelTypes

StorageAccountTypes

SubResource

UefiSettings

VaultCertificate

VaultSecretGroup

VirtualMachineSizeTypes

VMDiskSecurityProfile

VMSizeProperties

WindowsConfiguration

WindowsPatchAssessmentMode