Disk Restore Point - Get

서비스:: Compute

API 버전:: 2025-01-02

디스크 복원Point 리소스 가져오기

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}/restorePoints/{vmRestorePointName}/diskRestorePoints/{diskRestorePointName}?api-version=2025-01-02

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
diskRestorePointName	path	True	string	DiskRestorePoint의 이름
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
restorePointCollectionName	path	True	string	디스크 복원 지점이 속한 복원 지점 컬렉션의 이름입니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
vmRestorePointName	path	True	string	디스크 디스크 복원 지점이 속한 VM 복원 지점의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	DiskRestorePoint	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

get an incremental disk restorePoint resource.

get an incremental disk restorePoint when source resource is from a different region

get an incremental disk restorePoint resource.

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745?api-version=2025-01-02

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "properties": {
    "timeCreated": "2020-09-16T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
    "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "logicalSectorSize": 4096
  }
}

get an incremental disk restorePoint when source resource is from a different region

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745?api-version=2025-01-02

샘플 응답

상태 코드:: 200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "properties": {
    "timeCreated": "2020-09-16T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
    "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "replicationState": "Succeeded",
    "completionPercent": 100,
    "sourceResourceLocation": "eastus2",
    "logicalSectorSize": 4096
  }
}

정의

Name	Description
ApiError	API 오류.
ApiErrorBase	API 오류 기반.
Architecture	OS 디스크에서 지원하는 CPU 아키텍처입니다.
CloudError	컴퓨팅 서비스의 오류 응답입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DiskPurchasePlan	MarketPlace를 통해 제3자 아티팩트의 구매 컨텍스트를 설정하는 데 사용됩니다.
DiskRestorePoint	디스크 복원 지점의 속성
DiskSecurityProfile	리소스에 대한 보안 관련 정보를 포함합니다.
DiskSecurityTypes	VM의 SecurityType을 지정합니다. OS 디스크에만 적용됩니다.
Encryption	디스크 또는 스냅샷에 대한 미사용 시 암호화 설정
EncryptionType	디스크의 데이터를 암호화하는 데 사용되는 키 유형입니다.
HyperVGeneration	Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.
InnerError	내부 오류 세부 정보입니다.
NetworkAccessPolicy	네트워크를 통해 디스크에 액세스하기 위한 정책입니다.
OperatingSystemTypes	운영 체제 유형입니다.
PublicNetworkAccess	디스크에서 내보내기를 제어하는 정책입니다.
SupportedCapabilities	VM 사용을 위해 디스크 리소스에 유지되는 지원되는 기능 목록입니다.
SupportedSecurityOption	신뢰할 수 있는 시작 또는 기밀 VM을 만드는 데 지원되는 디스크의 보안 기능을 나타냅니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

ApiError

Object

API 오류.

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

ApiErrorBase

Object

API 오류 기반.

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

Architecture

열거형

OS 디스크에서 지원하는 CPU 아키텍처입니다.

값	Description
x64
Arm64

CloudError

Object

컴퓨팅 서비스의 오류 응답입니다.

Name	형식	Description
error	ApiError	API 오류.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Object

MarketPlace를 통해 제3자 아티팩트의 구매 컨텍스트를 설정하는 데 사용됩니다.

Name	형식	Description
name	string	계획 ID입니다.
product	string	마켓플레이스에서 이미지의 곱을 지정합니다. imageReference 요소 아래의 Offer와 동일한 값입니다.
promotionCode	string	제품 프로모션 코드입니다.
publisher	string	게시자 ID입니다.

DiskRestorePoint

Object

디스크 복원 지점의 속성

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름
properties.completionPercent	number (float)	원본 리소스가 다른 지역에 있는 경우 디스크 복원 지점의 백그라운드 복사본에 대한 완료율입니다.
properties.diskAccessId	string	디스크에서 프라이빗 엔드포인트를 사용하기 위한 DiskAccess 리소스의 ARM ID입니다.
properties.encryption	Encryption	암호화 속성을 사용하여 고객 관리형 키 또는 플랫폼 관리 키를 사용하여 미사용 데이터를 암호화할 수 있습니다.
properties.familyId	string	백업 스냅샷의 MIS 제품군의 id
properties.hyperVGeneration	HyperVGeneration	Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.
properties.logicalSectorSize	integer (int32)	UltraSSD_LRS 및 PremiumV2_LRS 디스크의 디스크 복원 지점에 대한 논리 섹터 크기(바이트)입니다. 지원되는 값은 512 및 4096입니다. 4096이 기본값입니다.
properties.networkAccessPolicy	NetworkAccessPolicy	네트워크를 통해 디스크에 액세스하기 위한 정책입니다.
properties.osType	OperatingSystemTypes	운영 체제 유형입니다.
properties.publicNetworkAccess	PublicNetworkAccess	디스크에서 내보내기를 제어하는 정책입니다.
properties.purchasePlan	DiskPurchasePlan	OS 디스크를 만든 이미지에 대한 구매 계획 정보입니다.
properties.replicationState	string	원본 리소스가 다른 지역의 경우 디스크 복원 지점의 복제 상태입니다.
properties.securityProfile	DiskSecurityProfile	리소스에 대한 보안 관련 정보를 포함합니다.
properties.sourceResourceId	string	원본 디스크 또는 원본 디스크 복원 지점의 ARM ID입니다.
properties.sourceResourceLocation	string	원본 리소스가 다른 지역에 있는 경우 원본 디스크 또는 원본 디스크 복원 지점의 위치입니다.
properties.sourceUniqueId	string	소스 디스크의 고유한 화신 ID
properties.supportedCapabilities	SupportedCapabilities	OS 디스크를 만든 이미지에 대해 지원되는 기능 목록입니다.
properties.supportsHibernation	boolean	디스크의 OS가 최대 절전 모드를 지원했음을 나타냅니다.
properties.timeCreated	string (date-time)	restorePoint 생성의 타임스탬프
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Object

리소스에 대한 보안 관련 정보를 포함합니다.

Name	형식	Description
secureVMDiskEncryptionSetId	string	고객 관리형 키로 암호화된 기밀 VM 지원 디스크에 연결된 디스크 암호화 집합의 ResourceId
securityType	DiskSecurityTypes	VM의 SecurityType을 지정합니다. OS 디스크에만 적용됩니다.

DiskSecurityTypes

열거형

VM의 SecurityType을 지정합니다. OS 디스크에만 적용됩니다.

값	Description
TrustedLaunch	Trusted Launch는 보안 부팅 및 가상 vTPM(신뢰할 수 있는 플랫폼 모듈)과 같은 보안 기능을 제공합니다.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	VM 게스트 상태만 암호화된 기밀 VM 디스크를 나타냅니다.
ConfidentialVM_DiskEncryptedWithPlatformKey	플랫폼 관리형 키로 암호화된 OS 디스크 및 VM 게스트 상태가 있는 기밀 VM 디스크를 나타냅니다.
ConfidentialVM_DiskEncryptedWithCustomerKey	고객 관리형 키로 암호화된 OS 디스크 및 VM 게스트 상태가 있는 기밀 VM 디스크를 나타냅니다.
ConfidentialVM_NonPersistedTPM	임시 vTPM이 있는 기밀 VM 디스크를 나타냅니다. vTPM 상태는 VM 재부팅 시 유지되지 않습니다.

Encryption

Object

디스크 또는 스냅샷에 대한 미사용 시 암호화 설정

Name	형식	Description
diskEncryptionSetId	string	미사용 암호화를 사용하도록 설정하는 데 사용할 디스크 암호화 집합의 ResourceId입니다.
type	EncryptionType	디스크의 데이터를 암호화하는 데 사용되는 키 유형입니다.

EncryptionType

열거형

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

값	Description
EncryptionAtRestWithPlatformKey	디스크는 플랫폼 관리 키를 사용하여 미사용 시 암호화됩니다. 기본 암호화 유형입니다. 디스크 암호화 세트에 유효한 암호화 유형이 아닙니다.
EncryptionAtRestWithCustomerKey	디스크는 고객이 변경 및 해지할 수 있는 고객 관리형 키를 사용하여 미사용 시 암호화됩니다.
EncryptionAtRestWithPlatformAndCustomerKeys	디스크는 2계층 암호화로 미사용 시 암호화됩니다. 키 중 하나는 고객 관리이고 다른 키는 플랫폼 관리입니다.

HyperVGeneration

열거형

Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.

값	Description
V1
V2

InnerError

Object

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

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

NetworkAccessPolicy

열거형

네트워크를 통해 디스크에 액세스하기 위한 정책입니다.

값	Description
AllowAll	디스크는 모든 네트워크에서 내보내거나 업로드할 수 있습니다.
AllowPrivate	디스크는 DiskAccess 리소스의 프라이빗 엔드포인트를 사용하여 내보내거나 업로드할 수 있습니다.
DenyAll	디스크를 내보낼 수 없습니다.

OperatingSystemTypes

열거형

운영 체제 유형입니다.

값	Description
Windows
Linux

PublicNetworkAccess

열거형

디스크에서 내보내기를 제어하는 정책입니다.

값	Description
Enabled	NetworkAccessPolicy가 AllowAll로 설정된 경우 인터넷에서 디스크의 기본 데이터에 공개적으로 액세스하는 SAS URI를 생성할 수 있습니다. NetworkAccessPolicy가 AllowPrivate으로 설정된 경우에만 신뢰할 수 있는 Azure VNET에서만 SAS URI를 통해 데이터에 액세스할 수 있습니다.
Disabled	NetworkAccessPolicy가 AllowAll로 설정된 경우에도 인터넷에서 디스크의 기본 데이터에 공개적으로 액세스할 수 없습니다. NetworkAccessPolicy가 AllowPrivate으로 설정된 경우에만 신뢰할 수 있는 Azure VNET에서만 SAS URI를 통해 데이터에 액세스할 수 있습니다.

SupportedCapabilities

Object

VM 사용을 위해 디스크 리소스에 유지되는 지원되는 기능 목록입니다.

Name	형식	Description
acceleratedNetwork	boolean	TRUE이면 OS 디스크를 만든 이미지가 가속화된 네트워킹을 지원합니다.
architecture	Architecture	OS 디스크에서 지원하는 CPU 아키텍처입니다.
diskControllerTypes	string	OS 디스크가 지원하는 디스크 컨트롤러입니다. 설정된 경우 SCSI 또는 SCSI, NVME 또는 NVME, SCSI일 수 있습니다.
supportedSecurityOption	SupportedSecurityOption	신뢰할 수 있는 시작 또는 기밀 VM을 만드는 데 지원되는 디스크의 보안 기능을 나타냅니다.

SupportedSecurityOption

열거형

신뢰할 수 있는 시작 또는 기밀 VM을 만드는 데 지원되는 디스크의 보안 기능을 나타냅니다.

값	Description
TrustedLaunchSupported	디스크는 신뢰할 수 있는 시작 VM 생성을 지원합니다.
TrustedLaunchAndConfidentialVMSupported	디스크는 신뢰할 수 있는 시작 및 기밀 VM 생성을 모두 지원합니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

Disk Restore Point - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

get an incremental disk restorePoint resource.

샘플 요청

샘플 응답

get an incremental disk restorePoint when source resource is from a different region

샘플 요청

샘플 응답

정의

ApiError

ApiErrorBase

Architecture

CloudError

createdByType

DiskPurchasePlan

DiskRestorePoint

DiskSecurityProfile

DiskSecurityTypes

Encryption

EncryptionType

HyperVGeneration

InnerError

NetworkAccessPolicy

OperatingSystemTypes

PublicNetworkAccess

SupportedCapabilities

SupportedSecurityOption

systemData