Replication Network Mappings - List By Replication Networks

服务:

Recovery Services - Site Recovery

API 版本:

2025-01-01

获取网络下的所有网络映射。
列出指定网络的所有 ASR 网络映射。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{resourceName}/replicationFabrics/{fabricName}/replicationNetworks/{networkName}/replicationNetworkMappings?api-version=2025-01-01

URI 参数

名称	在	必需	类型	说明
fabricName	path	True	string	主结构名称。
networkName	path	True	string	主网络名称。
resourceGroupName	path	True	string	恢复服务保管库所在的资源组的名称。
resourceName	path	True	string	恢复服务保管库的名称。
subscriptionId	path	True	string	订阅 ID。
api-version	query	True	string	客户端 API 版本。

响应

名称	类型	说明
200 OK	NetworkMappingCollection	好的

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

作用域

名称	说明
user_impersonation	模拟用户帐户。

示例

Gets all the network mappings under a network.

示例请求

HTTP

GET https://management.azure.com/subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac/replicationNetworks/e2267b5c-2650-49bd-ab3f-d66aae694c06/replicationNetworkMappings?api-version=2025-01-01

Java

/**
 * Samples for ReplicationNetworkMappings ListByReplicationNetworks.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/recoveryservicessiterecovery/resource-manager/Microsoft.RecoveryServices/stable/2025-01-01/examples
     * /ReplicationNetworkMappings_ListByReplicationNetworks.json
     */
    /**
     * Sample code: Gets all the network mappings under a network.
     * 
     * @param manager Entry point to SiteRecoveryManager.
     */
    public static void getsAllTheNetworkMappingsUnderANetwork(
        com.azure.resourcemanager.recoveryservicessiterecovery.SiteRecoveryManager manager) {
        manager.replicationNetworkMappings().listByReplicationNetworks("srcBvte2a14C27", "srce2avaultbvtaC27",
            "b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac", "e2267b5c-2650-49bd-ab3f-d66aae694c06",
            com.azure.core.util.Context.NONE);
    }
}

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

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_network_mappings_list_by_replication_networks.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="9112a37f-0f3e-46ec-9c00-060c6edca071",
        resource_group_name="srcBvte2a14C27",
        resource_name="srce2avaultbvtaC27",
    )

    response = client.replication_network_mappings.list_by_replication_networks(
        fabric_name="b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac",
        network_name="e2267b5c-2650-49bd-ab3f-d66aae694c06",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/recoveryservicessiterecovery/resource-manager/Microsoft.RecoveryServices/stable/2025-01-01/examples/ReplicationNetworkMappings_ListByReplicationNetworks.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/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4fc983fb08e5fd8a7a821eb6491f5338ce52a9cf/specification/recoveryservicessiterecovery/resource-manager/Microsoft.RecoveryServices/stable/2025-01-01/examples/ReplicationNetworkMappings_ListByReplicationNetworks.json
func ExampleReplicationNetworkMappingsClient_NewListByReplicationNetworksPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armrecoveryservicessiterecovery.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewReplicationNetworkMappingsClient().NewListByReplicationNetworksPager("srcBvte2a14C27", "srce2avaultbvtaC27", "b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac", "e2267b5c-2650-49bd-ab3f-d66aae694c06", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.NetworkMappingCollection = armrecoveryservicessiterecovery.NetworkMappingCollection{
		// 	Value: []*armrecoveryservicessiterecovery.NetworkMapping{
		// 		{
		// 			Name: to.Ptr("corpe2amap"),
		// 			Type: to.Ptr("Microsoft.RecoveryServices/vaults/replicationFabrics/replicationNetworks/replicationNetworkMappings"),
		// 			ID: to.Ptr("/Subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac/replicationNetworks/e2267b5c-2650-49bd-ab3f-d66aae694c06/replicationNetworkMappings/corpe2amap"),
		// 			Properties: &armrecoveryservicessiterecovery.NetworkMappingProperties{
		// 				FabricSpecificSettings: &armrecoveryservicessiterecovery.VmmToAzureNetworkMappingSettings{
		// 					InstanceType: to.Ptr("VmmToAzure"),
		// 				},
		// 				PrimaryFabricFriendlyName: to.Ptr("CP-B3L30108-01.ntdev.corp.microsoft.com"),
		// 				PrimaryNetworkFriendlyName: to.Ptr("corp"),
		// 				PrimaryNetworkID: to.Ptr("/Subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/d49858f157601230a6ac5862fbbc6e63bf38d23ecd96cf953767945d457fe9d5/replicationNetworks/e2267b5c-2650-49bd-ab3f-d66aae694c06"),
		// 				RecoveryFabricArmID: to.Ptr("/Subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/d49858f157601230a6ac5862fbbc6e63bf38d23ecd96cf953767945d457fe9d5"),
		// 				RecoveryFabricFriendlyName: to.Ptr("Microsoft Azure"),
		// 				RecoveryNetworkFriendlyName: to.Ptr("vnetavrai"),
		// 				RecoveryNetworkID: to.Ptr("/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/siterecoveryProd1/providers/Microsoft.Network/virtualNetworks/vnetavrai"),
		// 				State: to.Ptr("Paired"),
		// 			},
		// 	}},
		// }
	}
}

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");
require("dotenv/config");

/**
 * This sample demonstrates how to Lists all ASR network mappings for the specified network.
 *
 * @summary Lists all ASR network mappings for the specified network.
 * x-ms-original-file: specification/recoveryservicessiterecovery/resource-manager/Microsoft.RecoveryServices/stable/2025-01-01/examples/ReplicationNetworkMappings_ListByReplicationNetworks.json
 */
async function getsAllTheNetworkMappingsUnderANetwork() {
  const subscriptionId =
    process.env["RECOVERYSERVICESSITERECOVERY_SUBSCRIPTION_ID"] ||
    "9112a37f-0f3e-46ec-9c00-060c6edca071";
  const resourceGroupName =
    process.env["RECOVERYSERVICESSITERECOVERY_RESOURCE_GROUP"] || "srcBvte2a14C27";
  const resourceName = "srce2avaultbvtaC27";
  const fabricName = "b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac";
  const networkName = "e2267b5c-2650-49bd-ab3f-d66aae694c06";
  const credential = new DefaultAzureCredential();
  const client = new SiteRecoveryManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.replicationNetworkMappings.listByReplicationNetworks(
    resourceGroupName,
    resourceName,
    fabricName,
    networkName,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.RecoveryServicesSiteRecovery.Models;
using Azure.ResourceManager.RecoveryServicesSiteRecovery;

// Generated from example definition: specification/recoveryservicessiterecovery/resource-manager/Microsoft.RecoveryServices/stable/2025-01-01/examples/ReplicationNetworkMappings_ListByReplicationNetworks.json
// this example is just showing the usage of "ReplicationNetworkMappings_ListByReplicationNetworks" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SiteRecoveryNetworkResource created on azure
// for more information of creating SiteRecoveryNetworkResource, please refer to the document of SiteRecoveryNetworkResource
string subscriptionId = "9112a37f-0f3e-46ec-9c00-060c6edca071";
string resourceGroupName = "srcBvte2a14C27";
string resourceName = "srce2avaultbvtaC27";
string fabricName = "b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac";
string networkName = "e2267b5c-2650-49bd-ab3f-d66aae694c06";
ResourceIdentifier siteRecoveryNetworkResourceId = SiteRecoveryNetworkResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceName, fabricName, networkName);
SiteRecoveryNetworkResource siteRecoveryNetwork = client.GetSiteRecoveryNetworkResource(siteRecoveryNetworkResourceId);

// get the collection of this SiteRecoveryNetworkMappingResource
SiteRecoveryNetworkMappingCollection collection = siteRecoveryNetwork.GetSiteRecoveryNetworkMappings();

// invoke the operation and iterate over the result
await foreach (SiteRecoveryNetworkMappingResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    SiteRecoveryNetworkMappingData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationOperationStatus/a93f3cd5-9035-4b1e-a2c9-b16df6d5d34b?api-version=2025-01-01

{
  "value": [
    {
      "type": "Microsoft.RecoveryServices/vaults/replicationFabrics/replicationNetworks/replicationNetworkMappings",
      "id": "/Subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/b0cef6e9a4437b81803d0b55ada4f700ab66caae59c35d62723a1589c0cd13ac/replicationNetworks/e2267b5c-2650-49bd-ab3f-d66aae694c06/replicationNetworkMappings/corpe2amap",
      "name": "corpe2amap",
      "properties": {
        "state": "Paired",
        "primaryNetworkFriendlyName": "corp",
        "primaryNetworkId": "/Subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/d49858f157601230a6ac5862fbbc6e63bf38d23ecd96cf953767945d457fe9d5/replicationNetworks/e2267b5c-2650-49bd-ab3f-d66aae694c06",
        "primaryFabricFriendlyName": "CP-B3L30108-01.ntdev.corp.microsoft.com",
        "recoveryNetworkFriendlyName": "vnetavrai",
        "recoveryNetworkId": "/subscriptions/c183865e-6077-46f2-a3b1-deb0f4f4650a/resourceGroups/siterecoveryProd1/providers/Microsoft.Network/virtualNetworks/vnetavrai",
        "recoveryFabricArmId": "/Subscriptions/9112a37f-0f3e-46ec-9c00-060c6edca071/resourceGroups/srcBvte2a14C27/providers/Microsoft.RecoveryServices/vaults/srce2avaultbvtaC27/replicationFabrics/d49858f157601230a6ac5862fbbc6e63bf38d23ecd96cf953767945d457fe9d5",
        "recoveryFabricFriendlyName": "Microsoft Azure",
        "fabricSpecificSettings": {
          "instanceType": "VmmToAzure"
        }
      }
    }
  ]
}

定义

名称	说明
AzureToAzureNetworkMappingSettings	A2A 网络映射结构特定设置。
NetworkMapping	网络映射模型。 理想情况下，只要结构或方法签名没有差异，就可以从 InheritedModels 中的上一版本继承此类。 由于某些字段和方法没有基本模型（viz NetworkMappingProperties 和 Load 具有所需返回类型）的基模型，因此该类已全部引入，并引用了基本模型，以方便后续版本中的扩展。
NetworkMappingCollection	网络映射列表。 与 NetworkMapping 一样，应该可以重复使用此类的上一版本。 此类似乎不可能是一个稍微定制的 NetworkMapping 集合。 因此，使用 Base.NetworkMapping 替代 Load 而不是现有的 CurrentVersion.NetworkMapping 是有意义的。
NetworkMappingProperties	网络映射属性。
VmmToAzureNetworkMappingSettings	E2A 网络映射结构特定设置。
VmmToVmmNetworkMappingSettings	E2E 网络映射结构特定设置。

AzureToAzureNetworkMappingSettings

Object

A2A 网络映射结构特定设置。

名称	类型	说明
instanceType	string: AzureToAzure	获取实例类型。
primaryFabricLocation	string	主构造位置。
recoveryFabricLocation	string	恢复构造位置。

NetworkMapping

Object

网络映射模型。 理想情况下，只要结构或方法签名没有差异，就可以从 InheritedModels 中的上一版本继承此类。 由于某些字段和方法没有基本模型（viz NetworkMappingProperties 和 Load 具有所需返回类型）的基模型，因此该类已全部引入，并引用了基本模型，以方便后续版本中的扩展。

名称	类型	说明
id	string	资源 ID
location	string	资源位置
name	string	资源名称
properties	NetworkMappingProperties	网络映射属性。
type	string	资源类型

NetworkMappingCollection

Object

网络映射列表。 与 NetworkMapping 一样，应该可以重复使用此类的上一版本。 此类似乎不可能是一个稍微定制的 NetworkMapping 集合。 因此，使用 Base.NetworkMapping 替代 Load 而不是现有的 CurrentVersion.NetworkMapping 是有意义的。

名称	类型	说明
nextLink	string	下一个链接的值。
value	NetworkMapping[]	网络映射列表。

NetworkMappingProperties

Object

网络映射属性。

名称	类型	说明
fabricSpecificSettings	NetworkMappingFabricSpecificSettings: AzureToAzureNetworkMappingSettings VmmToAzureNetworkMappingSettings VmmToVmmNetworkMappingSettings	结构特定的设置。
primaryFabricFriendlyName	string	主构造友好名称。
primaryNetworkFriendlyName	string	主网络友好名称。
primaryNetworkId	string	网络映射的主网络 ID。
recoveryFabricArmId	string	恢复构造 ARM ID。
recoveryFabricFriendlyName	string	恢复构造友好名称。
recoveryNetworkFriendlyName	string	恢复网络友好名称。
recoveryNetworkId	string	网络映射的恢复网络 ID。
state	string	网络映射的配对状态。

VmmToAzureNetworkMappingSettings

Object

E2A 网络映射结构特定设置。

名称	类型	说明
instanceType	string: VmmToAzure	获取实例类型。

VmmToVmmNetworkMappingSettings

Object

E2E 网络映射结构特定设置。

名称	类型	说明
instanceType	string: VmmToVmm	获取实例类型。