Access Bridges - Create Or Update

Servizio:: Operator Nexus - Network Cloud

Versione API:: 2026-01-01-preview

Crea un nuovo ponte di accesso o aggiorna le proprietà del ponte di accesso esistente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accessBridgeName	path	True	AccessBridgeAllowedName	Il nome del ponte di accesso.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	La posizione estesa della risorsa. Questa proprietà è necessaria nella creazione della risorsa.
location	True	string	Posizione geografica in cui risiede la risorsa
properties.networkId	True	string (arm-id)	L'ID della risorsa della rete interna in un dominio di isolamento di livello 3 contenente le subnet IP da utilizzare.
properties.ipv4ConnectedPrefix		string	La subnet IPv4 da cui il bridge di accesso assegna un indirizzo. Questa sottorete deve far parte della rete interna specificata da networkId.
properties.ipv6ConnectedPrefix		string	La subnet IPv6 da cui il bridge di accesso assegna un indirizzo. Questa sottorete deve far parte della rete interna specificata da networkId.
properties.securityRules		AccessBridgeSecurityRule[]	L'elenco delle regole di sicurezza applicate dal ponte di accesso.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	AccessBridge	Operazione di aggiornamento della risorsa 'AccessBridge' riuscita
201 Created	AccessBridge	Risorsa 'AccessBridge' crea operazione con successo Intestazioni Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

AccessBridge

Operazione di aggiornamento della risorsa 'AccessBridge' riuscita

201 Created

AccessBridge

Risorsa 'AccessBridge' crea operazione con successo

Intestazioni

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create or update access bridge

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
}

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
AccessBridge	AccessBridge rappresenta una risorsa di access bridge gestita.
AccessBridgeAllowedName	Il nome del ponte di accesso.
AccessBridgeDetailedStatus	Lo stato dettagliato riportato dal ponte di accesso.
AccessBridgeEndpoint	AccessBridgeEndpoint descrive un singolo endpoint di servizio pubblicizzato.
AccessBridgeProvisioningState	Lo stato di rifornimento del ponte di accesso.
AccessBridgeSecurityRule	AccessBridgeSecurityRule cattura una regola di accesso individuale applicata dal bridge.
Azure.ResourceManager.CommonTypes.ExtendedLocation	Tipo complesso della posizione estesa.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocationType	Tipo dell'ubicazione estesa.
SecurityRuleDirection	La direzione del traffico di rete consentito si basa sulla regola.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TransportProtocol	Il protocollo pubblicizzato dagli endpoint del bridge di accesso.

AccessBridge

Oggetto

AccessBridge rappresenta una risorsa di access bridge gestita.

Nome	Tipo	Descrizione
etag	string	"Se l'etag viene fornito nel corpo della risposta, può anche essere fornito come intestazione secondo la normale convenzione dell'etag. I tag di entità vengono usati per confrontare due o più entità dalla stessa risorsa richiesta. HTTP/1.1 utilizza i tag di entità nei campi di intestazione etag (sezione 14.19), If-Match (sezione 14.24), If-None-Match (sezione 14.26) e If-Range (sezione 14.27).")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	La posizione estesa della risorsa. Questa proprietà è necessaria nella creazione della risorsa.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.detailedStatus	AccessBridgeDetailedStatus	Lo stato dettagliato riportato dal ponte di accesso.
properties.detailedStatusMessage	string	Il messaggio descrittivo che accompagna lo stato dettagliato.
properties.endpoints	AccessBridgeEndpoint[]	Gli endpoint osservati che i client dovrebbero utilizzare per raggiungere il ponte di accesso.
properties.ipv4ConnectedPrefix	string	La subnet IPv4 da cui il bridge di accesso assegna un indirizzo. Questa sottorete deve far parte della rete interna specificata da networkId.
properties.ipv6ConnectedPrefix	string	La subnet IPv6 da cui il bridge di accesso assegna un indirizzo. Questa sottorete deve far parte della rete interna specificata da networkId.
properties.networkId	string (arm-id)	L'ID della risorsa della rete interna in un dominio di isolamento di livello 3 contenente le subnet IP da utilizzare.
properties.protocol	TransportProtocol	Il protocollo pubblicizzato dagli endpoint del bridge di accesso.
properties.provisioningState	AccessBridgeProvisioningState	Lo stato di rifornimento del ponte di accesso.
properties.securityRules	AccessBridgeSecurityRule[]	L'elenco delle regole di sicurezza applicate dal ponte di accesso.
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Enumerazione

Il nome del ponte di accesso.

Valore	Descrizione
Bastion	Il ponte di accesso per l'accesso ai bastioni delle macchine in metallo nudo.
PrivateVault	Il ponte di accesso per l'accesso cluster al caveau privato.
StorageDashboard	Il ponte di accesso per accedere al cruscotto di stoccaggio.

AccessBridgeDetailedStatus

Enumerazione

Lo stato dettagliato riportato dal ponte di accesso.

Valore	Descrizione
Running	Il ponte di accesso è sano e funziona normalmente.
Degraded	Il ponte di accesso sta subendo prestazioni degradate o interruzioni parziali.
Failed	Il ponte di accesso non è operativo.

AccessBridgeEndpoint

Oggetto

AccessBridgeEndpoint descrive un singolo endpoint di servizio pubblicizzato.

Nome	Tipo	Descrizione
fqdn	string	Il nome di dominio completamente qualificato utilizzato per descrivere il nome del certificato per l'endpoint.
ipv4Address	string	L'indirizzo IPv4 associato all'endpoint.
ipv6Address	string	L'indirizzo IPv6 associato all'endpoint.
name	string	Il nome che identifica il tipo di endpoint (ad esempio VIP o host).

AccessBridgeProvisioningState

Enumerazione

Lo stato di rifornimento del ponte di accesso.

Valore	Descrizione
Accepted	Lo status di Accettato.
Canceled	Lo stato Annullato.
Failed	Lo status di fallito.
Provisioning	Lo stato di Provisioning.
Succeeded	Lo stato di Successo.

AccessBridgeSecurityRule

Oggetto

AccessBridgeSecurityRule cattura una regola di accesso individuale applicata dal bridge.

Nome	Tipo	Descrizione
description	string	L'utente ha fornito valore descrivendo questa regola.
direction	SecurityRuleDirection	La direzione del traffico di rete consentito si basa sulla regola.
ipv4Addresses	string[]	L'insieme di indirizzi IPv4 consentiti come sorgente o destinazione della regola di sicurezza. Per un singolo indirizzo, utilizzare un /32 (notazione CIDR). Uno o entrambi gli indirizzi Ipv4 e Ipv6 devono essere specificati. Formati di esempio: 10.10.10.10-10.10.10.20 oppure 10.10.10.10/24.
ipv6Addresses	string[]	L'insieme di indirizzi IPv6 consentiti come sorgente o destinazione della regola di sicurezza. Per un singolo indirizzo, si utilizza un /128 (notazione CIDR). Uno o entrambi gli indirizzi Ipv4 e Ipv6 devono essere specificati. Formati di esempio: 2001:db8:abcd::1-2001:db8:abcd::ff oppure 2001:db8:abcd::1/64.
port	string	La porta o intervallo di porte di origine o destinazione. Esempio 24562 o 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Oggetto

Tipo complesso della posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationType	Tipo dell'ubicazione estesa.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocationType

Enumerazione

Tipo dell'ubicazione estesa.

Valore	Descrizione
EdgeZone	Tipo di posizione delle zone perimetrali di Azure
CustomLocation	Tipo di posizioni personalizzate di Azure

SecurityRuleDirection

Enumerazione

La direzione del traffico di rete consentito si basa sulla regola.

Valore	Descrizione
Inbound	Traffico in entrata verso il cluster on-premises.
Outbound	Traffico in uscita dal cluster on-premise.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TransportProtocol

Enumerazione

Il protocollo pubblicizzato dagli endpoint del bridge di accesso.

Valore	Descrizione
TCP	Il protocollo di trasporto TCP.
UDP	Il protocollo di trasporto UDP.

Condividi tramite

Access Bridges - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create or update access bridge

Esempio di richiesta

Risposta di esempio

Definizioni

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol