Replication Recovery Services Providers - Refresh Provider

Serviço:: Recovery Services - Site Recovery

Versão da API:: 2026-05-01

Atualize os detalhes do provedor de serviços de recuperação.
A operação para atualizar as informações do provedor de serviços de recuperação.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationRecoveryServicesProviders/{providerName}/refreshProvider?api-version=2026-05-01

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
fabricName	path	True	string	Nome Fabric.
providerName	path	True	string	Nome do provedor de serviços de recuperaçã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)	O ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Descrição
200 OK	RecoveryServicesProvider	Operação do Azure concluída com sucesso.
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string Retry-After: integer

Name

Tipo

Descrição

200 OK

RecoveryServicesProvider

Operação do Azure concluída com sucesso.

202 Accepted

Operação de recurso aceita.

Cabeçalhos

Location: string
Retry-After: integer

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name	Descrição
user_impersonation	assumir a identidade da sua conta de utilizador

Exemplos

Refresh details from the recovery services provider.

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/cloud1/replicationRecoveryServicesProviders/241641e6-ee7b-4ee4-8141-821fadda43fa/refreshProvider?api-version=2026-05-01

Resposta da amostra

Código de estado:: 200

Azure-AsyncOperation: https://management.azure.com/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2026-05-01

{
  "name": "241641e6-ee7b-4ee4-8141-821fadda43fa",
  "type": "Microsoft.RecoveryServices/vaults/replicationFabrics/replicationRecoveryServicesProviders",
  "id": "/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationFabrics/cloud1/replicationRecoveryServicesProviders/241641e6-ee7b-4ee4-8141-821fadda43fa",
  "properties": {
    "allowedScenarios": [
      "Refresh"
    ],
    "connectionStatus": "Connected",
    "fabricFriendlyName": "cloud1",
    "fabricType": "HyperVSite",
    "friendlyName": "CP-B3L40406-12.ntdev.corp.microsoft.com",
    "lastHeartBeat": "2017-04-27T09:48:36.6528303Z",
    "protectedItemCount": 2,
    "providerVersion": "5.1.2250.0",
    "providerVersionState": "Latest",
    "serverVersion": "3.2.7510.0"
  }
}

Código de estado:: 202

Azure-AsyncOperation: https://management.azure.com/Subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/resourceGroupPS1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2026-05-01
Retry-After: 30

Definições

Name	Descrição
AgentVersionStatus	Um valor que indica se a atualização de segurança é necessária.
createdByType	O tipo de identidade que criou o recurso.
HealthError	Erro de integridade.
HealthErrorCustomerResolvability	Valor que indica se o erro de integridade pode ser resolvido pelo cliente.
IdentityProviderDetails	Detalhes do provedor de identidade.
InnerHealthError	Implementa a classe InnerHealthError. O objeto HealthError tem uma lista de InnerHealthErrors como erros filho. O InnerHealthError é usado porque isto impede um loop infinito de estruturas quando a Hydra tenta gerar automaticamente o contrato. Estamos expondo os erros de saúde relacionados como erros internos de saúde e todos os consumidores de API podem utilizar isso da mesma maneira que Exception -> InnerException.
RecoveryServicesProvider	Detalhes do fornecedor.
RecoveryServicesProviderProperties	Propriedades do provedor de serviços de recuperação.
systemData	Metadados referentes à criação e última modificação do recurso.
VersionDetails	Detalhes relacionados com a versão.

AgentVersionStatus

Enumeração

Um valor que indica se a atualização de segurança é necessária.

Valor	Descrição
Supported	Suportado
NotSupported	Não Suportado
Deprecated	Deprecated
UpdateRequired	Atualização necessária
SecurityUpdateRequired	SecurityUpdateRequired

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

HealthError

Object

Erro de integridade.

Name	Tipo	Descrição
creationTimeUtc	string (date-time)	Hora de criação do erro (UTC).
customerResolvability	HealthErrorCustomerResolvability	Valor que indica se o erro de integridade pode ser resolvido pelo cliente.
entityId	string	ID da entidade.
errorCategory	string	Categoria de erro.
errorCode	string	Código de erro.
errorId	string	O id exclusivo do erro de integridade.
errorLevel	string	Nível de erro.
errorMessage	string	Mensagem de erro.
errorSource	string	Fonte do erro.
errorType	string	Tipo de erro.
innerHealthErrors	InnerHealthError[]	Os erros internos de saúde. HealthError ter uma lista de HealthError como erros filho é problemático. O InnerHealthError é usado porque isto impede um loop infinito de estruturas quando a Hydra tenta gerar automaticamente o contrato. Estamos expondo os erros de saúde relacionados como erros internos de saúde e todos os consumidores de API podem utilizar isso da mesma maneira que Exception -> InnerException.
possibleCauses	string	Possíveis causas de erro.
recommendedAction	string	Ação recomendada para resolver o erro.
recoveryProviderErrorMessage	string	Mensagem de erro DRA.
summaryMessage	string	Mensagem resumida da entidade.

HealthErrorCustomerResolvability

Enumeração

Valor que indica se o erro de integridade pode ser resolvido pelo cliente.

Valor	Descrição
Allowed	Permitido
NotAllowed	Não permitido

IdentityProviderDetails

Object

Detalhes do provedor de identidade.

Name	Tipo	Descrição
aadAuthority	string	A autoridade base para a autenticação do Azure Ative Directory.
applicationId	string	A ID do aplicativo/cliente para a entidade de serviço com a qual os componentes do plano de dados/gerenciamento local se comunicariam com nossos serviços do Azure.
audience	string	O Público-alvo da entidade de serviço com a qual os componentes do plano de dados/gerenciamento local se comunicariam com nossos serviços do Azure.
objectId	string	A ID do objeto da entidade de serviço com a qual os componentes do plano de dados/gerenciamento local se comunicariam com nossos serviços do Azure.
tenantId	string	A ID do locatário para a entidade de serviço com a qual os componentes do plano de dados/gerenciamento local se comunicariam com nossos serviços do Azure.

InnerHealthError

Object

Implementa a classe InnerHealthError. O objeto HealthError tem uma lista de InnerHealthErrors como erros filho. O InnerHealthError é usado porque isto impede um loop infinito de estruturas quando a Hydra tenta gerar automaticamente o contrato. Estamos expondo os erros de saúde relacionados como erros internos de saúde e todos os consumidores de API podem utilizar isso da mesma maneira que Exception -> InnerException.

Name	Tipo	Descrição
creationTimeUtc	string (date-time)	Hora de criação do erro (UTC).
customerResolvability	HealthErrorCustomerResolvability	Valor que indica se o erro de integridade pode ser resolvido pelo cliente.
entityId	string	ID da entidade.
errorCategory	string	Categoria de erro.
errorCode	string	Código de erro.
errorId	string	O id exclusivo do erro de integridade.
errorLevel	string	Nível de erro.
errorMessage	string	Mensagem de erro.
errorSource	string	Fonte do erro.
errorType	string	Tipo de erro.
possibleCauses	string	Possíveis causas de erro.
recommendedAction	string	Ação recomendada para resolver o erro.
recoveryProviderErrorMessage	string	Mensagem de erro DRA.
summaryMessage	string	Mensagem resumida da entidade.

RecoveryServicesProvider

Object

Detalhes do fornecedor.

Name	Tipo	Descrição
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Localização do recurso
name	string	O nome do recurso
properties	RecoveryServicesProviderProperties	Propriedades do provedor.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

RecoveryServicesProviderProperties

Object

Propriedades do provedor de serviços de recuperação.

Name	Tipo	Descrição
allowedScenarios	string[]	Os cenários permitidos neste provedor.
authenticationIdentityDetails	IdentityProviderDetails	Os detalhes da identidade de autenticação.
biosId	string	O Bios Id.
connectionStatus	string	Um valor que indica se o DRA é responsivo.
dataPlaneAuthenticationIdentityDetails	IdentityProviderDetails	Os detalhes da identidade de autenticação do plano de dados.
draIdentifier	string	O ID DRA.
fabricFriendlyName	string	O nome amigável do tecido.
fabricType	string	Tipo de site.
friendlyName	string	Nome amigável do DRA.
healthErrorDetails	HealthError[]	Os detalhes do erro de integridade do provedor de serviços de recuperação.
lastHeartBeat	string (date-time)	Hora em que o último batimento cardíaco foi enviado pela DRA.
machineId	string	O ID da máquina.
machineName	string	O nome da máquina.
protectedItemCount	integer (int32)	Número de VMs protegidas atualmente gerenciadas pela DRA.
providerVersion	string	A versão do provedor.
providerVersionDetails	VersionDetails	Os detalhes da versão do provedor.
providerVersionExpiryDate	string (date-time)	Data de validade da versão.
providerVersionState	string	Status da versão DRA.
resourceAccessIdentityDetails	IdentityProviderDetails	Os detalhes da identidade de acesso ao recurso.
serverVersion	string	O provedor de malha.

systemData

Object

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

Name	Tipo	Descrição
createdAt	string (date-time)	A marca temporal da criação do recurso (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	A data e 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.

VersionDetails

Object

Detalhes relacionados com a versão.

Name	Tipo	Descrição
expiryDate	string (date-time)	Data de validade da versão.
status	AgentVersionStatus	Um valor que indica se a atualização de segurança é necessária.
version	string	A versão do agente.