Web kancalarını inceleme

  • 4 dakika

Runbook'u zamanlayarak veya web kancası kullanarak başlatmayı otomatikleştirebilirsiniz.

Web kancası, tek bir HTTPS isteği aracılığıyla belirli bir runbook'u Azure Otomasyonu başlatmanıza olanak tanır.

Azure DevOps, GitHub veya özel uygulamalar gibi dış hizmetlerin Azure Otomasyonu API'sini kullanarak daha karmaşık çözümler uygulamadan runbook'ları başlatmasına olanak tanır.

Web kancaları hakkında daha fazla bilgi için bkz. Web kancası ile Azure Otomasyonu runbook başlatma.

Diagram of flowchart webhook process. The Webhook and Runbook are within a square labeled Automation.

Web kancası oluşturma

Aşağıdaki adımları kullanarak runbook'a bağlı bir web kancası oluşturursunuz:

  1. Azure portalında, web kancasını oluşturmak istediğiniz runbook'u açın.
  2. Runbook bölmesindeki Kaynaklar'ın altında Web Kancaları'nı ve ardından + Web kancası ekle'yi seçin.
  3. Yeni web kancası oluştur'u seçin.
  4. Yeni web kancası oluştur iletişim kutusunda, yapılandırmanız gereken birkaç değer vardır. Bunları yapılandırdıktan sonra Oluştur'u seçin:
    • Adı. Web kancası için istediğiniz herhangi bir adı belirtin çünkü ad istemciye sunulmaz. Yalnızca Azure Otomasyonu'nda sizin runbook'u belirleyebilmeniz için kullanılır.
    • Etkin. Web kancası oluşturulduğunda varsayılan olarak etkinleştirilir. Devre Dışı olarak ayarlarsanız, hiçbir istemci kullanamaz.
    • Süresi doluyor. Her web kancasının bir son kullanma tarihi vardır ve bu tarih artık kullanılamaz. Web kancasının süresi dolmamışsa, web kancasını oluşturduktan sonra tarihi değiştirmeye devam edebilirsiniz.
    • URL. Web kancası URL'si, istemcinin web kancasına bağlı runbook'u başlatmak için HTTP POST ile çağıran benzersiz adrestir. Web kancasını oluşturduğunuzda otomatik olarak oluşturulur ve özel bir URL belirtemezsiniz. URL, runbook'un başka kimlik doğrulaması olmadan üçüncü taraf bir sistem tarafından çağrılmasını sağlayan bir güvenlik belirteci içerir. Bu nedenle parola gibi davranın. URL'yi yalnızca web kancası oluşturulduğunda güvenlik nedeniyle Azure portalında görüntüleyebilirsiniz. Url'yi gelecekte kullanmak üzere güvenli bir konumda not edin.Diagram of the flow of webhook parameter values and how they flow. The webhook starts with an incoming HTTP POST request.

Dekont

Oluştururken web kancası URL'sini kopyalayıp güvenli bir yerde depoladığınızdan emin olun. Web kancasını oluşturduktan sonra URL'yi yeniden alamazsınız.

  1. Parametreler çalıştırma ayarları (Varsayılan: Azure) seçeneğini belirleyin. Bu seçenek, aşağıdaki eylemleri tamamlamanızı sağlayan aşağıdaki özelliklere sahiptir:

    • Runbook'un zorunlu parametreleri varsa oluşturma sırasında bu gerekli parametreleri sağlamanız gerekir. Değerler sağlanmadığı sürece web kancasını oluşturamazsınız.
    • Runbook'ta zorunlu parametre yoksa, burada yapılandırma gerekmez.
    • Web kancası runbook'un zorunlu parametreleri için değerler içermeli ve isteğe bağlı parametreler için değerler içermelidir.
    • bir istemci web kancası kullanarak bir runbook başlattığında, tanımlanan parametre değerlerini geçersiz kılamaz.
    • runbook, istemciden veri almak için, istemcinin POST isteğine dahil olduğu verileri içeren türde $WebhookData [object] adlı tek bir parametreyi kabul edebilir.
    • $WebhookData parametresini desteklemek için gerekli web kancası yapılandırması yoktur.Screenshot of a warning explaining that after creating a webhook, its URL cannot be viewed. Copy it before pressing OK.

  2. Bittiğinde Oluştur’u seçin.

Web kancası kullanma

Oluşturulduktan sonra bir web kancası kullanmak için istemci uygulamanızın web kancasının URL'sini içeren bir HTTP POST vermesi gerekir.

  • Web kancasının söz dizimi aşağıdaki biçimdedir:

      http://< Webhook Server >/token?=< Token Value >

  • İstemci POST isteğinden aşağıdaki dönüş kodlarından birini alır.

    Kod   Test Açıklama
    202 Kabul edildi İstek kabul edildi ve runbook başarıyla kuyruğa alındı.
    400 Hatalı istek Runbook'un süresi dolduğu, devre dışı bırakıldığı veya URL'deki belirtecin geçersiz olduğu için istek kabul olmadı.
    404 Bulunamadı Web kancası, runbook veya hesap bulunamadığından istek kabul olmadı.
    500 İç Sunucu Hatası

  • Başarılı olursa, web kancası yanıtı iş kimliğini aşağıdaki gibi JSON biçiminde içerir:

    {"JobIds":["< JobId >"]}

    Yanıt tek bir iş kimliği içerir, ancak JSON biçimi gelecekteki olası geliştirmelere olanak tanır.

  • Runbook işinin ne zaman tamamleneceğini veya web kancasından tamamlanma durumunu belirleyemezsiniz. Bu bilgileri yalnızca powershell veya Azure Otomasyonu API'si gibi başka bir yöntemle iş kimliğini kullanarak seçebilirsiniz.

Web kancası ile Azure Otomasyonu runbook başlatma sayfasında daha fazla ayrıntı bulabilirsiniz.