Replication Protection Clusters - Get

Servizio:: Recovery Services - Site Recovery

Versione API:: 2026-01-01

Ottiene i dettagli di un cluster di protezione da replica.
Ottiene i dettagli di un cluster di protezione della replica ASR.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationProtectionContainers/{protectionContainerName}/replicationProtectionClusters/{replicationProtectionClusterName}?api-version=2026-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
fabricName	path	True	string pattern: ^[A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9]$	Fabric name.
protectionContainerName	path	True	string pattern: ^[A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9]$	Nome del contenitore di protezione.
replicationProtectionClusterName	path	True	string pattern: ^[A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9]$	Nome del cluster di protezione dalla replica.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
resourceName	path	True	string pattern: ^[A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9]$	Nome dell'insieme di credenziali di Servizi di ripristino.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ReplicationProtectionCluster	Operazione Azure completata con successo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Gets the details of a Replication protection cluster.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/eastus/replicationProtectionContainers/eastus-container/replicationProtectionClusters/cluster1?api-version=2026-01-01

Risposta di esempio

Codice di stato:: 200

{
  "name": "cluster1",
  "type": "Microsoft.RecoveryServices/vaults/replicationFabrics/replicationProtectionContainers/replicationProtectionClusters",
  "id": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/eastus/replicationProtectionContainers/eastus-container/replicationProtectionClusters/cluster1",
  "properties": {
    "activeLocation": "Primary",
    "agentClusterId": "dd9925cf-5f90-49e9-bd6d-d4cbdcec956b",
    "allowedOperations": [
      "UnplannedFailover",
      "DisableProtection"
    ],
    "areAllClusterNodesRegistered": true,
    "clusterFqdn": "ad45f2fc-f9d6-42ac-8a7c-1c5380c88c28",
    "clusterNodeFqdns": [],
    "clusterProtectedItemIds": [
      "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/eastus/replicationProtectionContainers/eastus-container/replicationProtectedItems/cluster2vm0",
      "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/eastus/replicationProtectionContainers/eastus-container/replicationProtectedItems/cluster2vm1"
    ],
    "clusterRegisteredNodes": [
      {
        "biosId": "eed7a457-b11f-420e-8e4f-384833a6b7c9",
        "clusterNodeFqdn": "VM0",
        "isSharedDiskVirtualNode": true,
        "machineId": "a7eaf02d-60d9-45be-a444-d1b945f1c7b2"
      }
    ],
    "currentScenario": null,
    "healthErrors": [],
    "lastSuccessfulFailoverTime": null,
    "policyFriendlyName": "24-hour-retention-policy",
    "policyId": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationPolicies/24-hour-retention-policy",
    "primaryFabricFriendlyName": "eastus",
    "primaryFabricProvider": "AzureFabric",
    "primaryProtectionContainerFriendlyName": "eastus",
    "protectionClusterType": "WindowsServerFailoverCluster",
    "protectionState": "Protected",
    "protectionStateDescription": "Protected",
    "providerSpecificDetails": {
      "clusterManagementId": "1ed32804-ae51-4752-9448-9f686ae27d7b",
      "failoverRecoveryPointId": null,
      "initialPrimaryExtendedLocation": null,
      "initialPrimaryFabricLocation": "eastus",
      "initialPrimaryZone": "",
      "initialRecoveryExtendedLocation": null,
      "initialRecoveryFabricLocation": "centraluseuap",
      "initialRecoveryZone": "",
      "instanceType": "A2A",
      "lastRpoCalculatedTime": null,
      "lifecycleId": null,
      "multiVmGroupCreateOption": "UserSpecified",
      "multiVmGroupId": "4c2988ed-7e2a-566e-9c5f-c33835621e83",
      "multiVmGroupName": "multiVmGroupName1111",
      "primaryAvailabilityZone": null,
      "primaryExtendedLocation": null,
      "primaryFabricLocation": "eastus",
      "recoveryAvailabilityZone": null,
      "recoveryExtendedLocation": null,
      "recoveryFabricLocation": "centraluseuap",
      "rpoInSeconds": null
    },
    "provisioningState": "Created",
    "recoveryContainerId": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/centraluseuap/replicationProtectionContainers/centraluseuap-container",
    "recoveryFabricFriendlyName": "centraluseuap",
    "recoveryFabricId": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/centraluseuap",
    "recoveryProtectionContainerFriendlyName": "eastus-container",
    "replicationHealth": "Normal",
    "sharedDiskProperties": {
      "activeLocation": null,
      "allowedOperations": [],
      "currentScenario": null,
      "healthErrors": [],
      "protectionState": "Protected",
      "replicationHealth": "Normal",
      "sharedDiskProviderSpecificDetails": {
        "failoverRecoveryPointId": null,
        "instanceType": "A2A",
        "lastRpoCalculatedTime": "2022-11-11T07:34:58.856Z",
        "managementId": "1ed32804-ae51-4752-9448-9f686ae27d7b",
        "monitoringJobType": null,
        "monitoringPercentageCompletion": null,
        "primaryFabricLocation": "eastus",
        "protectedManagedDisks": [
          {
            "allowedDiskLevelOperation": [],
            "dataPendingAtSourceAgentInMB": 10,
            "dataPendingInStagingStorageAccountInMB": 100,
            "dekKeyVaultArmId": null,
            "diskCapacityInBytes": 0,
            "diskId": "/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourcegroups/resourceGroupPS2/providers/microsoft.compute/disks/cluster2-datadisk0",
            "diskName": "cluster2-datadisk0",
            "diskState": "Unavailable",
            "diskType": "Data",
            "failoverDiskName": "cluster2-datadisk0",
            "isDiskEncrypted": false,
            "isDiskKeyEncrypted": false,
            "kekKeyVaultArmId": null,
            "keyIdentifier": null,
            "monitoringJobType": null,
            "monitoringPercentageCompletion": null,
            "primaryDiskEncryptionSetId": null,
            "primaryStagingAzureStorageAccountId": "/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS2/providers/Microsoft.Storage/storageAccounts/eastus1210192341",
            "recoveryDiskEncryptionSetId": null,
            "recoveryOrignalTargetDiskId": null,
            "recoveryReplicaDiskAccountType": "Premium_LRS",
            "recoveryReplicaDiskId": "/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.Compute/disks/cluster2-datadisk0-ASRReplica",
            "recoveryResourceGroupId": "/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1",
            "recoveryTargetDiskAccountType": "Premium_LRS",
            "recoveryTargetDiskId": null,
            "resyncRequired": true,
            "secretIdentifier": null,
            "tfoDiskName": "cluster2-datadisk0-ASRtest"
          }
        ],
        "recoveryFabricLocation": "centraluseuap",
        "rpoInSeconds": 300,
        "sharedDiskIRErrors": null,
        "unprotectedDisks": [
          {
            "diskAutoProtectionStatus": "Disabled",
            "diskLunId": 1
          },
          {
            "diskAutoProtectionStatus": "Disabled",
            "diskLunId": 2
          }
        ]
      }
    }
  }
}

Definizioni

Nome	Descrizione
A2AProtectedManagedDiskDetails	Dettagli del disco gestito protetto A2A.
A2AReplicationProtectionClusterDetails	Impostazioni specifiche del provider A2A.
A2ASharedDiskIRErrorDetails	Posizione estesa della risorsa.
A2ASharedDiskReplicationDetails	Impostazioni specifiche del provider A2A.
A2AUnprotectedDiskDetails	Dettagli del disco non protetto A2A.
AutoProtectionOfDataDisk	Valore che indica se la protezione automatica è abilitata.
createdByType	Tipo di identità che ha creato la risorsa.
CurrentScenarioDetails	Dettagli dello scenario corrente dell'entità protetta.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocation	Posizione estesa della risorsa.
ExtendedLocationType	Tipo di posizione estesa.
HealthError	Errore di integrità.
HealthErrorCustomerResolvability	Valore che indica se l'errore di integrità è risolvibile dal cliente.
InnerHealthError	Implementa la classe InnerHealthError. L'oggetto HealthError contiene un elenco di InnerHealthErrors come errori figlio. InnerHealthError viene usato perché questo impedisce un loop infinito di strutture quando Hydra cerca di generare automaticamente il contratto. Vengono esposti gli errori di integrità correlati come errori di integrità interni e tutti i consumer di API possono usarli nello stesso modo di Exception -> InnerException.
MultiVmGroupCreateOption	Indica se il gruppo di più macchine virtuali viene creato automaticamente o specificato dall'utente.
RegisteredClusterNodes	Posizione estesa della risorsa.
ReplicationProtectionCluster	Cluster di protezione dalla replica.
ReplicationProtectionClusterProperties	Dettagli dei dati personalizzati del cluster di protezione dalla replica.
SharedDiskReplicationItemProperties	Dettagli dei dati personalizzati dell'elemento Replica disco condiviso.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

A2AProtectedManagedDiskDetails

Oggetto

Dettagli del disco gestito protetto A2A.

Nome	Tipo	Descrizione
allowedDiskLevelOperation	string[]	Elenco delle operazioni a livello di disco.
dataPendingAtSourceAgentInMB	number (double)	Dati in sospeso nella macchina virtuale di origine in MB.
dataPendingInStagingStorageAccountInMB	number (double)	Dati in sospeso per la replica in MB nell'account di staging.
dekKeyVaultArmId	string	ID risorsa KeyVault per il segreto (BEK).
diskCapacityInBytes	integer (int64)	Capacità del disco in byte.
diskId	string	ID arm del disco gestito.
diskName	string	Nome del disco.
diskState	string	Stato del disco.
diskType	string	Tipo di disco.
failoverDiskName	string	Nome del failover per il disco gestito.
isDiskEncrypted	boolean	Valore che indica se la macchina virtuale ha o meno un disco del sistema operativo crittografato.
isDiskKeyEncrypted	boolean	Valore che indica se la chiave del disco è stata crittografata o meno.
kekKeyVaultArmId	string	ID risorsa KeyVault per la chiave (KEK).
keyIdentifier	string	URL chiave/identificatore (KEK).
monitoringJobType	string	Tipo del processo di monitoraggio. Lo stato di avanzamento è contenuto nella proprietà MonitoringPercentageCompletion.
monitoringPercentageCompletion	integer (int32)	Percentuale del processo di monitoraggio. Il tipo del processo di monitoraggio è definito dalla proprietà MonitoringJobType.
primaryDiskEncryptionSetId	string	ID del set di crittografia del disco primario.
primaryStagingAzureStorageAccountId	string	L'account principale di staging storage.
recoveryDiskEncryptionSetId	string	ID del set di crittografia del disco di ripristino.
recoveryOrignalTargetDiskId	string	ID arm del disco di destinazione originale di ripristino.
recoveryReplicaDiskAccountType	string	Tipo di disco di replica. Il valore facoltativo e sarà uguale al tipo di disco di origine se non è stato specificato dall'utente.
recoveryReplicaDiskId	string	ID arm del disco della replica di ripristino.
recoveryResourceGroupId	string	ID arm del gruppo di risorse del disco di ripristino.
recoveryTargetDiskAccountType	string	Tipo di disco di destinazione dopo il failover. Il valore facoltativo e sarà uguale al tipo di disco di origine se non è stato specificato dall'utente.
recoveryTargetDiskId	string	ID arm del disco di destinazione di ripristino.
resyncRequired	boolean	Valore che indica se la risincronizzazione è necessaria per questo disco.
secretIdentifier	string	URL/identificatore del segreto (BEK).
tfoDiskName	string	Nome del failover di test per il disco gestito.

A2AReplicationProtectionClusterDetails

Oggetto

Impostazioni specifiche del provider A2A.

Nome	Tipo	Descrizione
clusterManagementId	string	ID di gestione del cluster.
failoverRecoveryPointId	string	ID del punto di ripristino a cui è stato eseguito il failover del cluster.
initialPrimaryExtendedLocation	ExtendedLocation	Posizione estesa primaria iniziale.
initialPrimaryFabricLocation	string	Posizione iniziale dell'infrastruttura primaria.
initialPrimaryZone	string	Zona di disponibilità primaria iniziale.
initialRecoveryExtendedLocation	ExtendedLocation	Posizione estesa del ripristino iniziale.
initialRecoveryFabricLocation	string	Posizione iniziale dell'infrastruttura di ripristino.
initialRecoveryZone	string	Zona di disponibilità di ripristino iniziale.
instanceType	string: A2A	Ottiene il tipo di istanza.
lastRpoCalculatedTime	string (date-time)	Ora (in formato UTC) in cui l'ultimo valore RPO è stato calcolato dal servizio protezione.
lifecycleId	string	ID che sopravvive a azioni come la protezione switch che modifica internamente gli oggetti PE/CPE di backup. L'ID ciclo di vita viene portato avanti per avere un collegamento/continuità in grado di avere un ID che denota il cluster protetto "stesso" anche se altri ID interni/ID ARM potrebbero cambiare.
multiVmGroupCreateOption	MultiVmGroupCreateOption	Indica se il gruppo di più macchine virtuali viene creato automaticamente o specificato dall'utente.
multiVmGroupId	string	ID gruppo di più macchine virtuali.
multiVmGroupName	string	Nome del gruppo di più macchine virtuali.
primaryAvailabilityZone	string	Zona di disponibilità primaria.
primaryExtendedLocation	ExtendedLocation	Posizione estesa primaria.
primaryFabricLocation	string	Posizione dell'infrastruttura primaria.
recoveryAvailabilityZone	string	Zona di disponibilità di ripristino.
recoveryExtendedLocation	ExtendedLocation	Percorso esteso di ripristino.
recoveryFabricLocation	string	Posizione dell'infrastruttura di ripristino.
rpoInSeconds	integer (int64)	Ultimo valore RPO in secondi.

A2ASharedDiskIRErrorDetails

Oggetto

Posizione estesa della risorsa.

Nome	Tipo	Descrizione
errorCode	string	Codice di errore.
errorCodeEnum	string	Il codice di errore enumerazione.
errorMessage	string	Messaggio di errore.
possibleCauses	string	Le possibili cause.
recommendedAction	string	L'azione consigliata.

A2ASharedDiskReplicationDetails

Oggetto

Impostazioni specifiche del provider A2A.

Nome	Tipo	Descrizione
failoverRecoveryPointId	string	ID del punto di ripristino a cui è stato eseguito il failover del nodo virtuale.
instanceType	string: A2A	Ottiene il tipo di istanza.
lastRpoCalculatedTime	string (date-time)	Ora (in formato UTC) in cui l'ultimo valore RPO è stato calcolato dal servizio protezione.
managementId	string	ID di gestione.
monitoringJobType	string	Tipo del processo di monitoraggio. Lo stato di avanzamento è contenuto nella proprietà MonitoringPercentageCompletion.
monitoringPercentageCompletion	integer (int32)	Percentuale del processo di monitoraggio. Il tipo del processo di monitoraggio è definito dalla proprietà MonitoringJobType.
primaryFabricLocation	string	Posizione dell'infrastruttura primaria.
protectedManagedDisks	A2AProtectedManagedDiskDetails[]	L'elenco dei protected managed disks.
recoveryFabricLocation	string	Posizione dell'infrastruttura di ripristino.
rpoInSeconds	integer (int64)	Ultimo valore RPO in secondi.
sharedDiskIRErrors	A2ASharedDiskIRErrorDetails[]	Errori del runtime di integrazione.
unprotectedDisks	A2AUnprotectedDiskDetails[]	Elenco di dischi non protetti.

A2AUnprotectedDiskDetails

Oggetto

Dettagli del disco non protetto A2A.

Nome	Tipo	Descrizione
diskAutoProtectionStatus	AutoProtectionOfDataDisk	Valore che indica se la protezione automatica del disco è abilitata.
diskLunId	integer (int32)	ID lun di origine per il disco dati.

AutoProtectionOfDataDisk

Enumerazione

Valore che indica se la protezione automatica è abilitata.

Valore	Descrizione
Disabled	Disattivato
Enabled	Enabled

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

CurrentScenarioDetails

Oggetto

Dettagli dello scenario corrente dell'entità protetta.

Nome	Tipo	Descrizione
jobId	string	ID ARM del processo in esecuzione.
scenarioName	string	Nome dello scenario.
startTime	string (date-time)	Ora di inizio del flusso di lavoro.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Oggetto

Posizione estesa della risorsa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationType	Tipo di posizione estesa.

ExtendedLocationType

Enumerazione

Tipo di posizione estesa.

Valore	Descrizione
EdgeZone	EdgeZone

HealthError

Oggetto

Errore di integrità.

Nome	Tipo	Descrizione
creationTimeUtc	string (date-time)	Ora di creazione degli errori (UTC).
customerResolvability	HealthErrorCustomerResolvability	Valore che indica se l'errore di integrità è risolvibile dal cliente.
entityId	string	ID dell'entità.
errorCategory	string	Categoria di errore.
errorCode	string	Codice di errore.
errorId	string	ID univoco dell'errore di integrità.
errorLevel	string	Livello di errore.
errorMessage	string	Messaggio di errore.
errorSource	string	Origine dell'errore.
errorType	string	Tipo di errore.
innerHealthErrors	InnerHealthError[]	Errori di integrità interni. HealthError con un elenco di HealthError perché gli errori figlio sono problematici. InnerHealthError viene usato perché questo impedisce un loop infinito di strutture quando Hydra cerca di generare automaticamente il contratto. Vengono esposti gli errori di integrità correlati come errori di integrità interni e tutti i consumer di API possono usarli nello stesso modo di Exception -> InnerException.
possibleCauses	string	Possibili cause di errore.
recommendedAction	string	Azione consigliata per risolvere l'errore.
recoveryProviderErrorMessage	string	Messaggio di errore dra.
summaryMessage	string	Messaggio di riepilogo dell'entità.

HealthErrorCustomerResolvability

Enumerazione

Valore che indica se l'errore di integrità è risolvibile dal cliente.

Valore	Descrizione
Allowed	Consentito
NotAllowed	NonConsentito

InnerHealthError

Oggetto

Implementa la classe InnerHealthError. L'oggetto HealthError contiene un elenco di InnerHealthErrors come errori figlio. InnerHealthError viene usato perché questo impedisce un loop infinito di strutture quando Hydra cerca di generare automaticamente il contratto. Vengono esposti gli errori di integrità correlati come errori di integrità interni e tutti i consumer di API possono usarli nello stesso modo di Exception -> InnerException.

Nome	Tipo	Descrizione
creationTimeUtc	string (date-time)	Ora di creazione degli errori (UTC).
customerResolvability	HealthErrorCustomerResolvability	Valore che indica se l'errore di integrità è risolvibile dal cliente.
entityId	string	ID dell'entità.
errorCategory	string	Categoria di errore.
errorCode	string	Codice di errore.
errorId	string	ID univoco dell'errore di integrità.
errorLevel	string	Livello di errore.
errorMessage	string	Messaggio di errore.
errorSource	string	Origine dell'errore.
errorType	string	Tipo di errore.
possibleCauses	string	Possibili cause di errore.
recommendedAction	string	Azione consigliata per risolvere l'errore.
recoveryProviderErrorMessage	string	Messaggio di errore dra.
summaryMessage	string	Messaggio di riepilogo dell'entità.

MultiVmGroupCreateOption

Enumerazione

Indica se il gruppo di più macchine virtuali viene creato automaticamente o specificato dall'utente.

Valore	Descrizione
AutoCreated	AutoCreated
UserSpecified	UserSpecificato

RegisteredClusterNodes

Oggetto

Posizione estesa della risorsa.

Nome	Tipo	Descrizione
biosId	string	ID BIOS.
clusterNodeFqdn	string	Nome del nodo del cluster.
isSharedDiskVirtualNode	boolean	Valore che indica se rappresenta un'entità virtuale che ospita tutti i dischi condivisi.
machineId	string	ID computer.