Backups - Trigger

Служба:: Recovery Services - Backup

Версия API:: 2026-01-01

Активирует резервное копирование для указанного элемента резервного копирования. Это асинхронная операция. Чтобы узнать состояние операции, вызовите API GetProtectedItemOperationResult.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/backup?api-version=2026-01-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
containerName	path	True	string	Имя контейнера, данные которого необходимо получить.
fabricName	path	True	string	Имя ресурса BackupFabricResource
protectedItemName	path	True	string	Резервное имя элемента, данные которого должны быть получены.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
vaultName	path	True	string	Имя ресурса VaultResource
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Тип	Описание
eTag	string	Необязательный ETag.
location	string	Расположение ресурса.
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Свойства BackupRequestResource
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
202 Accepted		Запрос был принят для обработки, но обработка еще не завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Trigger Backup

Образец запроса

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/linuxRsVaultRG/providers/Microsoft.RecoveryServices/vaults/linuxRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testrg;v1win2012r/protectedItems/VM;iaasvmcontainerv2;testrg;v1win2012r/backup?api-version=2026-01-01

{
  "properties": {
    "objectType": "IaasVMBackupRequest"
  }
}

Пример ответа

Код состояния:: 202

Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/linuxRsVaultRG/providers/Microsoft.RecoveryServices/vaults/linuxRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainer;testrg;v1win2012r/protectedItems/VM;iaasvmcontainer;testrg;v1win2012r/operationsStatus/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/linuxRsVaultRG/providers/Microsoft.RecoveryServices/vaults/linuxRsVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainer;testrg;v1win2012r/protectedItems/VM;iaasvmcontainer;testrg;v1win2012r/operationResults/00000000-0000-0000-0000-000000000000?api-version=2016-12-01
Retry-After: 60

Определения

Имя	Описание
AzureFileShareBackupRequest	Запрос резервного копирования azureFileShare для конкретной рабочей нагрузки.
AzureWorkloadBackupRequest	Запрос резервного копирования для конкретной рабочей нагрузки AzureWorkload.
BackupRequestResource	Базовый класс для запроса резервного копирования. Запросы резервного копирования, относящиеся к рабочей нагрузке, являются производными от этого класса.
BackupType	Тип резервного копирования, viz. Полный, разностный, журнал или copyOnlyFull
createdByType	Тип удостоверения, создавшего ресурс.
ErrorDetail	Класс Error Detail, который инкапсулирует код, сообщение и рекомендации.
ErrorResponse	Ответ на ошибку
IaasVMBackupRequest	Запрос резервного копирования виртуальной машины IaaS для конкретной рабочей нагрузки.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

AzureFileShareBackupRequest

Объект

Запрос резервного копирования azureFileShare для конкретной рабочей нагрузки.

Имя	Тип	Описание
objectType	string: AzureFileShareBackupRequest	Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointExpiryTimeInUTC	string (date-time)	Резервное копирование истекает после указанного времени (UTC).

AzureWorkloadBackupRequest

Объект

Запрос резервного копирования для конкретной рабочей нагрузки AzureWorkload.

Имя	Тип	Описание
backupType	BackupType	Тип резервного копирования, viz. Полный, разностный, журнал или copyOnlyFull
enableCompression	boolean	Логический параметр для сжатия
objectType	string: AzureWorkloadBackupRequest	Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointExpiryTimeInUTC	string (date-time)	Резервное копирование истекает после указанного времени (UTC).

BackupRequestResource

Объект

Базовый класс для запроса резервного копирования. Запросы резервного копирования, относящиеся к рабочей нагрузке, являются производными от этого класса.

Имя	Тип	Описание
eTag	string	Необязательный ETag.
id	string	Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Расположение ресурса.
name	string	Имя ресурса
properties	BackupRequest: AzureFileShareBackupRequest AzureWorkloadBackupRequest IaasVMBackupRequest	Свойства BackupRequestResource
systemData	systemData	Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

BackupType

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

Тип резервного копирования, viz. Полный, разностный, журнал или copyOnlyFull

Значение	Описание
Invalid
Full
Differential
Log
CopyOnlyFull
Incremental
SnapshotFull
SnapshotCopyOnlyFull

createdByType

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

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

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

ErrorDetail

Объект

Класс Error Detail, который инкапсулирует код, сообщение и рекомендации.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке, связанное с кодом.
recommendations	string[]	Список строк рекомендаций.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

IaasVMBackupRequest

Объект

Запрос резервного копирования виртуальной машины IaaS для конкретной рабочей нагрузки.

Имя	Тип	Описание
objectType	string: IaasVMBackupRequest	Это свойство будет использоваться в качестве дискриминационных для принятия конкретных типов в полиморфной цепочке типов.
recoveryPointExpiryTimeInUTC	string (date-time)	Резервное копирование истекает после указанного времени (UTC).

systemData

Объект

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

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