Hızlı başlangıç: Blob Depolama olaylarını Azure portal web uç noktasına yönlendirmeQuickstart: Route Blob storage events to web endpoint with the Azure portal

Azure Event Grid, bulut için bir olay oluşturma hizmetidir.Azure Event Grid is an eventing service for the cloud. Bu makalede Azure portalını kullanarak bir Blob depolama hesabı oluşturur, bu blob depolama hesabının olaylarına abone olur ve sonucu görmek için bir olayı tetiklersiniz.In this article, you use the Azure portal to create a Blob storage account, subscribe to events for that blob storage, and trigger an event to view the result. Normalde olayları, olay verilerini işleyen ve eylemler gerçekleştiren bir uç noktaya gönderirsiniz.Typically, you send events to an endpoint that processes the event data and takes actions. Bununla birlikte, bu makaleyi basitleştirmek için olayları iletilerin toplandığı ve görüntülendiği bir web uygulamasına gönderirsiniz.However, to simplify this article, you send the events to a web app that collects and displays the messages.

Azure aboneliğinizyoksa başlamadan önce ücretsiz bir hesap oluşturun.If you don't have an Azure subscription, create a free account before you begin.

İşiniz bittiğinde, olay verilerinin web uygulamasına gönderildiğini görürsünüz.When you're finished, you see that the event data has been sent to the web app.

Sonuçları görüntüleme

Depolama hesabı oluşturmaCreate a storage account

  1. Azure portalda oturum açın.Sign in to Azure portal.

  2. Bir Blob depolaması oluşturmak için Kaynak oluşturun'u seçin.To create a Blob storage, select Create a resource.

    Kaynak oluşturma

  3. Kullanılabilir seçenekleri filtrelemek için Depolama'yı seçip Depolama hesabı - blob, dosya, tablo, kuyruk öğesini seçin.Select for Storage to filter the available options, and select Storage account - blob, file, table, queue.

    Depolama’yı seçme

  4. Olaylara abone olmak için, genel amaçlı v2 depolama hesabı veya bir Blob depolama hesabı oluşturun.To subscribe to events, create either a general-purpose v2 storage account or a Blob storage account. Daha fazla bilgi için bkz. Depolama hesabı oluşturma.For more information, see Create a storage account.

    Başlangıç adımları

İleti uç noktası oluşturmaCreate a message endpoint

Blob depolamasındaki olaylara abone olmadan önce olay iletisi için uç noktayı oluşturalım.Before subscribing to the events for the Blob storage, let's create the endpoint for the event message. Normalde, olay verileri temelinde uç nokta eylemleri gerçekleştirir.Typically, the endpoint takes actions based on the event data. Bu hızlı başlangıcı basitleştirmek için, olay iletilerini görüntüleyin bir önceden oluşturulmuş web uygulaması dağıtırsınız.To simplify this quickstart, you deploy a pre-built web app that displays the event messages. Dağıtılan çözüm bir App Service planı, App Service web uygulaması ve GitHub'dan kaynak kod içerir.The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.

  1. Çözümü aboneliğinize dağıtmak için Azure'a Dağıt'ı seçin.Select Deploy to Azure to deploy the solution to your subscription. Azure portalında parametre değerlerini girin.In the Azure portal, provide values for the parameters.

  2. Dağıtımın tamamlanması birkaç dakika sürebilir.The deployment may take a few minutes to complete. Dağıtım başarıyla gerçekleştirildikten sonra, web uygulamanızı görüntüleyip çalıştığından emin olun.After the deployment has succeeded, view your web app to make sure it's running. Web tarayıcısında şu adrese gidin: https://<your-site-name>.azurewebsites.netIn a web browser, navigate to: https://<your-site-name>.azurewebsites.net

  3. Siteyi görürsünüz ancak henüz yayımlanmış olay yoktur.You see the site but no events have been posted to it yet.

    Yeni siteyi görüntüleme

Event Grid kaynak sağlayıcısını etkinleştirmeEnable Event Grid resource provider

Azure aboneliğinizde daha önce Event Grid kullanmadıysanız Event Grid kaynak sağlayıcısına kaydolmanız gerekebilir.If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider.

Azure portalında:In the Azure portal:

  1. Abonelikler'i seçin.Select Subscriptions.
  2. Event Grid için kullandığınız aboneliği seçin.Select the subscription you're using for Event Grid.
  3. Ayarlar'ın altında Kaynak sağlayıcıları'nı seçin.Under Settings, select Resource providers.
  4. Microsoft.EventGrid öğesini bulun.Find Microsoft.EventGrid.
  5. Kayıtlı değilse Kaydol'u seçin.If not registered, select Register.

Kayıt işleminin tamamlanması biraz sürebilir.It may take a moment for the registration to finish. Durumu güncelleştirmek için Yenile’yi seçin.Select Refresh to update the status. Durum Kayıtlı olduğunda, devam etmeye hazırsınız demektir.When Status is Registered, you're ready to continue.

Blob depolamaya abone olmaSubscribe to the Blob storage

Event Grid’e hangi olayları izlemek istediğinizi ve olayların nereye gönderileceğini bildirmek için bir konuya abone olursunuz.You subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.

  1. Portalda blob depolamanızı ve ardından Olaylar'ı seçin.In the portal, select your blob storage and select Events.

    Olaylar'ı seçin

  2. Olayları görüntüleyici uygulamanıza göndermek için uç noktada bir web kancası kullanın.To send events to your viewer app, use a web hook for the endpoint. Diğer Seçenekler'i ve Web Kancası'nı seçin.Select More Options, and Web Hook.

    Web kancasını seçme

  3. Olay aboneliği, Blob depolamanızın değerleriyle doldurulmuş şekilde görünür.The event subscription is prefilled with values for your Blob storage. Web kancası uç noktası için web uygulamanızın URL'sini girin ve ana sayfa URL'sine api/updates ekleyin.For the web hook endpoint, provide the URL of your web app and add api/updates to the home page URL. Aboneliğinize bir ad verin.Give your subscription a name. İşiniz bittiğinde Oluştur’u seçin.When done, select Create.

    Günlükleri seçme

  4. Web uygulamanızı yeniden görüntüleyin ve buna bir abonelik doğrulama olayının gönderildiğine dikkat edin.View your web app again, and notice that a subscription validation event has been sent to it. Göz simgesini seçerek olay verilerini genişletin.Select the eye icon to expand the event data. Uç noktanın olay verilerini almak istediğini doğrulayabilmesi için Event Grid doğrulama olayını gönderir.Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. Web uygulaması aboneliği doğrulamak için kod içerir.The web app includes code to validate the subscription.

    Abonelik olayını görüntüleme

Şimdi, Event Grid’in iletiyi uç noktanıza nasıl dağıttığını görmek için bir olay tetikleyelim.Now, let's trigger an event to see how Event Grid distributes the message to your endpoint.

Uç noktanıza olay göndermeSend an event to your endpoint

Dosya yükleyerek Blob depolaması için bir olay tetiklemiş olursunuz.You trigger an event for the Blob storage by uploading a file. Dosyanın belirli bir içeriğe sahip olmasına gerek yoktur.The file doesn't need any specific content. Bu makalede testfile.txt adlı bir dosyaya sahip olduğunuz kabul edilmektedir ancak herhangi bir dosyayı kullanabilirsiniz.The articles assumes you have a file named testfile.txt, but you can use any file.

  1. Blob depolamanız için Bloblar'ı seçin.For your Blob storage, select Blobs.

    Bloblar'ı seçin

  2. + Kapsayıcı'yı seçin.Select + Container. Kapsayıcınıza bir ad verin ve herhangi bir erişim düzeyini kullanın.Give you container a name, and use any access level.

    Kapsayıcı ekleme

  3. Yeni kapsayıcınızı seçin.Select your new container.

    Kapsayıcı seçme

  4. Dosya yüklemek için Yükle'yi seçin.To upload a file, select Upload.

    Karşıya yükleme seçme

  5. Test dosyanıza göz atın ve yükleyin.Browse to your test file and upload it.

  6. Olayı tetiklediniz ve Event Grid, iletiyi abone olurken yapılandırdığınız uç noktaya gönderdi.You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. İleti JSON biçimindedir ve bir veya daha fazla olaya sahip bir dizi içerir.The message is in the JSON format and it contains an array with one or more events. Aşağıdaki örnekte, JSON iletisi bir olay içeren bir dizi içerir.In the following example, the JSON message contains an array with one event. Web uygulamanızı görüntülediğinizde blob oluşturma olayının gönderildiğini göreceksiniz.View your web app and notice that a blob created event was received.

    [{
     "topic": "/subscriptions/{subscription-id}/resourceGroups/eventgroup/providers/Microsoft.Storage/storageAccounts/demoblob0625",
     "subject": "/blobServices/default/containers/eventcontainer/blobs/testfile.txt",
     "eventType": "Microsoft.Storage.BlobCreated",
     "eventTime": "2018-06-25T22:50:41.1823131Z",
     "id": "89a2f9da-c01e-00bb-13d6-0c599506e4e3",
     "data": {
       "api": "PutBlockList",
       "clientRequestId": "41341a9b-e977-4a91-9000-c64125039047",
       "requestId": "89a2f9da-c01e-00bb-13d6-0c5995000000",
       "eTag": "0x8D5DAEE13C8F9ED",
       "contentType": "text/plain",
       "contentLength": 4,
       "blobType": "BlockBlob",
       "url": "https://demoblob0625.blob.core.windows.net/eventcontainer/testfile.txt",
       "sequencer": "00000000000000000000000000001C24000000000004712b",
       "storageDiagnostics": {
         "batchId": "ef633252-32fd-464b-8f5a-0d10d68885e6"
       }
     },
     "dataVersion": "",
     "metadataVersion": "1"
    }]
    

Kaynakları temizlemeClean up resources

Bu olayla çalışmaya devam etmeyi planlıyorsanız bu makalede oluşturulan kaynakları temizlemeyin.If you plan to continue working with this event, don't clean up the resources created in this article. Aksi takdirde, bu makalede oluşturduğunuz kaynakları silin.Otherwise, delete the resources you created in this article.

Kaynak grubunu seçin ve Kaynak grubunu sil seçeneğini belirleyin.Select the resource group, and select Delete resource group.

Sonraki adımlarNext steps

Özel konu ve olay abonelikleri oluşturma işlemini öğrendiğinize göre artık Event Grid’in size nasıl yardımcı olabileceği konusunda daha fazla bilgi edinebilirsiniz:Now that you know how to create custom topics and event subscriptions, learn more about what Event Grid can help you do: