Guia de início rápido: criar um hub de notificação usando um modelo do Gerenciador de Recursos

Artigo
03/17/2024

Os Hubs de Notificação do Azure fornecem um mecanismo de push fácil de usar e dimensionado que permite enviar notificações para qualquer plataforma (iOS, Android, Windows, Kindle, etc.) de qualquer back-end (nuvem ou local). Para obter mais informações sobre o serviço, consulte O que são os Hubs de Notificação do Azure.

Um modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo utiliza sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Este guia de início rápido usa um modelo do Azure Resource Manager para criar um namespace dos Hubs de Notificação do Azure e um hub de notificação chamado MyHub dentro desse namespace.

Se o seu ambiente cumpre os pré-requisitos e se está familiarizado com a utilização de modelos ARM, selecione o botão Implementar no Azure. O modelo será aberto no portal do Azure.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Rever o modelo

O modelo utilizado neste início rápido pertence aos Modelos de Início Rápido do Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.8.9.13224",
      "templateHash": "2713724900359552876"
    }
  },
  "parameters": {
    "namespaceName": {
      "type": "string",
      "metadata": {
        "description": "The name of the Notification Hubs namespace."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "The location in which the Notification Hubs resources should be deployed."
      }
    }
  },
  "variables": {
    "hubName": "MyHub"
  },
  "resources": [
    {
      "type": "Microsoft.NotificationHubs/namespaces",
      "apiVersion": "2017-04-01",
      "name": "[parameters('namespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Free"
      }
    },
    {
      "type": "Microsoft.NotificationHubs/namespaces/notificationHubs",
      "apiVersion": "2017-04-01",
      "name": "[format('{0}/{1}', parameters('namespaceName'), variables('hubName'))]",
      "location": "[parameters('location')]",
      "properties": {},
      "dependsOn": [
        "[resourceId('Microsoft.NotificationHubs/namespaces', parameters('namespaceName'))]"
      ]
    }
  ]
}

Implementar o modelo

Selecione a imagem seguinte para iniciar sessão no Azure e abrir um modelo. O modelo usa um nome de namespace dos Hubs de Notificação como parâmetro. Em seguida, o modelo cria um namespace com esse nome e um hub de notificação chamado MyHub dentro desse namespace.

Rever os recursos implementados

Você pode usar o portal do Azure para verificar os recursos implantados ou usar a CLI do Azure ou o script do Azure PowerShell para listar o namespace e o hub dos Hubs de Notificação implantados:

PowerShell
CLI

Get-AzNotificationHub -Namespace "nhtestns123" -ResourceGroup "ContosoNotificationsGroup"
Get-AzNotificationHubsNamespace -Namespace "nhtestns123"

az notification-hub show --resource-group ContosoNotificationsGroup --namespace-name nhtestns123 --name MyHub
az notification-hub namespace show --resource-group ContosoNotificationsGroup --name nhtestns123

A saída é semelhante a:

Verify deployment

Clean up resources (Limpar recursos)

Quando não for mais necessário, exclua o grupo de recursos, que exclui os recursos do grupo de recursos.

$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
Remove-AzResourceGroup -Name $resourceGroupName
Write-Host "Press [ENTER] to continue..."

Próximos passos

Para obter um tutorial passo a passo que o orienta pelo processo de criação de um modelo, consulte:

Tutorial: Criar e implantar seu primeiro modelo ARM

Share via