Snabbstart: Skapa en Azure-meddelandehubb med Hjälp av Azure CLI

Artikel
03/25/2023

Azure Notification Hubs innehåller en lättanvänd och uppskalad push-motor som gör det möjligt för dig att skicka meddelanden till valfri plattform (iOS, Android, Windows, Kindle, Baidu osv) från valfri serverdel (molnet eller lokalt). Mer information om tjänsten finns i Vad är Azure Notification Hubs?.

I den här snabbstarten skapar du en meddelandehubb med hjälp av Azure CLI. Det första avsnittet innehåller steg för att skapa ett Notification Hubs-namnområde. Det andra avsnittet innehåller steg för att skapa en meddelandehubb i ett befintligt namnområde. Du lär dig också hur du skapar en anpassad åtkomstprincip.

Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Förutsättningar

Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas att göra det installerar du Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Viktigt

Notification Hubs kräver version 2.0.67 eller senare av Azure CLI. Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Skapa en resursgrupp

Azure Notification Hubs, precis som alla Azure-resurser, måste distribueras till en resursgrupp. Resursgrupper gör det enkelt att organisera och hantera relaterade Azure-resurser. Mer information om resursgrupper finns i Vad är Azure Resource Manager?

I den här snabbstarten skapar du en resursgrupp med namnet spnhubrg på platsen eastus med följande kommando az group create .

az group create --name spnhubrg --location eastus

Skapa ett Notification Hubs-namnområde

Skapa ett namnområde för meddelandehubbarna.

Ett namnområde innehåller en eller flera hubbar och namnet måste vara unikt för alla Azure-prenumerationer och vara minst sex tecken långt. Om du vill kontrollera tillgängligheten för ett namn använder du kommandot az notification-hub namespace check-availability .
```
az notification-hub namespace check-availability --name spnhubns
```
Azure CLI svarar på din begäran om tillgänglighet genom att visa följande konsolutdata:
```
{
"id": "/subscriptions/yourSubscriptionID/providers/Microsoft.NotificationHubs/checkNamespaceAvailability",
"isAvailable": true,
"location": null,
"name": "spnhubns",
"properties": false,
"sku": null,
"tags": null,
"type": "Microsoft.NotificationHubs/namespaces/checkNamespaceAvailability"
}
```
Observera den andra raden i Azure CLI-svaret, "isAvailable": true. Den här raden läser false om önskat namn som du angav för namnområdet inte är tillgängligt. När du har bekräftat namnets tillgänglighet kör du kommandot az notification-hub namespace create för att skapa namnområdet.
```
az notification-hub namespace create --resource-group spnhubrg --name spnhubns  --location eastus --sku Free
```
Om du --name angav för az notification-hub namespace create kommandot inte är tillgängligt eller inte uppfyller namngivningsregler och begränsningar för Azure-resurser svarar Azure CLI med följande konsolutdata:
```
#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.
```
Om det förnamn du provade inte lyckas väljer du ett annat namn för det nya namnområdet och kör az notification-hub namespace create kommandot igen.

Anteckning

Från det här steget måste du ersätta värdet för parametern --namespace i varje Azure CLI-kommando som du kopierar från den här snabbstarten.
Hämta en lista över namnområden.

Om du vill se information om ditt nya namnområde använder du kommandot az notification-hub namespace list . Parametern --resource-group är valfri om du vill se alla namnrymder för en prenumeration.
```
az notification-hub namespace list --resource-group spnhubrg
```

Skapa meddelandehubbar

Skapa din första meddelandehubb.

En eller flera meddelandehubbar kan nu skapas i det nya namnområdet. Kör kommandot az notification-hub create för att skapa en meddelandehubb.
```
az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name spfcmtutorial1nhub --location eastus
```
Skapa en andra meddelandehubb.

Flera meddelandehubbar kan skapas i ett enda namnområde. Om du vill skapa en andra meddelandehubb i samma namnområde kör az notification-hub create du kommandot igen med ett annat hubbnamn.
```
az notification-hub create --resource-group spnhubrg --namespace-name spnhubns --name mysecondnhub --location eastus 
```
Hämta en lista över meddelandehubbar.

Azure CLI returnerar antingen ett lyckat eller felmeddelande med varje körningskommando. Att kunna fråga efter en lista över meddelandehubbar är dock betryggande. Kommandot az notification-hub list har utformats för detta ändamål.
```
az notification-hub list --resource-group spnhubrg --namespace-name spnhubns --output table
```

Arbeta med åtkomstprinciper

Azure Notification Hubs använder signatursäkerhet för delad åtkomst med hjälp av åtkomstprinciper. Två principer skapas automatiskt när du skapar en meddelandehubb. Anslutningssträngarna från dessa principer behövs för att konfigurera push-meddelanden. Kommandot az notification-hub authorization-rule list innehåller en lista över principnamn och deras respektive resursgrupper.
```
az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
```
Viktigt

Använd inte principen DefaultFullSharedAccessSignature i ditt program. Den här principen är avsedd att användas endast i serverdelen. Använd endast Listen åtkomstprinciper i klientprogrammet.
Om du vill skapa ytterligare auktoriseringsregler med meningsfulla namn kan du skapa och anpassa din egen åtkomstprincip med hjälp av kommandot az notification-hub authorization-rule create . Parametern --rights är en utrymmesavgränsad lista över de behörigheter som du vill tilldela.
```
az notification-hub authorization-rule create --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name spnhub1key --rights Listen Manage Send
```
Det finns två uppsättningar nycklar och anslutningssträngar för varje åtkomstprincip. Du behöver dem senare för att konfigurera en meddelandehubb. Om du vill visa en lista över nycklar och anslutningssträngar för en Notification Hubs-åtkomstprincip använder du kommandot 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
```
Anteckning

Ett Notification Hubs-namnområde och en meddelandehubb har separata åtkomstprinciper. Kontrollera att du använder rätt Azure CLI-referens när du frågar efter nycklar och anslutningssträngar.

Rensa resurser

När det inte längre behövs använder du kommandot az group delete för att ta bort resursgruppen och alla relaterade resurser:

az group delete --name spnhubrg

Nästa steg

I den här snabbstarten har du skapat en meddelandehubb. Information om hur du konfigurerar hubben med PNS-inställningar (Platform Notification System) finns i Konfigurera push-meddelanden i en meddelandehubb
Upptäck de omfattande funktionerna för att hantera meddelandehubbar med Azure CLI:

Fullständig referenslista för Notification Hubs

Referenslista för Notification Hubs-namnområde

Referenslista för notification hubs-auktoriseringsregel

Referenslista för Notification Hubs-autentiseringsuppgifter

Dela via