Access Bridges - Create Or Update

Служба:: Operator Nexus - Network Cloud

Версия API:: 2026-01-01-preview

Создайте новый подъездный мост или обновите свойства существующего доступного моста.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accessBridgeName	path	True	AccessBridgeAllowedName	Так называется подъездный мост.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
extendedLocation	True	Azure.ResourceManager.CommonTypes.ExtendedLocation	Расширенное расположение ресурса. Это свойство необходимо при создании ресурса.
location	True	string	Географическое расположение, в котором находится ресурс
properties.networkId	True	string (arm-id)	Идентификатор ресурса внутренней сети в изолированном домене уровня 3, содержащем IP-подсети для использования.
properties.ipv4ConnectedPrefix		string	Подсеть IPv4, из которой мост доступа выделяет адрес. Эта подсеть должна быть частью внутренней сети, указанной networkId.
properties.ipv6ConnectedPrefix		string	Подсеть IPv6, из которой мост доступа выделяет адрес. Эта подсеть должна быть частью внутренней сети, указанной networkId.
properties.securityRules		AccessBridgeSecurityRule[]	Список правил безопасности, обеспечиваемых мостом доступа.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	AccessBridge	Операция обновления ресурса 'AccessBridge' успешно прошла
201 Created	AccessBridge	Операция создания ресурса 'AccessBridge' успешно выполнена Заголовки Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

AccessBridge

Операция обновления ресурса 'AccessBridge' успешно прошла

201 Created

AccessBridge

Операция создания ресурса 'AccessBridge' успешно выполнена

Заголовки

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Create or update access bridge

Образец запроса

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

Пример ответа

Код состояния:: 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"
}

Код состояния:: 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"
}

Определения

Имя	Описание
AccessBridge	AccessBridge представляет собой управляемый мост доступа.
AccessBridgeAllowedName	Так называется подъездный мост.
AccessBridgeDetailedStatus	Подробный статус, сообщенный на подъездном мостике.
AccessBridgeEndpoint	AccessBridgeEndpoint описывает одну заявленную конечную точку сервиса.
AccessBridgeProvisioningState	Состояние снабжения подъездного моста.
AccessBridgeSecurityRule	AccessBridgeSecurityRule фиксирует индивидуальное правило доступа, контролируемое мостом.
Azure.ResourceManager.CommonTypes.ExtendedLocation	Сложный тип расширенного расположения.
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
ExtendedLocationType	Тип расширенного расположения.
SecurityRuleDirection	Направление разрешённого сетевого трафика зависит от правила.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
TransportProtocol	Протокол, рекламируемый конечными точками моста доступа.

AccessBridge

Объект

AccessBridge представляет собой управляемый мост доступа.

Имя	Тип	Описание
etag	string	«Если etag указан в теле ответа, он также может быть предоставлен в виде заголовка в соответствии с обычной конвенцией etag. Теги сущностей используются для сравнения двух или нескольких сущностей из одного запрошенного ресурса. HTTP/1.1 использует теги сущностей в полях заголовка etag (раздел 14.19), If-Match (раздел 14.24), If-None-Match (раздел 14.26) и If-Range (раздел 14.27)»).
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation	Расширенное расположение ресурса. Это свойство необходимо при создании ресурса.
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.detailedStatus	AccessBridgeDetailedStatus	Подробный статус, сообщенный на подъездном мостике.
properties.detailedStatusMessage	string	Описательное сообщение, сопровождающее подробный статус.
properties.endpoints	AccessBridgeEndpoint[]	Наблюдаемые конечные точки, которые клиенты должны использовать для доступа к мосту доступа.
properties.ipv4ConnectedPrefix	string	Подсеть IPv4, из которой мост доступа выделяет адрес. Эта подсеть должна быть частью внутренней сети, указанной networkId.
properties.ipv6ConnectedPrefix	string	Подсеть IPv6, из которой мост доступа выделяет адрес. Эта подсеть должна быть частью внутренней сети, указанной networkId.
properties.networkId	string (arm-id)	Идентификатор ресурса внутренней сети в изолированном домене уровня 3, содержащем IP-подсети для использования.
properties.protocol	TransportProtocol	Протокол, рекламируемый конечными точками моста доступа.
properties.provisioningState	AccessBridgeProvisioningState	Состояние снабжения подъездного моста.
properties.securityRules	AccessBridgeSecurityRule[]	Список правил безопасности, обеспечиваемых мостом доступа.
systemData	systemData	Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Перечисление

Так называется подъездный мост.

Значение	Описание
Bastion	Мост для доступа к бастионному бастиону голого металла.
PrivateVault	Мост доступа для кластерного доступа к частному хранилищу.
StorageDashboard	Мост доступа к панели хранения данных.

AccessBridgeDetailedStatus

Перечисление

Подробный статус, сообщенный на подъездном мостике.

Значение	Описание
Running	Мост доступа в состоянии и работает нормально.
Degraded	Подъездный мост испытывает ухудшение производительности или частичные сбои.
Failed	Подъездный мост не функционирует.

AccessBridgeEndpoint

Объект

AccessBridgeEndpoint описывает одну заявленную конечную точку сервиса.

Имя	Тип	Описание
fqdn	string	Полностью квалифицированное доменное имя, используемое для описания имени сертификата для конечной точки.
ipv4Address	string	IPv4-адрес, связанный с конечной точкой.
ipv6Address	string	IPv6-адрес, связанный с конечной точкой.
name	string	Имя, которое указывает тип конечной точки (например, VIP или хозяин).

AccessBridgeProvisioningState

Перечисление

Состояние снабжения подъездного моста.

Значение	Описание
Accepted	Статус «Принято».
Canceled	Статус «Отменено».
Failed	Статус «Неудачника».
Provisioning	Статус снабжения.
Succeeded	Статус «Преемник».

AccessBridgeSecurityRule

Объект

AccessBridgeSecurityRule фиксирует индивидуальное правило доступа, контролируемое мостом.

Имя	Тип	Описание
description	string	Пользователь предоставил ценность, описающую это правило.
direction	SecurityRuleDirection	Направление разрешённого сетевого трафика зависит от правила.
ipv4Addresses	string[]	Набор IPv4-адресов, разрешённых как источник или пункт назначения правила безопасности. Для одного адреса используйте /32 (обозначение CIDR). Необходимо указать один или оба Ipv4Адреса и Ipv6Адреса. Примеры форматов: 10.10.10.10-10.10.20 или 10.10.10.10/24.
ipv6Addresses	string[]	Набор IPv6-адресов, разрешенных в качестве источника или назначения правила безопасности. Для одного адреса используйте /128 (обозначение CIDR). Необходимо указать один или оба Ipv4Адреса и Ipv6Адреса. Примеры форматов: 2001:db8:abcd::1-2001:db8:abcd::ff или 2001:db8:abcd::1/64.
port	string	Источник, конечный порт или диапазон портов. Пример 24562 или 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Объект

Сложный тип расширенного расположения.

Имя	Тип	Описание
name	string	Имя расширенного расположения.
type	ExtendedLocationType	Тип расширенного расположения.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Объект

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ExtendedLocationType

Перечисление

Тип расширенного расположения.

Значение	Описание
EdgeZone	Тип расположения Пограничных зон Azure
CustomLocation	Тип пользовательских расположений Azure

SecurityRuleDirection

Перечисление

Направление разрешённого сетевого трафика зависит от правила.

Значение	Описание
Inbound	Входящий трафик в сторону локального кластера.
Outbound	Исходящий трафик из локального кластера.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

TransportProtocol

Перечисление

Протокол, рекламируемый конечными точками моста доступа.

Значение	Описание
TCP	Протокол транспортировки TCP.
UDP	Протокол транспортировки UDP.

Поделиться через

Access Bridges - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Create or update access bridge

Образец запроса

Пример ответа

Определения

AccessBridge

AccessBridgeAllowedName

AccessBridgeDetailedStatus

AccessBridgeEndpoint

AccessBridgeProvisioningState

AccessBridgeSecurityRule

Azure.ResourceManager.CommonTypes.ExtendedLocation

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocationType

SecurityRuleDirection

systemData

TransportProtocol