Creates or updates a peering in the specified virtual network.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/virtualNetworkPeerings/{virtualNetworkPeeringName}?api-version=2023-09-01
With optional parameters:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/virtualNetworkPeerings/{virtualNetworkPeeringName}?syncRemoteAddressSpace=true&api-version=2023-09-01
URI Parameters
Name |
In |
Required |
Type |
Description |
resourceGroupName
|
path |
True
|
string
|
The name of the resource group.
|
subscriptionId
|
path |
True
|
string
|
The subscription credentials which uniquely identify the Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
|
virtualNetworkName
|
path |
True
|
string
|
The name of the virtual network.
|
virtualNetworkPeeringName
|
path |
True
|
string
|
The name of the peering.
|
api-version
|
query |
True
|
string
|
Client API version.
|
syncRemoteAddressSpace
|
query |
|
SyncRemoteAddressSpace
|
Parameter indicates the intention to sync the peering with the current address space on the remote vNet after it's updated.
|
Request Body
Name |
Type |
Description |
id
|
string
|
Resource ID.
|
name
|
string
|
The name of the resource that is unique within a resource group. This name can be used to access the resource.
|
properties.allowForwardedTraffic
|
boolean
|
Whether the forwarded traffic from the VMs in the local virtual network will be allowed/disallowed in remote virtual network.
|
properties.allowGatewayTransit
|
boolean
|
If gateway links can be used in remote virtual networking to link to this virtual network.
|
properties.allowVirtualNetworkAccess
|
boolean
|
Whether the VMs in the local virtual network space would be able to access the VMs in remote virtual network space.
|
properties.doNotVerifyRemoteGateways
|
boolean
|
If we need to verify the provisioning state of the remote gateway.
|
properties.peeringState
|
VirtualNetworkPeeringState
|
The status of the virtual network peering.
|
properties.peeringSyncLevel
|
VirtualNetworkPeeringLevel
|
The peering sync status of the virtual network peering.
|
properties.remoteAddressSpace
|
AddressSpace
|
The reference to the address space peered with the remote virtual network.
|
properties.remoteBgpCommunities
|
VirtualNetworkBgpCommunities
|
The reference to the remote virtual network's Bgp Communities.
|
properties.remoteVirtualNetwork
|
SubResource
|
The reference to the remote virtual network. The remote virtual network can be in the same or different region (preview). See here to register for the preview and learn more (https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-create-peering).
|
properties.remoteVirtualNetworkAddressSpace
|
AddressSpace
|
The reference to the current address space of the remote virtual network.
|
properties.useRemoteGateways
|
boolean
|
If remote gateways can be used on this virtual network. If the flag is set to true, and allowGatewayTransit on remote peering is also true, virtual network will use gateways of remote virtual network for transit. Only one peering can have this flag set to true. This flag cannot be set if virtual network already has a gateway.
|
type
|
string
|
Resource type.
|
Responses
Name |
Type |
Description |
200 OK
|
VirtualNetworkPeering
|
Update successful. The operation returns the resulting VirtualNetworkPeering resource.
|
201 Created
|
VirtualNetworkPeering
|
Create successful. The operation returns the resulting VirtualNetworkPeering resource.
|
Other Status Codes
|
CloudError
|
Error response describing why the operation failed.
|
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name |
Description |
user_impersonation
|
impersonate your user account
|
Examples
Create peering
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?syncRemoteAddressSpace=true&api-version=2023-09-01
{
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
}
}
}
import com.azure.core.management.SubResource;
import com.azure.resourcemanager.network.fluent.models.VirtualNetworkPeeringInner;
/**
* Samples for VirtualNetworkPeerings CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreate.
* json
*/
/**
* Sample code: Create peering.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void createPeering(com.azure.resourcemanager.AzureResourceManager azure) {
azure.networks().manager().serviceClient().getVirtualNetworkPeerings().createOrUpdate("peerTest", "vnet1",
"peer",
new VirtualNetworkPeeringInner().withAllowVirtualNetworkAccess(true).withAllowForwardedTraffic(true)
.withAllowGatewayTransit(false).withUseRemoteGateways(false)
.withRemoteVirtualNetwork(new SubResource().withId(
"/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2")),
null, com.azure.core.util.Context.NONE);
}
/*
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/
* VirtualNetworkPeeringCreateWithRemoteVirtualNetworkEncryption.json
*/
/**
* Sample code: Create peering with remote virtual network encryption.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void
createPeeringWithRemoteVirtualNetworkEncryption(com.azure.resourcemanager.AzureResourceManager azure) {
azure.networks().manager().serviceClient().getVirtualNetworkPeerings().createOrUpdate("peerTest", "vnet1",
"peer",
new VirtualNetworkPeeringInner().withAllowVirtualNetworkAccess(true).withAllowForwardedTraffic(true)
.withAllowGatewayTransit(false).withUseRemoteGateways(false)
.withRemoteVirtualNetwork(new SubResource().withId(
"/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2")),
null, 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
from azure.identity import DefaultAzureCredential
from azure.mgmt.network import NetworkManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-network
# USAGE
python virtual_network_peering_create.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 = NetworkManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.virtual_network_peerings.begin_create_or_update(
resource_group_name="peerTest",
virtual_network_name="vnet1",
virtual_network_peering_name="peer",
virtual_network_peering_parameters={
"properties": {
"allowForwardedTraffic": True,
"allowGatewayTransit": False,
"allowVirtualNetworkAccess": True,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"useRemoteGateways": False,
}
},
).result()
print(response)
# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreate.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
package armnetwork_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d4205894880b989ede35d62d97c8e901ed14fb5a/specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreate.json
func ExampleVirtualNetworkPeeringsClient_BeginCreateOrUpdate_createPeering() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualNetworkPeeringsClient().BeginCreateOrUpdate(ctx, "peerTest", "vnet1", "peer", armnetwork.VirtualNetworkPeering{
Properties: &armnetwork.VirtualNetworkPeeringPropertiesFormat{
AllowForwardedTraffic: to.Ptr(true),
AllowGatewayTransit: to.Ptr(false),
AllowVirtualNetworkAccess: to.Ptr(true),
RemoteVirtualNetwork: &armnetwork.SubResource{
ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
},
UseRemoteGateways: to.Ptr(false),
},
}, &armnetwork.VirtualNetworkPeeringsClientBeginCreateOrUpdateOptions{SyncRemoteAddressSpace: nil})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %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.VirtualNetworkPeering = armnetwork.VirtualNetworkPeering{
// ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer"),
// Name: to.Ptr("peer"),
// Properties: &armnetwork.VirtualNetworkPeeringPropertiesFormat{
// AllowForwardedTraffic: to.Ptr(true),
// AllowGatewayTransit: to.Ptr(false),
// AllowVirtualNetworkAccess: to.Ptr(true),
// PeeringState: to.Ptr(armnetwork.VirtualNetworkPeeringStateInitiated),
// PeeringSyncLevel: to.Ptr(armnetwork.VirtualNetworkPeeringLevelFullyInSync),
// ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
// RemoteAddressSpace: &armnetwork.AddressSpace{
// AddressPrefixes: []*string{
// to.Ptr("12.0.0.0/8")},
// },
// RemoteBgpCommunities: &armnetwork.VirtualNetworkBgpCommunities{
// RegionalCommunity: to.Ptr("12076:50004"),
// VirtualNetworkCommunity: to.Ptr("12076:20002"),
// },
// RemoteVirtualNetwork: &armnetwork.SubResource{
// ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
// },
// RemoteVirtualNetworkAddressSpace: &armnetwork.AddressSpace{
// AddressPrefixes: []*string{
// to.Ptr("12.0.0.0/8")},
// },
// UseRemoteGateways: to.Ptr(false),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Creates or updates a peering in the specified virtual network.
*
* @summary Creates or updates a peering in the specified virtual network.
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreate.json
*/
async function createPeering() {
const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "peerTest";
const virtualNetworkName = "vnet1";
const virtualNetworkPeeringName = "peer";
const virtualNetworkPeeringParameters = {
allowForwardedTraffic: true,
allowGatewayTransit: false,
allowVirtualNetworkAccess: true,
remoteVirtualNetwork: {
id: "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2",
},
useRemoteGateways: false,
};
const credential = new DefaultAzureCredential();
const client = new NetworkManagementClient(credential, subscriptionId);
const result = await client.virtualNetworkPeerings.beginCreateOrUpdateAndWait(
resourceGroupName,
virtualNetworkName,
virtualNetworkPeeringName,
virtualNetworkPeeringParameters,
);
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
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Network;
using Azure.ResourceManager.Network.Models;
// Generated from example definition: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreate.json
// this example is just showing the usage of "VirtualNetworkPeerings_CreateOrUpdate" 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 VirtualNetworkResource created on azure
// for more information of creating VirtualNetworkResource, please refer to the document of VirtualNetworkResource
string subscriptionId = "subid";
string resourceGroupName = "peerTest";
string virtualNetworkName = "vnet1";
ResourceIdentifier virtualNetworkResourceId = VirtualNetworkResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualNetworkName);
VirtualNetworkResource virtualNetwork = client.GetVirtualNetworkResource(virtualNetworkResourceId);
// get the collection of this VirtualNetworkPeeringResource
VirtualNetworkPeeringCollection collection = virtualNetwork.GetVirtualNetworkPeerings();
// invoke the operation
string virtualNetworkPeeringName = "peer";
VirtualNetworkPeeringData data = new VirtualNetworkPeeringData()
{
AllowVirtualNetworkAccess = true,
AllowForwardedTraffic = true,
AllowGatewayTransit = false,
UseRemoteGateways = false,
RemoteVirtualNetworkId = new ResourceIdentifier("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
};
ArmOperation<VirtualNetworkPeeringResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualNetworkPeeringName, data);
VirtualNetworkPeeringResource result = lro.Value;
// the variable result 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
VirtualNetworkPeeringData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
"name": "peer",
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"remoteAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteVirtualNetworkAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "12076:20002",
"regionalCommunity": "12076:50004"
},
"peeringState": "Initiated",
"peeringSyncLevel": "FullyInSync",
"provisioningState": "Succeeded"
}
}
{
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
"name": "peer",
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"remoteAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteVirtualNetworkAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "12076:20002",
"regionalCommunity": "12076:50004"
},
"peeringState": "Initiated",
"peeringSyncLevel": "FullyInSync",
"provisioningState": "Succeeded"
}
}
Create peering with remote virtual network encryption
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?syncRemoteAddressSpace=true&api-version=2023-09-01
{
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
}
}
}
from azure.identity import DefaultAzureCredential
from azure.mgmt.network import NetworkManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-network
# USAGE
python virtual_network_peering_create_with_remote_virtual_network_encryption.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 = NetworkManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.virtual_network_peerings.begin_create_or_update(
resource_group_name="peerTest",
virtual_network_name="vnet1",
virtual_network_peering_name="peer",
virtual_network_peering_parameters={
"properties": {
"allowForwardedTraffic": True,
"allowGatewayTransit": False,
"allowVirtualNetworkAccess": True,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"useRemoteGateways": False,
}
},
).result()
print(response)
# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreateWithRemoteVirtualNetworkEncryption.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
package armnetwork_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d4205894880b989ede35d62d97c8e901ed14fb5a/specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreateWithRemoteVirtualNetworkEncryption.json
func ExampleVirtualNetworkPeeringsClient_BeginCreateOrUpdate_createPeeringWithRemoteVirtualNetworkEncryption() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualNetworkPeeringsClient().BeginCreateOrUpdate(ctx, "peerTest", "vnet1", "peer", armnetwork.VirtualNetworkPeering{
Properties: &armnetwork.VirtualNetworkPeeringPropertiesFormat{
AllowForwardedTraffic: to.Ptr(true),
AllowGatewayTransit: to.Ptr(false),
AllowVirtualNetworkAccess: to.Ptr(true),
RemoteVirtualNetwork: &armnetwork.SubResource{
ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
},
UseRemoteGateways: to.Ptr(false),
},
}, &armnetwork.VirtualNetworkPeeringsClientBeginCreateOrUpdateOptions{SyncRemoteAddressSpace: nil})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %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.VirtualNetworkPeering = armnetwork.VirtualNetworkPeering{
// ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer"),
// Name: to.Ptr("peer"),
// Properties: &armnetwork.VirtualNetworkPeeringPropertiesFormat{
// AllowForwardedTraffic: to.Ptr(true),
// AllowGatewayTransit: to.Ptr(false),
// AllowVirtualNetworkAccess: to.Ptr(true),
// PeeringState: to.Ptr(armnetwork.VirtualNetworkPeeringStateInitiated),
// ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
// RemoteAddressSpace: &armnetwork.AddressSpace{
// AddressPrefixes: []*string{
// to.Ptr("12.0.0.0/8")},
// },
// RemoteBgpCommunities: &armnetwork.VirtualNetworkBgpCommunities{
// RegionalCommunity: to.Ptr("12076:50004"),
// VirtualNetworkCommunity: to.Ptr("12076:20002"),
// },
// RemoteVirtualNetwork: &armnetwork.SubResource{
// ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
// },
// RemoteVirtualNetworkEncryption: &armnetwork.VirtualNetworkEncryption{
// Enabled: to.Ptr(true),
// Enforcement: to.Ptr(armnetwork.VirtualNetworkEncryptionEnforcementAllowUnencrypted),
// },
// UseRemoteGateways: to.Ptr(false),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Creates or updates a peering in the specified virtual network.
*
* @summary Creates or updates a peering in the specified virtual network.
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreateWithRemoteVirtualNetworkEncryption.json
*/
async function createPeeringWithRemoteVirtualNetworkEncryption() {
const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "peerTest";
const virtualNetworkName = "vnet1";
const virtualNetworkPeeringName = "peer";
const virtualNetworkPeeringParameters = {
allowForwardedTraffic: true,
allowGatewayTransit: false,
allowVirtualNetworkAccess: true,
remoteVirtualNetwork: {
id: "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2",
},
useRemoteGateways: false,
};
const credential = new DefaultAzureCredential();
const client = new NetworkManagementClient(credential, subscriptionId);
const result = await client.virtualNetworkPeerings.beginCreateOrUpdateAndWait(
resourceGroupName,
virtualNetworkName,
virtualNetworkPeeringName,
virtualNetworkPeeringParameters,
);
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
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Network;
using Azure.ResourceManager.Network.Models;
// Generated from example definition: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringCreateWithRemoteVirtualNetworkEncryption.json
// this example is just showing the usage of "VirtualNetworkPeerings_CreateOrUpdate" 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 VirtualNetworkResource created on azure
// for more information of creating VirtualNetworkResource, please refer to the document of VirtualNetworkResource
string subscriptionId = "subid";
string resourceGroupName = "peerTest";
string virtualNetworkName = "vnet1";
ResourceIdentifier virtualNetworkResourceId = VirtualNetworkResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualNetworkName);
VirtualNetworkResource virtualNetwork = client.GetVirtualNetworkResource(virtualNetworkResourceId);
// get the collection of this VirtualNetworkPeeringResource
VirtualNetworkPeeringCollection collection = virtualNetwork.GetVirtualNetworkPeerings();
// invoke the operation
string virtualNetworkPeeringName = "peer";
VirtualNetworkPeeringData data = new VirtualNetworkPeeringData()
{
AllowVirtualNetworkAccess = true,
AllowForwardedTraffic = true,
AllowGatewayTransit = false,
UseRemoteGateways = false,
RemoteVirtualNetworkId = new ResourceIdentifier("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
};
ArmOperation<VirtualNetworkPeeringResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualNetworkPeeringName, data);
VirtualNetworkPeeringResource result = lro.Value;
// the variable result 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
VirtualNetworkPeeringData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
"name": "peer",
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"remoteAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "12076:20002",
"regionalCommunity": "12076:50004"
},
"remoteVirtualNetworkEncryption": {
"enabled": true,
"enforcement": "AllowUnencrypted"
},
"peeringState": "Initiated",
"provisioningState": "Succeeded"
}
}
{
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
"name": "peer",
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"remoteAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "12076:20002",
"regionalCommunity": "12076:50004"
},
"remoteVirtualNetworkEncryption": {
"enabled": true,
"enforcement": "AllowUnencrypted"
},
"peeringState": "Initiated",
"provisioningState": "Succeeded"
}
}
Sync Peering
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?syncRemoteAddressSpace=true&api-version=2023-09-01
{
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
}
}
}
import com.azure.core.management.SubResource;
import com.azure.resourcemanager.network.fluent.models.VirtualNetworkPeeringInner;
import com.azure.resourcemanager.network.models.SyncRemoteAddressSpace;
/**
* Samples for VirtualNetworkPeerings CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringSync.
* json
*/
/**
* Sample code: Sync Peering.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void syncPeering(com.azure.resourcemanager.AzureResourceManager azure) {
azure.networks().manager().serviceClient().getVirtualNetworkPeerings().createOrUpdate("peerTest", "vnet1",
"peer",
new VirtualNetworkPeeringInner().withAllowVirtualNetworkAccess(true).withAllowForwardedTraffic(true)
.withAllowGatewayTransit(false).withUseRemoteGateways(false)
.withRemoteVirtualNetwork(new SubResource().withId(
"/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2")),
SyncRemoteAddressSpace.TRUE, com.azure.core.util.Context.NONE);
}
/*
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/
* VirtualNetworkPeeringCreateWithRemoteVirtualNetworkEncryption.json
*/
/**
* Sample code: Create peering with remote virtual network encryption.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void
createPeeringWithRemoteVirtualNetworkEncryption(com.azure.resourcemanager.AzureResourceManager azure) {
azure.networks().manager().serviceClient().getVirtualNetworkPeerings().createOrUpdate("peerTest", "vnet1",
"peer",
new VirtualNetworkPeeringInner().withAllowVirtualNetworkAccess(true).withAllowForwardedTraffic(true)
.withAllowGatewayTransit(false).withUseRemoteGateways(false)
.withRemoteVirtualNetwork(new SubResource().withId(
"/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2")),
null, 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
from azure.identity import DefaultAzureCredential
from azure.mgmt.network import NetworkManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-network
# USAGE
python virtual_network_peering_sync.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 = NetworkManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.virtual_network_peerings.begin_create_or_update(
resource_group_name="peerTest",
virtual_network_name="vnet1",
virtual_network_peering_name="peer",
virtual_network_peering_parameters={
"properties": {
"allowForwardedTraffic": True,
"allowGatewayTransit": False,
"allowVirtualNetworkAccess": True,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"useRemoteGateways": False,
}
},
).result()
print(response)
# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringSync.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
package armnetwork_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d4205894880b989ede35d62d97c8e901ed14fb5a/specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringSync.json
func ExampleVirtualNetworkPeeringsClient_BeginCreateOrUpdate_syncPeering() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualNetworkPeeringsClient().BeginCreateOrUpdate(ctx, "peerTest", "vnet1", "peer", armnetwork.VirtualNetworkPeering{
Properties: &armnetwork.VirtualNetworkPeeringPropertiesFormat{
AllowForwardedTraffic: to.Ptr(true),
AllowGatewayTransit: to.Ptr(false),
AllowVirtualNetworkAccess: to.Ptr(true),
RemoteVirtualNetwork: &armnetwork.SubResource{
ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
},
UseRemoteGateways: to.Ptr(false),
},
}, &armnetwork.VirtualNetworkPeeringsClientBeginCreateOrUpdateOptions{SyncRemoteAddressSpace: to.Ptr(armnetwork.SyncRemoteAddressSpaceTrue)})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %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.VirtualNetworkPeering = armnetwork.VirtualNetworkPeering{
// ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer"),
// Name: to.Ptr("peer"),
// Properties: &armnetwork.VirtualNetworkPeeringPropertiesFormat{
// AllowForwardedTraffic: to.Ptr(true),
// AllowGatewayTransit: to.Ptr(false),
// AllowVirtualNetworkAccess: to.Ptr(true),
// PeeringState: to.Ptr(armnetwork.VirtualNetworkPeeringStateInitiated),
// PeeringSyncLevel: to.Ptr(armnetwork.VirtualNetworkPeeringLevelFullyInSync),
// ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
// RemoteAddressSpace: &armnetwork.AddressSpace{
// AddressPrefixes: []*string{
// to.Ptr("12.0.0.0/8")},
// },
// RemoteBgpCommunities: &armnetwork.VirtualNetworkBgpCommunities{
// RegionalCommunity: to.Ptr("12076:50004"),
// VirtualNetworkCommunity: to.Ptr("12076:20002"),
// },
// RemoteVirtualNetwork: &armnetwork.SubResource{
// ID: to.Ptr("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
// },
// RemoteVirtualNetworkAddressSpace: &armnetwork.AddressSpace{
// AddressPrefixes: []*string{
// to.Ptr("12.0.0.0/8")},
// },
// UseRemoteGateways: to.Ptr(false),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Creates or updates a peering in the specified virtual network.
*
* @summary Creates or updates a peering in the specified virtual network.
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringSync.json
*/
async function syncPeering() {
const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "peerTest";
const virtualNetworkName = "vnet1";
const virtualNetworkPeeringName = "peer";
const syncRemoteAddressSpace = "true";
const virtualNetworkPeeringParameters = {
allowForwardedTraffic: true,
allowGatewayTransit: false,
allowVirtualNetworkAccess: true,
remoteVirtualNetwork: {
id: "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2",
},
useRemoteGateways: false,
};
const options = {
syncRemoteAddressSpace,
};
const credential = new DefaultAzureCredential();
const client = new NetworkManagementClient(credential, subscriptionId);
const result = await client.virtualNetworkPeerings.beginCreateOrUpdateAndWait(
resourceGroupName,
virtualNetworkName,
virtualNetworkPeeringName,
virtualNetworkPeeringParameters,
options,
);
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
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Network;
using Azure.ResourceManager.Network.Models;
// Generated from example definition: specification/network/resource-manager/Microsoft.Network/stable/2023-09-01/examples/VirtualNetworkPeeringSync.json
// this example is just showing the usage of "VirtualNetworkPeerings_CreateOrUpdate" 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 VirtualNetworkResource created on azure
// for more information of creating VirtualNetworkResource, please refer to the document of VirtualNetworkResource
string subscriptionId = "subid";
string resourceGroupName = "peerTest";
string virtualNetworkName = "vnet1";
ResourceIdentifier virtualNetworkResourceId = VirtualNetworkResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualNetworkName);
VirtualNetworkResource virtualNetwork = client.GetVirtualNetworkResource(virtualNetworkResourceId);
// get the collection of this VirtualNetworkPeeringResource
VirtualNetworkPeeringCollection collection = virtualNetwork.GetVirtualNetworkPeerings();
// invoke the operation
string virtualNetworkPeeringName = "peer";
VirtualNetworkPeeringData data = new VirtualNetworkPeeringData()
{
AllowVirtualNetworkAccess = true,
AllowForwardedTraffic = true,
AllowGatewayTransit = false,
UseRemoteGateways = false,
RemoteVirtualNetworkId = new ResourceIdentifier("/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"),
};
SyncRemoteAddressSpace? syncRemoteAddressSpace = SyncRemoteAddressSpace.True;
ArmOperation<VirtualNetworkPeeringResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, virtualNetworkPeeringName, data, syncRemoteAddressSpace: syncRemoteAddressSpace);
VirtualNetworkPeeringResource result = lro.Value;
// the variable result 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
VirtualNetworkPeeringData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
"name": "peer",
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"remoteAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteVirtualNetworkAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "12076:20002",
"regionalCommunity": "12076:50004"
},
"peeringState": "Initiated",
"peeringSyncLevel": "FullyInSync",
"provisioningState": "Succeeded"
}
}
{
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
"name": "peer",
"properties": {
"allowVirtualNetworkAccess": true,
"allowForwardedTraffic": true,
"allowGatewayTransit": false,
"useRemoteGateways": false,
"remoteVirtualNetwork": {
"id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
},
"remoteAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteVirtualNetworkAddressSpace": {
"addressPrefixes": [
"12.0.0.0/8"
]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "12076:20002",
"regionalCommunity": "12076:50004"
},
"peeringState": "Initiated",
"peeringSyncLevel": "FullyInSync",
"provisioningState": "Succeeded"
}
}
Definitions
AddressSpace
AddressSpace contains an array of IP address ranges that can be used by subnets of the virtual network.
Name |
Type |
Description |
addressPrefixes
|
string[]
|
A list of address blocks reserved for this virtual network in CIDR notation.
|
CloudError
An error response from the service.
CloudErrorBody
An error response from the service.
Name |
Type |
Description |
code
|
string
|
An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
|
details
|
CloudErrorBody[]
|
A list of additional details about the error.
|
message
|
string
|
A message describing the error, intended to be suitable for display in a user interface.
|
target
|
string
|
The target of the particular error. For example, the name of the property in error.
|
ProvisioningState
The current provisioning state.
Name |
Type |
Description |
Deleting
|
string
|
|
Failed
|
string
|
|
Succeeded
|
string
|
|
Updating
|
string
|
|
SubResource
Reference to another subresource.
Name |
Type |
Description |
id
|
string
|
Resource ID.
|
SyncRemoteAddressSpace
Parameter indicates the intention to sync the peering with the current address space on the remote vNet after it's updated.
Name |
Type |
Description |
true
|
string
|
|
VirtualNetworkBgpCommunities
Bgp Communities sent over ExpressRoute with each route corresponding to a prefix in this VNET.
Name |
Type |
Description |
regionalCommunity
|
string
|
The BGP community associated with the region of the virtual network.
|
virtualNetworkCommunity
|
string
|
The BGP community associated with the virtual network.
|
VirtualNetworkEncryption
Indicates if encryption is enabled on virtual network and if VM without encryption is allowed in encrypted VNet.
Name |
Type |
Description |
enabled
|
boolean
|
Indicates if encryption is enabled on the virtual network.
|
enforcement
|
VirtualNetworkEncryptionEnforcement
|
If the encrypted VNet allows VM that does not support encryption
|
VirtualNetworkEncryptionEnforcement
If the encrypted VNet allows VM that does not support encryption
Name |
Type |
Description |
AllowUnencrypted
|
string
|
|
DropUnencrypted
|
string
|
|
VirtualNetworkPeering
Peerings in a virtual network resource.
Name |
Type |
Description |
etag
|
string
|
A unique read-only string that changes whenever the resource is updated.
|
id
|
string
|
Resource ID.
|
name
|
string
|
The name of the resource that is unique within a resource group. This name can be used to access the resource.
|
properties.allowForwardedTraffic
|
boolean
|
Whether the forwarded traffic from the VMs in the local virtual network will be allowed/disallowed in remote virtual network.
|
properties.allowGatewayTransit
|
boolean
|
If gateway links can be used in remote virtual networking to link to this virtual network.
|
properties.allowVirtualNetworkAccess
|
boolean
|
Whether the VMs in the local virtual network space would be able to access the VMs in remote virtual network space.
|
properties.doNotVerifyRemoteGateways
|
boolean
|
If we need to verify the provisioning state of the remote gateway.
|
properties.peeringState
|
VirtualNetworkPeeringState
|
The status of the virtual network peering.
|
properties.peeringSyncLevel
|
VirtualNetworkPeeringLevel
|
The peering sync status of the virtual network peering.
|
properties.provisioningState
|
ProvisioningState
|
The provisioning state of the virtual network peering resource.
|
properties.remoteAddressSpace
|
AddressSpace
|
The reference to the address space peered with the remote virtual network.
|
properties.remoteBgpCommunities
|
VirtualNetworkBgpCommunities
|
The reference to the remote virtual network's Bgp Communities.
|
properties.remoteVirtualNetwork
|
SubResource
|
The reference to the remote virtual network. The remote virtual network can be in the same or different region (preview). See here to register for the preview and learn more (https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-create-peering).
|
properties.remoteVirtualNetworkAddressSpace
|
AddressSpace
|
The reference to the current address space of the remote virtual network.
|
properties.remoteVirtualNetworkEncryption
|
VirtualNetworkEncryption
|
The reference to the remote virtual network's encryption
|
properties.resourceGuid
|
string
|
The resourceGuid property of the Virtual Network peering resource.
|
properties.useRemoteGateways
|
boolean
|
If remote gateways can be used on this virtual network. If the flag is set to true, and allowGatewayTransit on remote peering is also true, virtual network will use gateways of remote virtual network for transit. Only one peering can have this flag set to true. This flag cannot be set if virtual network already has a gateway.
|
type
|
string
|
Resource type.
|
VirtualNetworkPeeringLevel
The peering sync status of the virtual network peering.
Name |
Type |
Description |
FullyInSync
|
string
|
|
LocalAndRemoteNotInSync
|
string
|
|
LocalNotInSync
|
string
|
|
RemoteNotInSync
|
string
|
|
VirtualNetworkPeeringState
The status of the virtual network peering.
Name |
Type |
Description |
Connected
|
string
|
|
Disconnected
|
string
|
|
Initiated
|
string
|
|