Replication Protection Intents - Create

服务:

Recovery Services - Site Recovery

API 版本:

2025-08-01

创建保护意向资源。
创建 ASR 复制保护意向项的作。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationProtectionIntents/{intentObjectName}?api-version=2025-08-01

URI 参数

名称	在	必需	类型	说明
intentObjectName	path	True	string	复制保护意向名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
resourceName	path	True	string	Vault 的名称
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

请求正文

名称	类型	说明
properties	CreateProtectionIntentProperties	创建保护意向输入属性。

响应

名称	类型	说明
200 OK	ReplicationProtectionIntent	资源“ReplicationProtectionIntent”更新作成功

安全性

azure_auth

Azure Active Directory OAuth2 流程。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Create protection intent Resource.

示例请求

HTTP

PUT https://management.azure.com/subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationProtectionIntents/vm1?api-version=2025-08-01

{
  "properties": {
    "providerSpecificDetails": {
      "fabricObjectId": "/subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/removeOne/providers/Microsoft.Compute/virtualMachines/vmPpgAv5",
      "instanceType": "A2A",
      "primaryLocation": "eastUs2",
      "recoveryAvailabilityType": "Single",
      "recoveryLocation": "westus2",
      "recoveryResourceGroupId": "/subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/removeOne-asr",
      "recoverySubscriptionId": "ed5bcdf6-d61e-47bd-8ea9-f2bd379a2640"
    }
  }
}

Go

package armrecoveryservicessiterecovery_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/recoveryservices/armrecoveryservicessiterecovery/v3"
)

// Generated from example definition: 2025-08-01/ReplicationProtectionIntents_Create.json
func ExampleReplicationProtectionIntentsClient_Create() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicessiterecovery.NewClientFactory("509099b2-9d2c-4636-b43e-bd5cafb6be69", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewReplicationProtectionIntentsClient().Create(ctx, "resourceGroupPS1", "vault1", "vm1", armrecoveryservicessiterecovery.CreateProtectionIntentInput{
		Properties: &armrecoveryservicessiterecovery.CreateProtectionIntentProperties{
			ProviderSpecificDetails: &armrecoveryservicessiterecovery.A2ACreateProtectionIntentInput{
				FabricObjectID:           to.Ptr("/subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/removeOne/providers/Microsoft.Compute/virtualMachines/vmPpgAv5"),
				InstanceType:             to.Ptr("A2A"),
				PrimaryLocation:          to.Ptr("eastUs2"),
				RecoveryAvailabilityType: to.Ptr(armrecoveryservicessiterecovery.A2ARecoveryAvailabilityTypeSingle),
				RecoveryLocation:         to.Ptr("westus2"),
				RecoveryResourceGroupID:  to.Ptr("/subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/removeOne-asr"),
				RecoverySubscriptionID:   to.Ptr("ed5bcdf6-d61e-47bd-8ea9-f2bd379a2640"),
			},
		},
	}, 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 = armrecoveryservicessiterecovery.ReplicationProtectionIntentsClientCreateResponse{
	// 	ReplicationProtectionIntent: &armrecoveryservicessiterecovery.ReplicationProtectionIntent{
	// 		Name: to.Ptr("vm1"),
	// 		Type: to.Ptr("Microsoft.RecoveryServices/vaults/replicationProtectionIntents"),
	// 		ID: to.Ptr("/Subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/2007vttp/providers/Microsoft.RecoveryServices/vaults/tp2007vt/replicationProtectionIntents/vm1"),
	// 		Properties: &armrecoveryservicessiterecovery.ReplicationProtectionIntentProperties{
	// 			FriendlyName: to.Ptr("vm1"),
	// 			JobID: to.Ptr("/Subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/a2acl-rg-vault-prod-gip-ccy/providers/Microsoft.RecoveryServices/vaults/a2acl-vault-prod-gip-ccy/replicationJobs/02004ea7-d498-4bb4-bdeb-cdb611706867"),
	// 			JobState: to.Ptr("InProgress"),
	// 			ProviderSpecificDetails: &armrecoveryservicessiterecovery.A2AReplicationIntentDetails{
	// 				InstanceType: to.Ptr("A2A"),
	// 				RecoveryAvailabilityType: to.Ptr("Single"),
	// 			},
	// 		},
	// 	},
	// }
}

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

示例响应

状态代码:

200

Azure-AsyncOperation: https://management.azure.com/Subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2025-08-01

{
  "name": "vm1",
  "type": "Microsoft.RecoveryServices/vaults/replicationProtectionIntents",
  "id": "/Subscriptions/509099b2-9d2c-4636-b43e-bd5cafb6be69/resourceGroups/2007vttp/providers/Microsoft.RecoveryServices/vaults/tp2007vt/replicationProtectionIntents/vm1",
  "properties": {
    "friendlyName": "vm1",
    "jobId": "/Subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/a2acl-rg-vault-prod-gip-ccy/providers/Microsoft.RecoveryServices/vaults/a2acl-vault-prod-gip-ccy/replicationJobs/02004ea7-d498-4bb4-bdeb-cdb611706867",
    "jobState": "InProgress",
    "providerSpecificDetails": {
      "instanceType": "A2A",
      "recoveryAvailabilityType": "Single"
    }
  }
}

定义

名称	说明
A2ACreateProtectionIntentInput	A2A 创建保护意图输入。
A2AProtectionIntentDiskInputDetails	Azure VM 非托管磁盘输入详细信息。
A2AProtectionIntentManagedDiskInputDetails	Azure VM 托管磁盘输入详细信息。
A2ARecoveryAvailabilityType	虚拟机的恢复可用性类型。
A2AReplicationIntentDetails	A2A 提供商特定设置。
AgentAutoUpdateStatus	一个值，该值指示是否启用自动更新。
AutomationAccountAuthenticationType	一个值，指示用于自动化帐户的类型身份验证。
AutoProtectionOfDataDisk	一个值，该值指示是否启用自动保护。
createdByType	创建资源的标识的类型。
CreateProtectionIntentInput	创建保护意向输入。
CreateProtectionIntentProperties	创建保护意向输入属性。
DiskEncryptionInfo	恢复磁盘加密信息（BEK 和 KEK）。
DiskEncryptionKeyInfo	磁盘加密密钥信息 （Windows 上的 BitLocker 加密密钥 （BEK） ） 。
ExistingProtectionProfile	现有存储帐户输入。
ExistingRecoveryAvailabilitySet	现有恢复可用性集输入。
ExistingRecoveryProximityPlacementGroup	现有恢复邻近放置组输入。
ExistingRecoveryRecoveryResourceGroup	现有恢复资源组输入。
ExistingRecoveryVirtualNetwork	现有恢复虚拟网络输入。
ExistingStorageAccount	现有存储帐户输入。
KeyEncryptionKeyInfo	密钥加密密钥 （KEK） 信息。
NewProtectionProfile	新的保护配置文件输入。
NewRecoveryVirtualNetwork	恢复虚拟网络输入，用于从给定源网络创建新的虚拟网络。
ReplicationProtectionIntent	复制保护意向。
ReplicationProtectionIntentProperties	复制保护意向自定义数据详细信息。
SetMultiVmSyncStatus	一个值，该值指示是否必须启用多 VM 同步。 值应为“Enabled”或“Disabled”。
systemData	与创建和上次修改资源相关的元数据。

A2ACreateProtectionIntentInput

对象

A2A 创建保护意图输入。

名称	类型	默认值	说明
agentAutoUpdateStatus	AgentAutoUpdateStatus		一个值，该值指示是否启用自动更新。
autoProtectionOfDataDisk	AutoProtectionOfDataDisk		一个值，该值指示是否启用自动保护。
automationAccountArmId	string		自动化帐户 arm ID。
automationAccountAuthenticationType	AutomationAccountAuthenticationType	RunAsAccount	一个值，指示自动化帐户的身份验证类型。 默认值为“RunAsAccount”。
diskEncryptionInfo	DiskEncryptionInfo		恢复磁盘加密信息（对于两个传递流）。
fabricObjectId	string		虚拟机的构造特定对象 ID。
instanceType	string: A2A		类类型。
multiVmGroupId	string		多 VM 组 ID。
multiVmGroupName	string		多 VM 组名称。
primaryLocation	string		虚拟机的主要位置。
primaryStagingStorageAccountCustomInput	StorageAccountCustomDetails: ExistingStorageAccount		主暂存存储帐户输入。
protectionProfileCustomInput	ProtectionProfileCustomDetails: ExistingProtectionProfile NewProtectionProfile		保护配置文件自定义输入。
recoveryAvailabilitySetCustomInput	RecoveryAvailabilitySetCustomDetails: ExistingRecoveryAvailabilitySet		恢复可用性集输入。
recoveryAvailabilityType	A2ARecoveryAvailabilityType		虚拟机的恢复可用性类型。
recoveryAvailabilityZone	string		恢复可用性区域。
recoveryBootDiagStorageAccount	StorageAccountCustomDetails: ExistingStorageAccount		启动诊断存储帐户。
recoveryLocation	string		虚拟机的恢复位置。
recoveryProximityPlacementGroupCustomInput	RecoveryProximityPlacementGroupCustomDetails: ExistingRecoveryProximityPlacementGroup		恢复邻近放置组自定义输入。
recoveryResourceGroupId	string		恢复资源组 ID。对于 V2 方案有效。
recoverySubscriptionId	string		虚拟机的恢复订阅 ID。
recoveryVirtualNetworkCustomInput	RecoveryVirtualNetworkCustomDetails: ExistingRecoveryVirtualNetwork NewRecoveryVirtualNetwork		恢复虚拟网络输入。
vmDisks	A2AProtectionIntentDiskInputDetails[]		VM 磁盘输入的列表。
vmManagedDisks	A2AProtectionIntentManagedDiskInputDetails[]		VM 托管磁盘输入的列表。

A2AProtectionIntentDiskInputDetails

对象

Azure VM 非托管磁盘输入详细信息。

名称	类型	说明
diskUri	string	磁盘 URI。
primaryStagingStorageAccountCustomInput	StorageAccountCustomDetails: ExistingStorageAccount	主暂存存储帐户输入。
recoveryAzureStorageAccountCustomInput	StorageAccountCustomDetails: ExistingStorageAccount	恢复 VHD 存储帐户输入。

A2AProtectionIntentManagedDiskInputDetails

对象

Azure VM 托管磁盘输入详细信息。

名称	类型	说明
diskEncryptionInfo	DiskEncryptionInfo	恢复磁盘加密信息（对于一个/单一传递流）。
diskId	string	磁盘 ID。
primaryStagingStorageAccountCustomInput	StorageAccountCustomDetails: ExistingStorageAccount	主暂存存储帐户输入。
recoveryDiskEncryptionSetId	string	恢复磁盘加密集 ID。
recoveryReplicaDiskAccountType	string	副本磁盘类型。 其可选值，如果不是用户提供的，则与源磁盘类型相同。
recoveryResourceGroupCustomInput	RecoveryResourceGroupCustomDetails: ExistingRecoveryRecoveryResourceGroup	恢复资源组输入。
recoveryTargetDiskAccountType	string	故障转移后的目标磁盘类型。 其可选值，如果不是用户提供的，则与源磁盘类型相同。

A2ARecoveryAvailabilityType

枚举

虚拟机的恢复可用性类型。

值	说明
Single	Single
AvailabilitySet	AvailabilitySet
AvailabilityZone	可用性区域

A2AReplicationIntentDetails

对象

A2A 提供商特定设置。

名称	类型	默认值	说明
agentAutoUpdateStatus	AgentAutoUpdateStatus		一个值，该值指示是否启用自动更新。
autoProtectionOfDataDisk	AutoProtectionOfDataDisk		一个值，该值指示是否启用自动保护。
automationAccountArmId	string		自动化帐户 arm ID。
automationAccountAuthenticationType	AutomationAccountAuthenticationType	RunAsAccount	一个值，指示用于自动化帐户的类型身份验证。
diskEncryptionInfo	DiskEncryptionInfo		恢复磁盘加密信息（对于两个传递流）。
fabricObjectId	string		虚拟机的构造特定对象 ID。
instanceType	string: A2A		获取实例类型。
multiVmGroupId	string		多 VM 组 ID。
multiVmGroupName	string		多 VM 组名称。
primaryLocation	string		虚拟机的主要位置。
primaryStagingStorageAccount	StorageAccountCustomDetails: ExistingStorageAccount		主暂存存储帐户详细信息。
protectionProfile	ProtectionProfileCustomDetails: ExistingProtectionProfile NewProtectionProfile		保护配置文件自定义详细信息。
recoveryAvailabilitySet	RecoveryAvailabilitySetCustomDetails: ExistingRecoveryAvailabilitySet		恢复可用性集详细信息。
recoveryAvailabilityType	string		虚拟机的恢复可用性类型。
recoveryAvailabilityZone	string		恢复可用性区域。
recoveryBootDiagStorageAccount	StorageAccountCustomDetails: ExistingStorageAccount		启动诊断存储帐户。
recoveryLocation	string		虚拟机的恢复位置。
recoveryProximityPlacementGroup	RecoveryProximityPlacementGroupCustomDetails: ExistingRecoveryProximityPlacementGroup		恢复邻近放置组自定义详细信息。
recoveryResourceGroupId	string		恢复资源组 ID。
recoverySubscriptionId	string		虚拟机的恢复订阅 ID。
recoveryVirtualNetwork	RecoveryVirtualNetworkCustomDetails: ExistingRecoveryVirtualNetwork NewRecoveryVirtualNetwork		恢复虚拟网络详细信息。
vmDisks	A2AProtectionIntentDiskInputDetails[]		VM 磁盘详细信息的列表。
vmManagedDisks	A2AProtectionIntentManagedDiskInputDetails[]		VM 托管磁盘详细信息的列表。

AgentAutoUpdateStatus

枚举

一个值，该值指示是否启用自动更新。

值	说明
Disabled	已禁用
Enabled	已启用

AutomationAccountAuthenticationType

枚举

一个值，指示用于自动化帐户的类型身份验证。

值	说明
RunAsAccount	RunAsAccount
SystemAssignedIdentity	SystemAssignedIdentity

AutoProtectionOfDataDisk

枚举

一个值，该值指示是否启用自动保护。

值	说明
Disabled	已禁用
Enabled	已启用

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

CreateProtectionIntentInput

对象

创建保护意向输入。

名称	类型	说明
properties	CreateProtectionIntentProperties	创建保护意向输入属性。

CreateProtectionIntentProperties

对象

创建保护意向输入属性。

名称	类型	说明
providerSpecificDetails	CreateProtectionIntentProviderSpecificDetails: A2ACreateProtectionIntentInput	ReplicationProviderInput。 对于 A2A 提供程序，它将是 A2ACreateProtectionIntentInput 对象。

DiskEncryptionInfo

对象

恢复磁盘加密信息（BEK 和 KEK）。

名称	类型	说明
diskEncryptionKeyInfo	DiskEncryptionKeyInfo	机密的恢复 KeyVault 引用。
keyEncryptionKeyInfo	KeyEncryptionKeyInfo	密钥的恢复 KeyVault 参考。

DiskEncryptionKeyInfo

对象

磁盘加密密钥信息 （Windows 上的 BitLocker 加密密钥 （BEK） ） 。

名称	类型	说明
keyVaultResourceArmId	string	机密的 KeyVault 资源 ARM ID。
secretIdentifier	string	机密 URL/标识符。

ExistingProtectionProfile

对象

现有存储帐户输入。

名称	类型	说明
protectionProfileId	string	保护配置文件 Arm ID。如果资源不存在，则引发错误。
resourceType	string: Existing	类类型。

ExistingRecoveryAvailabilitySet

对象

现有恢复可用性集输入。

名称	类型	说明
recoveryAvailabilitySetId	string	恢复可用性集 ID。如果资源不存在，将引发错误。
resourceType	string: Existing	类类型。

ExistingRecoveryProximityPlacementGroup

对象

现有恢复邻近放置组输入。

名称	类型	说明
recoveryProximityPlacementGroupId	string	恢复邻近放置组 ID。如果资源不存在，将引发错误。
resourceType	string: Existing	类类型。

ExistingRecoveryRecoveryResourceGroup

对象

现有恢复资源组输入。

名称	类型	说明
recoveryResourceGroupId	string	恢复资源组 ID。对于 V2 方案有效。
resourceType	string: Existing	类类型。

ExistingRecoveryVirtualNetwork

对象

现有恢复虚拟网络输入。

名称	类型	说明
recoverySubnetName	string	恢复子网名称。
recoveryVirtualNetworkId	string	恢复虚拟网络 ID。如果资源不存在，将引发错误。
resourceType	string: Existing	类类型。

ExistingStorageAccount

对象

现有存储帐户输入。

名称	类型	说明
azureStorageAccountId	string	存储帐户 Arm ID。如果资源不存在，则引发错误。
resourceType	string: Existing	类类型。

KeyEncryptionKeyInfo

对象

密钥加密密钥 （KEK） 信息。

名称	类型	说明
keyIdentifier	string	密钥 URL/标识符。
keyVaultResourceArmId	string	密钥的 KeyVault 资源 ARM ID。

NewProtectionProfile

对象

新的保护配置文件输入。

名称	类型	说明
appConsistentFrequencyInMinutes	integer (int32)	应用一致的快照频率（以分钟为单位）。
crashConsistentFrequencyInMinutes	integer (int32)	崩溃一致的快照频率（以分钟为单位）。
multiVmSyncStatus	SetMultiVmSyncStatus	一个值，该值指示是否必须启用多 VM 同步。 值应为“Enabled”或“Disabled”。
policyName	string	保护配置文件输入。
recoveryPointHistory	integer (int32)	恢复点需要存储到的持续时间（以分钟为单位）。
resourceType	string: New	类类型。

NewRecoveryVirtualNetwork

对象

恢复虚拟网络输入，用于从给定源网络创建新的虚拟网络。

名称	类型	说明
recoveryVirtualNetworkName	string	恢复虚拟网络名称。
recoveryVirtualNetworkResourceGroupName	string	要用于创建恢复虚拟网络的资源组的名称。 如果不存在，则会在与目标 VM 相同的资源组中创建目标网络。
resourceType	string: New	类类型。

ReplicationProtectionIntent

对象

复制保护意向。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。 例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location	string	资源位置
name	string	资源的名称
properties	ReplicationProtectionIntentProperties	自定义数据。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。 例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ReplicationProtectionIntentProperties

对象

复制保护意向自定义数据详细信息。

名称	类型	说明
creationTimeUTC	string	创建时间（UTC）。
friendlyName	string	名称。
isActive	boolean	指示意向对象是否处于活动状态的值。
jobId	string	作业 ID。
jobState	string	作业状态。
providerSpecificDetails	ReplicationProtectionIntentProviderSpecificSettings: A2AReplicationIntentDetails	复制提供程序自定义设置。

SetMultiVmSyncStatus

枚举

一个值，该值指示是否必须启用多 VM 同步。 值应为“Enabled”或“Disabled”。

值	说明
Enable	启用
Disable	禁用

systemData

对象

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	资源上次修改的时间戳 （UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。