Disk Restore Point - Get

Служба:: Compute

Версия API:: 2025-01-02

Получение ресурса disk restorePoint

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
diskRestorePointName	path	True	string	Имя DiskRestorePoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
restorePointCollectionName	path	True	string	Имя коллекции точек восстановления, к которой принадлежит точка восстановления диска.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
vmRestorePointName	path	True	string	Имя точки восстановления виртуальной машины, к которой принадлежит точка восстановления диска диска.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	DiskRestorePoint	Операция Azure успешно завершена.
Other Status Codes	CloudError	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
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
  }
}

Определения

Имя	Описание
ApiError	Ошибка API.
ApiErrorBase	База ошибок API.
Architecture	Архитектура ЦП, поддерживаемая диском ОС.
CloudError	Ответ об ошибке от службы вычислений.
createdByType	Тип удостоверения, создавшего ресурс.
DiskPurchasePlan	Используется для создания контекста покупки любого артефакта третьей стороны через MarketPlace.
DiskRestorePoint	Свойства точки восстановления диска
DiskSecurityProfile	Содержит сведения, связанные с безопасностью для ресурса.
DiskSecurityTypes	Указывает тип безопасности виртуальной машины. Применимо только для дисков ОС.
Encryption	Параметры шифрования при хранении для диска или моментального снимка
EncryptionType	Тип ключа, используемого для шифрования данных диска.
HyperVGeneration	Создание гипервизора виртуальной машины. Применимо только к дискам ОС.
InnerError	Сведения о внутренней ошибке.
NetworkAccessPolicy	Политика доступа к диску через сеть.
OperatingSystemTypes	Тип операционной системы.
PublicNetworkAccess	Политика управления экспортом на диске.
SupportedCapabilities	Список поддерживаемых возможностей, сохраненный на дисковом ресурсе для использования виртуальной машиной.
SupportedSecurityOption	Относится к возможностям безопасности диска, поддерживаемого для создания доверенного запуска или конфиденциальной виртуальной машины.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

ApiError

Объект

Ошибка API.

Имя	Тип	Описание
code	string	Код ошибки.
details	ApiErrorBase[]	Сведения об ошибке Api
innererror	InnerError	Внутренняя ошибка Api
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

ApiErrorBase

Объект

База ошибок API.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

Architecture

Перечисление

Архитектура ЦП, поддерживаемая диском ОС.

Значение	Описание
x64
Arm64

CloudError

Объект

Ответ об ошибке от службы вычислений.

Имя	Тип	Описание
error	ApiError	Ошибка API.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Объект

Используется для создания контекста покупки любого артефакта третьей стороны через MarketPlace.

Имя	Тип	Описание
name	string	Идентификатор плана.
product	string	Задает продукт изображения из Marketplace. Это то же значение, что и Предложение в элементе imageReference.
promotionCode	string	Код продвижения предложения.
publisher	string	Идентификатор издателя.

DiskRestorePoint

Объект

Свойства точки восстановления диска

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Имя ресурса
properties.completionPercent	number (float)	Процент готовности для фоновой копии точки восстановления диска, когда исходный ресурс находится в другом регионе.
properties.diskAccessId	string	Идентификатор ARM ресурса DiskAccess для использования частных конечных точек на дисках.
properties.encryption	Encryption	Свойство шифрования можно использовать для шифрования неактивных данных с помощью управляемых клиентом ключей или управляемых платформой ключей.
properties.familyId	string	идентификатор семейства MIS резервного снимка
properties.hyperVGeneration	HyperVGeneration	Создание гипервизора виртуальной машины. Применимо только к дискам ОС.
properties.logicalSectorSize	integer (int32)	Размер логического сектора в байтах для точек восстановления дисков UltraSSD_LRS и PremiumV2_LRS дисков. Поддерживаемые значения: 512 и 4096. 4096 — это значение по умолчанию.
properties.networkAccessPolicy	NetworkAccessPolicy	Политика доступа к диску через сеть.
properties.osType	OperatingSystemTypes	Тип операционной системы.
properties.publicNetworkAccess	PublicNetworkAccess	Политика управления экспортом на диске.
properties.purchasePlan	DiskPurchasePlan	Сведения о плане покупки образа, из которого был создан диск ОС.
properties.replicationState	string	Состояние репликации точки восстановления диска, когда исходный ресурс находится в другом регионе.
properties.securityProfile	DiskSecurityProfile	Содержит сведения, связанные с безопасностью для ресурса.
properties.sourceResourceId	string	Идентификатор ARM исходного диска или точки восстановления исходного диска.
properties.sourceResourceLocation	string	Расположение исходного диска или точки восстановления исходного диска, если исходный ресурс находится в другом регионе.
properties.sourceUniqueId	string	Уникальный идентификатор воплощения исходного диска
properties.supportedCapabilities	SupportedCapabilities	Список поддерживаемых возможностей для образа, из которого был создан диск ОС.
properties.supportsHibernation	boolean	Указывает, что ОС на диске поддерживает гибернацию.
properties.timeCreated	string (date-time)	Временная метка создания restorePoint
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Объект

Содержит сведения, связанные с безопасностью для ресурса.

Имя	Тип	Описание
secureVMDiskEncryptionSetId	string	ResourceId набора шифрования диска, связанного с поддерживаемым конфиденциальным диском виртуальной машины, зашифрованным с помощью управляемого клиентом ключа.
securityType	DiskSecurityTypes	Указывает тип безопасности виртуальной машины. Применимо только для дисков ОС.

DiskSecurityTypes

Перечисление

Указывает тип безопасности виртуальной машины. Применимо только для дисков ОС.

Значение	Описание
TrustedLaunch	Trusted Launch предоставляет функции безопасности, такие как безопасная загрузка и виртуальный модуль доверенной платформы (vTPM)
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Указывает на конфиденциальный диск виртуальной машины, в котором зашифровано только гостевое состояние виртуальной машины
ConfidentialVM_DiskEncryptedWithPlatformKey	Указывает на конфиденциальный диск виртуальной машины с зашифрованным состоянием диска ОС и гостевой виртуальной машины с помощью ключа, управляемого платформой
ConfidentialVM_DiskEncryptedWithCustomerKey	Указывает на конфиденциальный диск виртуальной машины с зашифрованным состоянием диска ОС и гостевой виртуальной машины с помощью ключа, управляемого клиентом
ConfidentialVM_NonPersistedTPM	Указывает на конфиденциальный диск виртуальной машины с временным vTPM. Состояние vTPM не сохраняется при перезагрузке виртуальной машины.

Encryption

Объект

Параметры шифрования при хранении для диска или моментального снимка

Имя	Тип	Описание
diskEncryptionSetId	string	ResourceId набора шифрования дисков, который используется для включения шифрования неактивных данных.
type	EncryptionType	Тип ключа, используемого для шифрования данных диска.

EncryptionType

Перечисление

Тип ключа, используемого для шифрования данных диска.

Значение	Описание
EncryptionAtRestWithPlatformKey	Диск шифруется при хранении с помощью ключа, управляемого платформой. Это тип шифрования по умолчанию. Это недопустимый тип шифрования для наборов шифрования диска.
EncryptionAtRestWithCustomerKey	Диск шифруется при хранении с помощью ключа, управляемого клиентом, который может быть изменен и отозван клиентом.
EncryptionAtRestWithPlatformAndCustomerKeys	Диск шифруется при хранении с помощью 2 уровней шифрования. Один из ключей управляется клиентом, а другой — управляется платформой.

HyperVGeneration

Перечисление

Создание гипервизора виртуальной машины. Применимо только к дискам ОС.

Значение	Описание
V1
V2

InnerError

Объект

Сведения о внутренней ошибке.

Имя	Тип	Описание
errordetail	string	Внутреннее сообщение об ошибке или дамп исключений.
exceptiontype	string	Тип исключения.

NetworkAccessPolicy

Перечисление

Политика доступа к диску через сеть.

Значение	Описание
AllowAll	Диск может быть экспортирован или загружен из любой сети.
AllowPrivate	Диск можно экспортировать или отправить на него с помощью частных конечных точек ресурса DiskAccess.
DenyAll	Диск не может быть экспортирован.

OperatingSystemTypes

Перечисление

Тип операционной системы.

Значение	Описание
Windows
Linux

PublicNetworkAccess

Перечисление

Политика управления экспортом на диске.

Значение	Описание
Enabled	Можно создать универсальный код ресурса (URI) SAS для доступа к базовым данным диска в открытом доступе в Интернете, если для параметра NetworkAccessPolicy задано значение AllowAll. Вы можете получить доступ к данным через универсальный код ресурса (URI) SAS только из доверенной виртуальной сети Azure, если для параметра NetworkAccessPolicy задано значение AllowPrivate.
Disabled	Вы не можете получить доступ к базовым данным диска в Интернете, даже если для параметра NetworkAccessPolicy задано значение AllowAll. Вы можете получить доступ к данным через универсальный код ресурса (URI) SAS только из доверенной виртуальной сети Azure, если для параметра NetworkAccessPolicy задано значение AllowPrivate.

Значение

Описание

Enabled

Можно создать универсальный код ресурса (URI) SAS для доступа к базовым данным диска в открытом доступе в Интернете, если для параметра NetworkAccessPolicy задано значение AllowAll. Вы можете получить доступ к данным через универсальный код ресурса (URI) SAS только из доверенной виртуальной сети Azure, если для параметра NetworkAccessPolicy задано значение AllowPrivate.

Disabled

Вы не можете получить доступ к базовым данным диска в Интернете, даже если для параметра NetworkAccessPolicy задано значение AllowAll. Вы можете получить доступ к данным через универсальный код ресурса (URI) SAS только из доверенной виртуальной сети Azure, если для параметра NetworkAccessPolicy задано значение AllowPrivate.

SupportedCapabilities

Объект

Список поддерживаемых возможностей, сохраненный на дисковом ресурсе для использования виртуальной машиной.

Имя	Тип	Описание
acceleratedNetwork	boolean	Значение true, если образ, из которого создается диск ОС, поддерживает ускорение сети.
architecture	Architecture	Архитектура ЦП, поддерживаемая диском ОС.
diskControllerTypes	string	Контроллеры дисков, поддерживаемые диском ОС. Если задано значение SCSI или SCSI, NVME или NVME, SCSI.
supportedSecurityOption	SupportedSecurityOption	Относится к возможностям безопасности диска, поддерживаемого для создания доверенного запуска или конфиденциальной виртуальной машины.

SupportedSecurityOption

Перечисление

Относится к возможностям безопасности диска, поддерживаемого для создания доверенного запуска или конфиденциальной виртуальной машины.

Значение	Описание
TrustedLaunchSupported	Диск поддерживает создание виртуальных машин с доверенным запуском.
TrustedLaunchAndConfidentialVMSupported	Диск поддерживает создание как доверенных запусков, так и конфиденциальных виртуальных машин.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

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