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=2023-09-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
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

Nome Necessario Tipo Descrizione
properties.appliesToGroups True

connectivityGroupItem[]

Gruppi per la configurazione

properties.connectivityTopology True

ConnectivityTopology

Tipo di topologia di connettività.

properties.deleteExistingPeering

DeleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

properties.description

string

Descrizione della configurazione della connettività.

properties.hubs

Hub[]

Elenco di hubItems

properties.isGlobal

IsGlobal

Contrassegna se la mesh globale è supportata.

Risposte

Nome Tipo Descrizione
200 OK

ConnectivityConfiguration

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

201 Created

ConnectivityConfiguration

Creazione riuscita. L'operazione restituisce la configurazione della connettività di Gestione rete risultante.

Other Status Codes

CloudError

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

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ConnectivityConfigurationsPut

Sample Request

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

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

Sample Response

{
  "name": "myTestConnectivityConfig",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/groups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000"
  }
}
{
  "name": "myTestConnectivityConfig",
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myTestConnectivityConfig",
        "resourceType": "Microsoft.Network/virtualNetworks"
      }
    ],
    "deleteExistingPeering": "True",
    "isGlobal": "True",
    "appliesToGroups": [
      {
        "networkGroupId": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/group1",
        "useHubGateway": "True",
        "groupConnectivity": "None",
        "isGlobal": "False"
      }
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "00000000-0000-0000-0000-000000000000"
  }
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

ConnectivityConfiguration

Risorsa di configurazione della connettività di Network Manager

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 la mesh globale è supportata.

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.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

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

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

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

target

string

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

ConnectivityConfiguration

Risorsa di configurazione della connettività di Network Manager

Nome Tipo Descrizione
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

connectivityGroupItem[]

Gruppi per la configurazione

properties.connectivityTopology

ConnectivityTopology

Tipo di topologia di connettività.

properties.deleteExistingPeering

DeleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

properties.description

string

Descrizione della configurazione della connettività.

properties.hubs

Hub[]

Elenco di hubItems

properties.isGlobal

IsGlobal

Contrassegna se la mesh globale è supportata.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa di configurazione della connettività.

properties.resourceGuid

string

Identificatore univoco per questa risorsa.

systemData

SystemData

Metadati di sistema correlati a questa risorsa.

type

string

Tipo di risorsa.

connectivityGroupItem

Elemento del gruppo di connettività.

Nome Tipo Descrizione
groupConnectivity

GroupConnectivity

Tipo di connettività del gruppo.

isGlobal

IsGlobal

Contrassegno se globale è supportato.

networkGroupId

string

ID gruppo di rete.

useHubGateway

UseHubGateway

Contrassegnare se è necessario usare il gateway hub.

ConnectivityTopology

Tipo di topologia di connettività.

Nome Tipo Descrizione
HubAndSpoke

string

Mesh

string

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DeleteExistingPeering

Contrassegnare se è necessario rimuovere i peering esistenti correnti.

Nome Tipo Descrizione
False

string

True

string

GroupConnectivity

Tipo di connettività del gruppo.

Nome Tipo Descrizione
DirectlyConnected

string

None

string

Hub

Elemento hub.

Nome Tipo Descrizione
resourceId

string

ID risorsa.

resourceType

string

Tipo di risorsa.

IsGlobal

Contrassegna se la mesh globale è supportata.

Nome Tipo Descrizione
False

string

True

string

ProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Deleting

string

Failed

string

Succeeded

string

Updating

string

SystemData

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

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

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

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

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

UseHubGateway

Contrassegnare se è necessario usare il gateway hub.

Nome Tipo Descrizione
False

string

True

string