Share via

Creación de un centro de notificaciones de Azure con la CLI de Azure

  • Artículo

Azure Notification Hubs proporciona un motor de inserción de escalabilidad horizontal y fácil de usar que le permite enviar notificaciones a cualquier plataforma (iOS, Android, Windows, Kindle, Baidu, etc.) desde cualquier back-end (en la nube o local). Para más información sobre el servicio, consulte ¿Qué es Azure Notification Hubs?.

En este inicio rápido, creará un centro de notificaciones mediante la CLI de Azure. En la primera sección se dan los pasos necesarios para crear un espacio de nombres de Notification Hubs. La segunda sección proporciona los pasos para crear un centro de notificaciones en un espacio de nombres existente. También aprenderá a crear una directiva de acceso personalizado.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Prerrequisitos

Importante

Notification Hubs requiere la versión 2.0.67 o posterior de la CLI de Azure. Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Crear un grupo de recursos

Azure Notification Hubs, como todos los demás recursos de Azure, se tiene que implementar en un grupo de recursos. Los grupos de recursos le permiten organizar y administrar los recursos relacionados de Azure. Consulte ¿Qué es Azure Resource Manager? para más información sobre los grupos de recursos.

Para esta guía de inicio rápido, cree un grupo de recursos llamado spnhubrg en la ubicación eastus con el comando az group create siguiente.

az group create --name spnhubrg --location eastus

Creación de un espacio de nombres de Notification Hubs

  1. Cree un espacio de nombres para los centros de notificaciones.

    Un espacio de nombres contiene uno o varios centros y el nombre tiene que ser único dentro de todas las suscripciones de Azure y tener al menos seis caracteres de longitud. Para comprobar la disponibilidad de un nombre, use el comando az notification-hub namespace check-availability.

    az notification-hub namespace check-availability --name spnhubns

    La CLI de Azure responde a la solicitud de disponibilidad mostrando la siguiente salida de la consola:

    {
"id": "/subscriptions/yourSubscriptionID/providers/Microsoft.NotificationHubs/checkNamespaceAvailability",
"isAvailable": true,
"location": null,
"name": "spnhubns",
"properties": false,
"sku": null,
"tags": null,
"type": "Microsoft.NotificationHubs/namespaces/checkNamespaceAvailability"
}

    Observe la segunda línea de la respuesta de la CLI de Azure, "isAvailable": true. Esta línea muestra false si el nombre deseado que especificó para el espacio de nombres no está disponible. Una vez que haya confirmado la disponibilidad del nombre, ejecute el comando az notification-hub namespace create para crear el espacio de nombres.

    az notification-hub namespace create --resource-group spnhubrg --name spnhubns  --location eastus --sku Free

    Si el valor de --name que proporcionó al comando az notification-hub namespace create no está disponible o no cumple las restricciones y reglas nomenclatura de los recursos de Azure, la CLI de Azure responderá con la siguiente salida de la consola:

    #the name is not available
The specified name is not available. For more information visit https://aka.ms/eventhubsarmexceptions.

#the name is invalid
The specified service namespace is invalid.

    Si el nombre que ha intentado no es correcto, seleccione otro nombre para el nuevo espacio de nombres y vuelva a ejecutar el comando az notification-hub namespace create.

    Nota

    A partir de este paso, tendrá que reemplazar el valor del parámetro --namespace en todos los comandos de la CLI de Azure que copie de este inicio rápido.

  2. Obtenga una lista de espacios de nombres.

    Para ver los detalles sobre el nuevo espacio de nombres, use el comando az notification-hub namespace list. El parámetro --resource-group es opcional si desea ver todos los espacios de nombres de una suscripción.

    az notification-hub namespace list --resource-group spnhubrg

Creación de centros de notificaciones

  1. Cree su primer centro de notificaciones.

    Ahora se puede crear uno o varios centros de notificaciones en el nuevo espacio de nombres. Ejecute el comando az notification-hub create para crear un centro de notificaciones.

    az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name spfcmtutorial1nhub --location eastus

  2. Cree un segundo centro de notificaciones.

    Se pueden crear varios centros de notificaciones en un solo espacio de nombres. Para crear un segundo centro de notificaciones en el mismo espacio de nombres, vuelva a ejecutar el comando az notification-hub create con un nombre de centro diferente.

    az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name mysecondnhub --location eastus

  3. Obtiene una lista de centros de notificaciones.

    La CLI de Azure devuelve un mensaje de estado correcto o erróneo con cada comando ejecutado; sin embargo, es posible consultar una lista de los centros de notificaciones, lo cual resulta útil. El comando az notification-hub list se diseñó para este fin.

    az notification-hub list --resource-group spnhubrg --namespace-name spnhubns --output table

Trabajo con directivas de acceso

  1. Azure Notification Hubs utiliza seguridad de firma de acceso compartido mediante el uso de directivas de acceso. Cuando se crea un centro de notificaciones, se crean dos directivas automáticamente. Las cadenas de conexión de estas directivas son necesarias para configurar las notificaciones de envío. El comando az notification-hub authorization-rule list proporciona una lista de nombres de directivas y sus grupos de recursos respectivos.

    az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table

    Importante

    No use la directiva DefaultFullSharedAccessSignature en la aplicación. Esta directiva está pensada para usarse solo en su back-end. Use solo directivas de acceso Listen en la aplicación cliente.

  2. Si desea crear reglas de autorización adicionales con nombres significativos, puede crear y personalizar su propia directiva de acceso mediante el comando az notification-hub authorization-rule create. El parámetro --rights es una lista delimitada por espacios de los permisos que desea asignar.

    az notification-hub authorization-rule create --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --rights Listen Manage Send

  3. Hay dos conjuntos de claves y cadenas de conexión para cada directiva de acceso. Las necesitará más adelante para configurar un centro de notificaciones. Para enumerar las claves y las cadenas de conexión para una directiva de acceso de Notification Hubs, use el comando az notification-hub authorization-rule list-keys.

    # query the keys and connection strings for DefaultListenSharedAccessSignature
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name DefaultListenSharedAccessSignature --output table

    # query the keys and connection strings for a custom policy
az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --output table

    Nota

    Un espacio de nombres de Notification Hubs y una instancia de Notification Hubs tienen directivas de acceso independientes. Asegúrese de que está usando la referencia correcta de la CLI de Azure al consultar las claves y las cadenas de conexión.

Limpieza de recursos

Cuando ya no se necesiten, utilice el comando az group delete para quitar el grupo de recursos y todos los recursos relacionados:

az group delete --name spnhubrg

Pasos siguientes