Delen via


Virtual Network Peerings - Get

Hiermee haalt u de opgegeven peering voor het virtuele netwerk op.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/virtualNetworkPeerings/{virtualNetworkPeeringName}?api-version=2024-05-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

virtualNetworkName
path True

string

De naam van het virtuele netwerk.

virtualNetworkPeeringName
path True

string

De naam van de peering van het virtuele netwerk.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

VirtualNetworkPeering

Aanvraag is voltooid. De bewerking retourneert de resulterende VirtualNetworkPeering-resource.

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Get peering
Get peering with remote virtual network encryption
Get subnet peering
Get V6 subnet peering

Get peering

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?api-version=2024-05-01

Voorbeeldrespons

{
  "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"
  }
}

Get peering with remote virtual network encryption

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?api-version=2024-05-01

Voorbeeldrespons

{
  "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"
  }
}

Get subnet peering

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?api-version=2024-05-01

Voorbeeldrespons

{
  "id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
  "name": "peer",
  "properties": {
    "allowVirtualNetworkAccess": true,
    "allowForwardedTraffic": true,
    "allowGatewayTransit": false,
    "useRemoteGateways": false,
    "localSubnetNames": [
      "Subnet1"
    ],
    "remoteSubnetNames": [
      "Subnet2"
    ],
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
    },
    "remoteAddressSpace": {
      "addressPrefixes": [
        "12.0.0.0/8",
        "2001:2001::/64"
      ]
    },
    "localAddressSpace": {
      "addressPrefixes": [
        "212.0.0.0/16",
        "2002:2002::/64"
      ]
    },
    "localVirtualNetworkAddressSpace": {
      "addressPrefixes": [
        "212.0.0.0/16",
        "2002:2002::/64"
      ]
    },
    "remoteVirtualNetworkAddressSpace": {
      "addressPrefixes": [
        "12.0.0.0/8",
        "2001:2001::/64"
      ]
    },
    "remoteBgpCommunities": {
      "virtualNetworkCommunity": "12076:20002",
      "regionalCommunity": "12076:50004"
    },
    "peeringState": "Initiated",
    "peeringSyncLevel": "FullyInSync",
    "peerCompleteVnets": false,
    "enableOnlyIPv6Peering": false,
    "provisioningState": "Succeeded"
  }
}

Get V6 subnet peering

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer?api-version=2024-05-01

Voorbeeldrespons

{
  "id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet1/virtualNetworkPeerings/peer",
  "name": "peer",
  "properties": {
    "allowVirtualNetworkAccess": true,
    "allowForwardedTraffic": true,
    "allowGatewayTransit": false,
    "useRemoteGateways": false,
    "localSubnetNames": [
      "Subnet1"
    ],
    "remoteSubnetNames": [
      "Subnet2"
    ],
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet2"
    },
    "remoteAddressSpace": {
      "addressPrefixes": [
        "2001:2001::/64"
      ]
    },
    "localAddressSpace": {
      "addressPrefixes": [
        "2002:2002::/64"
      ]
    },
    "localVirtualNetworkAddressSpace": {
      "addressPrefixes": [
        "2002:2002::/64"
      ]
    },
    "remoteVirtualNetworkAddressSpace": {
      "addressPrefixes": [
        "2001:2001::/64"
      ]
    },
    "remoteBgpCommunities": {
      "virtualNetworkCommunity": "12076:20002",
      "regionalCommunity": "12076:50004"
    },
    "peeringState": "Initiated",
    "peeringSyncLevel": "FullyInSync",
    "peerCompleteVnets": false,
    "enableOnlyIPv6Peering": true,
    "provisioningState": "Succeeded"
  }
}

Definities

Name Description
AddressSpace

AddressSpace bevat een matrix met IP-adresbereiken die kunnen worden gebruikt door subnetten van het virtuele netwerk.

CloudError

Een foutreactie van de service.

CloudErrorBody

Een foutreactie van de service.

IpamPoolPrefixAllocation

Verwijzing naar ipamPool-voorvoegseltoewijzing.

ProvisioningState

De huidige inrichtingsstatus.

SubResource

Verwijzing naar een andere subresource.

VirtualNetworkBgpCommunities

Bgp-community's die via ExpressRoute worden verzonden, waarbij elke route overeenkomt met een voorvoegsel in dit VNET.

VirtualNetworkEncryption

Geeft aan of versleuteling is ingeschakeld in een virtueel netwerk en of vm zonder versleuteling is toegestaan in versleuteld VNet.

VirtualNetworkEncryptionEnforcement

Als het versleutelde VNet VM toestaat die geen ondersteuning biedt voor versleuteling. Dit veld is bedoeld voor toekomstige ondersteuning. AllowUnencrypted is de enige ondersteunde waarde bij algemene beschikbaarheid.

VirtualNetworkPeering

Peerings in een virtuele netwerkresource.

VirtualNetworkPeeringLevel

De peeringsynchronisatiestatus van de peering van het virtuele netwerk.

VirtualNetworkPeeringState

De status van peering van het virtuele netwerk.

AddressSpace

AddressSpace bevat een matrix met IP-adresbereiken die kunnen worden gebruikt door subnetten van het virtuele netwerk.

Name Type Description
addressPrefixes

string[]

Een lijst met adresblokken die zijn gereserveerd voor dit virtuele netwerk in CIDR-notatie.

ipamPoolPrefixAllocations

IpamPoolPrefixAllocation[]

Een lijst met IPAM-pools die IP-adresvoorvoegsels toewijzen.

CloudError

Een foutreactie van de service.

Name Type Description
error

CloudErrorBody

Hoofdtekst van cloudfout.

CloudErrorBody

Een foutreactie van de service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

details

CloudErrorBody[]

Een lijst met aanvullende informatie over de fout.

message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

target

string

Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

IpamPoolPrefixAllocation

Verwijzing naar ipamPool-voorvoegseltoewijzing.

Name Type Description
allocatedAddressPrefixes

string[]

Lijst met toegewezen IP-adresvoorvoegsels in de IpamPool van de gekoppelde resource.

numberOfIpAddresses

string

Aantal IP-adressen dat moet worden toegewezen.

pool.id

string (arm-id)

Resource-id van de bijbehorende Azure IpamPool-resource.

ProvisioningState

De huidige inrichtingsstatus.

Waarde Description
Deleting
Failed
Succeeded
Updating

SubResource

Verwijzing naar een andere subresource.

Name Type Description
id

string

Resource-id.

VirtualNetworkBgpCommunities

Bgp-community's die via ExpressRoute worden verzonden, waarbij elke route overeenkomt met een voorvoegsel in dit VNET.

Name Type Description
regionalCommunity

string

De BGP-community die is gekoppeld aan de regio van het virtuele netwerk.

virtualNetworkCommunity

string

De BGP-community die is gekoppeld aan het virtuele netwerk.

VirtualNetworkEncryption

Geeft aan of versleuteling is ingeschakeld in een virtueel netwerk en of vm zonder versleuteling is toegestaan in versleuteld VNet.

Name Type Description
enabled

boolean

Geeft aan of versleuteling is ingeschakeld in het virtuele netwerk.

enforcement

VirtualNetworkEncryptionEnforcement

Als het versleutelde VNet VM toestaat die geen ondersteuning biedt voor versleuteling. Dit veld is bedoeld voor toekomstige ondersteuning. AllowUnencrypted is de enige ondersteunde waarde bij algemene beschikbaarheid.

VirtualNetworkEncryptionEnforcement

Als het versleutelde VNet VM toestaat die geen ondersteuning biedt voor versleuteling. Dit veld is bedoeld voor toekomstige ondersteuning. AllowUnencrypted is de enige ondersteunde waarde bij algemene beschikbaarheid.

Waarde Description
AllowUnencrypted
DropUnencrypted

VirtualNetworkPeering

Peerings in een virtuele netwerkresource.

Name Type Description
etag

string

Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.

id

string

Resource-id.

name

string

De naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot de resource.

properties.allowForwardedTraffic

boolean

Of het doorgestuurde verkeer van de VIRTUELE machines in het lokale virtuele netwerk wordt toegestaan/niet toegestaan in een extern virtueel netwerk.

properties.allowGatewayTransit

boolean

Als gatewaykoppelingen kunnen worden gebruikt in externe virtuele netwerken om verbinding te maken met dit virtuele netwerk.

properties.allowVirtualNetworkAccess

boolean

Of de VM's in de lokale virtuele netwerkruimte toegang hebben tot de VM's in externe virtuele netwerkruimte.

properties.doNotVerifyRemoteGateways

boolean

Als we de inrichtingsstatus van de externe gateway moeten controleren.

properties.enableOnlyIPv6Peering

boolean

Of alleen ipv6-adresruimte is gekoppeld voor subnetpeering.

properties.localAddressSpace

AddressSpace

De lokale adresruimte van het lokale virtuele netwerk dat is gekoppeld.

properties.localSubnetNames

string[]

Lijst met lokale subnetnamen die zijn gekoppeld aan een extern virtueel netwerk.

properties.localVirtualNetworkAddressSpace

AddressSpace

De huidige lokale adresruimte van het lokale virtuele netwerk dat is gekoppeld.

properties.peerCompleteVnets

boolean

Of de volledige adresruimte van het virtuele netwerk is gekoppeld.

properties.peeringState

VirtualNetworkPeeringState

De status van peering van het virtuele netwerk.

properties.peeringSyncLevel

VirtualNetworkPeeringLevel

De peeringsynchronisatiestatus van de peering van het virtuele netwerk.

properties.provisioningState

ProvisioningState

De inrichtingsstatus van de peeringresource van het virtuele netwerk.

properties.remoteAddressSpace

AddressSpace

De verwijzing naar de adresruimte die is gekoppeld aan het externe virtuele netwerk.

properties.remoteBgpCommunities

VirtualNetworkBgpCommunities

De verwijzing naar de BGP-community's van het externe virtuele netwerk.

properties.remoteSubnetNames

string[]

Lijst met externe subnetnamen van extern virtueel netwerk die zijn gekoppeld aan een subnet.

properties.remoteVirtualNetwork

SubResource

De verwijzing naar het externe virtuele netwerk. Het externe virtuele netwerk kan zich in dezelfde of een andere regio bevinden (preview). Zie hier om u te registreren voor de preview en meer te weten te komen (https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-create-peering).

properties.remoteVirtualNetworkAddressSpace

AddressSpace

De verwijzing naar de huidige adresruimte van het externe virtuele netwerk.

properties.remoteVirtualNetworkEncryption

VirtualNetworkEncryption

De verwijzing naar de versleuteling van het externe virtuele netwerk

properties.resourceGuid

string

De eigenschap resourceGuid van de peeringresource van virtual network.

properties.useRemoteGateways

boolean

Als externe gateways in dit virtuele netwerk kunnen worden gebruikt. Als de vlag is ingesteld op true en allowGatewayTransit op externe peering ook waar is, gebruikt het virtuele netwerk gateways van extern virtueel netwerk voor overdracht. Met slechts één peering kan deze vlag zijn ingesteld op waar. Deze vlag kan niet worden ingesteld als het virtuele netwerk al een gateway heeft.

type

string

Resourcetype.

VirtualNetworkPeeringLevel

De peeringsynchronisatiestatus van de peering van het virtuele netwerk.

Waarde Description
FullyInSync
LocalAndRemoteNotInSync
LocalNotInSync
RemoteNotInSync

VirtualNetworkPeeringState

De status van peering van het virtuele netwerk.

Waarde Description
Connected
Disconnected
Initiated