Compartilhar via


Replication Protection Intents - Create

Criar recurso de intenção de proteção.
A operação para criar um item de intenção de proteção de replicação ASR.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
intentObjectName
path True

string

Nome da intenção de proteção de replicação.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

resourceName
path True

string

O nome do Vault

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
properties

CreateProtectionIntentProperties

Criar propriedades de entrada de intenção de proteção.

Respostas

Nome Tipo Description
200 OK

ReplicationProtectionIntent

Operação de atualização do recurso 'ReplicationProtectionIntent' bem-sucedida

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Create protection intent Resource.

Solicitação de exemplo

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"
    }
  }
}

Resposta de exemplo

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"
    }
  }
}

Definições

Nome Description
A2ACreateProtectionIntentInput

A2A cria entrada de intenção de proteção.

A2AProtectionIntentDiskInputDetails

Detalhes de entrada de disco não gerenciado da VM do Azure.

A2AProtectionIntentManagedDiskInputDetails

Detalhes de entrada do disco gerenciado da VM do Azure.

A2ARecoveryAvailabilityType

O tipo de disponibilidade de recuperação da máquina virtual.

A2AReplicationIntentDetails

Configurações específicas do provedor A2A.

AgentAutoUpdateStatus

Um valor que indica se a atualização automática está habilitada.

AutomationAccountAuthenticationType

Um valor que indica a autenticação de tipo a ser usada para a conta de automação.

AutoProtectionOfDataDisk

Um valor que indica se a proteção automática está habilitada.

createdByType

O tipo de identidade que criou o recurso.

CreateProtectionIntentInput

Crie uma entrada de intenção de proteção.

CreateProtectionIntentProperties

Criar propriedades de entrada de intenção de proteção.

DiskEncryptionInfo

Informações de criptografia do disco de recuperação (BEK e KEK).

DiskEncryptionKeyInfo

Informações da chave de criptografia de disco (BEK (chave de criptografia do BitLocker) no Windows).

ExistingProtectionProfile

Entrada da conta de armazenamento existente.

ExistingRecoveryAvailabilitySet

Entrada do conjunto de disponibilidade de recuperação existente.

ExistingRecoveryProximityPlacementGroup

Entrada do grupo de posicionamento de proximidade de recuperação existente.

ExistingRecoveryRecoveryResourceGroup

Entrada do grupo de recursos de recuperação existente.

ExistingRecoveryVirtualNetwork

Entrada de rede virtual de recuperação existente.

ExistingStorageAccount

Entrada da conta de armazenamento existente.

KeyEncryptionKeyInfo

Informações de chave de criptografia de chave (KEK).

NewProtectionProfile

Nova entrada de perfil de proteção.

NewRecoveryVirtualNetwork

Entrada de rede virtual de recuperação para criar uma nova rede virtual a partir de determinada rede de origem.

ReplicationProtectionIntent

Intenção de proteção de replicação.

ReplicationProtectionIntentProperties

Detalhes de dados personalizados da intenção de proteção de replicação.

SetMultiVmSyncStatus

Um valor que indica se a sincronização de várias VMs deve ser habilitada. O valor deve ser "Habilitado" ou "Desabilitado".

systemData

Metadados relativos à criação e última modificação do recurso.

A2ACreateProtectionIntentInput

A2A cria entrada de intenção de proteção.

Nome Tipo Valor padrão Description
agentAutoUpdateStatus

AgentAutoUpdateStatus

Um valor que indica se a atualização automática está habilitada.

autoProtectionOfDataDisk

AutoProtectionOfDataDisk

Um valor que indica se a proteção automática está habilitada.

automationAccountArmId

string

A ID do braço da conta de automação.

automationAccountAuthenticationType

AutomationAccountAuthenticationType

RunAsAccount

Um valor que indica o tipo de autenticação para a conta de automação. O valor padrão é "RunAsAccount".

diskEncryptionInfo

DiskEncryptionInfo

As informações de criptografia de disco de recuperação (para dois fluxos de passagem).

fabricObjectId

string

A ID de objeto específica da malha da máquina virtual.

instanceType string:

A2A

O tipo de classe.

multiVmGroupId

string

A ID do grupo de várias VMs.

multiVmGroupName

string

O nome do grupo de várias VMs.

primaryLocation

string

O local principal da máquina virtual.

primaryStagingStorageAccountCustomInput StorageAccountCustomDetails:

ExistingStorageAccount

A entrada da conta de armazenamento de preparo primário.

protectionProfileCustomInput ProtectionProfileCustomDetails:

As entradas personalizadas do perfil de proteção.

recoveryAvailabilitySetCustomInput RecoveryAvailabilitySetCustomDetails:

ExistingRecoveryAvailabilitySet

A entrada do conjunto de disponibilidade de recuperação.

recoveryAvailabilityType

A2ARecoveryAvailabilityType

O tipo de disponibilidade de recuperação da máquina virtual.

recoveryAvailabilityZone

string

A zona de disponibilidade de recuperação.

recoveryBootDiagStorageAccount StorageAccountCustomDetails:

ExistingStorageAccount

A conta de armazenamento de diagnóstico de inicialização.

recoveryLocation

string

O local de recuperação da máquina virtual.

recoveryProximityPlacementGroupCustomInput RecoveryProximityPlacementGroupCustomDetails:

ExistingRecoveryProximityPlacementGroup

A entrada personalizada do grupo de posicionamento por proximidade de recuperação.

recoveryResourceGroupId

string

A ID do grupo de recursos de recuperação. Válida para cenários V2.

recoverySubscriptionId

string

A ID da assinatura de recuperação da máquina virtual.

recoveryVirtualNetworkCustomInput RecoveryVirtualNetworkCustomDetails:

A entrada de rede virtual de recuperação.

vmDisks

A2AProtectionIntentDiskInputDetails[]

A lista de entradas de disco de VM.

vmManagedDisks

A2AProtectionIntentManagedDiskInputDetails[]

A lista de entradas de disco gerenciado de VM.

A2AProtectionIntentDiskInputDetails

Detalhes de entrada de disco não gerenciado da VM do Azure.

Nome Tipo Description
diskUri

string

O Uri do disco.

primaryStagingStorageAccountCustomInput StorageAccountCustomDetails:

ExistingStorageAccount

A entrada da conta de armazenamento de preparo primário.

recoveryAzureStorageAccountCustomInput StorageAccountCustomDetails:

ExistingStorageAccount

A entrada da conta de armazenamento VHD de recuperação.

A2AProtectionIntentManagedDiskInputDetails

Detalhes de entrada do disco gerenciado da VM do Azure.

Nome Tipo Description
diskEncryptionInfo

DiskEncryptionInfo

As informações de criptografia de disco de recuperação (para um/fluxos de passagem única).

diskId

string

A ID do disco.

primaryStagingStorageAccountCustomInput StorageAccountCustomDetails:

ExistingStorageAccount

A entrada da conta de armazenamento de preparo primário.

recoveryDiskEncryptionSetId

string

A ID do conjunto de criptografia de disco de recuperação.

recoveryReplicaDiskAccountType

string

O tipo de disco de réplica. É um valor opcional e será igual ao tipo de disco de origem se não for fornecido pelo usuário.

recoveryResourceGroupCustomInput RecoveryResourceGroupCustomDetails:

ExistingRecoveryRecoveryResourceGroup

A entrada do grupo de recursos de recuperação.

recoveryTargetDiskAccountType

string

O tipo de disco de destino após o failover. É um valor opcional e será igual ao tipo de disco de origem se não for fornecido pelo usuário.

A2ARecoveryAvailabilityType

O tipo de disponibilidade de recuperação da máquina virtual.

Valor Description
Single

Solteiro

AvailabilitySet

AvailabilitySet

AvailabilityZone

Zona de Disponibilidade

A2AReplicationIntentDetails

Configurações específicas do provedor A2A.

Nome Tipo Valor padrão Description
agentAutoUpdateStatus

AgentAutoUpdateStatus

Um valor que indica se a atualização automática está habilitada.

autoProtectionOfDataDisk

AutoProtectionOfDataDisk

Um valor que indica se a proteção automática está habilitada.

automationAccountArmId

string

A ID do braço da conta de automação.

automationAccountAuthenticationType

AutomationAccountAuthenticationType

RunAsAccount

Um valor que indica a autenticação de tipo a ser usada para a conta de automação.

diskEncryptionInfo

DiskEncryptionInfo

As informações de criptografia de disco de recuperação (para dois fluxos de passagem).

fabricObjectId

string

A ID de objeto específica da malha da máquina virtual.

instanceType string:

A2A

Obtém o tipo de instância.

multiVmGroupId

string

A ID do grupo de várias VMs.

multiVmGroupName

string

O nome do grupo de várias VMs.

primaryLocation

string

O local principal da máquina virtual.

primaryStagingStorageAccount StorageAccountCustomDetails:

ExistingStorageAccount

Os detalhes da conta de armazenamento de preparo principal.

protectionProfile ProtectionProfileCustomDetails:

Os detalhes personalizados do perfil de proteção.

recoveryAvailabilitySet RecoveryAvailabilitySetCustomDetails:

ExistingRecoveryAvailabilitySet

Os detalhes do conjunto de disponibilidade de recuperação.

recoveryAvailabilityType

string

O tipo de disponibilidade de recuperação da máquina virtual.

recoveryAvailabilityZone

string

A zona de disponibilidade de recuperação.

recoveryBootDiagStorageAccount StorageAccountCustomDetails:

ExistingStorageAccount

A conta de armazenamento de diagnóstico de inicialização.

recoveryLocation

string

O local de recuperação da máquina virtual.

recoveryProximityPlacementGroup RecoveryProximityPlacementGroupCustomDetails:

ExistingRecoveryProximityPlacementGroup

Os detalhes personalizados do grupo de posicionamento por proximidade de recuperação.

recoveryResourceGroupId

string

A ID do grupo de recursos de recuperação.

recoverySubscriptionId

string

A ID da assinatura de recuperação da máquina virtual.

recoveryVirtualNetwork RecoveryVirtualNetworkCustomDetails:

Os detalhes da rede virtual de recuperação.

vmDisks

A2AProtectionIntentDiskInputDetails[]

A lista de detalhes do disco de VM.

vmManagedDisks

A2AProtectionIntentManagedDiskInputDetails[]

A lista de detalhes do disco gerenciado da VM.

AgentAutoUpdateStatus

Um valor que indica se a atualização automática está habilitada.

Valor Description
Disabled

Desabilitado

Enabled

Enabled

AutomationAccountAuthenticationType

Um valor que indica a autenticação de tipo a ser usada para a conta de automação.

Valor Description
RunAsAccount

RunAsAccount

SystemAssignedIdentity

Identidade Atribuída pelo Sistema

AutoProtectionOfDataDisk

Um valor que indica se a proteção automática está habilitada.

Valor Description
Disabled

Desabilitado

Enabled

Enabled

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

CreateProtectionIntentInput

Crie uma entrada de intenção de proteção.

Nome Tipo Description
properties

CreateProtectionIntentProperties

Criar propriedades de entrada de intenção de proteção.

CreateProtectionIntentProperties

Criar propriedades de entrada de intenção de proteção.

Nome Tipo Description
providerSpecificDetails CreateProtectionIntentProviderSpecificDetails:

A2ACreateProtectionIntentInput

O ReplicationProviderInput. Para o provedor A2A, será o objeto A2ACreateProtectionIntentInput.

DiskEncryptionInfo

Informações de criptografia do disco de recuperação (BEK e KEK).

Nome Tipo Description
diskEncryptionKeyInfo

DiskEncryptionKeyInfo

A referência keyvault de recuperação para segredo.

keyEncryptionKeyInfo

KeyEncryptionKeyInfo

A referência keyVault de recuperação para chave.

DiskEncryptionKeyInfo

Informações da chave de criptografia de disco (BEK (chave de criptografia do BitLocker) no Windows).

Nome Tipo Description
keyVaultResourceArmId

string

A ID do ARM do recurso KeyVault para segredo.

secretIdentifier

string

A url/identificador do segredo.

ExistingProtectionProfile

Entrada da conta de armazenamento existente.

Nome Tipo Description
protectionProfileId

string

A ID do Braço do perfil de proteção. Gerar erro, se o recurso não existir.

resourceType string:

Existing

O tipo de classe.

ExistingRecoveryAvailabilitySet

Entrada do conjunto de disponibilidade de recuperação existente.

Nome Tipo Description
recoveryAvailabilitySetId

string

A ID do conjunto de disponibilidade de recuperação. Gerará um erro se o recurso não existir.

resourceType string:

Existing

O tipo de classe.

ExistingRecoveryProximityPlacementGroup

Entrada do grupo de posicionamento de proximidade de recuperação existente.

Nome Tipo Description
recoveryProximityPlacementGroupId

string

A ID do grupo de posicionamento por proximidade de recuperação. Gerará um erro se o recurso não existir.

resourceType string:

Existing

O tipo de classe.

ExistingRecoveryRecoveryResourceGroup

Entrada do grupo de recursos de recuperação existente.

Nome Tipo Description
recoveryResourceGroupId

string

A ID do grupo de recursos de recuperação. Válida para cenários V2.

resourceType string:

Existing

O tipo de classe.

ExistingRecoveryVirtualNetwork

Entrada de rede virtual de recuperação existente.

Nome Tipo Description
recoverySubnetName

string

O nome da sub-rede de recuperação.

recoveryVirtualNetworkId

string

A ID da rede virtual de recuperação. Gerará um erro se o recurso não existir.

resourceType string:

Existing

O tipo de classe.

ExistingStorageAccount

Entrada da conta de armazenamento existente.

Nome Tipo Description
azureStorageAccountId

string

A ID do Braço da conta de armazenamento. Gerar erro, se o recurso não existir.

resourceType string:

Existing

O tipo de classe.

KeyEncryptionKeyInfo

Informações de chave de criptografia de chave (KEK).

Nome Tipo Description
keyIdentifier

string

A URL/identificador da chave.

keyVaultResourceArmId

string

A ID do ARM do recurso KeyVault para chave.

NewProtectionProfile

Nova entrada de perfil de proteção.

Nome Tipo Description
appConsistentFrequencyInMinutes

integer (int32)

A frequência de instantâneo consistente do aplicativo (em minutos).

crashConsistentFrequencyInMinutes

integer (int32)

A frequência de instantâneo consistente de falha (em minutos).

multiVmSyncStatus

SetMultiVmSyncStatus

Um valor que indica se a sincronização de várias VMs deve ser habilitada. O valor deve ser "Habilitado" ou "Desabilitado".

policyName

string

A entrada do perfil de proteção.

recoveryPointHistory

integer (int32)

A duração em minutos até que os pontos de recuperação precisem ser armazenados.

resourceType string:

New

O tipo de classe.

NewRecoveryVirtualNetwork

Entrada de rede virtual de recuperação para criar uma nova rede virtual a partir de determinada rede de origem.

Nome Tipo Description
recoveryVirtualNetworkName

string

O nome da rede virtual de recuperação.

recoveryVirtualNetworkResourceGroupName

string

O nome do grupo de recursos a ser usado para criar a rede virtual de recuperação. Se ausente, a rede de destino seria criada no mesmo grupo de recursos que a VM de destino.

resourceType string:

New

O tipo de classe.

ReplicationProtectionIntent

Intenção de proteção de replicação.

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Local do recurso

name

string

O nome do recurso

properties

ReplicationProtectionIntentProperties

Os dados personalizados.

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ReplicationProtectionIntentProperties

Detalhes de dados personalizados da intenção de proteção de replicação.

Nome Tipo Description
creationTimeUTC

string

A hora de criação em UTC.

friendlyName

string

O nome.

isActive

boolean

Um valor que indica se o objeto de intenção está ativo.

jobId

string

O ID do trabalho.

jobState

string

O estado do trabalho.

providerSpecificDetails ReplicationProtectionIntentProviderSpecificSettings:

A2AReplicationIntentDetails

As configurações personalizadas do provedor de replicação.

SetMultiVmSyncStatus

Um valor que indica se a sincronização de várias VMs deve ser habilitada. O valor deve ser "Habilitado" ou "Desabilitado".

Valor Description
Enable

Enable

Disable

Disable

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.