Condividi tramite


Virtual Network Peerings - Get

Ottiene il peering di rete virtuale specificato.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/virtualNetworkPeerings/{virtualNetworkPeeringName}?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.

virtualNetworkPeeringName
path True

string

Nome del peering di rete virtuale.

api-version
query True

string

Versione API client.

Risposte

Nome Tipo Descrizione
200 OK

VirtualNetworkPeering

Richiesta riuscita. L'operazione restituisce la risorsa VirtualNetworkPeering risultante.

Other Status Codes

CloudError

Risposta di errore che descrive perché 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

Get peering
Get peering with remote virtual network encryption

Get peering

Sample Request

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

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

Get peering with remote virtual network encryption

Sample Request

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

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

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 sottoresource.

VirtualNetworkBgpCommunities

Le 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 alla macchina virtuale che non supporta la crittografia

VirtualNetworkPeering

Peering in una risorsa di rete virtuale.

VirtualNetworkPeeringLevel

Stato di sincronizzazione del peering della rete virtuale.

VirtualNetworkPeeringState

Stato del peering della 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 usati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

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

target

string

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

ProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Deleting

string

Failed

string

Succeeded

string

Updating

string

SubResource

Riferimento a un'altra sottoresource.

Nome Tipo Descrizione
id

string

ID risorsa.

VirtualNetworkBgpCommunities

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

Nome Tipo Descrizione
regionalCommunity

string

La community BGP associata all'area della rete virtuale.

virtualNetworkCommunity

string

La 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 alla macchina virtuale che non supporta la crittografia

VirtualNetworkEncryptionEnforcement

Se la rete virtuale crittografata consente alla 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

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 al gateway possono essere usati nella rete virtuale remota per collegarsi a questa rete virtuale.

properties.allowVirtualNetworkAccess

boolean

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 della rete virtuale.

properties.peeringSyncLevel

VirtualNetworkPeeringLevel

Stato di sincronizzazione del peering della rete virtuale.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa di 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 diversa (anteprima). Vedere qui per registrare 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 di peering Rete virtuale.

properties.useRemoteGateways

boolean

Se i gateway remoti possono essere usati in questa rete virtuale. Se il flag è impostato su true e allowGatewayTransit sul peering remoto è true, la rete virtuale userà gateway di rete virtuale remota per il transito. Un solo 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 della rete virtuale.

Nome Tipo Descrizione
FullyInSync

string

LocalAndRemoteNotInSync

string

LocalNotInSync

string

RemoteNotInSync

string

VirtualNetworkPeeringState

Stato del peering della rete virtuale.

Nome Tipo Descrizione
Connected

string

Disconnected

string

Initiated

string