Access Bridges - Create Or Update

Tjänst:: Operator Nexus - Network Cloud

API-version:: 2026-01-01-preview

Skapa en ny tillfartsbro eller uppdatera egenskaperna för den befintliga bron.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/accessBridges/{accessBridgeName}?api-version=2026-01-01-preview

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accessBridgeName	path	True	AccessBridgeAllowedName	Namnet på tillfartsbron.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	Den utökade platsen för resursen. Denna egenskap krävs vid skapandet av resursen.
location	True	string	Den geo-plats där resursen finns
properties.networkId	True	string (arm-id)	Resurs-ID:t för det interna nätverket i en lager 3-isoleringsdomän som innehåller IP-subnäten som ska användas.
properties.ipv4ConnectedPrefix		string	IPv4-subnätet från vilket accessbron tilldelar en adress. Detta subnät måste vara en del av det interna nätverk som specificeras av networkId.
properties.ipv6ConnectedPrefix		string	IPv6-subnätet från vilket accessbryggan tilldelar en adress. Detta subnät måste vara en del av det interna nätverk som specificeras av networkId.
properties.securityRules		AccessBridgeSecurityRule[]	Listan över säkerhetsregler som tillämps av accessbron.
tags		object	Resursetiketter.

Svar

Name	Typ	Description
200 OK	AccessBridge	Resursens 'AccessBridge'-uppdateringsoperation lyckades
201 Created	AccessBridge	Resursen 'AccessBridge'-skapande lyckades Sidhuvuden Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

AccessBridge

Resursens 'AccessBridge'-uppdateringsoperation lyckades

201 Created

AccessBridge

Resursen 'AccessBridge'-skapande lyckades

Sidhuvuden

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Create or update access bridge

Exempelbegäran

HTTP

PUT https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/accessBridges/Bastion?api-version=2026-01-01-preview

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "location": "location",
  "properties": {
    "ipv4ConnectedPrefix": "198.51.100.0/24",
    "ipv6ConnectedPrefix": "2001:db8::/64",
    "networkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName/internalNetworks/internalNetworkName",
    "securityRules": [
      {
        "description": "Allow management plane egress",
        "direction": "Outbound",
        "ipv4Addresses": [
          "10.10.20.10-10.10.20.20"
        ],
        "ipv6Addresses": [
          "2001:db8:abcd:12::1000-2001:db8:abcd:12::1fff"
        ],
        "port": "24562-24570"
      }
    ]
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  }
}

Exempelsvar

Statuskod:: 200

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/accessBridges/accessBridgeName",
  "location": "location",
  "name": "accessBridgeName",
  "properties": {
    "detailedStatus": "Running",
    "detailedStatusMessage": "The access bridge is serving traffic from the VIP and storage appliance endpoints.",
    "endpoints": [
      {
        "fqdn": "bastion.contoso.example.com",
        "ipv4Address": "192.51.100.10",
        "ipv6Address": "2001:db8::10",
        "name": "vip"
      }
    ],
    "ipv4ConnectedPrefix": "198.51.100.0/24",
    "ipv6ConnectedPrefix": "2001:db8::/64",
    "networkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName/internalNetworks/internalNetworkName",
    "protocol": "TCP",
    "provisioningState": "Succeeded",
    "securityRules": [
      {
        "description": "Allow management plane egress",
        "direction": "Outbound",
        "ipv4Addresses": [
          "10.10.20.10-10.10.20.20"
        ],
        "ipv6Addresses": [
          "2001:db8:abcd:12::1000-2001:db8:abcd:12::1fff"
        ],
        "port": "24562-24570"
      }
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/accessBridges"
}

Statuskod:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2026-01-01-preview

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/accessBridges/accessBridgeName",
  "location": "location",
  "name": "accessBridgeName",
  "properties": {
    "detailedStatus": "Running",
    "detailedStatusMessage": "The access bridge is serving traffic from the VIP and storage appliance endpoints.",
    "endpoints": [
      {
        "fqdn": "bastion.contoso.example.com",
        "ipv4Address": "192.51.100.10",
        "ipv6Address": "2001:db8::10",
        "name": "vip"
      }
    ],
    "ipv4ConnectedPrefix": "198.51.100.0/24",
    "ipv6ConnectedPrefix": "2001:db8::/64",
    "networkId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName/internalNetworks/internalNetworkName",
    "protocol": "TCP",
    "provisioningState": "Accepted",
    "securityRules": [
      {
        "description": "Allow management plane egress",
        "direction": "Outbound",
        "ipv4Addresses": [
          "10.10.20.10-10.10.20.20"
        ],
        "ipv6Addresses": [
          "2001:db8:abcd:12::1000-2001:db8:abcd:12::1fff"
        ],
        "port": "24562-24570"
      }
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/accessBridges"
}

Definitioner

Name	Description
AccessBridge	AccessBridge representerar en resurs för hanterad åtkomstbro.
AccessBridgeAllowedName	Namnet på tillfartsbron.
AccessBridgeDetailedStatus	Den detaljerade statusen rapporteras av tillfartsbron.
AccessBridgeEndpoint	AccessBridgeEndpoint beskriver en enda annonserad tjänsteändpunkt.
AccessBridgeProvisioningState	Provianteringsläget för accessbron.
AccessBridgeSecurityRule	AccessBridgeSecurityRule fångar en individuell åtkomstregel som bryggan upprätthåller.
Azure.ResourceManager.CommonTypes.ExtendedLocation	Den komplexa typen av utökad plats.
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Detaljerna om felet.
ErrorResponse	Felsvar
ExtendedLocationType	Typ av utökad plats.
SecurityRuleDirection	Riktningen för tillåten nätverkstrafik baseras på regeln.
systemData	Metadata som rör skapande och senaste ändring av resursen.
TransportProtocol	Protokollet som annonseras av accessbryggans endpoints.

AccessBridge

Objekt

AccessBridge representerar en resurs för hanterad åtkomstbro.

Name	Typ	Description
etag	string	"Om etag anges i svarstexten kan det också anges som en rubrik enligt den normala etag-konventionen. Entitetstaggar används för att jämföra två eller flera entiteter från samma begärda resurs. HTTP/1.1 använder entitetstaggar i rubrikfälten etag (avsnitt 14.19), If-Match (avsnitt 14.24), If-None-Match (avsnitt 14.26) och If-Range (avsnitt 14.27).
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	Den utökade platsen för resursen. Denna egenskap krävs vid skapandet av resursen.
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.detailedStatus	AccessBridgeDetailedStatus	Den detaljerade statusen rapporteras av tillfartsbron.
properties.detailedStatusMessage	string	Det beskrivande budskapet som följer med den detaljerade statusen.
properties.endpoints	AccessBridgeEndpoint[]	De observerade slutpunkterna som klienter bör använda för att nå accessbryggan.
properties.ipv4ConnectedPrefix	string	IPv4-subnätet från vilket accessbron tilldelar en adress. Detta subnät måste vara en del av det interna nätverk som specificeras av networkId.
properties.ipv6ConnectedPrefix	string	IPv6-subnätet från vilket accessbryggan tilldelar en adress. Detta subnät måste vara en del av det interna nätverk som specificeras av networkId.
properties.networkId	string (arm-id)	Resurs-ID:t för det interna nätverket i en lager 3-isoleringsdomän som innehåller IP-subnäten som ska användas.
properties.protocol	TransportProtocol	Protokollet som annonseras av accessbryggans endpoints.
properties.provisioningState	AccessBridgeProvisioningState	Provianteringsläget för accessbron.
properties.securityRules	AccessBridgeSecurityRule[]	Listan över säkerhetsregler som tillämps av accessbron.
systemData	systemData	Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Uppräkning

Namnet på tillfartsbron.

Värde	Description
Bastion	Tillgångsbron för bar metallmaskin-bastionåtkomst.
PrivateVault	Accessbron för klusteråtkomst till privat valv.
StorageDashboard	Accessbron för tillgång till lagringsinstrumentpanelen.

AccessBridgeDetailedStatus

Uppräkning

Den detaljerade statusen rapporteras av tillfartsbron.

Värde	Description
Running	Tillfartsbron är i skick och fungerar normalt.
Degraded	Åtkomstbron upplever försämrad prestanda eller partiella avbrott.
Failed	Tillfartsbron är inte i drift.

AccessBridgeEndpoint

Objekt

AccessBridgeEndpoint beskriver en enda annonserad tjänsteändpunkt.

Name	Typ	Description
fqdn	string	Det fullt kvalificerade domännamnet som används för att beskriva certifikatnamnet för slutpunkten.
ipv4Address	string	IPv4-adressen som är kopplad till slutpunkten.
ipv6Address	string	IPv6-adressen som är kopplad till slutpunkten.
name	string	Namnet som identifierar typen av slutpunkt (till exempel VIP eller värd).

AccessBridgeProvisioningState

Uppräkning

Provianteringsläget för accessbron.

Värde	Description
Accepted	Statusen Accepterad.
Canceled	Statusen Avbrutet.
Failed	Misslyckad status.
Provisioning	Provisioneringsstatus.
Succeeded	Status som Efterträdd.

AccessBridgeSecurityRule

Objekt

AccessBridgeSecurityRule fångar en individuell åtkomstregel som bryggan upprätthåller.

Name	Typ	Description
description	string	Användaren gav värde som beskrev denna regel.
direction	SecurityRuleDirection	Riktningen för tillåten nätverkstrafik baseras på regeln.
ipv4Addresses	string[]	Den uppsättning IPv4-adresser som tillåts vara källa eller destination för säkerhetsregeln. För som en enda adress, använd en /32 (CIDR-notation). En eller båda Ipv4Addresses och Ipv6Addresses måste specificeras. Exempelformat: 10.10.10.10-10.10.10.20 eller 10.10.10.10/24.
ipv6Addresses	string[]	Den uppsättning IPv6-adresser som tillåts vara källa eller destination för säkerhetsregeln. För som en enda adress, använd en /128 (CIDR-notation). En eller båda Ipv4Addresses och Ipv6Addresses måste specificeras. Exempelformat: 2001:db8:abcd::1-2001:db8:abcd::ff eller 2001:db8:abcd::1/64.
port	string	Källa- eller destinationsporten eller portområdet. Exempel 24562 eller 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Objekt

Den komplexa typen av utökad plats.

Name	Typ	Description
name	string	Namnet på den utökade platsen.
type	ExtendedLocationType	Typ av utökad plats.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Detaljerna om felet.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ExtendedLocationType

Uppräkning

Typ av utökad plats.

Värde	Description
EdgeZone	Platstyp för Azure Edge-zoner
CustomLocation	Typ av anpassade Azure-platser

SecurityRuleDirection

Uppräkning

Riktningen för tillåten nätverkstrafik baseras på regeln.

Värde	Description
Inbound	Inkommande trafik mot on-premsises-klustret.
Outbound	Utgående trafik från det lokala klustret.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

TransportProtocol

Uppräkning

Protokollet som annonseras av accessbryggans endpoints.

Värde	Description
TCP	TCP-transportprotokollet.
UDP	UDP-transportprotokollet.

Dela via

Access Bridges - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Create or update access bridge

Exempelbegäran

Exempelsvar

Definitioner

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol