Connectivity Configurations - Create Or Update

Crea/Aggiornamenti una nuova configurazione di connettività di Gestione rete

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

Parametri dell'URI

Name In Required Type Description
configurationName
path True
  • string

Nome della configurazione della connettività di Gestione rete.

networkManagerName
path True
  • string

Nome del gestore di rete.

resourceGroupName
path True
  • string

Nome del gruppo di risorse.

subscriptionId
path True
  • string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True
  • string

Versione API client.

Corpo della richiesta

Name Required Type Description
properties.appliesToGroups True

Gruppi per la configurazione

properties.connectivityTopology True

Tipo di topologia di connettività.

properties.deleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

properties.description
  • string

Descrizione della configurazione della connettività.

properties.hubs

Elenco di hubItems

properties.isGlobal

Contrassegna se è supportata la mesh globale.

Risposte

Name Type Description
200 OK

Aggiornamento riuscito. L'operazione restituisce la configurazione di connettività di Gestione rete risultante.

201 Created

Creare correttamente. L'operazione restituisce la configurazione di connettività di Gestione rete risultante.

Other Status Codes

Risposta di errore del provider di risorse che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

ConnectivityConfigurationsPut

Sample Request

PUT https://management.azure.com/subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig?api-version=2022-01-01

{
  "properties": {
    "description": "Sample Configuration",
    "connectivityTopology": "HubAndSpoke",
    "hubs": [
      {
        "resourceId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/subscriptionA/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ]
  }
}

Sample Response

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

Definizioni

CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

ConnectivityConfiguration

Risorsa di configurazione della connettività di Gestione rete

connectivityGroupItem

Elemento del gruppo di connettività.

ConnectivityTopology

Tipo di topologia di connettività.

createdByType

Tipo di identità che ha creato la risorsa.

DeleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

GroupConnectivity

Tipo di connettività del gruppo.

Hub

Elemento hub.

IsGlobal

Contrassegna se è supportata la mesh globale.

ProvisioningState

Stato di provisioning corrente.

SystemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

UseHubGateway

Contrassegnare se è necessario usare il gateway hub.

CloudError

Risposta di errore dal servizio.

Name Type Description
error

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Name Type Description
code
  • string

Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice.

details

Elenco di dettagli aggiuntivi sull'errore.

message
  • string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target
  • string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in caso di errore.

ConnectivityConfiguration

Risorsa di configurazione della connettività di Gestione rete

Name Type Description
etag
  • string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.

id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.appliesToGroups

Gruppi per la configurazione

properties.connectivityTopology

Tipo di topologia di connettività.

properties.deleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

properties.description
  • string

Descrizione della configurazione della connettività.

properties.hubs

Elenco di hubItems

properties.isGlobal

Contrassegna se è supportata la mesh globale.

properties.provisioningState

Stato di provisioning della risorsa di configurazione della connettività.

systemData

Metadati di sistema correlati a questa risorsa.

type
  • string

Tipo di risorsa.

connectivityGroupItem

Elemento del gruppo di connettività.

Name Type Description
groupConnectivity

Tipo di connettività del gruppo.

isGlobal

Contrassegna se è supportato global.

networkGroupId
  • string

ID gruppo di rete.

useHubGateway

Contrassegnare se è necessario usare il gateway hub.

ConnectivityTopology

Tipo di topologia di connettività.

Name Type Description
HubAndSpoke
  • string
Mesh
  • string

createdByType

Tipo di identità che ha creato la risorsa.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DeleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

Name Type Description
False
  • string
True
  • string

GroupConnectivity

Tipo di connettività del gruppo.

Name Type Description
DirectlyConnected
  • string
None
  • string

Hub

Elemento hub.

Name Type Description
resourceId
  • string

ID risorsa.

resourceType
  • string

Tipo di risorsa.

IsGlobal

Contrassegna se è supportata la mesh globale.

Name Type Description
False
  • string
True
  • string

ProvisioningState

Stato di provisioning corrente.

Name Type Description
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

SystemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Name Type Description
createdAt
  • string

Timestamp della creazione di risorse (UTC).

createdBy
  • string

Identità che ha creato la risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt
  • string

Tipo di identità che ha modificato l'ultima risorsa.

lastModifiedBy
  • string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

Tipo di identità che ha modificato l'ultima risorsa.

UseHubGateway

Contrassegnare se è necessario usare il gateway hub.

Name Type Description
False
  • string
True
  • string