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 |
---|---|---|---|---|
configuration
|
path | True |
string |
Nome della configurazione della connettività di Gestione rete. |
network
|
path | True |
string |
Nome del gestore di rete. |
resource
|
path | True |
string |
Nome del gruppo di risorse. |
subscription
|
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 |
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 |
Hub[] |
Elenco di hubItems |
|
properties.isGlobal |
Contrassegna se la mesh globale è supportata. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornamento riuscito. L'operazione restituisce la configurazione della connettività di Gestione rete risultante. |
|
201 Created |
Creazione riuscita. L'operazione restituisce la configurazione della 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
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 |
---|---|
Cloud |
Risposta di errore dal servizio. |
Cloud |
Risposta di errore dal servizio. |
Connectivity |
Risorsa di configurazione della connettività di Network Manager |
connectivity |
Elemento del gruppo di connettività. |
Connectivity |
Tipo di topologia di connettività. |
created |
Tipo di identità che ha creato la risorsa. |
Delete |
Contrassegnare se è necessario rimuovere i peering esistenti correnti. |
Group |
Tipo di connettività del gruppo. |
Hub |
Elemento hub. |
Is |
Contrassegna se la mesh globale è supportata. |
Provisioning |
Stato di provisioning corrente. |
System |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Use |
Contrassegnare se è necessario usare il gateway hub. |
CloudError
Risposta di errore dal servizio.
Nome | Tipo | Descrizione |
---|---|---|
error |
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 |
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 |
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 |
Hub[] |
Elenco di hubItems |
properties.isGlobal |
Contrassegna se la mesh globale è supportata. |
|
properties.provisioningState |
Stato di provisioning della risorsa di configurazione della connettività. |
|
properties.resourceGuid |
string |
Identificatore univoco per questa risorsa. |
systemData |
Metadati di sistema correlati a questa risorsa. |
|
type |
string |
Tipo di risorsa. |
connectivityGroupItem
Elemento del gruppo di connettività.
Nome | Tipo | Descrizione |
---|---|---|
groupConnectivity |
Tipo di connettività del gruppo. |
|
isGlobal |
Contrassegno se globale è supportato. |
|
networkGroupId |
string |
ID gruppo di rete. |
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 |
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 |
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 |