Access Bridges - Create Or Update

Usługa:: Operator Nexus - Network Cloud

Wersja interfejsu API:: 2026-01-01-preview

Stwórz nowy most dostępu lub zaktualizuj właściwości istniejącego mostu dostępowego.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accessBridgeName	path	True	AccessBridgeAllowedName	Nazwa mostu dojazdowego.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	Rozszerzone położenie zasobu. Ta właściwość jest wymagana podczas tworzenia zasobu.
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
properties.networkId	True	string (arm-id)	Identyfikator zasobu wewnętrznej sieci w domenie izolacji warstwy 3, zawierającej podsieci IP do użytku.
properties.ipv4ConnectedPrefix		string	Podsieć IPv4, z której most dostępu przydziela adres. Ta podsieć musi być częścią wewnętrznej sieci określonej przez networkId.
properties.ipv6ConnectedPrefix		string	Podsieć IPv6, z której most dostępu przydziela adres. Ta podsieć musi być częścią wewnętrznej sieci określonej przez networkId.
properties.securityRules		AccessBridgeSecurityRule[]	Lista zasad bezpieczeństwa egzekwowanych przez most dostępu do sieci.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AccessBridge	Aktualizacja zasobu 'AccessBridge' zakończyła się sukcesem
201 Created	AccessBridge	Operacja tworzenia zasobu 'AccessBridge' zakończyła się sukcesem Nagłówki Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

200 OK

AccessBridge

Aktualizacja zasobu 'AccessBridge' zakończyła się sukcesem

201 Created

AccessBridge

Operacja tworzenia zasobu 'AccessBridge' zakończyła się sukcesem

Nagłówki

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create or update access bridge

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
AccessBridge	AccessBridge reprezentuje zasób zarządzanego mostu dostępowego.
AccessBridgeAllowedName	Nazwa mostu dojazdowego.
AccessBridgeDetailedStatus	Szczegółowy status raportowany przez most dojazdowy.
AccessBridgeEndpoint	AccessBridgeEndpoint opisuje pojedynczy reklamowany punkt końcowy usługi.
AccessBridgeProvisioningState	Stan provisioningu mostka dostępu (access bridge).
AccessBridgeSecurityRule	AccessBridgeSecurityRule rejestruje indywidualną regułę dostępu egzekwowaną przez most.
Azure.ResourceManager.CommonTypes.ExtendedLocation	Typ złożony lokalizacji rozszerzonej.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocationType	Typ lokalizacji rozszerzonej.
SecurityRuleDirection	Kierunek dozwolonego ruchu sieciowego na podstawie tej reguły.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
TransportProtocol	Protokół reklamowany przez punkty końcowe mostu dostępowego.

AccessBridge

Objekt

AccessBridge reprezentuje zasób zarządzanego mostu dostępowego.

Nazwa	Typ	Opis
etag	string	"Jeśli etag jest podany w treści odpowiedzi, może być również dostarczony jako nagłówek zgodnie z normalną konwencją etag. Tagi jednostek są używane do porównywania co najmniej dwóch jednostek z tego samego żądanego zasobu. Protokół HTTP/1.1 używa tagów encji w polach nagłówka etag (sekcja 14.19), If-Match (sekcja 14.24), If-None-Match (sekcja 14.26) i If-Range (sekcja 14.27).")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	Rozszerzone położenie zasobu. Ta właściwość jest wymagana podczas tworzenia zasobu.
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.detailedStatus	AccessBridgeDetailedStatus	Szczegółowy status raportowany przez most dojazdowy.
properties.detailedStatusMessage	string	Opisowa wiadomość towarzysząca szczegółowemu statusowi.
properties.endpoints	AccessBridgeEndpoint[]	Obserwowane punkty końcowe, których klienci powinni wykorzystać, aby dotrzeć do mostu dostępu do sieci.
properties.ipv4ConnectedPrefix	string	Podsieć IPv4, z której most dostępu przydziela adres. Ta podsieć musi być częścią wewnętrznej sieci określonej przez networkId.
properties.ipv6ConnectedPrefix	string	Podsieć IPv6, z której most dostępu przydziela adres. Ta podsieć musi być częścią wewnętrznej sieci określonej przez networkId.
properties.networkId	string (arm-id)	Identyfikator zasobu wewnętrznej sieci w domenie izolacji warstwy 3, zawierającej podsieci IP do użytku.
properties.protocol	TransportProtocol	Protokół reklamowany przez punkty końcowe mostu dostępowego.
properties.provisioningState	AccessBridgeProvisioningState	Stan provisioningu mostka dostępu (access bridge).
properties.securityRules	AccessBridgeSecurityRule[]	Lista zasad bezpieczeństwa egzekwowanych przez most dostępu do sieci.
systemData	systemData	Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Wyliczenie

Nazwa mostu dojazdowego.

Wartość	Opis
Bastion	Most dostępu do bastionu maszyn z gołym metalem.
PrivateVault	Most dostępu do klastra do prywatnego skarbca.
StorageDashboard	Most dostępu do pulpitu dysku.

AccessBridgeDetailedStatus

Wyliczenie

Szczegółowy status raportowany przez most dojazdowy.

Wartość	Opis
Running	Most dostępu jest zdrowy i działa normalnie.
Degraded	Most dostępu doświadcza pogorszonej wydajności lub częściowych przerw w dostawie prądu.
Failed	Most dostępu nie działa.

AccessBridgeEndpoint

Objekt

AccessBridgeEndpoint opisuje pojedynczy reklamowany punkt końcowy usługi.

Nazwa	Typ	Opis
fqdn	string	W pełni kwalifikowana nazwa domeny używana do opisu nazwy certyfikatu dla punktu końcowego.
ipv4Address	string	Adres IPv4 powiązany z punktem końcowym.
ipv6Address	string	Adres IPv6 powiązany z punktem końcowym.
name	string	Nazwa określająca typ punktu końcowego (na przykład VIP lub host).

AccessBridgeProvisioningState

Wyliczenie

Stan provisioningu mostka dostępu (access bridge).

Wartość	Opis
Accepted	Status Akceptowany.
Canceled	Status Anulowany.
Failed	Status Nieudanego.
Provisioning	Status Provisioning.
Succeeded	Status sukcesy.

AccessBridgeSecurityRule

Objekt

AccessBridgeSecurityRule rejestruje indywidualną regułę dostępu egzekwowaną przez most.

Nazwa	Typ	Opis
description	string	Użytkownik podał wartość opisującą tę regułę.
direction	SecurityRuleDirection	Kierunek dozwolonego ruchu sieciowego na podstawie tej reguły.
ipv4Addresses	string[]	Zestaw adresów IPv4 dozwolonych jako źródło lub miejsce docelowe reguły bezpieczeństwa. Jako pojedynczy adres używaj /32 (notacja CIDR). Należy podać jeden lub oba adresy: Ipv4Address, oraz Ipv6Address. Przykładowe formaty: 10.10.10-10.10.10.20 lub 10.10.10.10/24.
ipv6Addresses	string[]	Zestaw adresów IPv6 dozwolonych jako źródło lub miejsce docelowe reguły bezpieczeństwa. Jako pojedynczy adres używaj /128 (notacja CIDR). Należy podać jeden lub oba adresy: Ipv4Address, oraz Ipv6Address. Przykładowe formaty: 2001:db8:abcd::1-2001:db8:abcd::ff lub 2001:db8:abcd::1/64.
port	string	Port źródłowy lub docelowy lub zasięg portów. Przykład 24562 lub 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Objekt

Typ złożony lokalizacji rozszerzonej.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	ExtendedLocationType	Typ lokalizacji rozszerzonej.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocationType

Wyliczenie

Typ lokalizacji rozszerzonej.

Wartość	Opis
EdgeZone	Typ lokalizacji stref usługi Azure Edge Zones
CustomLocation	Typ lokalizacji niestandardowych platformy Azure

SecurityRuleDirection

Wyliczenie

Kierunek dozwolonego ruchu sieciowego na podstawie tej reguły.

Wartość	Opis
Inbound	Ruch przychodzący do klastra on-premsis.
Outbound	Ruch wychodzący z klastra lokalnego.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TransportProtocol

Wyliczenie

Protokół reklamowany przez punkty końcowe mostu dostępowego.

Wartość	Opis
TCP	Protokół transportowy TCP.
UDP	Protokół transportowy UDP.

Udostępnij za pośrednictwem

Access Bridges - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Create or update access bridge

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol