Vpn Sites - Create Or Update
Létrehoz egy VpnSite-erőforrást, ha az nem létezik, frissíti a meglévő VpnSite-t.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/vpnSites/{vpnSiteName}?api-version=2023-11-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
A VpnSite erőforráscsoportjának neve. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi. |
vpn
|
path | True |
string |
A létrehozott vagy frissített VpnSite neve. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
location | True |
string |
Erőforrás helye. |
id |
string |
Erőforrás-azonosító. |
|
properties.addressSpace |
Az IP-címtartományokat tartalmazó AddressSpace. |
||
properties.bgpProperties |
A bgp-tulajdonságok halmaza. |
||
properties.deviceProperties |
Az eszköz tulajdonságai. |
||
properties.ipAddress |
string |
A VPN-hely IP-címe. |
|
properties.isSecuritySite |
boolean |
IsSecuritySite jelző. |
|
properties.o365Policy |
Office365-szabályzat. |
||
properties.siteKey |
string |
A kapcsolatokhoz használható VPN-hely kulcsa. |
|
properties.virtualWan |
Az a VirtualWAN, amelyhez a vpnSite tartozik. |
||
properties.vpnSiteLinks |
Az összes VPN-webhelyhivatkozás listája. |
||
tags |
object |
Erőforráscímkék. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A kérés sikeres. A létrehozott vagy frissített VpnSite adatait adja vissza. |
|
201 Created |
A kérelem sikeresen megérkezett. A létrehozott vagy frissített VpnSite adatait adja vissza. |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy miért nem sikerült a művelet. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
VpnSiteCreate
Mintakérelem
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/vpnSites/vpnSite1?api-version=2023-11-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
}
}
}
}
Mintaválasz
{
"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
}
}
}
]
}
}
{
"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
}
}
}
]
}
}
Definíciók
Name | Description |
---|---|
Address |
A AddressSpace a virtuális hálózat alhálózatai által használható IP-címtartományokat tartalmazó tömböt tartalmaz. |
Bgp |
A BGP beállításainak részletei. |
Cloud |
Hibaválasz a szolgáltatástól. |
Cloud |
Hibaválasz a szolgáltatástól. |
Device |
Az eszköz tulajdonságainak listája. |
IPConfiguration |
Az IPConfigurationBgpPeeringAddress tulajdonságai. |
O365Break |
Office365-ös mellékkategóriák. |
O365Policy |
Az Office365-ös különrend. |
Provisioning |
Az aktuális kiépítési állapot. |
Sub |
Hivatkozás egy másik alforrásra. |
Vpn |
A hivatkozás BGP-beállításainak részletei. |
Vpn |
Hivatkozásszolgáltató tulajdonságainak listája. |
Vpn |
VpnSite-erőforrás. |
Vpn |
VpnSiteLink-erőforrás. |
AddressSpace
A AddressSpace a virtuális hálózat alhálózatai által használható IP-címtartományokat tartalmazó tömböt tartalmaz.
Name | Típus | Description |
---|---|---|
addressPrefixes |
string[] |
A CIDR-jelölésben a virtuális hálózat számára fenntartott címblokkok listája. |
BgpSettings
A BGP beállításainak részletei.
Name | Típus | Description |
---|---|---|
asn |
integer |
A BGP-hangszóró ASN-jét. |
bgpPeeringAddress |
string |
A BGP-társviszony-létesítési cím és a BGP-beszélő BGP-azonosítója. |
bgpPeeringAddresses |
BGP-társviszony-létesítési cím a virtuális hálózati átjáró IP-konfigurációazonosítójával. |
|
peerWeight |
integer |
A BGP-hangszóróból tanult útvonalakhoz hozzáadott súly. |
CloudError
Hibaválasz a szolgáltatástól.
Name | Típus | Description |
---|---|---|
error |
Felhőbeli hibatörzs. |
CloudErrorBody
Hibaválasz a szolgáltatástól.
Name | Típus | Description |
---|---|---|
code |
string |
A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók. |
details |
A hiba további részleteinek listája. |
|
message |
string |
A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre. |
target |
string |
Az adott hiba célja. Például a tulajdonság neve hibás. |
DeviceProperties
Az eszköz tulajdonságainak listája.
Name | Típus | Description |
---|---|---|
deviceModel |
string |
Az eszköz modellje. |
deviceVendor |
string |
Az eszköz szállítójának neve. |
linkSpeedInMbps |
integer |
Kapcsolat sebessége. |
IPConfigurationBgpPeeringAddress
Az IPConfigurationBgpPeeringAddress tulajdonságai.
Name | Típus | Description |
---|---|---|
customBgpIpAddresses |
string[] |
Az IP-konfigurációhoz tartozó egyéni BGP-társviszony-létesítési címek listája. |
defaultBgpIpAddresses |
string[] |
Az IP-konfigurációhoz tartozó alapértelmezett BGP-társviszony-címek listája. |
ipconfigurationId |
string |
Az átjáróhoz tartozó IP-konfiguráció azonosítója. |
tunnelIpAddresses |
string[] |
Az IP-konfigurációhoz tartozó nyilvános bújtatási IP-címek listája. |
O365BreakOutCategoryPolicies
Office365-ös mellékkategóriák.
Name | Típus | Description |
---|---|---|
allow |
boolean |
Jelölő a kategória engedélyezésének szabályozásához. |
default |
boolean |
Jelölő az alapértelmezett kategória szabályozásához. |
optimize |
boolean |
Jelölő az optimalizált kategória szabályozásához. |
O365PolicyProperties
Az Office365-ös különrend.
Name | Típus | Description |
---|---|---|
breakOutCategories |
Office365-ös mellékkategóriák. |
ProvisioningState
Az aktuális kiépítési állapot.
Name | Típus | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
SubResource
Hivatkozás egy másik alforrásra.
Name | Típus | Description |
---|---|---|
id |
string |
Erőforrás-azonosító. |
VpnLinkBgpSettings
A hivatkozás BGP-beállításainak részletei.
Name | Típus | Description |
---|---|---|
asn |
integer |
A BGP-hangszóró ASN-jét. |
bgpPeeringAddress |
string |
A BGP-társviszony-létesítési cím és a BGP-beszélő BGP-azonosítója. |
VpnLinkProviderProperties
Hivatkozásszolgáltató tulajdonságainak listája.
Name | Típus | Description |
---|---|---|
linkProviderName |
string |
A hivatkozásszolgáltató neve. |
linkSpeedInMbps |
integer |
Kapcsolat sebessége. |
VpnSite
VpnSite-erőforrás.
Name | Típus | Description |
---|---|---|
etag |
string |
Egyedi írásvédett sztring, amely az erőforrás frissítésekor változik. |
id |
string |
Erőforrás-azonosító. |
location |
string |
Erőforrás helye. |
name |
string |
Erőforrás neve. |
properties.addressSpace |
Az IP-címtartományokat tartalmazó AddressSpace. |
|
properties.bgpProperties |
A bgp-tulajdonságok halmaza. |
|
properties.deviceProperties |
Az eszköz tulajdonságai. |
|
properties.ipAddress |
string |
A VPN-hely IP-címe. |
properties.isSecuritySite |
boolean |
IsSecuritySite jelző. |
properties.o365Policy |
Office365-szabályzat. |
|
properties.provisioningState |
A VPN-helyerőforrás kiépítési állapota. |
|
properties.siteKey |
string |
A kapcsolatokhoz használható VPN-hely kulcsa. |
properties.virtualWan |
Az a VirtualWAN, amelyhez a vpnSite tartozik. |
|
properties.vpnSiteLinks |
Az összes VPN-webhelyhivatkozás listája. |
|
tags |
object |
Erőforráscímkék. |
type |
string |
Erőforrás típusa. |
VpnSiteLink
VpnSiteLink-erőforrás.
Name | Típus | Description |
---|---|---|
etag |
string |
Egyedi írásvédett sztring, amely az erőforrás frissítésekor változik. |
id |
string |
Erőforrás-azonosító. |
name |
string |
Az erőforráscsoporton belül egyedi erőforrás neve. Ez a név használható az erőforrás eléréséhez. |
properties.bgpProperties |
A bgp-tulajdonságok halmaza. |
|
properties.fqdn |
string |
A vpn-site-link teljes tartománynevét. |
properties.ipAddress |
string |
A vpn-site-link IP-címe. |
properties.linkProperties |
A hivatkozásszolgáltató tulajdonságai. |
|
properties.provisioningState |
A VPN-helykapcsolati erőforrás kiépítési állapota. |
|
type |
string |
Erőforrás típusa. |