Aracılığıyla paylaş


Access Bridges - Create Or Update

Yeni bir erişim köprüsü oluşturun veya mevcut erişim köprüsünün özelliklerini güncelleyin.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
accessBridgeName
path True

AccessBridgeAllowedName

Erişim köprüsünün adı.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.

subscriptionId
path True

string (uuid)

Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name Gerekli Tür Description
extendedLocation True

Azure.ResourceManager.CommonTypes.ExtendedLocation

Kaynağın genişletilmiş konumu. Bu özellik, kaynak oluşturulurken gereklidir.

location True

string

Kaynağın bulunduğu coğrafi konum

properties.networkId True

string (arm-id)

Kullanılacak IP alt ağlarını içeren katman 3 izolasyon alanında iç ağın kaynak kimliği.

properties.ipv4ConnectedPrefix

string

Erişim köprüsünün adres tahsis ettiği IPv4 alt ağı. Bu alt ağ, networkId tarafından belirlenen dahili ağın bir parçası olmalıdır.

properties.ipv6ConnectedPrefix

string

Erişim köprüsünün adres tahsis ettiği IPv6 alt ağı. Bu alt ağ, networkId tarafından belirlenen dahili ağın bir parçası olmalıdır.

properties.securityRules

AccessBridgeSecurityRule[]

Erişim köprüsü tarafından uygulanan güvenlik kuralları listesi.

tags

object

Kaynak etiketleri.

Yanıtlar

Name Tür Description
200 OK

AccessBridge

Kaynak 'AccessBridge' güncelleme işlemi başarılı oldu

201 Created

AccessBridge

Kaynak 'AccessBridge' operasyonu oluşturma başarısı sağlandı

Üst Bilgiler

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

Create or update access bridge

Örnek isteği

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

Örnek yanıt

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

Tanımlar

Name Description
AccessBridge

AccessBridge, yönetilen bir erişim köprüsü kaynağıdır.

AccessBridgeAllowedName

Erişim köprüsünün adı.

AccessBridgeDetailedStatus

Erişim köprüsü tarafından bildirilen ayrıntılı durum.

AccessBridgeEndpoint

AccessBridgeEndpoint, reklam edilen tek bir hizmet uç noktasını tanımlar.

AccessBridgeProvisioningState

Erişim köprüsünün tedarik durumu.

AccessBridgeSecurityRule

AccessBridgeSecurityRule, köprü tarafından uygulanan bireysel erişim kuralını yakalar.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Genişletilmiş konumun karmaşık türü.

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

ExtendedLocationType

Genişletilmiş konumun türü.

SecurityRuleDirection

Kurala göre izin verilen ağ trafiğinin yönü.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

TransportProtocol

Erişim köprüsü uç noktaları tarafından reklam edilen protokol.

AccessBridge

AccessBridge, yönetilen bir erişim köprüsü kaynağıdır.

Name Tür Description
etag

string

"Yanıt gövdesinde etag sağlanmışsa, normal etag kuralına göre bir başlık olarak da sağlanabilir. Varlık etiketleri, aynı istenen kaynaktan iki veya daha fazla varlığı karşılaştırmak için kullanılır. HTTP/1.1, etag (bölüm 14.19), If-Match (bölüm 14.24), If-None-Match (bölüm 14.26) ve If-Range (bölüm 14.27) başlık alanlarında varlık etiketlerini kullanır.")

extendedLocation

Azure.ResourceManager.CommonTypes.ExtendedLocation

Kaynağın genişletilmiş konumu. Bu özellik, kaynak oluşturulurken gereklidir.

id

string (arm-id)

Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Kaynağın bulunduğu coğrafi konum

name

string

Kaynağın adı

properties.detailedStatus

AccessBridgeDetailedStatus

Erişim köprüsü tarafından bildirilen ayrıntılı durum.

properties.detailedStatusMessage

string

Detaylı duruma eşlik eden betimleyici mesaj.

properties.endpoints

AccessBridgeEndpoint[]

Erişim köprüsüne ulaşmak için istemcilerin kullanması gereken gözlemlenen uç noktalar.

properties.ipv4ConnectedPrefix

string

Erişim köprüsünün adres tahsis ettiği IPv4 alt ağı. Bu alt ağ, networkId tarafından belirlenen dahili ağın bir parçası olmalıdır.

properties.ipv6ConnectedPrefix

string

Erişim köprüsünün adres tahsis ettiği IPv6 alt ağı. Bu alt ağ, networkId tarafından belirlenen dahili ağın bir parçası olmalıdır.

properties.networkId

string (arm-id)

Kullanılacak IP alt ağlarını içeren katman 3 izolasyon alanında iç ağın kaynak kimliği.

properties.protocol

TransportProtocol

Erişim köprüsü uç noktaları tarafından reklam edilen protokol.

properties.provisioningState

AccessBridgeProvisioningState

Erişim köprüsünün tedarik durumu.

properties.securityRules

AccessBridgeSecurityRule[]

Erişim köprüsü tarafından uygulanan güvenlik kuralları listesi.

systemData

systemData

Azure Resource Manager metadata içeren createdBy ve modifiedBy bilgileri.

tags

object

Kaynak etiketleri.

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

AccessBridgeAllowedName

Erişim köprüsünün adı.

Değer Description
Bastion

Çıplak metal makine bastion erişimi için erişim köprüsü.

PrivateVault

Özel kasaya küme erişimi için erişim köprüsü.

StorageDashboard

Depolama paneline erişim köprüsü.

AccessBridgeDetailedStatus

Erişim köprüsü tarafından bildirilen ayrıntılı durum.

Değer Description
Running

Erişim köprüsü sağlıklı ve normal çalışıyor.

Degraded

Erişim köprüsü performans düşüşü veya kısmi kesintiler yaşıyor.

Failed

Erişim köprüsü çalışmıyor.

AccessBridgeEndpoint

AccessBridgeEndpoint, reklam edilen tek bir hizmet uç noktasını tanımlar.

Name Tür Description
fqdn

string

Uç nokta için sertifika adını tanımlamak için kullanılan tam nitelikli alan adı.

ipv4Address

string

Uç noktaya bağlı IPv4 adresi.

ipv6Address

string

Uç noktaya bağlı IPv6 adresi.

name

string

Uç nokta türünü (örneğin VIP veya host) belirten isim.

AccessBridgeProvisioningState

Erişim köprüsünün tedarik durumu.

Değer Description
Accepted

Kabul Edilmiş statüsü.

Canceled

İptal edilmiş durum.

Failed

Başarısız statüsü.

Provisioning

Provisioning durumu.

Succeeded

Başarılı statüsü.

AccessBridgeSecurityRule

AccessBridgeSecurityRule, köprü tarafından uygulanan bireysel erişim kuralını yakalar.

Name Tür Description
description

string

Kullanıcı bu kuralı tanımlayan bir değer sağladı.

direction

SecurityRuleDirection

Kurala göre izin verilen ağ trafiğinin yönü.

ipv4Addresses

string[]

Güvenlik kuralının kaynağı veya hedefi olarak izin verilen IPv4 adresleri kümesi. Tek adres için /32 (CIDR gösterimi) kullanın. Bir veya her iki Ipv4Adres ve Ipv6 Adresi belirtilmelidir. Örnek formatlar: 10.10.10.10-10.10.10.20 veya 10.10.10.10/24.

ipv6Addresses

string[]

Güvenlik kuralının kaynağı veya hedefi olarak izin verilen IPv6 adresleri kümesi. Tek adres olarak /128 (CIDR gösterimi) kullanın. Bir veya her iki Ipv4Adres ve Ipv6 Adresi belirtilmelidir. Örnek formatlar: 2001:db8:abcd::1-2001:db8:abcd::ff veya 2001:db8:abcd::1/64.

port

string

Kaynak veya hedef port veya port aralığı. Örnek 24562 veya 24562-24570.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Genişletilmiş konumun karmaşık türü.

Name Tür Description
name

string

Genişletilmiş konumun adı.

type

ExtendedLocationType

Genişletilmiş konumun türü.

createdByType

Kaynağı oluşturan kimliğin türü.

Değer Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name Tür Description
info

object

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi.

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

Hata nesnesi.

ExtendedLocationType

Genişletilmiş konumun türü.

Değer Description
EdgeZone

Azure Edge Zones konum türü

CustomLocation

Azure Özel Konumlar türü

SecurityRuleDirection

Kurala göre izin verilen ağ trafiğinin yönü.

Değer Description
Inbound

Yerel kümeye giden trafik.

Outbound

On-premises kümesinden giden trafik.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string (date-time)

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string (date-time)

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimlik türü.

TransportProtocol

Erişim köprüsü uç noktaları tarafından reklam edilen protokol.

Değer Description
TCP

TCP taşıma protokolü.

UDP

UDP taşıma protokolü.