Share via

Hızlı Başlangıç: Azure CLI kullanarak Azure bildirim hub'ı oluşturma

  • Makale

Azure Notification Hubs, herhangi bir arka uçtan (bulut ya da şirket içi) herhangi bir platforma (iOS, Android, Windows, Kindle, Baidu vb.) bildirim göndermenize olanak tanıyan, kullanımı kolay ve ölçeği artırılmış bir gönderme altyapısı sağlar. Hizmet hakkında daha fazla bilgi için bkz. Azure Notification Hubs nedir?.

Bu hızlı başlangıçta Azure CLI kullanarak bir bildirim hub'ı oluşturacaksınız. İlk bölümde Notification Hubs ad alanı oluşturma adımları gösterilir. İkinci bölüm, mevcut ad alanında bildirim hub'ı oluşturma adımlarını sunar. Ayrıca özel erişim ilkesi oluşturmayı da öğrenirsiniz.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

Önemli

Notification Hubs, Azure CLI'nın 2.0.67 veya sonraki bir sürümünü gerektirir. Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Kaynak grubu oluşturma

Tüm Azure kaynakları gibi Azure Notification Hubs da bir kaynak grubuna dağıtılmalıdır. Kaynak grupları, ilgili Azure kaynaklarını düzenlemenizi ve yönetmenizi sağlar. Kaynak grupları hakkında daha fazla bilgi edinmek için bkz. Azure Resource Manager nedir?

Bu hızlı başlangıç için eastus konumunda aşağıdaki az group create komutuyla spnhubrg adlı bir kaynak grubu oluşturun.

az group create --name spnhubrg --location eastus

Notification Hubs ad alanı oluşturma

  1. Bildirim hub'larınız için bir ad alanı oluşturun.

    Ad alanı bir veya daha fazla hub içerir ve adın tüm Azure aboneliklerinde benzersiz olması ve en az altı karakter uzunluğunda olması gerekir. Bir adın kullanılabilirliğini denetlemek için az notification-hub namespace check-availability komutunu kullanın.

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

    Azure CLI, aşağıdaki konsol çıkışını görüntüleyerek kullanılabilirlik isteğinize yanıt verir:

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

    Azure CLI yanıtında "isAvailable": trueikinci satır olan öğesine dikkat edin. Ad alanı için belirttiğiniz istenen ad kullanılamıyorsa bu satır okunur false . Adın kullanılabilirliğini onayladıktan sonra ad alanınızı oluşturmak için az notification-hub namespace create komutunu çalıştırın.

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

    --name Komuta sağladığınız az notification-hub namespace create komut kullanılamıyorsa veya Azure kaynakları için Adlandırma kurallarını ve kısıtlamalarını karşılamıyorsa, Azure CLI aşağıdaki konsol çıkışıyla yanıt verir:

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

    Denediğiniz ad başarılı olmazsa, yeni ad alanınız için farklı bir ad seçin ve komutu yeniden çalıştırın az notification-hub namespace create .

    Not

    Bu adımdan itibaren, bu hızlı başlangıçtan --namespace kopyaladığınız her Azure CLI komutundaki parametrenin değerini değiştirmeniz gerekir.

  2. Ad alanlarının listesini alın.

    Yeni ad alanınızla ilgili ayrıntıları görmek için az notification-hub ad alanı listesi komutunu kullanın. Bir aboneliğin --resource-group tüm ad alanlarını görmek istiyorsanız parametresi isteğe bağlıdır.

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

Bildirim hub'ları oluşturma

  1. İlk bildirim hub'ınızı oluşturun.

    Artık yeni ad alanınızda bir veya daha fazla bildirim hub'ı oluşturulabilir. Bildirim hub'ı oluşturmak için az notification-hub create komutunu çalıştırın.

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

  2. İkinci bir bildirim hub'ı oluşturun.

    Tek bir ad alanında birden çok bildirim hub'ı oluşturulabilir. Aynı ad alanında ikinci bir bildirim hub'ı oluşturmak için komutunu farklı bir hub adı kullanarak yeniden çalıştırın az notification-hub create .

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

  3. Bildirim hub'larının listesini alın.

    Azure CLI, yürütülen her komutla bir başarı veya hata iletisi döndürür; ancak bildirim hub'larının listesini sorgulamak güven vericidir. az notification-hub list komutu bu amaçla tasarlanmıştır.

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

Erişim ilkeleriyle çalışma

  1. Azure Notification Hubs , erişim ilkelerini kullanarak paylaşılan erişim imzası güvenliğini kullanır. Bildirim hub'ı oluşturduğunuzda otomatik olarak iki ilke oluşturulur. Anında iletme bildirimlerini yapılandırmak için bu ilkelerden gelen bağlantı dizeleri gereklidir. az notification-hub authorization-rule list komutu, ilke adlarının ve ilgili kaynak gruplarının listesini sağlar.

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

    Önemli

    Uygulamanızda DefaultFullSharedAccessSignature ilkesini kullanmayın. Bu ilkenin yalnızca arka uçta kullanılması amaçlanır. İstemci uygulamanızda yalnızca Listen erişim ilkelerini kullanın.

  2. Anlamlı adlarla ek yetkilendirme kuralları oluşturmak istiyorsanız , az notification-hub authorization-rule create komutunu kullanarak kendi erişim ilkenizi oluşturabilir ve özelleştirebilirsiniz. --rights parametresi, atamak istediğiniz izinlerin boşlukla ayrılmış bir listesidir.

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

  3. Her erişim ilkesi için iki anahtar ve bağlantı dizesi kümesi vardır. Daha sonra bir bildirim hub'ı yapılandırmak için bunlara ihtiyacınız olacak. Notification Hubs erişim ilkesinin anahtarlarını ve bağlantı dizelerini listelemek için az notification-hub authorization-rule list-keys komutunu kullanın.

    # 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

    Not

    Notification Hubs ad alanı ve bildirim hub'ı ayrı erişim ilkelerine sahiptir. Anahtarları ve bağlantı dizelerini sorgularken doğru Azure CLI başvurusunu kullandığınızdan emin olun.

Kaynakları temizleme

Artık gerekli olmadığında az group delete komutunu kullanarak kaynak grubunu ve tüm ilgili kaynakları kaldırın:

az group delete --name spnhubrg

Sonraki adımlar