Connectivity Configurations - Create Or Update

Cria/Atualizações 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=2022-01-01

Parâmetros de URI

Name In Required Type 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 de API do cliente.

Corpo da solicitação

Name Required Type Description
properties.appliesToGroups True

Grupos para configuração

properties.connectivityTopology True

Tipo de topologia de conectividade.

properties.deleteExistingPeering

Sinalizar se necessário remover os emparelhamentos existentes atuais.

properties.description
  • string

Uma descrição da configuração de conectividade.

properties.hubs

Lista de hubItems

properties.isGlobal

Sinalizar se houver suporte para a malha global.

Respostas

Name Type Description
200 OK

Atualização bem-sucedida. A operação retorna a configuração de conectividade resultante do gerenciador de rede.

201 Created

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

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.

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

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"
  }
}

Definições

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 necessário remover os emparelhamentos existentes atuais.

GroupConnectivity

Tipo de conectividade de grupo.

Hub

Item do Hub.

IsGlobal

Sinalizar se houver suporte para a malha global.

ProvisioningState

O estado de provisionamento atual.

SystemData

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

UseHubGateway

Sinalizar se necessário usar o gateway do hub.

CloudError

Uma resposta de erro do serviço.

Name Type Description
error

Corpo do erro na nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Name Type 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

Name Type Description
etag
  • string

Uma cadeia de caracteres exclusiva somente leitura 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 necessário remover os emparelhamentos existentes atuais.

properties.description
  • string

Uma descrição da configuração de conectividade.

properties.hubs

Lista de hubItems

properties.isGlobal

Sinalizar se houver suporte para a malha global.

properties.provisioningState

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

systemData

Os metadados do sistema relacionados a esse recurso.

type
  • string

Tipo de recurso.

connectivityGroupItem

Item do grupo de conectividade.

Name Type Description
groupConnectivity

Tipo de conectividade de grupo.

isGlobal

Sinalizar se houver suporte global.

networkGroupId
  • string

ID do grupo de rede.

useHubGateway

Sinalizar se necessário usar o gateway do hub.

ConnectivityTopology

Tipo de topologia de conectividade.

Name Type Description
HubAndSpoke
  • string
Mesh
  • string

createdByType

O tipo de identidade que criou o recurso.

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

DeleteExistingPeering

Sinalizar se necessário remover os emparelhamentos existentes atuais.

Name Type Description
False
  • string
True
  • string

GroupConnectivity

Tipo de conectividade de grupo.

Name Type Description
DirectlyConnected
  • string
None
  • string

Hub

Item do Hub.

Name Type Description
resourceId
  • string

ID do recurso.

resourceType
  • string

Tipo de recurso.

IsGlobal

Sinalizar se houver suporte para a malha global.

Name Type Description
False
  • string
True
  • string

ProvisioningState

O estado de provisionamento atual.

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

SystemData

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

Name Type Description
createdAt
  • string

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

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 necessário usar o gateway do hub.

Name Type Description
False
  • string
True
  • string