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 |
|---|---|---|---|---|
|
access
|
path | True |
Erişim köprüsünün adı. |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır. |
|
subscription
|
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 |
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 |
Erişim köprüsü tarafından uygulanan güvenlik kuralları listesi. |
||
| tags |
object |
Kaynak etiketleri. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
Kaynak 'AccessBridge' güncelleme işlemi başarılı oldu |
|
| 201 Created |
Kaynak 'AccessBridge' operasyonu oluşturma başarısı sağlandı Üst Bilgiler Azure-AsyncOperation: string |
|
| Other Status Codes |
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 |
|---|---|
|
Access |
AccessBridge, yönetilen bir erişim köprüsü kaynağıdır. |
|
Access |
Erişim köprüsünün adı. |
|
Access |
Erişim köprüsü tarafından bildirilen ayrıntılı durum. |
|
Access |
AccessBridgeEndpoint, reklam edilen tek bir hizmet uç noktasını tanımlar. |
|
Access |
Erişim köprüsünün tedarik durumu. |
|
Access |
AccessBridgeSecurityRule, köprü tarafından uygulanan bireysel erişim kuralını yakalar. |
|
Azure. |
Genişletilmiş konumun karmaşık türü. |
|
created |
Kaynağı oluşturan kimliğin türü. |
|
Error |
Kaynak yönetimi hatası ek bilgileri. |
|
Error |
Hata ayrıntısı. |
|
Error |
Hata yanıtı |
|
Extended |
Genişletilmiş konumun türü. |
|
Security |
Kurala göre izin verilen ağ trafiğinin yönü. |
|
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
|
Transport |
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 |
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 |
Erişim köprüsü tarafından bildirilen ayrıntılı durum. |
|
| properties.detailedStatusMessage |
string |
Detaylı duruma eşlik eden betimleyici mesaj. |
| properties.endpoints |
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 |
Erişim köprüsü uç noktaları tarafından reklam edilen protokol. |
|
| properties.provisioningState |
Erişim köprüsünün tedarik durumu. |
|
| properties.securityRules |
Erişim köprüsü tarafından uygulanan güvenlik kuralları listesi. |
|
| 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 |
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 |
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 |
Hata ek bilgileri. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
| Name | Tür | Description |
|---|---|---|
| error |
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 |
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 |
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ü. |