Access Bridges - Create Or Update

Szolgáltatás:: Operator Nexus - Network Cloud

API-verzió:: 2026-01-01-preview

Hozz létre új hozzáférési hidat, vagy frissítsd a meglévő hozzáférési híd tulajdonságait.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
accessBridgeName	path	True	AccessBridgeAllowedName	A hozzáférési híd neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	Az erőforrás kiterjesztett elhelyezkedése. Ez a tulajdonság szükséges az erőforrás létrehozásakor.
location	True	string	Az a földrajzi hely, ahol az erőforrás él
properties.networkId	True	string (arm-id)	A belső hálózat erőforrás-azonosítója egy 3-as rétegű izolációs tartományban, amely tartalmazza az IP-alhálózatokat.
properties.ipv4ConnectedPrefix		string	Az IPv4 alhálózat, amelyből a hozzáférési híd címet oszt ki. Ennek az alhálózatnak a networkId által meghatározott belső hálózat része kell lennie.
properties.ipv6ConnectedPrefix		string	Az IPv6 alhálózat, amelyből a hozzáférési híd címet oszt ki. Ennek az alhálózatnak a networkId által meghatározott belső hálózat része kell lennie.
properties.securityRules		AccessBridgeSecurityRule[]	Az Access Bridge által betartatott biztonsági szabályok listája.
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	AccessBridge	Az 'AccessBridge' erőforrás frissítési művelete sikeres
201 Created	AccessBridge	Az 'AccessBridge' erőforrás létrehozása sikeres Fejlécek Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Name

Típus

Description

200 OK

AccessBridge

Az 'AccessBridge' erőforrás frissítési művelete sikeres

201 Created

AccessBridge

Az 'AccessBridge' erőforrás létrehozása sikeres

Fejlécek

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Váratlan hibaválasz.

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

Create or update access bridge

Mintakérelem

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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 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"
}

Definíciók

Name	Description
AccessBridge	Az AccessBridge egy menedzselt hozzáférési híd erőforrást képvisel.
AccessBridgeAllowedName	A hozzáférési híd neve.
AccessBridgeDetailedStatus	A hozzáférési híd részletes állapotát közölte.
AccessBridgeEndpoint	Az AccessBridgeEndpoint egyetlen hirdetett szolgáltatásvégpontot ír le.
AccessBridgeProvisioningState	A hozzáférési híd ellátási állapota.
AccessBridgeSecurityRule	Az AccessBridgeSecurityRule egy egyéni, a híd által érvényesített hozzáférési szabályt rögzít.
Azure.ResourceManager.CommonTypes.ExtendedLocation	A kiterjesztett hely összetett típusa.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
ExtendedLocationType	A kiterjesztett hely típusa.
SecurityRuleDirection	A hálózati forgalom iránya a szabály alapján.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
TransportProtocol	A hozzáférési híd végpontjai által hirdetett protokoll.

AccessBridge

Tárgy

Az AccessBridge egy menedzselt hozzáférési híd erőforrást képvisel.

Name	Típus	Description
etag	string	"Ha az etag meg van adva a válasz törzsében, akkor a normál etag konvenció szerint fejlécként is megadható. Az entitáscímkék két vagy több entitás egyazon kért erőforrásból való összehasonlítására szolgálnak. A HTTP/1.1 entitáscímkéket használ az etag (14.19. szakasz), a If-Match (14.24. szakasz), az If-None-Match (14.26. szakasz) és a If-Range (14.27. szakasz) fejlécmezőkben.")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	Az erőforrás kiterjesztett elhelyezkedése. Ez a tulajdonság szükséges az erőforrás létrehozásakor.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.detailedStatus	AccessBridgeDetailedStatus	A hozzáférési híd részletes állapotát közölte.
properties.detailedStatusMessage	string	A részletes státuszhoz kapcsolódó leíró üzenet.
properties.endpoints	AccessBridgeEndpoint[]	Azok a megfigyelt végpontok, amelyeket az ügyfeleknek használniuk kell a hozzáférési híd eléréséhez.
properties.ipv4ConnectedPrefix	string	Az IPv4 alhálózat, amelyből a hozzáférési híd címet oszt ki. Ennek az alhálózatnak a networkId által meghatározott belső hálózat része kell lennie.
properties.ipv6ConnectedPrefix	string	Az IPv6 alhálózat, amelyből a hozzáférési híd címet oszt ki. Ennek az alhálózatnak a networkId által meghatározott belső hálózat része kell lennie.
properties.networkId	string (arm-id)	A belső hálózat erőforrás-azonosítója egy 3-as rétegű izolációs tartományban, amely tartalmazza az IP-alhálózatokat.
properties.protocol	TransportProtocol	A hozzáférési híd végpontjai által hirdetett protokoll.
properties.provisioningState	AccessBridgeProvisioningState	A hozzáférési híd ellátási állapota.
properties.securityRules	AccessBridgeSecurityRule[]	Az Access Bridge által betartatott biztonsági szabályok listája.
systemData	systemData	Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Felsorolás

A hozzáférési híd neve.

Érték	Description
Bastion	A bevezető híd a meztelen fém gép bástyán megközelítéséhez.
PrivateVault	A hozzáférési híd a klaszterhozzáféréshez a privát trezorhoz.
StorageDashboard	A hozzáférési híd a tároló irányítópultjához.

AccessBridgeDetailedStatus

Felsorolás

A hozzáférési híd részletes állapotát közölte.

Érték	Description
Running	A hozzáférési híd egészséges és normálisan működik.
Degraded	A hozzáférési híd teljesítményromlását vagy részleges kimaradásokat tapasztal.
Failed	A bevezető híd nem működik.

AccessBridgeEndpoint

Tárgy

Az AccessBridgeEndpoint egyetlen hirdetett szolgáltatásvégpontot ír le.

Name	Típus	Description
fqdn	string	A teljes minősítésű domain név, amelyet a végpont tanúsítvány nevének leírására használnak.
ipv4Address	string	Az IPv4 cím, amely a végponthoz kapcsolódik.
ipv6Address	string	Az IPv6 cím, amely a végponthoz kapcsolódik.
name	string	Az a név, amely megjelöli a végállomás típusát (például VIP vagy host).

AccessBridgeProvisioningState

Felsorolás

A hozzáférési híd ellátási állapota.

Érték	Description
Accepted	Az Elfogadott státusz.
Canceled	A törölt státusz.
Failed	A Sikertelen státusz.
Provisioning	A Provisioning státusz.
Succeeded	A Successed státusz.

AccessBridgeSecurityRule

Tárgy

Az AccessBridgeSecurityRule egy egyéni, a híd által érvényesített hozzáférési szabályt rögzít.

Name	Típus	Description
description	string	A felhasználó értéket adott le ennek a szabálynak a leírására.
direction	SecurityRuleDirection	A hálózati forgalom iránya a szabály alapján.
ipv4Addresses	string[]	Az IPv4 címek halmaza, amely engedélyezett a biztonsági szabály forrásaként vagy célállomásaként. Egyetlen címhez használj egy /32-t (CIDR jelölés). Meg kell határozni az egyik vagy mindkét IPv4Address-t, illetve az IPv6Address-t. Példa formátumok: 10.10.10.10-10.10.20 vagy 10.10.10.10/24.
ipv6Addresses	string[]	Az IPv6 címek halmaza, amely engedélyezett a biztonsági szabály forrása vagy célpontja. Egyetlen címhez használj egy /128-at (CIDR jelölés). Meg kell határozni az egyik vagy mindkét IPv4Address-t, illetve az IPv6Address-t. Példa formátumok: 2001:db8:abcd::1-2001:db8:abcd::ff vagy 2001:db8:abcd::1/64.
port	string	A forrás- vagy célport vagy porttartomány. Példa 24562 vagy 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Tárgy

A kiterjesztett hely összetett típusa.

Name	Típus	Description
name	string	A kiterjesztett hely neve.
type	ExtendedLocationType	A kiterjesztett hely típusa.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

ExtendedLocationType

Felsorolás

A kiterjesztett hely típusa.

Érték	Description
EdgeZone	Azure Edge Zones helytípus
CustomLocation	Azure Custom Locations típusa

SecurityRuleDirection

Felsorolás

A hálózati forgalom iránya a szabály alapján.

Érték	Description
Inbound	Bejövő forgalom a helyszíni klaszter felé.
Outbound	A kifelé irányuló forgalom az on-premises klaszterből.

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

TransportProtocol

Felsorolás

A hozzáférési híd végpontjai által hirdetett protokoll.

Érték	Description
TCP	A TCP transzportprotokoll.
UDP	Az UDP transzportációs protokoll.

Megosztás a következőn keresztül:

Access Bridges - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Create or update access bridge

Mintakérelem

Mintaválasz

Definíciók

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol