Access Bridges - Create Or Update

Služba:: Operator Nexus - Network Cloud

Verze rozhraní API:: 2026-01-01-preview

Vytvořte nový přístupový most nebo aktualizujte vlastnosti stávajícího přístupového mostu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accessBridgeName	path	True	AccessBridgeAllowedName	Název přístupového mostu.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	Rozšířená poloha zdroje. Tato vlastnost je vyžadována při vytváření zdroje.
location	True	string	Geografické umístění, ve kterém se nachází zdroj
properties.networkId	True	string (arm-id)	ID zdroje interní sítě v izolační doméně vrstvy 3, která obsahuje IP podsítě k použití.
properties.ipv4ConnectedPrefix		string	IPv4 podsíť, ze které přístupový most přiděluje adresu. Tato podsíť musí být součástí interní sítě specifikované networkId.
properties.ipv6ConnectedPrefix		string	IPv6 podsíť, ze které přístupový most přiděluje adresu. Tato podsíť musí být součástí interní sítě specifikované networkId.
properties.securityRules		AccessBridgeSecurityRule[]	Seznam bezpečnostních pravidel vynucovaných přístupovým mostem.
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	AccessBridge	Aktualizace zdroje 'AccessBridge' byla úspěšná
201 Created	AccessBridge	Operace vytvoření zdroje 'AccessBridge' uspěla Hlavičky Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

AccessBridge

Aktualizace zdroje 'AccessBridge' byla úspěšná

201 Created

AccessBridge

Operace vytvoření zdroje 'AccessBridge' uspěla

Hlavičky

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create or update access bridge

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
}

Stavový kó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"
}

Definice

Name	Description
AccessBridge	AccessBridge představuje zdroj spravovaného přístupového mostu.
AccessBridgeAllowedName	Název přístupového mostu.
AccessBridgeDetailedStatus	Podrobný stav hlášený přístupovým mostem.
AccessBridgeEndpoint	AccessBridgeEndpoint popisuje jeden inzerovaný koncový bod služby.
AccessBridgeProvisioningState	Stav provisioningu přístupového mostu.
AccessBridgeSecurityRule	AccessBridgeSecurityRule zachycuje individuální pravidlo přístupu vynucované mostem.
Azure.ResourceManager.CommonTypes.ExtendedLocation	Komplexní typ rozšířeného umístění.
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocationType	Typ rozšířeného umístění.
SecurityRuleDirection	Směr povoleného síťového provozu založený na pravidle.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TransportProtocol	Protokol inzerovaný endpointy access bridge.

AccessBridge

Objekt

AccessBridge představuje zdroj spravovaného přístupového mostu.

Name	Typ	Description
etag	string	"Pokud je v těle odpovědi uveden etag, může být také poskytnut jako hlavička podle normální konvence etag. Značky entit se používají k porovnání dvou nebo více entit ze stejného požadovaného prostředku. Protokol HTTP/1.1 používá značky entit v polích záhlaví značek etag (oddíl 14.19), If-Match (oddíl 14.24), If-None-Match (oddíl 14.26) a If-Range (oddíl 14.27).")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	Rozšířená poloha zdroje. Tato vlastnost je vyžadována při vytváření zdroje.
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.detailedStatus	AccessBridgeDetailedStatus	Podrobný stav hlášený přístupovým mostem.
properties.detailedStatusMessage	string	Popisná zpráva, která doprovází podrobný stav.
properties.endpoints	AccessBridgeEndpoint[]	Pozorované koncové body, které by klienti měli použít k dosažení přístupového mostu.
properties.ipv4ConnectedPrefix	string	IPv4 podsíť, ze které přístupový most přiděluje adresu. Tato podsíť musí být součástí interní sítě specifikované networkId.
properties.ipv6ConnectedPrefix	string	IPv6 podsíť, ze které přístupový most přiděluje adresu. Tato podsíť musí být součástí interní sítě specifikované networkId.
properties.networkId	string (arm-id)	ID zdroje interní sítě v izolační doméně vrstvy 3, která obsahuje IP podsítě k použití.
properties.protocol	TransportProtocol	Protokol inzerovaný endpointy access bridge.
properties.provisioningState	AccessBridgeProvisioningState	Stav provisioningu přístupového mostu.
properties.securityRules	AccessBridgeSecurityRule[]	Seznam bezpečnostních pravidel vynucovaných přístupovým mostem.
systemData	systemData	Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

AccessBridgeAllowedName

Výčet

Název přístupového mostu.

Hodnota	Description
Bastion	Přístupový most pro přístup k holým kovovým strojům na bastion.
PrivateVault	Přístupový most pro clusterový přístup k privátnímu trezoru.
StorageDashboard	Přístupový most pro přístup k úložnému panelu.

AccessBridgeDetailedStatus

Výčet

Podrobný stav hlášený přístupovým mostem.

Hodnota	Description
Running	Přístupový most je v pořádku a funguje normálně.
Degraded	Přístupový most má zhoršený výkon nebo částečné výpadky.
Failed	Přístupový most není funkční.

AccessBridgeEndpoint

Objekt

AccessBridgeEndpoint popisuje jeden inzerovaný koncový bod služby.

Name	Typ	Description
fqdn	string	Plně kvalifikované doménové jméno používané k popisu certifikátu pro koncový bod.
ipv4Address	string	IPv4 adresa spojená s koncovým bodem.
ipv6Address	string	IPv6 adresa spojená s koncovým bodem.
name	string	Název, který identifikuje typ endpointu (například VIP nebo hostitel).

AccessBridgeProvisioningState

Výčet

Stav provisioningu přístupového mostu.

Hodnota	Description
Accepted	Status Přijato.
Canceled	Stav zrušený.
Failed	Stav Neúspěšný.
Provisioning	Stav Provisioning.
Succeeded	Status Successed.

AccessBridgeSecurityRule

Objekt

AccessBridgeSecurityRule zachycuje individuální pravidlo přístupu vynucované mostem.

Name	Typ	Description
description	string	Uživatel zadal hodnotu popisující toto pravidlo.
direction	SecurityRuleDirection	Směr povoleného síťového provozu založený na pravidle.
ipv4Addresses	string[]	Sada IPv4 adres povolených jako zdroj nebo cíl bezpečnostního pravidla. Pro jednu adresu použijte /32 (notace CIDR). Musí být uvedena jedna nebo obě adresy Ipv4Addresses a Ipv6Address. Příklady formátů: 10.10.10.10-10.10.10.20 nebo 10.10.10.10/24.
ipv6Addresses	string[]	Sada IPv6 adres povolených jako zdroj nebo cíl bezpečnostního pravidla. Pro jednu adresu použijte /128 (notace CIDR). Musí být uvedena jedna nebo obě adresy Ipv4Addresses a Ipv6Address. Příklady formátů: 2001:db8:abcd::1-2001:db8:abcd::ff nebo 2001:db8:abcd::1/64.
port	string	Zdrojový nebo cílový port nebo rozsah portů. Příklad 24562 nebo 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Objekt

Komplexní typ rozšířeného umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationType	Typ rozšířeného umístění.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocationType

Výčet

Typ rozšířeného umístění.

Hodnota	Description
EdgeZone	Typ umístění zón Azure Edge
CustomLocation	Typ vlastních umístění Azure

SecurityRuleDirection

Výčet

Směr povoleného síťového provozu založený na pravidle.

Hodnota	Description
Inbound	Příchozí provoz směrem ke clusteru on-premsises (on-premises cluster).
Outbound	Odchozí provoz z on-premises clusteru.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TransportProtocol

Výčet

Protokol inzerovaný endpointy access bridge.

Hodnota	Description
TCP	TCP transportní protokol.
UDP	Protokol UDP transportu.

Sdílet prostřednictvím

Access Bridges - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Create or update access bridge

Ukázkový požadavek

Ukázková odpověď

Definice

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol