Access Bridges - Create Or Update

Serviço:: Operator Nexus - Network Cloud

Versão da API:: 2026-01-01-preview

Crie uma nova ponte de acesso ou atualize as propriedades da ponte de acesso existente.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accessBridgeName	path	True	AccessBridgeAllowedName	O nome da ponte de acesso.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	A localização estendida do recurso. Esta propriedade é necessária na criação do recurso.
location	True	string	A geolocalização onde o recurso vive
properties.networkId	True	string (arm-id)	O ID de recurso da rede interna num domínio de isolamento de camada 3 contendo as subredes IP a utilizar.
properties.ipv4ConnectedPrefix		string	A sub-rede IPv4 a partir da qual a ponte de acesso atribui um endereço. Esta sub-rede deve fazer parte da rede interna especificada pelo networkId.
properties.ipv6ConnectedPrefix		string	A sub-rede IPv6 a partir da qual a ponte de acesso atribui um endereço. Esta sub-rede deve fazer parte da rede interna especificada pelo networkId.
properties.securityRules		AccessBridgeSecurityRule[]	A lista de regras de segurança aplicadas pela ponte de acesso.
tags		object	Tags de recursos.

Respostas

Name	Tipo	Description
200 OK	AccessBridge	Operação de atualização do recurso 'AccessBridge' bem-sucedida
201 Created	AccessBridge	Recurso 'AccessBridge' criar operação bem-sucedida Cabeçalhos Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

AccessBridge

Operação de atualização do recurso 'AccessBridge' bem-sucedida

201 Created

AccessBridge

Recurso 'AccessBridge' criar operação bem-sucedida

Cabeçalhos

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Create or update access bridge

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
}

Código de estado:: 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"
}

Definições

Name	Description
AccessBridge	O AccessBridge representa um recurso de ponte de acesso gerida.
AccessBridgeAllowedName	O nome da ponte de acesso.
AccessBridgeDetailedStatus	O estado detalhado reportado pela ponte de acesso.
AccessBridgeEndpoint	AccessBridgeEndpoint descreve um único endpoint de serviço anunciado.
AccessBridgeProvisioningState	O estado de abastecimento da ponte de acesso.
AccessBridgeSecurityRule	O AccessBridgeSecurityRule capta uma regra de acesso individual aplicada pela ponte.
Azure.ResourceManager.CommonTypes.ExtendedLocation	O tipo complexo do local estendido.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExtendedLocationType	O tipo de localização ampliada.
SecurityRuleDirection	A direção do tráfego de rede permitido com base na regra.
systemData	Metadados referentes à criação e última modificação do recurso.
TransportProtocol	O protocolo anunciado pelos endpoints da ponte de acesso.

AccessBridge

Object

O AccessBridge representa um recurso de ponte de acesso gerida.

Name	Tipo	Description
etag	string	"Se o etag for fornecido no corpo da resposta, ele também pode ser fornecido como um cabeçalho de acordo com a convenção normal do etag. As tags de entidade são usadas para comparar duas ou mais entidades do mesmo recurso solicitado. HTTP/1.1 usa tags de entidade nos campos de cabeçalho etag (seção 14.19), If-Match (seção 14.24), If-None-Match (seção 14.26) e If-Range (seção 14.27).")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	A localização estendida do recurso. Esta propriedade é necessária na criação do recurso.
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.detailedStatus	AccessBridgeDetailedStatus	O estado detalhado reportado pela ponte de acesso.
properties.detailedStatusMessage	string	A mensagem descritiva que acompanha o estado detalhado.
properties.endpoints	AccessBridgeEndpoint[]	Os endpoints observados que os clientes devem usar para aceder à ponte de acesso.
properties.ipv4ConnectedPrefix	string	A sub-rede IPv4 a partir da qual a ponte de acesso atribui um endereço. Esta sub-rede deve fazer parte da rede interna especificada pelo networkId.
properties.ipv6ConnectedPrefix	string	A sub-rede IPv6 a partir da qual a ponte de acesso atribui um endereço. Esta sub-rede deve fazer parte da rede interna especificada pelo networkId.
properties.networkId	string (arm-id)	O ID de recurso da rede interna num domínio de isolamento de camada 3 contendo as subredes IP a utilizar.
properties.protocol	TransportProtocol	O protocolo anunciado pelos endpoints da ponte de acesso.
properties.provisioningState	AccessBridgeProvisioningState	O estado de abastecimento da ponte de acesso.
properties.securityRules	AccessBridgeSecurityRule[]	A lista de regras de segurança aplicadas pela ponte de acesso.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Enumeração

O nome da ponte de acesso.

Valor	Description
Bastion	A ponte de acesso para o acesso às bastiões de máquinas de metal nu.
PrivateVault	A ponte de acesso para o acesso em cluster ao cofre privado.
StorageDashboard	A ponte de acesso para aceder ao painel de armazenamento.

AccessBridgeDetailedStatus

Enumeração

O estado detalhado reportado pela ponte de acesso.

Valor	Description
Running	A ponte de acesso está saudável e a funcionar normalmente.
Degraded	A ponte de acesso está a apresentar desempenho degradado ou interrupções parciais.
Failed	A ponte de acesso não está operacional.

AccessBridgeEndpoint

Object

AccessBridgeEndpoint descreve um único endpoint de serviço anunciado.

Name	Tipo	Description
fqdn	string	O nome de domínio totalmente qualificado usado para descrever o nome do certificado do endpoint.
ipv4Address	string	O endereço IPv4 associado ao endpoint.
ipv6Address	string	O endereço IPv6 associado ao endpoint.
name	string	O nome que identifica o tipo de endpoint (por exemplo, VIP ou anfitrião).

AccessBridgeProvisioningState

Enumeração

O estado de abastecimento da ponte de acesso.

Valor	Description
Accepted	O estatuto Aceite.
Canceled	O estado Cancelado.
Failed	O estado de Falhado.
Provisioning	O estado do Provisionamento.
Succeeded	O estatuto de Sucedido.

AccessBridgeSecurityRule

Object

O AccessBridgeSecurityRule capta uma regra de acesso individual aplicada pela ponte.

Name	Tipo	Description
description	string	O utilizador forneceu valor ao descrever esta regra.
direction	SecurityRuleDirection	A direção do tráfego de rede permitido com base na regra.
ipv4Addresses	string[]	O conjunto de endereços IPv4 permitidos como origem ou destino da regra de segurança. Para um único endereço, utilize-se um /32 (notação CIDR). Um ou ambos os Endereços Ipv4 e Endereços Ipv6 devem ser especificados. Formatos de exemplo: 10.10.10.10-10.10.10.20 ou 10.10.10.10/24.
ipv6Addresses	string[]	O conjunto de endereços IPv6 permitidos como fonte ou destino da regra de segurança. Para um único endereço, utilize-se um /128 (notação CIDR). Um ou ambos os Endereços Ipv4 e Endereços Ipv6 devem ser especificados. Formatos de exemplo: 2001:db8:abcd::1-2001:db8:abcd::ff ou 2001:db8:abcd::1/64.
port	string	A porta de origem ou destino ou o intervalo de portas. Exemplo 24562 ou 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Object

O tipo complexo do local estendido.

Name	Tipo	Description
name	string	O nome do local estendido.
type	ExtendedLocationType	O tipo de localização ampliada.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExtendedLocationType

Enumeração

O tipo de localização ampliada.

Valor	Description
EdgeZone	Tipo de local das Zonas de Borda do Azure
CustomLocation	Tipo de Locais Personalizados do Azure

SecurityRuleDirection

Enumeração

A direção do tráfego de rede permitido com base na regra.

Valor	Description
Inbound	Tráfego de entrada em direção ao cluster on-premises.
Outbound	Tráfego de saída do cluster local.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TransportProtocol

Enumeração

O protocolo anunciado pelos endpoints da ponte de acesso.

Valor	Description
TCP	O protocolo de transporte TCP.
UDP	O protocolo de transporte UDP.

Partilhar via

Access Bridges - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create or update access bridge

Pedido de amostra

Resposta da amostra

Definições

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol