Restore Point Collections - List

참조

서비스:: Compute

API 버전:: 2024-03-01

리소스 그룹의 복원 지점 컬렉션 목록을 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스 그룹의 이름.
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.
api-version	query	True	string	클라이언트 API 버전.

응답

Name	형식	Description
200 OK	RestorePointCollectionListResult	정상
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Gets the list of restore point collections in a resource group.

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections?api-version=2024-03-01

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_list_by_resource_group.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.list(
        resource_group_name="myResourceGroup",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/restorePointExamples/RestorePointCollection_ListByResourceGroup.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/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/restorePointExamples/RestorePointCollection_ListByResourceGroup.json
func ExampleRestorePointCollectionsClient_NewListPager() {
	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)
	}
	pager := clientFactory.NewRestorePointCollectionsClient().NewListPager("myResourceGroup", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.RestorePointCollectionListResult = armcompute.RestorePointCollectionListResult{
		// 	Value: []*armcompute.RestorePointCollection{
		// 		{
		// 			Name: to.Ptr("restorePointCollection1"),
		// 			Type: to.Ptr("Microsoft.Compute/restorePointCollections"),
		// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection1"),
		// 			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/restorePointCollection1"),
		// 					Location: to.Ptr("westus"),
		// 				},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("restorePointCollection2"),
		// 			Type: to.Ptr("Microsoft.Compute/restorePointCollections"),
		// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection2"),
		// 			Location: to.Ptr("westus"),
		// 			Tags: map[string]*string{
		// 				"myTag1": to.Ptr("tagValue1"),
		// 			},
		// 			Properties: &armcompute.RestorePointCollectionProperties{
		// 				ProvisioningState: to.Ptr("Succeeded"),
		// 				RestorePointCollectionID: to.Ptr("2875c590-e337-4102-9668-4f5b7e3f98a4"),
		// 				Source: &armcompute.RestorePointCollectionSourceProperties{
		// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection2"),
		// 					Location: to.Ptr("westus"),
		// 				},
		// 			},
		// 	}},
		// }
	}
}

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 Gets the list of restore point collections in a resource group.
 *
 * @summary Gets the list of restore point collections in a resource group.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/restorePointExamples/RestorePointCollection_ListByResourceGroup.json
 */
async function getsTheListOfRestorePointCollectionsInAResourceGroup() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.restorePointCollections.list(resourceGroupName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "name": "restorePointCollection1",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection1",
      "type": "Microsoft.Compute/restorePointCollections",
      "location": "westus",
      "tags": {
        "myTag1": "tagValue1"
      },
      "properties": {
        "source": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection1",
          "location": "westus"
        },
        "restorePointCollectionId": "59f04a5d-f783-4200-a1bd-d3f464e8c4b4",
        "provisioningState": "Succeeded"
      }
    },
    {
      "name": "restorePointCollection2",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection2",
      "type": "Microsoft.Compute/restorePointCollections",
      "location": "westus",
      "tags": {
        "myTag1": "tagValue1"
      },
      "properties": {
        "source": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/restorePointCollection2",
          "location": "westus"
        },
        "restorePointCollectionId": "2875c590-e337-4102-9668-4f5b7e3f98a4",
        "provisioningState": "Deleting"
      }
    }
  ]
}

정의

Name	Description
AdditionalUnattendContent	Windows 설치 프로그램에서 사용하는 Unattend.xml 파일에 포함할 수 있는 추가 XML 형식 정보를 지정합니다. 콘텐츠는 이름, 구성 요소 이름 및 콘텐츠가 적용되는 전달을 설정하여 정의됩니다.
ApiEntityReference	API 엔터티 참조입니다.
ApiError	API 오류입니다.
ApiErrorBase	API 오류 기준입니다.
BootDiagnostics	부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.
CachingTypes	캐싱 형식을 가져옵니다.
CloudError	Compute 서비스의 오류 응답입니다.
ComponentNames	구성 요소 이름입니다. 현재 허용되는 유일한 값은 Microsoft-Windows-Shell-Setup입니다.
ConsistencyModeTypes	RestorePoint의 ConsistencyMode입니다. 복원 지점을 만드는 동안 입력에 지정할 수 있습니다. 지금은 CrashConsistent만 유효한 입력으로 허용됩니다. 자세한 내용은 을 https://aka.ms/RestorePoints 참조하세요.
DiagnosticsProfile	부팅 진단 설정 상태를 지정합니다. 최소 api-version: 2015-06-15.
DiskControllerTypes	복원 지점을 만들 때 캡처된 VM의 디스크 컨트롤러 유형을 가져옵니다.
DiskEncryptionSetParameters	디스크에 대해 지정할 수 있는 고객 관리 디스크 암호화 집합 리소스 ID의 매개 변수에 대해 설명합니다. 참고: 디스크 암호화 집합 리소스 ID는 관리 디스크에 대해서만 지정할 수 있습니다. 자세한 내용은 을 참조 https://aka.ms/mdssewithcmkoverview 하세요.
DiskEncryptionSettings	디스크에 대한 암호화 설정에 대해 설명합니다.
DiskRestorePointAttributes	디스크 복원 지점 세부 정보.
DiskRestorePointInstanceView	디스크 복원 지점의 instance 보기입니다.
DiskRestorePointReplicationStatus	디스크 복원 지점의 instance 보기입니다.
EncryptionIdentity	ADE에서 keyvault 작업에 대한 액세스 토큰을 가져오는 데 사용하는 관리 ID를 지정합니다.
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 패치 설정에서 패치 모드 AutomaticByPlatform을 선택할 때 적용할 추가 설정을 지정합니다.
LinuxVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신의 기본 패치 구성이 사용됩니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 속성은 true여야 합니다.
ManagedDiskParameters	관리 디스크의 매개 변수입니다.
Mode	기능을 사용하는 경우 ProxyAgent가 실행할 모드를 지정합니다. ProxyAgent는 감사 또는 모니터링을 시작하지만 감사 모드에서 엔드포인트를 호스트하는 요청에 대한 액세스 제어를 적용하지 않고 적용 모드에서는 액세스 제어를 적용합니다. 기본값은 적용 모드입니다.
OperatingSystemType	운영 체제 유형을 가져옵니다.
OSProfile	가상 머신에 대한 운영 체제 설정을 지정합니다. VM이 프로비전되면 일부 설정을 변경할 수 없습니다.
PassNames	pass 이름입니다. 현재 허용 가능한 값은 OobeSystem뿐입니다.
PatchSettings	Windows의 VM 게스트 패치와 관련된 설정을 지정합니다.
ProtocolTypes	WinRM 수신기의 프로토콜을 지정합니다. 가능한 값은 http,https입니다.
ProxyAgentSettings	가상 머신을 만드는 동안 ProxyAgent 설정을 지정합니다. 최소 api-version: 2024-03-01.
RestorePoint	복원 지점 세부 정보입니다.
RestorePointCollection	복원 지점 컬렉션 매개 변수를 만들거나 업데이트합니다.
RestorePointCollectionListResult	목록 복원 지점 컬렉션 작업 응답입니다.
RestorePointCollectionSourceProperties	이 복원 지점 컬렉션에서 만든 원본 리소스의 속성입니다.
RestorePointEncryption	디스크 복원 지점에 대한 미사용 데이터 암호화 설정입니다. 복원 지점을 만드는 동안 입력에 지정할 수 있는 선택적 속성입니다.
RestorePointEncryptionType	디스크 복원 지점의 데이터를 암호화하는 데 사용되는 키 유형입니다.
RestorePointInstanceView	복원 지점의 instance 보기입니다.
RestorePointSourceMetadata	복원 지점을 만든 Virtual Machine의 속성에 대해 설명합니다. 제공된 속성은 하위 집합이며 복원 지점을 만들 때 캡처된 전체 Virtual Machine 속성의 스냅샷.
RestorePointSourceVMDataDisk	데이터 디스크에 대해 설명합니다.
RestorePointSourceVMOSDisk	운영 체제 디스크에 대해 설명합니다.
RestorePointSourceVMStorageProfile	스토리지 프로필을 설명합니다.
securityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob의 암호화를 위한 VMGuestStateOnly 및 VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 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-version: 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 패치 설정에서 패치 모드 AutomaticByPlatform을 선택할 때 적용할 추가 설정을 지정합니다.
WindowsVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. 수동 - 가상 머신에 패치 적용을 제어합니다. VM 내에서 수동으로 패치를 적용하여 이 작업을 수행합니다. 이 모드에서는 자동 업데이트를 사용할 수 없습니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 false여야 합니다. AutomaticByOS - 가상 머신이 OS에 의해 자동으로 업데이트됩니다. WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 및 WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.
WinRMConfiguration	VM의 Windows 원격 관리 구성에 대해 설명합니다.
WinRMListener	Windows 원격 관리 수신기의 프로토콜 및 지문에 대해 설명합니다.

AdditionalUnattendContent

Windows 설치 프로그램에서 사용하는 Unattend.xml 파일에 포함할 수 있는 추가 XML 형식 정보를 지정합니다. 콘텐츠는 이름, 구성 요소 이름 및 콘텐츠가 적용되는 전달을 설정하여 정의됩니다.

Name	형식	Description
componentName	ComponentNames	구성 요소 이름입니다. 현재 허용되는 유일한 값은 Microsoft-Windows-Shell-Setup입니다.
content	string	지정된 경로 및 구성 요소에 대한 unattend.xml 파일에 추가되는 XML 형식의 콘텐츠를 지정합니다. XML은 4KB 미만이어야 하며 삽입되는 설정 또는 기능에 대한 루트 요소를 포함해야 합니다.
passName	PassNames	통과 이름입니다. 현재 허용되는 유일한 값은 OobeSystem입니다.
settingName	SettingNames	콘텐츠가 적용되는 설정의 이름을 지정합니다. 가능한 값은 FirstLogonCommands 및 AutoLogon입니다.

ApiEntityReference

API 엔터티 참조입니다.

Name	형식	Description
id	string	/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 형식의 ARM 리소스 ID입니다.

ApiError

API 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	ApiErrorBase[]	API 오류 세부 정보
innererror	InnerError	API 내부 오류
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

BootDiagnostics

부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.

Name	형식	Description
enabled	boolean	Virtual Machine에서 부팅 진단 사용하도록 설정해야 하는지 여부입니다.
storageUri	string	콘솔 출력 및 스크린샷을 배치하는 데 사용할 스토리지 계정의 URI입니다. 부팅 진단 사용하도록 설정하는 동안 storageUri를 지정하지 않으면 관리형 스토리지가 사용됩니다.

CachingTypes

캐싱 형식을 가져옵니다.

Name	형식	Description
None	string
ReadOnly	string
ReadWrite	string

CloudError

Compute 서비스의 오류 응답입니다.

Name	형식	Description
error	ApiError	API 오류입니다.

ComponentNames

구성 요소 이름입니다. 현재 허용되는 유일한 값은 Microsoft-Windows-Shell-Setup입니다.

Name	형식	Description
Microsoft-Windows-Shell-Setup	string

ConsistencyModeTypes

RestorePoint의 ConsistencyMode입니다. 복원 지점을 만드는 동안 입력에 지정할 수 있습니다. 지금은 CrashConsistent만 유효한 입력으로 허용됩니다. 자세한 내용은 을 https://aka.ms/RestorePoints 참조하세요.

Name	형식	Description
ApplicationConsistent	string
CrashConsistent	string
FileSystemConsistent	string

DiagnosticsProfile

부팅 진단 설정 상태를 지정합니다. 최소 api-version: 2015-06-15.

Name	형식	Description
bootDiagnostics	BootDiagnostics	부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 참고: storageUri를 지정하는 경우 스토리지 계정이 VM과 동일한 지역 및 구독에 있는지 확인합니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.

DiskControllerTypes

복원 지점을 만들 때 캡처된 VM의 디스크 컨트롤러 유형을 가져옵니다.

Name	형식	Description
NVMe	string
SCSI	string

DiskEncryptionSetParameters

디스크에 대해 지정할 수 있는 고객 관리 디스크 암호화 집합 리소스 ID의 매개 변수에 대해 설명합니다. 참고: 디스크 암호화 집합 리소스 ID는 관리 디스크에 대해서만 지정할 수 있습니다. 자세한 내용은 을 참조 https://aka.ms/mdssewithcmkoverview 하세요.

Name	형식	Description
id	string	리소스 ID

DiskEncryptionSettings

디스크에 대한 암호화 설정에 대해 설명합니다.

Name	형식	Description
diskEncryptionKey	KeyVaultSecretReference	Key Vault 비밀인 디스크 암호화 키의 위치를 지정합니다.
enabled	boolean	가상 머신에서 디스크 암호화를 사용하도록 설정할지 여부를 지정합니다.
keyEncryptionKey	KeyVaultKeyReference	Key Vault 키 암호화 키의 위치를 지정합니다.

DiskRestorePointAttributes

디스크 복원 지점 세부 정보.

Name	형식	Description
encryption	RestorePointEncryption	디스크 복원 지점에 대한 미사용 데이터 암호화 설정입니다. 복원 지점을 만드는 동안 입력에 지정할 수 있는 선택적 속성입니다.
id	string	리소스 ID
sourceDiskRestorePoint	ApiEntityReference	원본 디스크 복원 지점의 리소스 ID입니다.

DiskRestorePointInstanceView

디스크 복원 지점의 instance 보기입니다.

Name	형식	Description
id	string	디스크 복원 지점 ID입니다.
replicationStatus	DiskRestorePointReplicationStatus	디스크 복원 지점 복제 상태 정보입니다.

DiskRestorePointReplicationStatus

디스크 복원 지점의 instance 보기입니다.

Name	형식	Description
completionPercent	integer	복제 완료율입니다.
status	InstanceViewStatus	리소스 상태 정보입니다.

EncryptionIdentity

ADE에서 keyvault 작업에 대한 액세스 토큰을 가져오는 데 사용하는 관리 ID를 지정합니다.

Name	형식	Description
userAssignedIdentityResourceId	string	VM과 연결된 사용자 ID 중 하나의 ARM 리소스 ID를 지정합니다.

HardwareProfile

가상 머신에 대한 하드웨어 설정을 지정합니다.

Name	형식	Description
vmSize	VirtualMachineSizeTypes	가상 컴퓨터의 크기를 지정합니다. 열거형 데이터 형식은 현재 사용되지 않으며 2023년 12월 23일까지 제거됩니다. 사용 가능한 크기 목록을 가져오는 권장 방법은 다음 API를 사용하는 것입니다. 가용성 집합에 사용 가능한 가상 머신 크기를 모두 나열하고, 지역에서 사용 가능한 가상 머신 크기를 모두 나열하고, 크기 조정에 사용할 수 있는 가상 머신 크기를 모두 나열합니다. 가상 머신 크기에 대한 자세한 내용은 가상 머신의 크기를 참조하세요. 사용 가능한 VM 크기는 지역 및 가용성 집합에 따라 달라집니다.
vmSizeProperties	VMSizeProperties	가상 머신의 크기를 사용자 지정하기 위한 속성을 지정합니다. 최소 api-version: 2021-07-01. 이 기능은 아직 미리 보기 모드이며 VirtualMachineScaleSet에 대해 지원되지 않습니다. 자세한 내용은 VM 사용자 지정 의 지침을 따르세요.

HyperVGenerationTypes

복원 지점이 캡처되는 원본 VM의 HyperVGeneration입니다.

Name	형식	Description
V1	string
V2	string

InnerError

내부 오류 세부 정보입니다.

Name	형식	Description
errordetail	string	내부 오류 메시지 또는 예외 덤프입니다.
exceptiontype	string	예외 형식입니다.

InstanceViewStatus

인스턴스 보기 상태.

Name	형식	Description
code	string	상태 코드입니다.
displayStatus	string	상태 대한 짧은 지역화 가능 레이블입니다.
level	StatusLevelTypes	수준 코드입니다.
message	string	경고 및 오류 메시지를 포함하여 자세한 상태 메시지입니다.
time	string	상태 시간입니다.

KeyVaultKeyReference

Key Vault 키에 대한 참조를 설명합니다.

Name	형식	Description
keyUrl	string	Key Vault 키 암호화 키를 참조하는 URL입니다.
sourceVault	SubResource	키를 포함하는 Key Vault 상대 URL입니다.

KeyVaultSecretReference

Key Vault 비밀에 대한 참조를 설명합니다.

Name	형식	Description
secretUrl	string	Key Vault 비밀을 참조하는 URL입니다.
sourceVault	SubResource	비밀을 포함하는 Key Vault 상대 URL입니다.

LinuxConfiguration

가상 머신에서 Linux 운영 체제 설정을 지정합니다. 지원되는 Linux 배포 목록은 Azure-Endorsed 배포판의 Linux를 참조하세요.

Name	형식	Description
disablePasswordAuthentication	boolean	암호 인증을 사용하지 않도록 설정할지 여부를 지정합니다.
enableVMAgentPlatformUpdates	boolean	Linux 가상 머신에 대해 VMAgent Platform 업데이트 사용하도록 설정되어 있는지 여부를 나타냅니다. 기본값은 false입니다.
patchSettings	LinuxPatchSettings	[미리 보기 기능] Linux의 VM 게스트 패치와 관련된 설정을 지정합니다.
provisionVMAgent	boolean	가상 컴퓨터에서 가상 컴퓨터 에이전트를 프로비전해야 하는지 여부를 나타냅니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본 동작은 true로 설정하는 것입니다. 이렇게 하면 나중에 VM에 확장을 추가할 수 있도록 VM 에이전트가 VM에 설치됩니다.
ssh	SshConfiguration	Linux OS용 ssh 키 구성을 지정합니다.

LinuxPatchAssessmentMode

IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다.

가능한 값은 다음과 같습니다.

ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다.

AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.

Name	형식	Description
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

Linux의 VM 게스트 패치와 관련된 설정을 지정합니다.

Name	형식	Description
assessmentMode	LinuxPatchAssessmentMode	IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다. AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Linux의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.
patchMode	LinuxVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신의 기본 패치 구성이 사용됩니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 속성은 true여야 합니다.

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

Name	형식	Description
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Linux 패치 설정에서 패치 모드 AutomaticByPlatform을 선택할 때 적용할 추가 설정을 지정합니다.

Name	형식	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	고객이 실수로 업그레이드하지 않고 패치를 예약할 수 있습니다.
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

LinuxVMGuestPatchMode

OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다.

가능한 값은 다음과 같습니다.

ImageDefault - 가상 머신의 기본 패치 구성이 사용됩니다.

AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 속성은 true여야 합니다.

Name	형식	Description
AutomaticByPlatform	string
ImageDefault	string

ManagedDiskParameters

관리 디스크의 매개 변수입니다.

Name	형식	Description
diskEncryptionSet	DiskEncryptionSetParameters	관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.
id	string	리소스 ID
securityProfile	VMDiskSecurityProfile	관리 디스크의 보안 프로필을 지정합니다.
storageAccountType	StorageAccountTypes	관리 디스크의 스토리지 계정 유형을 지정합니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있으므로 OS 디스크와 함께 사용할 수 없습니다.

Mode

기능을 사용하는 경우 ProxyAgent가 실행할 모드를 지정합니다. ProxyAgent는 감사 또는 모니터링을 시작하지만 감사 모드에서 엔드포인트를 호스트하는 요청에 대한 액세스 제어를 적용하지 않고 적용 모드에서는 액세스 제어를 적용합니다. 기본값은 적용 모드입니다.

Name	형식	Description
Audit	string
Enforce	string

OperatingSystemType

운영 체제 유형을 가져옵니다.

Name	형식	Description
Linux	string
Windows	string

OSProfile

가상 머신에 대한 운영 체제 설정을 지정합니다. VM이 프로비전되면 일부 설정을 변경할 수 없습니다.

Name	형식	Description
adminPassword	string	관리자 계정의 암호를 지정합니다. 최소 길이(Windows): 8자 최소 길이(Linux): 6자 최대 길이(Windows): 123자 최대 길이(Linux): 72자 복잡성 요구 사항: 아래의 4개 조건 중 3개는 충족해야 합니다. 문자가 낮습니다. 대문자 포함 숫자 가 있습니다. 특수 문자가 있습니다(Regex 일치 [\W_]) 허용되지 않는 값: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" 암호를 다시 설정하려면 Windows VM에서 원격 데스크톱 서비스 또는 해당 로그인 암호를 다시 설정하는 방법을 참조하세요. 루트 암호를 다시 설정하려면 VMAccess 확장을 사용하여 Azure Linux VM에서 사용자, SSH 및 검사 관리 또는 디스크 복구를 참조하세요.
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

pass 이름입니다. 현재 허용 가능한 값은 OobeSystem뿐입니다.

Name	형식	Description
OobeSystem	string

PatchSettings

Windows의 VM 게스트 패치와 관련된 설정을 지정합니다.

Name	형식	Description
assessmentMode	WindowsPatchAssessmentMode	IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다. AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Windows의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.
enableHotpatching	boolean	고객이 다시 부팅하지 않고도 Azure VM을 패치할 수 있습니다. enableHotpatching의 경우 'provisionVMAgent'를 true로 설정하고 'patchMode'를 'AutomaticByPlatform'으로 설정해야 합니다.
patchMode	WindowsVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. 수동 - 가상 머신에 대한 패치 애플리케이션을 제어합니다. VM 내에서 수동으로 패치를 적용하여 이 작업을 수행합니다. 이 모드에서는 자동 업데이트를 사용할 수 없습니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 false여야 합니다. AutomaticByOS - 가상 머신이 OS에 의해 자동으로 업데이트됩니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 true여야 합니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 및 WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.

ProtocolTypes

WinRM 수신기의 프로토콜을 지정합니다. 가능한 값은 http,https입니다.

Name	형식	Description
Http	string
Https	string

ProxyAgentSettings

가상 머신을 만드는 동안 ProxyAgent 설정을 지정합니다. 최소 api-version: 2024-03-01.

Name	형식	Description
enabled	boolean	가상 머신 또는 가상 머신 확장 집합에서 ProxyAgent 기능을 사용하도록 설정할지 여부를 지정합니다.
keyIncarnationId	integer	이 속성의 값을 늘리면 사용자가 게스트와 호스트 간의 통신 채널을 보호하는 데 사용되는 키를 다시 설정할 수 있습니다.
mode	Mode	기능을 사용하는 경우 ProxyAgent가 실행할 모드를 지정합니다. ProxyAgent는 감사 또는 모니터링을 시작하지만 감사 모드에서 엔드포인트를 호스트하는 요청에 대한 액세스 제어를 적용하지는 않지만 적용 모드에서는 액세스 제어를 적용합니다. 기본값은 적용 모드입니다.

RestorePoint

복원 지점 세부 정보입니다.

Name	형식	Description
id	string	리소스 ID
name	string	리소스 이름
properties.consistencyMode	ConsistencyModeTypes	RestorePoint의 ConsistencyMode입니다. 복원 지점을 만드는 동안 입력에 지정할 수 있습니다. 지금은 CrashConsistent만 유효한 입력으로 허용됩니다. 자세한 내용은 을 https://aka.ms/RestorePoints 참조하세요.
properties.excludeDisks	ApiEntityReference[]	고객이 복원 지점에서 제외하려는 디스크 리소스 ID 목록입니다. 지정된 디스크가 없으면 모든 디스크가 포함됩니다.
properties.instanceView	RestorePointInstanceView	복원 지점 instance 보기입니다.
properties.provisioningState	string	복원 지점의 프로비전 상태를 가져옵니다.
properties.sourceMetadata	RestorePointSourceMetadata	복원 지점을 만들 때 캡처된 VM의 세부 정보를 가져옵니다.
properties.sourceRestorePoint	ApiEntityReference	복사본을 만들어야 하는 원본 복원 지점의 리소스 ID입니다.
properties.timeCreated	string	복원 지점의 생성 시간을 가져옵니다.
type	string	리소스 유형

RestorePointCollection

복원 지점 컬렉션 매개 변수를 만들거나 업데이트합니다.

Name	형식	Description
id	string	리소스 ID
location	string	리소스 위치
name	string	리소스 이름
properties.provisioningState	string	복원 지점 컬렉션의 프로비전 상태입니다.
properties.restorePointCollectionId	string	복원 지점 컬렉션의 고유 ID입니다.
properties.restorePoints	RestorePoint[]	이 복원 지점 컬렉션에서 만든 모든 복원 지점을 포함하는 목록입니다.
properties.source	RestorePointCollectionSourceProperties	이 복원 지점 컬렉션에서 만든 원본 리소스의 속성입니다.
tags	object	리소스 태그
type	string	리소스 유형

RestorePointCollectionListResult

목록 복원 지점 컬렉션 작업 응답입니다.

Name	형식	Description
nextLink	string	RestorePointCollections의 다음 페이지를 가져올 URI입니다. 이 를 사용하여 ListNext()를 호출하여 RestorePointCollections의 다음 페이지를 가져옵니다.
value	RestorePointCollection[]	복원 지점 컬렉션 목록을 가져옵니다.

RestorePointCollectionSourceProperties

이 복원 지점 컬렉션에서 만든 원본 리소스의 속성입니다.

Name	형식	Description
id	string	이 복원 지점 컬렉션을 만드는 데 사용되는 원본 리소스의 리소스 ID
location	string	이 복원 지점 컬렉션을 만드는 데 사용되는 원본 리소스의 위치입니다.

RestorePointEncryption

디스크 복원 지점에 대한 미사용 데이터 암호화 설정입니다. 복원 지점을 만드는 동안 입력에 지정할 수 있는 선택적 속성입니다.

Name	형식	Description
diskEncryptionSet	DiskEncryptionSetParameters	디스크에 대해 지정할 수 있는 고객 관리 디스크 암호화 집합 리소스 ID의 매개 변수에 대해 설명합니다. 참고: 디스크 암호화 집합 리소스 ID는 관리 디스크에 대해서만 지정할 수 있습니다. 자세한 내용은 을 참조 https://aka.ms/mdssewithcmkoverview 하세요.
type	RestorePointEncryptionType	디스크 복원 지점의 데이터를 암호화하는 데 사용되는 키 유형입니다.

RestorePointEncryptionType

디스크 복원 지점의 데이터를 암호화하는 데 사용되는 키 유형입니다.

Name	형식	Description
EncryptionAtRestWithCustomerKey	string	디스크 복원 지점은 고객이 변경하고 취소할 수 있는 고객 관리형 키를 사용하여 미사용 시 암호화됩니다.
EncryptionAtRestWithPlatformAndCustomerKeys	string	디스크 복원 지점은 2개의 암호화 계층으로 미사용 시 암호화됩니다. 키 중 하나는 고객 관리이고 다른 키는 플랫폼 관리입니다.
EncryptionAtRestWithPlatformKey	string	디스크 복원 지점은 플랫폼 관리형 키를 사용하여 미사용 시 암호화됩니다.

RestorePointInstanceView

복원 지점의 instance 보기입니다.

Name	형식	Description
diskRestorePoints	DiskRestorePointInstanceView[]	디스크 복원은 정보를 가리킵니다.
statuses	InstanceViewStatus[]	리소스 상태 정보입니다.

RestorePointSourceMetadata

복원 지점을 만든 Virtual Machine의 속성에 대해 설명합니다. 제공된 속성은 하위 집합이며 복원 지점을 만들 때 캡처된 전체 Virtual Machine 속성의 스냅샷.

Name	형식	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	가상 머신 고유 ID를 가져옵니다.

RestorePointSourceVMDataDisk

데이터 디스크에 대해 설명합니다.

Name	형식	Description
caching	CachingTypes	캐싱 형식을 가져옵니다.
diskRestorePoint	DiskRestorePointAttributes	디스크 복원 지점 속성을 포함합니다.
diskSizeGB	integer	빈 데이터 디스크의 초기 디스크 크기(GB)와 기존 OS 및 데이터 디스크에 대해 원하는 새 크기를 가져옵니다.
lun	integer	논리 단위 번호를 가져옵니다.
managedDisk	ManagedDiskParameters	관리 디스크 세부 정보를 포함합니다.
name	string	디스크 이름을 가져옵니다.
writeAcceleratorEnabled	boolean	디스크가 쓰기 가속기를 사용하도록 설정된 경우 true를 표시합니다.

RestorePointSourceVMOSDisk

운영 체제 디스크에 대해 설명합니다.

Name	형식	Description
caching	CachingTypes	캐싱 형식을 가져옵니다.
diskRestorePoint	DiskRestorePointAttributes	디스크 복원 지점 속성을 포함합니다.
diskSizeGB	integer	디스크 크기를 GB 단위로 가져옵니다.
encryptionSettings	DiskEncryptionSettings	디스크 암호화 설정을 가져옵니다.
managedDisk	ManagedDiskParameters	관리 디스크 세부 정보를 가져옵니다.
name	string	디스크 이름을 가져옵니다.
osType	OperatingSystemType	운영 체제 유형을 가져옵니다.
writeAcceleratorEnabled	boolean	디스크가 쓰기 가속기를 사용하도록 설정된 경우 true를 표시합니다.

RestorePointSourceVMStorageProfile

스토리지 프로필을 설명합니다.

Name	형식	Description
dataDisks	RestorePointSourceVMDataDisk[]	복원 지점을 만들 때 캡처된 VM의 데이터 디스크를 가져옵니다.
diskControllerType	DiskControllerTypes	복원 지점을 만들 때 캡처된 VM의 디스크 컨트롤러 유형을 가져옵니다.
osDisk	RestorePointSourceVMOSDisk	복원 지점을 만들 때 캡처된 VM의 OS 디스크를 가져옵니다.

securityEncryptionTypes

관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob의 암호화를 위한 VMGuestStateOnly 및 VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.

Name	형식	Description
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다.

Name	형식	Description
encryptionAtHost	boolean	이 속성은 요청의 사용자가 가상 머신 또는 가상 머신 확장 집합에 대한 호스트 암호화를 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다. 이렇게 하면 호스트 자체의 리소스/임시 디스크를 비롯한 모든 디스크에 대한 암호화가 활성화됩니다. 기본 동작은 리소스에 대해 이 속성이 true로 설정되지 않는 한 호스트의 암호화를 사용하지 않도록 설정됩니다.
encryptionIdentity	EncryptionIdentity	ADE에서 keyvault 작업에 대한 액세스 토큰을 가져오는 데 사용하는 관리 ID를 지정합니다.
proxyAgentSettings	ProxyAgentSettings	가상 머신을 만드는 동안 ProxyAgent 설정을 지정합니다. 최소 api-version: 2024-03-01.
securityType	SecurityTypes	가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 기본 동작은 다음과 같습니다. 이 속성이 설정되지 않으면 UefiSettings가 사용하도록 설정되지 않습니다.
uefiSettings	UefiSettings	가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다. 최소 api-version: 2020-12-01.

SecurityTypes

가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 기본 동작은 다음과 같습니다. 이 속성이 설정되지 않으면 UefiSettings가 사용하도록 설정되지 않습니다.

Name	형식	Description
ConfidentialVM	string
TrustedLaunch	string

SettingNames

콘텐츠가 적용되는 설정의 이름을 지정합니다. 가능한 값은 FirstLogonCommands 및 AutoLogon입니다.

Name	형식	Description
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

Azure에서 실행되는 Linux 기반 VM에 대한 SSH 구성

Name	형식	Description
publicKeys	SshPublicKey[]	Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다.

SshPublicKey

SSH 인증서 공개 키 및 공개 키가 배치된 Linux VM의 경로에 대한 정보를 포함합니다.

Name	형식	Description
keyData	string	ssh를 통해 VM으로 인증하는 데 사용되는 SSH 공개 키 인증서입니다. 키는 2048비트 이상이어야 하며 ssh-rsa 형식이어야 합니다. ssh 키를 만들려면 [Azure에서 Linux 및 Linux VM용 Mac에서 SSH 키 만들기]를 참조하세요.https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	ssh 공개 키가 저장되는 생성된 VM의 전체 경로를 지정합니다. 파일이 이미 있으면 지정한 키는 파일에 추가됩니다. 예: /home/user/.ssh/authorized_keys

StatusLevelTypes

수준 코드입니다.

Name	형식	Description
Error	string
Info	string
Warning	string

StorageAccountTypes

관리 디스크의 스토리지 계정 유형을 지정합니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있으므로 OS 디스크와 함께 사용할 수 없습니다.

Name	형식	Description
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

SubResource

Name	형식	Description
id	string	리소스 ID

UefiSettings

가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다. 최소 api-version: 2020-12-01.

Name	형식	Description
secureBootEnabled	boolean	가상 머신에서 보안 부팅을 사용하도록 설정할지 여부를 지정합니다. 최소 api-version: 2020-12-01.
vTpmEnabled	boolean	가상 머신에서 vTPM을 사용하도록 설정할지 여부를 지정합니다. 최소 api-version: 2020-12-01.

VaultCertificate

Key Vault 단일 인증서 참조와 인증서가 VM에 있어야 하는 위치에 대해 설명합니다.

Name	형식	Description
certificateStore	string	Windows VM의 경우 인증서를 추가해야 하는 Virtual Machine의 인증서 저장소를 지정합니다. 지정된 인증서 저장소는 LocalMachine 계정에 암시적으로 있습니다. Linux VM의 경우 인증서 파일은 /var/lib/waagent 디렉터리 아래에 배치되며, 파일 이름은 <X509 인증서 파일의 경우 UppercaseThumbprint.crt>이고 <프라이빗 키의 경우 UppercaseThumbprint.prv>입니다. 이 두 파일은 모두 .pem 형식입니다.
certificateUrl	string	비밀로 Key Vault 업로드된 인증서의 URL입니다. Key Vault 비밀을 추가하려면 키 자격 증명 모음에 키 또는 비밀 추가를 참조하세요. 이 경우 인증서는 UTF-8로 인코딩된 다음 JSON 개체의 Base64 인코딩이어야 합니다. { "data":"", "dataType":"pfx", "password":"" } 가상 머신에 인증서를 설치하려면 Linux용 Azure Key Vault 가상 머신 확장 또는 Windows용 Azure Key Vault 가상 머신 확장을 사용하는 것이 좋습니다.

VaultSecretGroup

모두 동일한 Key Vault 있는 인증서 집합에 대해 설명합니다.

Name	형식	Description
sourceVault	SubResource	VaultCertificates에 있는 모든 인증서를 포함하는 Key Vault 상대 URL입니다.
vaultCertificates	VaultCertificate[]	인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다.

VirtualMachineSizeTypes

가상 컴퓨터의 크기를 지정합니다. 열거형 데이터 형식은 현재 사용되지 않으며 2023년 12월 23일까지 제거됩니다. 사용 가능한 크기 목록을 가져오는 권장 방법은 다음 API를 사용하는 것입니다. 가용성 집합에 사용 가능한 모든 가상 머신 크기 나열, 지역에서 사용 가능한 모든 가상 머신 크기 나열, 크기 조정을 위해 사용 가능한 모든 가상 머신 크기 나열. 가상 머신 크기에 대한 자세한 내용은 가상 머신의 크기를 참조하세요. 사용 가능한 VM 크기는 지역 및 가용성 집합에 따라 달라집니다.

Name	형식	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에 대해서만 설정할 수 있습니다.

Name	형식	Description
diskEncryptionSet	DiskEncryptionSetParameters	고객 관리형 키 암호화 ConfidentialVM OS 디스크 및 VMGuest Blob에 사용되는 관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.
securityEncryptionType	securityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob의 암호화를 위한 VMGuestStateOnly 및 VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.

VMSizeProperties

가상 머신에서 VM 크기 속성 설정을 지정합니다.

Name	형식	Description
vCPUsAvailable	integer	VM에 사용할 수 있는 vCPU 수를 지정합니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본 동작은 해당 지역의 사용 가능한 모든 가상 머신 크기 나열의 api 응답에 노출된 해당 VM 크기에 사용할 수 있는 vCPU 값으로 설정하는 것입니다.
vCPUsPerCore	integer	실제 코어 비율에 대한 vCPU를 지정합니다. 요청 본문에 이 속성을 지정하지 않은 경우 기본 동작은 지역에서 사용 가능한 모든 가상 머신 크기 나열의 api 응답에 노출된 VM 크기에 대한 vCPUsPerCore 값으로 설정됩니다. 또한 이 속성을 1로 설정하면 하이퍼 스레딩이 사용하지 않도록 설정됩니다.

WindowsConfiguration

가상 머신의 Windows 운영 체제 설정을 지정합니다.

Name	형식	Description
additionalUnattendContent	AdditionalUnattendContent[]	Windows 설치 프로그램에 사용되는 Unattend.xml 파일에 포함될 수 있는, base-64로 인코딩된 추가적인 XML 형식 정보를 지정합니다.
enableAutomaticUpdates	boolean	Windows 가상 머신에 대해 자동 업데이트 사용할 수 있는지 여부를 나타냅니다. 기본값은 true입니다. 가상 머신 확장 집합의 경우 이 속성을 업데이트할 수 있으며 업데이트는 OS 다시 프로비전에 적용됩니다.
enableVMAgentPlatformUpdates	boolean	Windows 가상 머신에 대해 VMAgent Platform 업데이트 사용하도록 설정되어 있는지 여부를 나타냅니다. 기본값은 false입니다.
patchSettings	PatchSettings	[미리 보기 기능] Windows의 VM 게스트 패치와 관련된 설정을 지정합니다.
provisionVMAgent	boolean	가상 컴퓨터에서 가상 컴퓨터 에이전트를 프로비전해야 하는지 여부를 나타냅니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본적으로 true로 설정됩니다. 이렇게 하면 나중에 VM에 확장을 추가할 수 있도록 VM 에이전트가 VM에 설치됩니다.
timeZone	string	가상 머신의 표준 시간대를 지정합니다. 예: "태평양 표준시". 가능한 값은 TimeZoneInfo.GetSystemTimeZones에서 반환된 표준 시간대의 TimeZoneInfo.Id 값일 수 있습니다.
winRM	WinRMConfiguration	Windows 원격 관리 수신기를 지정합니다. 따라서 원격 Windows PowerShell을 사용할 수 있습니다.

WindowsPatchAssessmentMode

Name	형식	Description
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

Name	형식	Description
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Windows 패치 설정에서 패치 모드 AutomaticByPlatform을 선택할 때 적용할 추가 설정을 지정합니다.

Name	형식	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	고객이 실수로 업그레이드하지 않고 패치를 예약할 수 있습니다.
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

WindowsVMGuestPatchMode

OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다.

가능한 값은 다음과 같습니다.

수동 - 가상 머신에 패치 적용을 제어합니다. VM 내에서 수동으로 패치를 적용하여 이 작업을 수행합니다. 이 모드에서는 자동 업데이트를 사용할 수 없습니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 false여야 합니다.

AutomaticByOS - 가상 머신이 OS에 의해 자동으로 업데이트됩니다. WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.

AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 및 WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.

Name	형식	Description
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

VM의 Windows 원격 관리 구성에 대해 설명합니다.

Name	형식	Description
listeners	WinRMListener[]	Windows 원격 관리 수신기 목록

WinRMListener

Windows 원격 관리 수신기의 프로토콜 및 지문에 대해 설명합니다.

Name	형식	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 - List

URI 매개 변수

응답

보안

azure_auth

범위

예제

Gets the list of restore point collections in a resource group.

샘플 요청

샘플 응답

정의

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

RestorePointCollectionListResult

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

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

WindowsVMGuestPatchAutomaticByPlatformSettings

WindowsVMGuestPatchMode