Compartilhar via


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
configurationName
path True

string

O nome da configuração de conectividade do gerenciador de rede.

networkManagerName
path True

string

O nome do gerenciador de rede.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
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

connectivityGroupItem[]

Grupos para configuração

properties.connectivityTopology True

ConnectivityTopology

Tipo de topologia de conectividade.

properties.deleteExistingPeering

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

IsGlobal

Sinalizar se houver suporte para malha global.

Respostas

Nome Tipo Description
200 OK

ConnectivityConfiguration

Atualize com êxito. A operação retorna a configuração de conectividade do gerenciador de rede resultante.

201 Created

ConnectivityConfiguration

Crie com êxito. A operação retorna a configuração de conectividade do gerenciador de rede resultante.

Other Status Codes

CloudError

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
CloudError

Uma resposta de erro do serviço.

CloudErrorBody

Uma resposta de erro do serviço.

ConnectivityConfiguration

O recurso de configuração de conectividade do gerenciador de rede

connectivityGroupItem

Item do grupo de conectividade.

ConnectivityTopology

Tipo de topologia de conectividade.

createdByType

O tipo de identidade que criou o recurso.

DeleteExistingPeering

Sinalizar se for necessário remover os emparelhamentos existentes atuais.

GroupConnectivity

Tipo de conectividade de grupo.

Hub

Item do Hub.

IsGlobal

Sinalizar se houver suporte para malha global.

ProvisioningState

O estado de provisionamento atual.

SystemData

Metadados relativos à criação e última modificação do recurso.

UseHubGateway

Sinalizar se for necessário usar o gateway do hub.

CloudError

Uma resposta de erro do serviço.

Nome Tipo Description
error

CloudErrorBody

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

CloudErrorBody[]

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

connectivityGroupItem[]

Grupos para configuração

properties.connectivityTopology

ConnectivityTopology

Tipo de topologia de conectividade.

properties.deleteExistingPeering

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

IsGlobal

Sinalizar se houver suporte para malha global.

properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso de configuração de conectividade.

properties.resourceGuid

string

Identificador exclusivo para esse recurso.

systemData

SystemData

Os metadados do sistema relacionados a esse recurso.

type

string

Tipo de recurso.

connectivityGroupItem

Item do grupo de conectividade.

Nome Tipo Description
groupConnectivity

GroupConnectivity

Tipo de conectividade de grupo.

isGlobal

IsGlobal

Sinalizar se houver suporte global.

networkGroupId

string

ID do grupo de rede.

useHubGateway

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

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

createdByType

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