Connectivity Configurations - Create Or Update
Cria/atualiza uma nova configuração de conectividade do gerenciador de rede
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/connectivityConfigurations/{configurationName}?api-version=2024-05-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
configuration
|
path | True |
string |
O nome da configuração de conectividade do gerenciador de rede. |
network
|
path | True |
string |
O nome do gerenciador de rede. |
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
path | True |
string |
As credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço. |
api-version
|
query | True |
string |
Versão da API do cliente. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
properties.appliesToGroups | True |
Grupos para configuração |
|
properties.connectivityTopology | True |
Tipo de topologia de conectividade. |
|
properties.deleteExistingPeering |
Sinalizar se for necessário remover os emparelhamentos existentes atuais. |
||
properties.description |
string |
Uma descrição da configuração de conectividade. |
|
properties.hubs |
Hub[] |
Lista de hubItems |
|
properties.isGlobal |
Sinalizar se houver suporte para malha global. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Atualize com êxito. A operação retorna a configuração de conectividade do gerenciador de rede resultante. |
|
201 Created |
Crie com êxito. A operação retorna a configuração de conectividade do gerenciador de rede resultante. |
|
Other Status Codes |
Resposta de erro do Provedor de Recursos descrevendo por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
ConnectivityConfigurationsPut
Solicitação de exemplo
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkManagers/testNetworkManager/connectivityConfigurations/myTestConnectivityConfig?api-version=2024-05-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"
}
]
}
}
Resposta de exemplo
{
"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"
}
}
Definições
Nome | Description |
---|---|
Cloud |
Uma resposta de erro do serviço. |
Cloud |
Uma resposta de erro do serviço. |
Connectivity |
O recurso de configuração de conectividade do gerenciador de rede |
connectivity |
Item do grupo de conectividade. |
Connectivity |
Tipo de topologia de conectividade. |
created |
O tipo de identidade que criou o recurso. |
Delete |
Sinalizar se for necessário remover os emparelhamentos existentes atuais. |
Group |
Tipo de conectividade de grupo. |
Hub |
Item do Hub. |
Is |
Sinalizar se houver suporte para malha global. |
Provisioning |
O estado de provisionamento atual. |
System |
Metadados relativos à criação e última modificação do recurso. |
Use |
Sinalizar se for necessário usar o gateway do hub. |
CloudError
Uma resposta de erro do serviço.
Nome | Tipo | Description |
---|---|---|
error |
Corpo do erro de nuvem. |
CloudErrorBody
Uma resposta de erro do serviço.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
details |
Uma lista de detalhes adicionais sobre o erro. |
|
message |
string |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
target |
string |
O destino do erro específico. Por exemplo, o nome da propriedade em erro. |
ConnectivityConfiguration
O recurso de configuração de conectividade do gerenciador de rede
Nome | Tipo | Description |
---|---|---|
etag |
string |
Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado. |
id |
string |
ID do recurso. |
name |
string |
Nome do recurso. |
properties.appliesToGroups |
Grupos para configuração |
|
properties.connectivityTopology |
Tipo de topologia de conectividade. |
|
properties.deleteExistingPeering |
Sinalizar se for necessário remover os emparelhamentos existentes atuais. |
|
properties.description |
string |
Uma descrição da configuração de conectividade. |
properties.hubs |
Hub[] |
Lista de hubItems |
properties.isGlobal |
Sinalizar se houver suporte para malha global. |
|
properties.provisioningState |
O estado de provisionamento do recurso de configuração de conectividade. |
|
properties.resourceGuid |
string |
Identificador exclusivo para esse recurso. |
systemData |
Os metadados do sistema relacionados a esse recurso. |
|
type |
string |
Tipo de recurso. |
connectivityGroupItem
Item do grupo de conectividade.
Nome | Tipo | Description |
---|---|---|
groupConnectivity |
Tipo de conectividade de grupo. |
|
isGlobal |
Sinalizar se houver suporte global. |
|
networkGroupId |
string |
ID do grupo de rede. |
useHubGateway |
Sinalizar se for necessário usar o gateway do hub. |
ConnectivityTopology
Tipo de topologia de conectividade.
Valor | Description |
---|---|
HubAndSpoke | |
Mesh |
createdByType
O tipo de identidade que criou o recurso.
Valor | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DeleteExistingPeering
Sinalizar se for necessário remover os emparelhamentos existentes atuais.
Valor | Description |
---|---|
False | |
True |
GroupConnectivity
Tipo de conectividade de grupo.
Valor | Description |
---|---|
DirectlyConnected | |
None |
Hub
Item do Hub.
Nome | Tipo | Description |
---|---|---|
resourceId |
string |
ID do recurso. |
resourceType |
string |
Tipo de recurso. |
IsGlobal
Sinalizar se houver suporte para malha global.
Valor | Description |
---|---|
False | |
True |
ProvisioningState
O estado de provisionamento atual.
Valor | Description |
---|---|
Deleting | |
Failed | |
Succeeded | |
Updating |
SystemData
Metadados relativos à criação e última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string (date-time) |
O tipo de identidade que modificou o recurso pela última vez. |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
UseHubGateway
Sinalizar se for necessário usar o gateway do hub.
Valor | Description |
---|---|
False | |
True |