Criar um circuito do ExpressRoute usando um modelo do Azure Resource Manager

  • Artigo

Saiba como criar um circuito do ExpressRoute implantando um modelo do Azure Resource Manager com o Azure PowerShell. Para obter mais informações sobre como desenvolver modelos do Resource Manager, confira documentação do Resource Manager e a referência de modelo.

Antes de começar

  • Examine os pré-requisitos e os fluxos de trabalho antes de começar a configuração.
  • Verifique se você tem permissões para criar novos recursos de rede. Se você não tiver as permissões corretas, entre em contato com o administrador da conta.
  • Você pode exibir um vídeo antes de começar para entender melhor as etapas.

Criar e provisionar um circuito do ExpressRoute

Os modelos de início rápido do Azure trazem uma ampla coleção de modelos do Resource Manager. Para criar um circuito do ExpressRoute, use um dos modelos existentes.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "14062891962288443864"
    }
  },
  "parameters": {
    "circuitName": {
      "type": "string",
      "metadata": {
        "description": "This is the name of the ExpressRoute circuit"
      }
    },
    "serviceProviderName": {
      "type": "string",
      "metadata": {
        "description": "This is the name of the ExpressRoute Service Provider. It must exactly match one of the Service Providers from List ExpressRoute Service Providers API call."
      }
    },
    "peeringLocation": {
      "type": "string",
      "metadata": {
        "description": "This is the name of the peering location and not the ARM resource location. It must exactly match one of the available peering locations from List ExpressRoute Service Providers API call."
      }
    },
    "bandwidthInMbps": {
      "type": "int",
      "metadata": {
        "description": "This is the bandwidth in Mbps of the circuit being created. It must exactly match one of the available bandwidth offers List ExpressRoute Service Providers API call."
      }
    },
    "skuTier": {
      "type": "string",
      "defaultValue": "Standard",
      "allowedValues": [
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "Chosen SKU Tier of ExpressRoute circuit. Choose from Premium or Standard SKU tiers."
      }
    },
    "skuFamily": {
      "type": "string",
      "defaultValue": "MeteredData",
      "allowedValues": [
        "MeteredData",
        "UnlimitedData"
      ],
      "metadata": {
        "description": "Chosen SKU family of ExpressRoute circuit. Choose from MeteredData or UnlimitedData SKU families."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Network/expressRouteCircuits",
      "apiVersion": "2021-02-01",
      "name": "[parameters('circuitName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[format('{0}_{1}', parameters('skuTier'), parameters('skuFamily'))]",
        "tier": "[parameters('skuTier')]",
        "family": "[parameters('skuFamily')]"
      },
      "properties": {
        "serviceProviderProperties": {
          "serviceProviderName": "[parameters('serviceProviderName')]",
          "peeringLocation": "[parameters('peeringLocation')]",
          "bandwidthInMbps": "[parameters('bandwidthInMbps')]"
        }
      }
    }
  ]
}

Para ver mais modelos relacionados, selecione aqui.

Para criar um circuito do ExpressRoute implantando um modelo:

  1. Selecione Testar no seguinte bloco de código e, em seguida, siga as instruções para entrar no Azure Cloud Shell.

    $circuitName = Read-Host -Prompt "Enter a circuit name"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${circuitName}rg"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.network/expressroute-circuit-create/azuredeploy.json"
$serviceProviderName = "Equinix"
$peeringLocation = "Silicon Valley"
$bandwidthInMbps = 500
$sku_tier = "Premium"
$sku_family = "MeteredData"

New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -circuitName $circuitName -serviceProviderName $serviceProviderName -peeringLocation $peeringLocation -bandwidthInMbps $bandwidthInMbps -sku_tier $sku_tier -sku_family $sku_family

Write-Host "Press [ENTER] to continue ..."

    • O nível de SKU determina se um circuito do ExpressRoute é Local, Padrão ou Premium. Você poderá especificar Local, *Standard ou Premium.

    • A família do SKU determina o tipo de cobrança. Você pode especificar Metereddata para um plano de dados limitado e Unlimiteddata para um plano de dados ilimitado. É possível alterar o tipo de cobrança de Metereddata para Unlimiteddata, mas não é possível alterar o tipo de Unlimiteddata para Metereddata. Um circuito local é somente Unlimiteddata.

    • Local de Emparelhamento é o local físico em que você está realizando o emparelhamento com a Microsoft.

      Importante

      O Local de Emparelhamento indica o local físico em que você está realizando o emparelhamento com a Microsoft. Isso não tem vínculo à propriedade "Local", que se refere à posição geográfica na qual o Provedor de Recursos de Rede do Azure está localizado. Embora eles não estejam relacionados, é uma boa prática escolher um provedor de recursos de rede geograficamente próximo do Local de Emparelhamento do circuito.

    O nome do grupo de recursos é o nome do namespace do barramento de serviço com o acréscimo de rg.

  2. Selecione Copiar para copiar o script do PowerShell.

  3. Clique com o botão direito do mouse no console do Shell e selecione Colar.

Pode demorar alguns minutos para criar um hub de eventos.

Neste tutorial, o Azure PowerShell é usado para implantar o modelo. Para outros métodos de implantação de modelo, consulte:

Desprovisionamento e exclusão de um circuito do ExpressRoute

Você pode excluir seu circuito do ExpressRoute selecionando o ícone Excluir . Observe as seguintes informações:

  • Você deve desvincular todas as redes virtuais do circuito do ExpressRoute. Se essa operação falhar, verifique se há redes virtuais vinculadas ao circuito.
  • Se o estado de provisionamento do provedor de serviço de circuito de ExpressRoute for Provisionando ou Provisionado, você deverá trabalhar com seu provedor de serviços para que ele desprovisione o circuito. Continuaremos a reservar recursos e a cobrar de você até que o provedor de serviços complete o desprovisionamento do circuito e nos notifique.
  • Se o provedor de serviços tiver desprovisionado o circuito (o estado de provisionamento do provedor de serviços estiver definido como Não provisionado), exclua o circuito. Isso interrompe a cobrança pelo circuito.

Você pode excluir o circuito do ExpressRoute executando o comando do PowerShell a seguir:

$circuitName = Read-Host -Prompt "Enter the same circuit name that you used earlier"
$resourceGroupName = "${circuitName}rg"

Remove-AzExpressRouteCircuit -ResourceGroupName $resourceGroupName -Name $circuitName

Próximas etapas

Depois de criar o circuito, continue para as próximas etapas: