Share via

Rövid útmutató: Azure-értesítési központ létrehozása az Azure CLI használatával

  • Cikk

Az Azure Notification Hubs egy egyszerűen használható és kibővített leküldéses értesítési alrendszert biztosít, amellyel értesítéseket küldhet bármilyen platformra (iOS, Android, Windows, Kindle, Baidu stb.) bármilyen háttérrendszerből (felhőbeli vagy helyszíni). A szolgáltatással kapcsolatos további információkért lásd : Mi az az Azure Notification Hubs?.

Ebben a rövid útmutatóban egy értesítési központot hoz létre az Azure CLI használatával. Az első szakasz a Notification Hubs-névtér létrehozásának lépéseit ismerteti. A második szakaszban lépésekkel hozhat létre egy értesítési központot egy meglévő névtérben. Azt is megtudhatja, hogyan hozhat létre egyéni hozzáférési szabályzatot.

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Előfeltételek

Fontos

A Notification Hubshoz az Azure CLI 2.0.67-es vagy újabb verziója szükséges. Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Erőforráscsoport létrehozása

Az Azure Notification Hubsot, mint minden Azure-erőforrást, egy erőforráscsoportban kell üzembe helyezni. Az erőforráscsoportok lehetővé teszik az egymáshoz kapcsolódó Azure-erőforrások rendszerezését és kezelését. Az erőforráscsoportokról további információt az Azure Resource Manager ismertetése című témakörben talál.

Ebben a rövid útmutatóban hozzon létre egy spnhubrg nevű erőforráscsoportot az eastus helyen az alábbi az group create paranccsal.

az group create --name spnhubrg --location eastus

Notification Hubs-névtér létrehozása

  1. Hozzon létre egy névteret az értesítési központok számára.

    A névtér egy vagy több központot tartalmaz, és a névnek minden Azure-előfizetésben egyedinek kell lennie, és legalább hat karakter hosszúságúnak kell lennie. A név rendelkezésre állásának ellenőrzéséhez használja az az notification-hub namespace check-availability parancsot.

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

    Az Azure CLI a következő konzolkimenet megjelenítésével válaszol a rendelkezésre állási kérelemre:

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

    Figyelje meg az Azure CLI-válasz második sorát: "isAvailable": true. Ez a sor azt olvassa false fel, hogy a névtérhez megadott kívánt név nem érhető-e el. Miután megerősítette a név rendelkezésre állását, futtassa az az notification-hub namespace create parancsot a névtér létrehozásához.

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

    Ha a --nameaz notification-hub namespace create parancshoz megadott parancs nem érhető el, vagy nem felel meg az Azure-erőforrások elnevezési szabályainak és korlátozásainak, az Azure CLI a következő konzolkimenettel válaszol:

    #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.

    Ha a kipróbált utónév nem sikerült, válasszon másik nevet az új névtérnek, és futtassa újra a az notification-hub namespace create parancsot.

    Megjegyzés

    Ebből a lépésből a paraméter értékét kell lecserélnie az ebben a --namespace rövid útmutatóban másolt Azure CLI-parancsokban.

  2. Névterek listájának lekérése.

    Az új névtér részleteinek megtekintéséhez használja az az notification-hub névtérlista parancsot. A --resource-group paraméter nem kötelező, ha egy előfizetés összes névterét meg szeretné jeleníteni.

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

Értesítési központok létrehozása

  1. Hozza létre az első értesítési központot.

    Mostantól létrehozhat egy vagy több értesítési központot az új névtérben. Az értesítési központ létrehozásához futtassa az az notification-hub create parancsot.

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

  2. Hozzon létre egy második értesítési központot.

    Több értesítési központ hozható létre egyetlen névtérben. Ha egy második értesítési központot szeretne létrehozni ugyanabban a névtérben, futtassa újra a az notification-hub create parancsot egy másik központnévvel.

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

  3. Az értesítési központok listájának lekérése.

    Az Azure CLI egy sikeres vagy hibaüzenetet ad vissza az egyes végrehajtott parancsokkal; Az értesítési központok listájának lekérdezése azonban megnyugtató. Az az notification-hub list parancsot erre a célra tervezték.

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

Hozzáférési szabályzatok működése

  1. Az Azure Notification Hubs a hozzáférési szabályzatok használatával közös hozzáférésű jogosultságkód-biztonságot használ. Az értesítési központ létrehozásakor két szabályzat jön létre automatikusan. A leküldéses értesítések konfigurálásához az ezekből a szabályzatokból származó kapcsolati sztringekre van szükség. Az az notification-hub authorization-rule list parancs a szabályzatnevek és a hozzájuk tartozó erőforráscsoportok listáját tartalmazza.

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

    Fontos

    Ne használja a DefaultFullSharedAccessSignature szabályzatot az alkalmazásban. Ez a szabályzat csak a háttérrendszerben használható. Listen Csak hozzáférési szabályzatokat használjon az ügyfélalkalmazásban.

  2. Ha további, értelmes neveket tartalmazó engedélyezési szabályokat szeretne létrehozni, az az notification-hub authorization-rule create paranccsal hozhatja létre és szabhatja testre a saját hozzáférési szabályzatát. A --rights paraméter a hozzárendelni kívánt engedélyek szóközzel tagolt listája.

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

  3. Minden hozzáférési szabályzathoz két kulcskészlet és kapcsolati sztring tartozik. Később szüksége lesz rájuk egy értesítési központ konfigurálásához. A Notification Hubs hozzáférési szabályzatának kulcsainak és kapcsolati sztringjeinek listázásához használja az az notification-hub authorization-rule list-keys parancsot.

    # 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

    Megjegyzés

    A Notification Hubs-névtér és az értesítési központ külön hozzáférési szabályzatokkal rendelkezik. Győződjön meg arról, hogy a megfelelő Azure CLI-referenciát használja a kulcsok és kapcsolati sztringek lekérdezéséhez.

Az erőforrások eltávolítása

Ha már nincs rá szükség, az az group delete paranccsal távolítsa el az erőforráscsoportot és az összes kapcsolódó erőforrást:

az group delete --name spnhubrg

Következő lépések