Condividi tramite


Virtual Network Peerings - List

Ottiene tutti i peering di rete virtuale in una rete virtuale.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse.

subscriptionId
path True

string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

virtualNetworkName
path True

string

nome della rete virtuale.

api-version
query True

string

Versione API client.

Risposte

Nome Tipo Descrizione
200 OK

VirtualNetworkPeeringListResult

Richiesta completata. L'operazione restituisce un elenco di risorse VirtualNetworkPeering.

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

List peerings
List peerings with remote virtual network encryption

List peerings

Sample Request

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

Sample Response

{
  "value": [
    {
      "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/peer2",
      "name": "peer",
      "properties": {
        "allowVirtualNetworkAccess": true,
        "allowForwardedTraffic": false,
        "allowGatewayTransit": false,
        "useRemoteGateways": false,
        "remoteVirtualNetwork": {
          "id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet3"
        },
        "remoteAddressSpace": {
          "addressPrefixes": [
            "13.0.0.0/8"
          ]
        },
        "remoteVirtualNetworkAddressSpace": {
          "addressPrefixes": [
            "13.0.0.0/8"
          ]
        },
        "remoteBgpCommunities": {
          "virtualNetworkCommunity": "12076:20003",
          "regionalCommunity": "12076:50004"
        },
        "peeringState": "Initiated",
        "peeringSyncLevel": "FullyInSync",
        "provisioningState": "Succeeded"
      }
    }
  ]
}

List peerings with remote virtual network encryption

Sample Request

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

Sample Response

{
  "value": [
    {
      "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/peer2",
      "name": "peer",
      "properties": {
        "allowVirtualNetworkAccess": true,
        "allowForwardedTraffic": false,
        "allowGatewayTransit": false,
        "useRemoteGateways": false,
        "remoteVirtualNetwork": {
          "id": "/subscriptions/subid/resourceGroups/peerTest/providers/Microsoft.Network/virtualNetworks/vnet3"
        },
        "remoteAddressSpace": {
          "addressPrefixes": [
            "13.0.0.0/8"
          ]
        },
        "remoteBgpCommunities": {
          "virtualNetworkCommunity": "12076:20003",
          "regionalCommunity": "12076:50004"
        },
        "remoteVirtualNetworkEncryption": {
          "enabled": true,
          "enforcement": "AllowUnencrypted"
        },
        "peeringState": "Initiated",
        "provisioningState": "Succeeded"
      }
    }
  ]
}

Definizioni

Nome Descrizione
AddressSpace

AddressSpace contiene una matrice di intervalli di indirizzi IP che possono essere usati dalle subnet della rete virtuale.

CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

ProvisioningState

Stato di provisioning corrente.

SubResource

Riferimento a un'altra sottorisorsa.

VirtualNetworkBgpCommunities

Community Bgp inviate tramite ExpressRoute con ogni route corrispondente a un prefisso in questa rete virtuale.

VirtualNetworkEncryption

Indica se la crittografia è abilitata nella rete virtuale e se la macchina virtuale senza crittografia è consentita nella rete virtuale crittografata.

VirtualNetworkEncryptionEnforcement

Se la rete virtuale crittografata consente la macchina virtuale che non supporta la crittografia

VirtualNetworkPeering

Peering in una risorsa di rete virtuale.

VirtualNetworkPeeringLevel

Stato di sincronizzazione del peering del peering di rete virtuale.

VirtualNetworkPeeringListResult

Risposta per la chiamata al servizio API ListSubnets. Recupera tutte le subnet che appartengono a una rete virtuale.

VirtualNetworkPeeringState

Stato del peering di rete virtuale.

AddressSpace

AddressSpace contiene una matrice di intervalli di indirizzi IP che possono essere usati dalle subnet della rete virtuale.

Nome Tipo Descrizione
addressPrefixes

string[]

Elenco di blocchi di indirizzi riservati per questa rete virtuale nella notazione CIDR.

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, che deve essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

ProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Deleting

string

Failed

string

Succeeded

string

Updating

string

SubResource

Riferimento a un'altra sottorisorsa.

Nome Tipo Descrizione
id

string

ID risorsa.

VirtualNetworkBgpCommunities

Community Bgp inviate tramite ExpressRoute con ogni route corrispondente a un prefisso in questa rete virtuale.

Nome Tipo Descrizione
regionalCommunity

string

Community BGP associata all'area della rete virtuale.

virtualNetworkCommunity

string

Community BGP associata alla rete virtuale.

VirtualNetworkEncryption

Indica se la crittografia è abilitata nella rete virtuale e se la macchina virtuale senza crittografia è consentita nella rete virtuale crittografata.

Nome Tipo Descrizione
enabled

boolean

Indica se la crittografia è abilitata nella rete virtuale.

enforcement

VirtualNetworkEncryptionEnforcement

Se la rete virtuale crittografata consente la macchina virtuale che non supporta la crittografia

VirtualNetworkEncryptionEnforcement

Se la rete virtuale crittografata consente la macchina virtuale che non supporta la crittografia

Nome Tipo Descrizione
AllowUnencrypted

string

DropUnencrypted

string

VirtualNetworkPeering

Peering in una risorsa di rete virtuale.

Nome Tipo Descrizione
etag

string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id

string

ID risorsa.

name

string

Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.

properties.allowForwardedTraffic

boolean

Indica se il traffico inoltrato dalle macchine virtuali nella rete virtuale locale sarà consentito/non consentito nella rete virtuale remota.

properties.allowGatewayTransit

boolean

Se i collegamenti gateway possono essere usati nella rete virtuale remota per collegarsi a questa rete virtuale.

properties.allowVirtualNetworkAccess

boolean

Indica se le macchine virtuali nello spazio di rete virtuale locale sarebbero in grado di accedere alle macchine virtuali nello spazio di rete virtuale remoto.

properties.doNotVerifyRemoteGateways

boolean

Se è necessario verificare lo stato di provisioning del gateway remoto.

properties.peeringState

VirtualNetworkPeeringState

Stato del peering di rete virtuale.

properties.peeringSyncLevel

VirtualNetworkPeeringLevel

Stato di sincronizzazione del peering del peering di rete virtuale.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa peering di rete virtuale.

properties.remoteAddressSpace

AddressSpace

Riferimento allo spazio indirizzi con peering con la rete virtuale remota.

properties.remoteBgpCommunities

VirtualNetworkBgpCommunities

Riferimento alle community Bgp della rete virtuale remota.

properties.remoteVirtualNetwork

SubResource

Riferimento alla rete virtuale remota. La rete virtuale remota può trovarsi nella stessa area o in un'area diversa (anteprima). Vedere qui per registrarsi per l'anteprima e altre informazioni (https://docs.microsoft.com/en-us/azure/virtual-network/virtual-network-create-peering).

properties.remoteVirtualNetworkAddressSpace

AddressSpace

Riferimento allo spazio indirizzi corrente della rete virtuale remota.

properties.remoteVirtualNetworkEncryption

VirtualNetworkEncryption

Riferimento alla crittografia della rete virtuale remota

properties.resourceGuid

string

Proprietà resourceGuid della risorsa Rete virtuale peering.

properties.useRemoteGateways

boolean

Se i gateway remoti possono essere usati in questa rete virtuale. Se il flag è impostato su true e allowGatewayTransit nel peering remoto è true, anche la rete virtuale userà i gateway della rete virtuale remota per il transito. Solo un peering può avere questo flag impostato su true. Questo flag non può essere impostato se la rete virtuale ha già un gateway.

type

string

Tipo di risorsa.

VirtualNetworkPeeringLevel

Stato di sincronizzazione del peering del peering di rete virtuale.

Nome Tipo Descrizione
FullyInSync

string

LocalAndRemoteNotInSync

string

LocalNotInSync

string

RemoteNotInSync

string

VirtualNetworkPeeringListResult

Risposta per la chiamata al servizio API ListSubnets. Recupera tutte le subnet che appartengono a una rete virtuale.

Nome Tipo Descrizione
nextLink

string

URL per ottenere il set di risultati successivo.

value

VirtualNetworkPeering[]

Peering in una rete virtuale.

VirtualNetworkPeeringState

Stato del peering di rete virtuale.

Nome Tipo Descrizione
Connected

string

Disconnected

string

Initiated

string