Replication Recovery Services Providers - Create

서비스:: Recovery Services - Site Recovery

API 버전:: 2026-05-01

복구 서비스 공급자를 추가합니다.
복구 서비스 공급자를 추가하는 작업입니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
fabricName	path	True	string	Fabric 이름.
providerName	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 버전입니다.

요청 본문

Name	필수	형식	Description
properties	True	AddRecoveryServicesProviderInputProperties	공급자 요청 추가의 속성입니다.

응답

Name	형식	Description
200 OK	RecoveryServicesProvider	리소스 'RecoveryServicesProvider' 업데이트 작업 성공
202 Accepted		자원 작업이 허용되었습니다. 헤더 Location: string Retry-After: integer

Name

형식

Description

200 OK

RecoveryServicesProvider

리소스 'RecoveryServicesProvider' 업데이트 작업 성공

202 Accepted

자원 작업이 허용되었습니다.

헤더

Location: string
Retry-After: integer

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정을 사칭하다

예제

Adds a recovery services provider.

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/cb53d0c3-bd59-4721-89bc-06916a9147ef/resourceGroups/resourcegroup1/providers/Microsoft.RecoveryServices/vaults/migrationvault/replicationFabrics/vmwarefabric1/replicationRecoveryServicesProviders/vmwareprovider1?api-version=2026-05-01

{
  "properties": {
    "authenticationIdentityInput": {
      "aadAuthority": "https://login.microsoftonline.com",
      "applicationId": "f66fce08-c0c6-47a1-beeb-0ede5ea94f90",
      "audience": "https://microsoft.onmicrosoft.com/cf19e349-644c-4c6a-bcae-9c8f35357874",
      "objectId": "141360b8-5686-4240-a027-5e24e6affeba",
      "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
    },
    "machineName": "vmwareprovider1",
    "resourceAccessIdentityInput": {
      "aadAuthority": "https://login.microsoftonline.com",
      "applicationId": "f66fce08-c0c6-47a1-beeb-0ede5ea94f90",
      "audience": "https://microsoft.onmicrosoft.com/cf19e349-644c-4c6a-bcae-9c8f35357874",
      "objectId": "141360b8-5686-4240-a027-5e24e6affeba",
      "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
    }
  }
}

샘플 응답

상태 코드:: 200

Azure-AsyncOperation: https://management.azure.com/Subscriptions/cb53d0c3-bd59-4721-89bc-06916a9147ef/resourceGroups/resourcegroup1/providers/Microsoft.RecoveryServices/vaults/migrationvault/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2026-05-01

{
  "name": "vmwareprovider1",
  "type": "Microsoft.RecoveryServices/vaults/replicationFabrics/replicationRecoveryServicesProviders",
  "id": "/Subscriptions/cb53d0c3-bd59-4721-89bc-06916a9147ef/resourceGroups/resourcegroup1/providers/Microsoft.RecoveryServices/vaults/migrationvault/replicationFabrics/vmwarefabric1/replicationRecoveryServicesProviders/vmwareprovider1",
  "properties": {
    "allowedScenarios": [
      "Refresh"
    ],
    "connectionStatus": "Connected",
    "fabricFriendlyName": "vmwarefabric1",
    "fabricType": "VMwareV2",
    "friendlyName": "vmwareprovider1",
    "lastHeartBeat": "2017-04-27T09:16:04.9405768Z",
    "protectedItemCount": 2,
    "providerVersion": "5.1.3688.0",
    "providerVersionState": "Latest",
    "serverVersion": "3.2.7510.0"
  }
}

상태 코드:: 202

Azure-AsyncOperation: https://management.azure.com/Subscriptions/cb53d0c3-bd59-4721-89bc-06916a9147ef/resourceGroups/resourcegroup1/providers/Microsoft.RecoveryServices/vaults/migrationvault/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2026-05-01
Retry-After: 30

정의

Name	Description
AddRecoveryServicesProviderInput	공급자를 추가하는 데 필요한 입력입니다.
AddRecoveryServicesProviderInputProperties	공급자 요청 추가의 속성입니다.
AgentVersionStatus	보안 업데이트가 필요한지 여부를 나타내는 값입니다.
createdByType	리소스를 만든 ID 유형입니다.
HealthError	상태 오류.
HealthErrorCustomerResolvability	상태 오류가 고객을 확인할 수 있는지 여부를 나타내는 값입니다.
IdentityProviderDetails	ID 공급자 세부 정보.
IdentityProviderInput	ID 공급자 입력.
InnerHealthError	InnerHealthError 클래스를 구현합니다. HealthError 개체에는 자식 오류로 InnerHealthErrors 목록이 있습니다. InnerHealthError가 사용되는 이유는 하이드라가 계약을 자동 생성하려 할 때 무한 구조 loop를 방지하기 때문입니다. 관련 상태 오류를 내부 상태 오류로 노출하고 있으며 모든 API 소비자는 Exception -> InnerException과 동일한 방식으로 이를 활용할 수 있습니다.
RecoveryServicesProvider	공급자 세부 정보.
RecoveryServicesProviderProperties	복구 서비스 공급자 속성.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
VersionDetails	버전 관련 세부 정보.

AddRecoveryServicesProviderInput

Object

공급자를 추가하는 데 필요한 입력입니다.

Name	형식	Description
properties	AddRecoveryServicesProviderInputProperties	공급자 요청 추가의 속성입니다.

AddRecoveryServicesProviderInputProperties

Object

공급자 요청 추가의 속성입니다.

Name	형식	Description
authenticationIdentityInput	IdentityProviderInput	DRA 인증에 대한 ID 공급자 입력입니다.
biosId	string	컴퓨터의 Bios ID입니다.
dataPlaneAuthenticationIdentityInput	IdentityProviderInput	데이터 평면 인증에 대한 ID 공급자 입력입니다.
machineId	string	공급자가 추가되는 컴퓨터의 ID입니다.
machineName	string	공급자가 추가되는 컴퓨터의 이름입니다.
resourceAccessIdentityInput	IdentityProviderInput	리소스 액세스를 위한 ID 공급자 입력입니다.

AgentVersionStatus

열거형

보안 업데이트가 필요한지 여부를 나타내는 값입니다.

값	Description
Supported	지원됨
NotSupported	지원되지 않음
Deprecated	Deprecated
UpdateRequired	업데이트 필요
SecurityUpdateRequired	보안 업데이트 필요

createdByType

열거형

리소스를 만든 ID 유형입니다.

값	Description
User
Application
ManagedIdentity
Key

HealthError

Object

상태 오류.

Name	형식	Description
creationTimeUtc	string (date-time)	오류 생성 시간(UTC)입니다.
customerResolvability	HealthErrorCustomerResolvability	상태 오류가 고객을 확인할 수 있는지 여부를 나타내는 값입니다.
entityId	string	엔터티의 ID입니다.
errorCategory	string	오류 범주입니다.
errorCode	string	오류 코드입니다.
errorId	string	상태 오류 고유 ID입니다.
errorLevel	string	오류 수준입니다.
errorMessage	string	오류 메시지입니다.
errorSource	string	오류의 원인입니다.
errorType	string	오류 유형입니다.
innerHealthErrors	InnerHealthError[]	내부 상태 오류입니다. HealthError 목록을 자식 오류로 사용하는 것은 문제가 됩니다. InnerHealthError가 사용되는 이유는 하이드라가 계약을 자동 생성하려 할 때 무한 구조 loop를 방지하기 때문입니다. 관련 상태 오류를 내부 상태 오류로 노출하고 있으며 모든 API 소비자는 Exception -> InnerException과 동일한 방식으로 이를 활용할 수 있습니다.
possibleCauses	string	가능한 오류 원인입니다.
recommendedAction	string	오류를 해결하는 데 권장되는 작업입니다.
recoveryProviderErrorMessage	string	DRA 오류 메시지입니다.
summaryMessage	string	엔터티의 요약 메시지입니다.

HealthErrorCustomerResolvability

열거형

상태 오류가 고객을 확인할 수 있는지 여부를 나타내는 값입니다.

값	Description
Allowed	허용됨
NotAllowed	허용되지 않음

IdentityProviderDetails

Object

ID 공급자 세부 정보.

Name	형식	Description
aadAuthority	string	Azure Active Directory 인증에 대한 기본 기관입니다.
applicationId	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 애플리케이션/클라이언트 ID입니다.
audience	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 의도된 대상 그룹입니다.
objectId	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 개체 ID입니다.
tenantId	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 테넌트 ID입니다.

IdentityProviderInput

Object

ID 공급자 입력.

Name	형식	Description
aadAuthority	string	Azure Active Directory 인증에 대한 기본 기관입니다.
applicationId	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 애플리케이션/클라이언트 ID입니다.
audience	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 의도된 대상 그룹입니다.
objectId	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 개체 ID입니다.
tenantId	string	온-프레미스 관리/데이터 평면 구성 요소가 Azure 서비스와 통신하는 서비스 주체의 테넌트 ID입니다.

InnerHealthError

Object

InnerHealthError 클래스를 구현합니다. HealthError 개체에는 자식 오류로 InnerHealthErrors 목록이 있습니다. InnerHealthError가 사용되는 이유는 하이드라가 계약을 자동 생성하려 할 때 무한 구조 loop를 방지하기 때문입니다. 관련 상태 오류를 내부 상태 오류로 노출하고 있으며 모든 API 소비자는 Exception -> InnerException과 동일한 방식으로 이를 활용할 수 있습니다.

Name	형식	Description
creationTimeUtc	string (date-time)	오류 생성 시간(UTC)입니다.
customerResolvability	HealthErrorCustomerResolvability	상태 오류가 고객을 확인할 수 있는지 여부를 나타내는 값입니다.
entityId	string	엔터티의 ID입니다.
errorCategory	string	오류 범주입니다.
errorCode	string	오류 코드입니다.
errorId	string	상태 오류 고유 ID입니다.
errorLevel	string	오류 수준입니다.
errorMessage	string	오류 메시지입니다.
errorSource	string	오류의 원인입니다.
errorType	string	오류 유형입니다.
possibleCauses	string	가능한 오류 원인입니다.
recommendedAction	string	오류를 해결하는 데 권장되는 작업입니다.
recoveryProviderErrorMessage	string	DRA 오류 메시지입니다.
summaryMessage	string	엔터티의 요약 메시지입니다.

RecoveryServicesProvider

Object

공급자 세부 정보.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	리소스 위치
name	string	리소스의 이름
properties	RecoveryServicesProviderProperties	공급자 속성.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

RecoveryServicesProviderProperties

Object

복구 서비스 공급자 속성.

Name	형식	Description
allowedScenarios	string[]	이 공급자에서 허용되는 시나리오입니다.
authenticationIdentityDetails	IdentityProviderDetails	인증 ID 세부 정보입니다.
biosId	string	바이오스 ID.
connectionStatus	string	DRA가 응답하는지 여부를 나타내는 값입니다.
dataPlaneAuthenticationIdentityDetails	IdentityProviderDetails	데이터 플레인 인증 ID 세부 정보입니다.
draIdentifier	string	DRA ID입니다.
fabricFriendlyName	string	패브릭 친화적인 이름입니다.
fabricType	string	사이트 유형입니다.
friendlyName	string	DRA의 이름입니다.
healthErrorDetails	HealthError[]	복구 서비스 공급자 상태 오류 세부 정보입니다.
lastHeartBeat	string (date-time)	DRA에서 마지막 하트비트를 전송한 시간입니다.
machineId	string	머신 ID입니다.
machineName	string	기계 이름.
protectedItemCount	integer (int32)	현재 DRA에서 관리하는 보호된 VM 수입니다.
providerVersion	string	공급자 버전입니다.
providerVersionDetails	VersionDetails	공급자 버전 세부 정보입니다.
providerVersionExpiryDate	string (date-time)	버전의 만료 날짜입니다.
providerVersionState	string	DRA 버전 상태입니다.
resourceAccessIdentityDetails	IdentityProviderDetails	리소스 액세스 ID 세부 정보입니다.
serverVersion	string	패브릭 공급자.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID 유형입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

VersionDetails

Object

버전 관련 세부 정보.

Name	형식	Description
expiryDate	string (date-time)	버전 만료 날짜입니다.
status	AgentVersionStatus	보안 업데이트가 필요한지 여부를 나타내는 값입니다.
version	string	에이전트 버전입니다.