Vpn Sites - Create Or Update

Référence

Service:: Virtual WAN

Version d'API:: 2024-05-01

Crée une ressource VpnSite s’il n’existe pas d’autre mise à jour du site VpnSite existant.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}?api-version=2024-05-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources du VpnSite.
subscriptionId	path	True	string	Informations d’identification de l’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
vpnSiteName	path	True	string	Nom du vpnSite en cours de création ou de mise à jour.
api-version	query	True	string	Version de l’API cliente.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement des ressources.
id		string	ID de ressource.
properties.addressSpace		AddressSpace	AddressSpace qui contient un tableau de plages d’adresses IP.
properties.bgpProperties		BgpSettings	Ensemble de propriétés bgp.
properties.deviceProperties		DeviceProperties	Propriétés de l’appareil.
properties.ipAddress		string	Adresse IP du site vpn.
properties.isSecuritySite		boolean	Indicateur IsSecuritySite.
properties.o365Policy		O365PolicyProperties	Stratégie Office365.
properties.siteKey		string	Clé pour vpn-site qui peut être utilisée pour les connexions.
properties.virtualWan		SubResource	VirtualWAN auquel appartient le vpnSite.
properties.vpnSiteLinks		VpnSiteLink[]	Liste de tous les liens de site vpn.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	VpnSite	Demande réussie. Retourne les détails du vpnSite créé ou mis à jour.
201 Created	VpnSite	Demande reçue avec succès. Retourne les détails du vpnSite créé ou mis à jour.
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

VpnSiteCreate

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1?api-version=2024-05-01

{
  "tags": {
    "key1": "value1"
  },
  "location": "West US",
  "properties": {
    "virtualWan": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWANs/wan1"
    },
    "addressSpace": {
      "addressPrefixes": [
        "10.0.0.0/16"
      ]
    },
    "isSecuritySite": false,
    "vpnSiteLinks": [
      {
        "name": "vpnSiteLink1",
        "properties": {
          "ipAddress": "50.50.50.56",
          "fqdn": "link1.vpnsite1.contoso.com",
          "linkProperties": {
            "linkProviderName": "vendor1",
            "linkSpeedInMbps": 0
          },
          "bgpProperties": {
            "bgpPeeringAddress": "192.168.0.0",
            "asn": 1234
          }
        }
      }
    ],
    "o365Policy": {
      "breakOutCategories": {
        "allow": true,
        "optimize": true,
        "default": false
      }
    }
  }
}

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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ab04533261eff228f28e08900445d0edef3eb70c/specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/VpnSitePut.json
func ExampleVPNSitesClient_BeginCreateOrUpdate() {
	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.NewVPNSitesClient().BeginCreateOrUpdate(ctx, "rg1", "vpnSite1", armnetwork.VPNSite{
		Location: to.Ptr("West US"),
		Tags: map[string]*string{
			"key1": to.Ptr("value1"),
		},
		Properties: &armnetwork.VPNSiteProperties{
			AddressSpace: &armnetwork.AddressSpace{
				AddressPrefixes: []*string{
					to.Ptr("10.0.0.0/16")},
			},
			IsSecuritySite: to.Ptr(false),
			O365Policy: &armnetwork.O365PolicyProperties{
				BreakOutCategories: &armnetwork.O365BreakOutCategoryPolicies{
					Default:  to.Ptr(false),
					Allow:    to.Ptr(true),
					Optimize: to.Ptr(true),
				},
			},
			VirtualWan: &armnetwork.SubResource{
				ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWANs/wan1"),
			},
			VPNSiteLinks: []*armnetwork.VPNSiteLink{
				{
					Name: to.Ptr("vpnSiteLink1"),
					Properties: &armnetwork.VPNSiteLinkProperties{
						BgpProperties: &armnetwork.VPNLinkBgpSettings{
							Asn:               to.Ptr[int64](1234),
							BgpPeeringAddress: to.Ptr("192.168.0.0"),
						},
						Fqdn:      to.Ptr("link1.vpnsite1.contoso.com"),
						IPAddress: to.Ptr("50.50.50.56"),
						LinkProperties: &armnetwork.VPNLinkProviderProperties{
							LinkProviderName: to.Ptr("vendor1"),
							LinkSpeedInMbps:  to.Ptr[int32](0),
						},
					},
				}},
		},
	}, 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.VPNSite = armnetwork.VPNSite{
	// 	Name: to.Ptr("vpnSite1"),
	// 	Type: to.Ptr("Microsoft.Network/vpnSites"),
	// 	ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"key1": to.Ptr("value1"),
	// 	},
	// 	Etag: to.Ptr("w/\\00000000-0000-0000-0000-000000000000\\"),
	// 	Properties: &armnetwork.VPNSiteProperties{
	// 		AddressSpace: &armnetwork.AddressSpace{
	// 			AddressPrefixes: []*string{
	// 				to.Ptr("10.0.0.0/16")},
	// 			},
	// 			DeviceProperties: &armnetwork.DeviceProperties{
	// 				LinkSpeedInMbps: to.Ptr[int32](0),
	// 			},
	// 			IsSecuritySite: to.Ptr(false),
	// 			ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
	// 			VirtualWan: &armnetwork.SubResource{
	// 				ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWANs/wan1"),
	// 			},
	// 			VPNSiteLinks: []*armnetwork.VPNSiteLink{
	// 				{
	// 					ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/vpnSiteLink1"),
	// 					Name: to.Ptr("vpnSiteLink1"),
	// 					Type: to.Ptr("Microsoft.Network/vpnSites/vpnSiteLinks"),
	// 					Etag: to.Ptr("W/\"00000000-0000-0000-0000-000000000000\""),
	// 					Properties: &armnetwork.VPNSiteLinkProperties{
	// 						BgpProperties: &armnetwork.VPNLinkBgpSettings{
	// 							Asn: to.Ptr[int64](1234),
	// 							BgpPeeringAddress: to.Ptr("192.168.0.0"),
	// 						},
	// 						IPAddress: to.Ptr("50.50.50.56"),
	// 						LinkProperties: &armnetwork.VPNLinkProviderProperties{
	// 							LinkProviderName: to.Ptr("vendor1"),
	// 							LinkSpeedInMbps: to.Ptr[int32](0),
	// 						},
	// 						ProvisioningState: to.Ptr(armnetwork.ProvisioningStateSucceeded),
	// 					},
	// 			}},
	// 		},
	// 	}
}

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

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "name": "vpnSite1",
  "type": "Microsoft.Network/vpnSites",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "virtualWan": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWANs/wan1"
    },
    "deviceProperties": {
      "linkSpeedInMbps": 0
    },
    "addressSpace": {
      "addressPrefixes": [
        "10.0.0.0/16"
      ]
    },
    "isSecuritySite": false,
    "vpnSiteLinks": [
      {
        "name": "vpnSiteLink1",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/vpnSiteLink1",
        "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
        "type": "Microsoft.Network/vpnSites/vpnSiteLinks",
        "properties": {
          "provisioningState": "Succeeded",
          "ipAddress": "50.50.50.56",
          "linkProperties": {
            "linkProviderName": "vendor1",
            "linkSpeedInMbps": 0
          },
          "bgpProperties": {
            "bgpPeeringAddress": "192.168.0.0",
            "asn": 1234
          }
        }
      }
    ]
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "name": "vpnSite1",
  "type": "Microsoft.Network/vpnSites",
  "tags": {
    "key1": "value1"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "virtualWan": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWANs/wan1"
    },
    "deviceProperties": {
      "linkSpeedInMbps": 0
    },
    "addressSpace": {
      "addressPrefixes": [
        "10.0.0.0/16"
      ]
    },
    "isSecuritySite": false,
    "vpnSiteLinks": [
      {
        "name": "vpnSiteLink1",
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1/vpnSiteLinks/vpnSiteLink1",
        "etag": "W/\"00000000-0000-0000-0000-000000000000\"",
        "properties": {
          "provisioningState": "Succeeded",
          "ipAddress": "50.50.50.56",
          "linkProperties": {
            "linkProviderName": "vendor1",
            "linkSpeedInMbps": 0
          },
          "bgpProperties": {
            "bgpPeeringAddress": "192.168.0.0",
            "asn": 1234
          }
        }
      }
    ]
  }
}

Définitions

Nom	Description
AddressSpace	AddressSpace contient un tableau de plages d’adresses IP qui peuvent être utilisées par les sous-réseaux du réseau virtuel.
BgpSettings	Détails des paramètres BGP.
CloudError	Réponse d’erreur du service.
CloudErrorBody	Réponse d’erreur du service.
DeviceProperties	Liste des propriétés de l’appareil.
IpamPoolPrefixAllocation	Référence d’allocation de préfixe IpamPool.
IPConfigurationBgpPeeringAddress	Propriétés d’IPConfigurationBgpPeeringAddress.
O365BreakOutCategoryPolicies	Catégories de sous-groupes Office365.
O365PolicyProperties	Stratégie de déploiement Office365.
ProvisioningState	État d’approvisionnement actuel.
SubResource	Référence à une autre sous-ressource.
VpnLinkBgpSettings	Détails des paramètres BGP pour un lien.
VpnLinkProviderProperties	Liste des propriétés d’un fournisseur de liens.
VpnSite	Ressource VpnSite.
VpnSiteLink	Ressource VpnSiteLink.

AddressSpace

AddressSpace contient un tableau de plages d’adresses IP qui peuvent être utilisées par les sous-réseaux du réseau virtuel.

Nom	Type	Description
addressPrefixes	string[]	Liste des blocs d’adresses réservés à ce réseau virtuel en notation CIDR.
ipamPoolPrefixAllocations	IpamPoolPrefixAllocation[]	Liste des pools IPAM qui allouent des préfixes d’adresses IP.

BgpSettings

Détails des paramètres BGP.

Nom	Type	Description
asn	integer	ASN de l’orateur BGP.
bgpPeeringAddress	string	Adresse de peering BGP et identificateur BGP de cet orateur BGP.
bgpPeeringAddresses	IPConfigurationBgpPeeringAddress[]	Adresse de peering BGP avec l’ID de configuration IP pour la passerelle de réseau virtuel.
peerWeight	integer	Poids ajouté aux itinéraires appris à partir de ce haut-parleur BGP.

CloudError

Réponse d’erreur du service.

Nom	Type	Description
error	CloudErrorBody	Corps de l’erreur cloud.

CloudErrorBody

Réponse d’erreur du service.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details	CloudErrorBody[]	Liste des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

DeviceProperties

Liste des propriétés de l’appareil.

Nom	Type	Description
deviceModel	string	Modèle de l’appareil.
deviceVendor	string	Nom du fournisseur de l’appareil.
linkSpeedInMbps	integer	Vitesse du lien.

IpamPoolPrefixAllocation

Référence d’allocation de préfixe IpamPool.

Nom	Type	Description
allocatedAddressPrefixes	string[]	Liste des préfixes d’adresse IP affectés dans le Pool Ipam de la ressource associée.
numberOfIpAddresses	string	Nombre d’adresses IP à allouer.
pool.id	string	ID de ressource de la ressource Azure IpamPool associée.

IPConfigurationBgpPeeringAddress

Propriétés d’IPConfigurationBgpPeeringAddress.

Nom	Type	Description
customBgpIpAddresses	string[]	Liste des adresses de peering BGP personnalisées qui appartiennent à la configuration IP.
defaultBgpIpAddresses	string[]	Liste des adresses de peering BGP par défaut qui appartiennent à la configuration IP.
ipconfigurationId	string	ID de la configuration IP qui appartient à la passerelle.
tunnelIpAddresses	string[]	Liste des adresses IP publiques de tunnel qui appartiennent à la configuration IP.

O365BreakOutCategoryPolicies

Catégories de sous-groupes Office365.

Nom	Type	Description
allow	boolean	Indicateur permettant de contrôler la catégorie d’autorisation.
default	boolean	Indicateur pour contrôler la catégorie par défaut.
optimize	boolean	Indicateur pour contrôler la catégorie d’optimisation.

O365PolicyProperties

Stratégie de déploiement Office365.

Nom	Type	Description
breakOutCategories	O365BreakOutCategoryPolicies	Catégories de sous-groupes Office365.

ProvisioningState

État d’approvisionnement actuel.

Nom	Type	Description
Deleting	string
Failed	string
Succeeded	string
Updating	string

SubResource

Référence à une autre sous-ressource.

Nom	Type	Description
id	string	ID de ressource.

VpnLinkBgpSettings

Détails des paramètres BGP pour un lien.

Nom	Type	Description
asn	integer	ASN de l’orateur BGP.
bgpPeeringAddress	string	Adresse de peering BGP et identificateur BGP de cet orateur BGP.

VpnLinkProviderProperties

Liste des propriétés d’un fournisseur de liens.

Nom	Type	Description
linkProviderName	string	Nom du fournisseur de liens.
linkSpeedInMbps	integer	Vitesse du lien.

VpnSite

Ressource VpnSite.

Nom	Type	Description
etag	string	Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id	string	ID de ressource.
location	string	Emplacement des ressources.
name	string	Nom de la ressource.
properties.addressSpace	AddressSpace	AddressSpace qui contient un tableau de plages d’adresses IP.
properties.bgpProperties	BgpSettings	Ensemble de propriétés bgp.
properties.deviceProperties	DeviceProperties	Propriétés de l’appareil.
properties.ipAddress	string	Adresse IP du site vpn.
properties.isSecuritySite	boolean	Indicateur IsSecuritySite.
properties.o365Policy	O365PolicyProperties	Stratégie Office365.
properties.provisioningState	ProvisioningState	État d’approvisionnement de la ressource de site VPN.
properties.siteKey	string	Clé pour vpn-site qui peut être utilisée pour les connexions.
properties.virtualWan	SubResource	VirtualWAN auquel appartient le vpnSite.
properties.vpnSiteLinks	VpnSiteLink[]	Liste de tous les liens de site vpn.
tags	object	Balises de ressource.
type	string	Type de ressource.

VpnSiteLink

Ressource VpnSiteLink.

Nom	Type	Description
etag	string	Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id	string	ID de ressource.
name	string	Nom de la ressource unique au sein d’un groupe de ressources. Ce nom peut être utilisé pour accéder à la ressource.
properties.bgpProperties	VpnLinkBgpSettings	Ensemble de propriétés bgp.
properties.fqdn	string	Nom de domaine complet du vpn-site-link.
properties.ipAddress	string	Adresse IP du vpn-site-link.
properties.linkProperties	VpnLinkProviderProperties	Propriétés du fournisseur de liens.
properties.provisioningState	ProvisioningState	État d’approvisionnement de la ressource de liaison de site VPN.
type	string	Type de ressource.

Partager via