Connectivity Configurations - Create Or Update

Hizmet:

Network Manager

API Sürümü:

2025-05-01

Yeni bir ağ yöneticisi bağlantı yapılandırması oluşturur/güncelleştirir

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/connectivityConfigurations/{configurationName}?api-version=2025-05-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
configurationName	path	True	string	Ağ yöneticisi bağlantı yapılandırmasının adı.
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Ağ yöneticisinin 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
properties.appliesToGroups	True	connectivityGroupItem[]	Yapılandırma grupları
properties.connectivityTopology	True	ConnectivityTopology	Bağlantı topolojisi türü.
properties.connectivityCapabilities		ConnectivityConfigurationPropertiesConnectivityCapabilities	Bağlantı yapılandırma kaynağının belirli topoloji davranışlarını geliştirmek için ek ayarların toplanması.
properties.deleteExistingPeering		DeleteExistingPeering	Geçerli eşlemeleri kaldırmanız gerekiyorsa bayrak ekleyin.
properties.description		string	Bağlantı yapılandırmasının açıklaması.
properties.hubs		Hub[]	hubItems listesi
properties.isGlobal		IsGlobal	Genel ağ destekleniyorsa bayrak ekleyin.

Yanıtlar

Name	Tür	Description
200 OK	ConnectivityConfiguration	Kaynak 'ConnectivityConfiguration' güncelleme işlemi başarılı oldu
201 Created	ConnectivityConfiguration	Kaynak 'ConnectivityConfiguration' oluşturma işlemi başarılı oldu
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 akışı.

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

ConnectivityConfigurationsPut

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig?api-version=2025-05-01

{
  "properties": {
    "description": "Sample Configuration",
    "appliesToGroups": [
      {
        "groupConnectivity": "None",
        "isGlobal": "False",
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True"
      }
    ],
    "connectivityCapabilities": {
      "connectedGroupAddressOverlap": "Allowed",
      "connectedGroupPrivateEndpointsScale": "Standard",
      "peeringEnforcement": "Unenforced"
    },
    "connectivityTopology": "HubAndSpoke",
    "deleteExistingPeering": "True",
    "hubs": [
      {
        "resourceId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "isGlobal": "True"
  }
}

JavaScript

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Creates/Updates a new network manager connectivity configuration
 *
 * @summary Creates/Updates a new network manager connectivity configuration
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkManagerConnectivityConfigurationPut.json
 */
async function connectivityConfigurationsPut() {
  const subscriptionId =
    process.env["NETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "myResourceGroup";
  const networkManagerName = "testNetworkManager";
  const configurationName = "myTestConnectivityConfig";
  const connectivityConfiguration = {
    description: "Sample Configuration",
    appliesToGroups: [
      {
        groupConnectivity: "None",
        isGlobal: "False",
        networkGroupId:
          "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        useHubGateway: "True",
      },
    ],
    connectivityCapabilities: {
      connectedGroupAddressOverlap: "Allowed",
      connectedGroupPrivateEndpointsScale: "Standard",
      peeringEnforcement: "Unenforced",
    },
    connectivityTopology: "HubAndSpoke",
    deleteExistingPeering: "True",
    hubs: [
      {
        resourceId:
          "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        resourceType: "Microsoft.Network/virtualNetworks",
      },
    ],
    isGlobal: "True",
  };
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.connectivityConfigurations.createOrUpdate(
    resourceGroupName,
    networkManagerName,
    configurationName,
    connectivityConfiguration,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:

200

{
  "name": "myTestConnectivityConfig",
  "type": "Microsoft.Network/networkManagers/connectivityConfigurations",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig",
  "properties": {
    "description": "Sample Connectivity Configuration",
    "appliesToGroups": [
      {
        "groupConnectivity": "None",
        "isGlobal": "False",
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/groups/group1",
        "useHubGateway": "True"
      }
    ],
    "connectivityCapabilities": {
      "connectedGroupAddressOverlap": "Allowed",
      "connectedGroupPrivateEndpointsScale": "Standard",
      "peeringEnforcement": "Unenforced"
    },
    "connectivityTopology": "HubAndSpoke",
    "deleteExistingPeering": "True",
    "hubs": [
      {
        "resourceId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "isGlobal": "True",
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000"
  },
  "systemData": {
    "createdAt": "2021-01-11T18:52:27Z",
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User"
  }
}

Durum kodu:

201

{
  "name": "myTestConnectivityConfig",
  "type": "Microsoft.Network/networkManagers/connectivityConfigurations",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig",
  "properties": {
    "description": "Sample Configuration",
    "appliesToGroups": [
      {
        "groupConnectivity": "None",
        "isGlobal": "False",
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True"
      }
    ],
    "connectivityCapabilities": {
      "connectedGroupAddressOverlap": "Allowed",
      "connectedGroupPrivateEndpointsScale": "Standard",
      "peeringEnforcement": "Unenforced"
    },
    "connectivityTopology": "HubAndSpoke",
    "deleteExistingPeering": "True",
    "hubs": [
      {
        "resourceId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "isGlobal": "True",
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000"
  },
  "systemData": {
    "createdAt": "2021-01-11T18:52:27Z",
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User"
  }
}

Tanımlar

Name	Description
CloudError	Hizmetten bir hata yanıtı.
CloudErrorBody	Hizmetten bir hata yanıtı.
ConnectedGroupAddressOverlap	Bağlantı yapılandırmasının bağlı grubunun üyeleri arasında çakışan IP adresi alanını işleme davranışı.
ConnectedGroupPrivateEndpointsScale	Bağlantı yapılandırmasının bağlı grubunda izin verilen özel uç noktaların ölçeğini gösteren seçenek.
ConnectivityConfiguration	Ağ yöneticisi bağlantı yapılandırma kaynağı
ConnectivityConfigurationPropertiesConnectivityCapabilities	Bağlantı yapılandırma kaynağının belirli topoloji davranışlarını geliştirmek için ek ayarların toplanması.
connectivityGroupItem	Bağlantı grubu öğesi.
ConnectivityTopology	Bağlantı topolojisi türü.
createdByType	Kaynağı oluşturan kimliğin türü.
DeleteExistingPeering	Geçerli eşlemeleri kaldırmanız gerekiyorsa bayrak ekleyin.
GroupConnectivity	Grup bağlantı türü.
Hub	Hub Öğesi.
IsGlobal	Genel ağ destekleniyorsa bayrak ekleyin.
PeeringEnforcement	Bağlantı yapılandırması tarafından oluşturulan eşlemelerin zorlanmasını gösteren seçenek.
ProvisioningState	Kaynağın sağlama durumları.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UseHubGateway	Hub ağ geçidini kullanmanız gerekiyorsa bayrak ekleyin.

CloudError

Nesne

Hizmetten bir hata yanıtı.

Name	Tür	Description
error	CloudErrorBody	Bulut hata gövdesi.

CloudErrorBody

Nesne

Hizmetten bir hata yanıtı.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
details	CloudErrorBody[]	Hatayla ilgili ek ayrıntıların listesi.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.
target	string	Belirli bir hatanın hedefi. Örneğin, özelliğin adı hatalı.

ConnectedGroupAddressOverlap

Numaralandırma

Bağlantı yapılandırmasının bağlı grubunun üyeleri arasında çakışan IP adresi alanını işleme davranışı.

Değer	Description
Allowed	Default. Bağlı grup üyelerinin çakışan IP adres alanına sahip olmasına izin verir.
Disallowed	Bağlı grup üyelerinin çakışan IP adresi alanına sahip olmasına kesinlikle izin vermez. Bağlı gruba çakışan adrese sahip bir sanal ağın eklenmesini engeller, herhangi bir bağlı grup üyesinin çakışan bir aralığı varsa sanal ağ ile bağlı grup üyesi arasında eşlemeyi engeller ve çakışmaya neden olabilecek adres alanı değişikliklerini kısıtlar.

ConnectedGroupPrivateEndpointsScale

Numaralandırma

Bağlantı yapılandırmasının bağlı grubunda izin verilen özel uç noktaların ölçeğini gösteren seçenek.

Değer	Description
Standard	Default. Bağlı grupta en fazla 2K özel uç noktaya izin verir.
HighScale	Bağlı grupta en fazla 20 bin özel uç noktaya izin verir.

ConnectivityConfiguration

Nesne

Ağ yöneticisi bağlantı yapılandırma kaynağı

Name	Tür	Description
etag	string	Kaynak her güncelleştirildiğinde değişen benzersiz bir salt okunur dize.
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.appliesToGroups	connectivityGroupItem[]	Yapılandırma grupları
properties.connectivityCapabilities	ConnectivityConfigurationPropertiesConnectivityCapabilities	Bağlantı yapılandırma kaynağının belirli topoloji davranışlarını geliştirmek için ek ayarların toplanması.
properties.connectivityTopology	ConnectivityTopology	Bağlantı topolojisi türü.
properties.deleteExistingPeering	DeleteExistingPeering	Geçerli eşlemeleri kaldırmanız gerekiyorsa bayrak ekleyin.
properties.description	string	Bağlantı yapılandırmasının açıklaması.
properties.hubs	Hub[]	hubItems listesi
properties.isGlobal	IsGlobal	Genel ağ destekleniyorsa bayrak ekleyin.
properties.provisioningState	ProvisioningState	Bağlantı yapılandırma kaynağının sağlama durumu.
properties.resourceGuid	string	Bu kaynağın benzersiz tanımlayıcısı.
systemData	systemData	Bu kaynakla ilgili sistem meta verileri.
type	string	Kaynak türü.

ConnectivityConfigurationPropertiesConnectivityCapabilities

Nesne

Bağlantı yapılandırma kaynağının belirli topoloji davranışlarını geliştirmek için ek ayarların toplanması.

Name	Tür	Default value	Description
connectedGroupAddressOverlap	ConnectedGroupAddressOverlap	Allowed	Bağlantı yapılandırmasının bağlı grubunun üyeleri arasında çakışan IP adresi alanını işleme davranışı.
connectedGroupPrivateEndpointsScale	ConnectedGroupPrivateEndpointsScale	Standard	Bağlantı yapılandırmasının bağlı grubunda izin verilen özel uç noktaların ölçeğini gösteren seçenek.
peeringEnforcement	PeeringEnforcement	Unenforced	Bağlantı yapılandırması tarafından oluşturulan eşlemelerin zorlanmasını gösteren seçenek.

connectivityGroupItem

Nesne

Bağlantı grubu öğesi.

Name	Tür	Description
groupConnectivity	GroupConnectivity	Grup bağlantı türü.
isGlobal	IsGlobal	Genel destekleniyorsa bayrak.
networkGroupId	string	Ağ grubu kimliği.
useHubGateway	UseHubGateway	Hub ağ geçidini kullanmanız gerekiyorsa bayrak ekleyin.

ConnectivityTopology

Numaralandırma

Bağlantı topolojisi türü.

Değer	Description
HubAndSpoke	HubAndSpoke
Mesh	Örgü

createdByType

Numaralandırma

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

Değer	Description
User
Application
ManagedIdentity
Key

DeleteExistingPeering

Numaralandırma

Geçerli eşlemeleri kaldırmanız gerekiyorsa bayrak ekleyin.

Değer	Description
False	Yanlış
True	Doğru

GroupConnectivity

Numaralandırma

Grup bağlantı türü.

Değer	Description
None	Hiçbiri
DirectlyConnected	DirectConnected

Hub

Nesne

Hub Öğesi.

Name	Tür	Description
resourceId	string	Kaynak Kimliği.
resourceType	string	Kaynak Türü.

IsGlobal

Numaralandırma

Genel ağ destekleniyorsa bayrak ekleyin.

Değer	Description
False	Yanlış
True	Doğru

PeeringEnforcement

Numaralandırma

Bağlantı yapılandırması tarafından oluşturulan eşlemelerin zorlanmasını gösteren seçenek.

Değer	Description
Unenforced	Default. Bağlantı yapılandırması tarafından oluşturulan eşlemeler, ağ yöneticisinin dışında değiştirilebilir veya silinebilir.
Enforced	Bağlantı yapılandırması tarafından oluşturulan eşlemeler, ağ yöneticisi dışında değiştirilemez veya silinemez.

ProvisioningState

Numaralandırma

Kaynağın sağlama durumları.

Değer	Description
Failed	Başarısız oldu
Succeeded	Succeeded
Canceled	İptal edildi
Creating	Oluşturma
Updating	Güncelleştirme
Deleting	Siliniyor

systemData

Nesne

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ü.

UseHubGateway

Numaralandırma

Hub ağ geçidini kullanmanız gerekiyorsa bayrak ekleyin.

Değer	Description
False	Yanlış
True	Doğru