Replication Eligibility Results - List

服务:

Recovery Services - Site Recovery

API 版本:

2025-08-01

获取验证错误，以防 VM 不适合保护。
验证给定虚拟机是否可以受到保护，在这种情况下，将返回错误列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.RecoveryServices/replicationEligibilityResults?api-version=2025-08-01

URI 参数

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

响应

名称	类型	说明
200 OK	ReplicationEligibilityResultsCollection	Azure 操作已成功完成。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Gets the validation errors in case the VM is unsuitable for protection.

示例请求

HTTP

GET https://management.azure.com/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/microsoft.Compute/virtualMachines/testVm2/providers/Microsoft.RecoveryServices/replicationEligibilityResults?api-version=2025-08-01

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.recoveryservicessiterecovery import SiteRecoveryManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-recoveryservicessiterecovery
# USAGE
    python replication_eligibility_results_list.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = SiteRecoveryManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.replication_eligibility_results.list(
        resource_group_name="testRg1",
        virtual_machine_name="testVm2",
    )
    print(response)


# x-ms-original-file: 2025-08-01/ReplicationEligibilityResults_List.json
if __name__ == "__main__":
    main()

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

Go

package armrecoveryservicessiterecovery_test

import (
	"context"
	"log"

	"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/ReplicationEligibilityResults_List.json
func ExampleReplicationEligibilityResultsClient_List() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicessiterecovery.NewClientFactory("d90d145a-4cdd-45a3-b2c4-971d69775278", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewReplicationEligibilityResultsClient().List(ctx, "testRg1", "testVm2", 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.ReplicationEligibilityResultsClientListResponse{
	// 	ReplicationEligibilityResultsCollection: &armrecoveryservicessiterecovery.ReplicationEligibilityResultsCollection{
	// 		Value: []*armrecoveryservicessiterecovery.ReplicationEligibilityResults{
	// 			{
	// 				Name: to.Ptr("default"),
	// 				Type: to.Ptr("Microsoft.RecoveryServices/replicationEligibilityResults"),
	// 				ID: to.Ptr("/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.Compute/virtualMachines/testVm2/providers/Microsoft.RecoveryServices/replicationEligibilityResults/default"),
	// 				Properties: &armrecoveryservicessiterecovery.ReplicationEligibilityResultsProperties{
	// 					ClientRequestID: to.Ptr("a62c81df-e26e-47ea-ab4b-f1fcc1e5b135"),
	// 					Errors: []*armrecoveryservicessiterecovery.ReplicationEligibilityResultsErrorInfo{
	// 						{
	// 							Code: to.Ptr("AzureVmIsNotInDesiredProvisioningState"),
	// 							Message: to.Ptr("Azure virtual machine with Id (/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.Compute/virtualMachines/testVm2) is with provisioning state 'failed'. To enable replication, VM's provisioning state should be 'succeeded'."),
	// 							PossibleCauses: to.Ptr("Virtual machine is not in desired state."),
	// 							RecommendedAction: to.Ptr("\n      Ensure that the VM's provisioning state is 'succeeded'.\n      Refer to https://aka.ms/a2a-vm-state-issues to troubleshoot VM provisioning state issues.\n    "),
	// 							Status: to.Ptr("Error"),
	// 						},
	// 						{
	// 							Code: to.Ptr("AzureVmIsNotInDesiredPowerState"),
	// 							Message: to.Ptr("Azure virtual machine with Id (/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.Compute/virtualMachines/testVm2) is with power status 'deallocated'. To enable replication, VM's power status should be 'running'."),
	// 							PossibleCauses: to.Ptr("Virtual machine is not in desired state."),
	// 							RecommendedAction: to.Ptr("\n      Ensure that the VM's power status is 'running'.\n      You can check the power status in 'VM > Settings > Properties > Status' in Azure portal.\n    "),
	// 							Status: to.Ptr("Error"),
	// 						},
	// 					},
	// 				},
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

const { SiteRecoveryManagementClient } = require("@azure/arm-recoveryservices-siterecovery");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to validates whether a given VM can be protected or not in which case returns list of errors.
 *
 * @summary validates whether a given VM can be protected or not in which case returns list of errors.
 * x-ms-original-file: 2025-08-01/ReplicationEligibilityResults_List.json
 */
async function getsTheValidationErrorsInCaseTheVMIsUnsuitableForProtection() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "d90d145a-4cdd-45a3-b2c4-971d69775278";
  const client = new SiteRecoveryManagementClient(credential, subscriptionId);
  const result = await client.replicationEligibilityResults.list("testRg1", "testVm2");
  console.log(result);
}

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/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.RecoveryServices/vaults/vault1/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2025-08-01

{
  "value": [
    {
      "name": "default",
      "type": "Microsoft.RecoveryServices/replicationEligibilityResults",
      "id": "/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.Compute/virtualMachines/testVm2/providers/Microsoft.RecoveryServices/replicationEligibilityResults/default",
      "properties": {
        "clientRequestId": "a62c81df-e26e-47ea-ab4b-f1fcc1e5b135",
        "errors": [
          {
            "code": "AzureVmIsNotInDesiredProvisioningState",
            "message": "Azure virtual machine with Id (/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.Compute/virtualMachines/testVm2) is with provisioning state 'failed'. To enable replication, VM's provisioning state should be 'succeeded'.",
            "possibleCauses": "Virtual machine is not in desired state.",
            "recommendedAction": "\n      Ensure that the VM's provisioning state is 'succeeded'.\n      Refer to https://aka.ms/a2a-vm-state-issues to troubleshoot VM provisioning state issues.\n    ",
            "status": "Error"
          },
          {
            "code": "AzureVmIsNotInDesiredPowerState",
            "message": "Azure virtual machine with Id (/subscriptions/d90d145a-4cdd-45a3-b2c4-971d69775278/resourceGroups/testRg1/providers/Microsoft.Compute/virtualMachines/testVm2) is with power status 'deallocated'. To enable replication, VM's power status should be 'running'.",
            "possibleCauses": "Virtual machine is not in desired state.",
            "recommendedAction": "\n      Ensure that the VM's power status is 'running'.\n      You can check the power status in 'VM > Settings > Properties > Status' in Azure portal.\n    ",
            "status": "Error"
          }
        ]
      }
    }
  ]
}

定义

名称	说明
createdByType	创建资源的标识的类型。
ReplicationEligibilityResults	复制资格结果响应模型。
ReplicationEligibilityResultsCollection	复制资格结果收集响应模型。
ReplicationEligibilityResultsErrorInfo	可以向用户公开的错误模型。
ReplicationEligibilityResultsProperties	复制资格结果 API 的属性模型。
systemData	与创建和上次修改资源相关的元数据。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

ReplicationEligibilityResults

对象

复制资格结果响应模型。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。 例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties	ReplicationEligibilityResultsProperties	获取复制资格结果 API 的属性模型。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。 例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ReplicationEligibilityResultsCollection

对象

复制资格结果收集响应模型。

名称	类型	说明
value	ReplicationEligibilityResults[]	复制资格结果详细信息。

ReplicationEligibilityResultsErrorInfo

对象

可以向用户公开的错误模型。

名称	类型	说明
code	string	错误代码。
message	string	错误消息。
possibleCauses	string	可能的原因。
recommendedAction	string	建议的作。
status	string	错误状态。

ReplicationEligibilityResultsProperties

对象

复制资格结果 API 的属性模型。

名称	类型	说明
clientRequestId	string	客户端请求 ID。
errors	ReplicationEligibilityResultsErrorInfo[]	错误详细信息。

systemData

对象

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

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