Sdílet prostřednictvím

Příjemci volaných služeb

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

K programovému vytvoření předplatného použijte uživatele hooku služby. Odběr určuje událost, příjemce a akci.

Vyberte příjemce, kterého chcete použít ve svém předplatném, od následujících příjemců. Další informace o dostupných službách naleznete v tématu Integrace s hooky služeb, Dostupné služby.

Azure Service Bus

Poskytuje integraci se službou Microsoft Azure Service Bus, včetně Notification Hubs.

Odeslání zprávy do centra oznámení

Tato akce odešle obecné oznámení šablony do zadaného centra oznámení Azure. Další informace najdete v přehledu.

  • ID příjemce: azureServiceBus
  • ID akce: serviceBusNotificationHubSend
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • connectionString
      • připojovací řetězec SAS
      • SAS (sdílený přístupový podpis) připojovací řetězec použít pro připojení ke službě Azure Service Bus. Tento připojovací řetězec je k dispozici na webu Azure Portal.
      • Datový typ: řetězec
      • Povinné: Ano
    • notificationHubName
      • Název centra oznámení
      • Název centra oznámení, do které chcete oznámení odeslat. Název může obsahovat pouze písmena, číslice, tečky, pomlčky, lomítka a podtržítka. Název musí začínat a končit písmenem nebo číslem. Centrum by již mělo existovat.
      • Datový typ: řetězec
      • Povinné: Ano
    • tagsExpression
      • Značky
      • Výraz značek (pro cílení na konkrétní sady zařízení). Další informace.
      • Datový typ: řetězec
      • Povinné: Ne

Odeslání zprávy do fronty služby Service Bus

Tato akce odešle řetězcovou reprezentaci události JSON do zadané fronty služby Azure Service Bus. Další informace najdete v tématu Fronty, články a předplatná služby Service Bus.

  • ID příjemce: azureServiceBus
  • ID akce: serviceBusQueueSend
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • connectionString
      • připojovací řetězec SAS
      • SAS (sdílený přístupový podpis) připojovací řetězec použít pro připojení ke službě Azure Service Bus. Tento připojovací řetězec je k dispozici na webu Azure Portal.
      • Datový typ: řetězec
      • Povinné: Ano
    • queueName
      • Název fronty
      • Název fronty pro odeslání zprávy. Název může obsahovat pouze písmena, číslice, tečky, pomlčky, lomítka a podtržítka. Název musí začínat a končit písmenem nebo číslem. Pokud fronta neexistuje, vytvoří se, pokud zadaná připojovací řetězec má potřebná oprávnění.
      • Datový typ: řetězec
      • Povinné: Ano
    • resourceDetailsToSend
      • Podrobnosti o zdroji k odeslání
      • Řízení polí zdrojů k odeslání
      • Datový typ: řetězec
      • Povinné: Ne
    • messagesToSend
      • Zprávy k odeslání
      • Řízení zpráv, které se mají odeslat
      • Datový typ: řetězec
      • Povinné: Ne
    • detailedMessagesToSend
      • Podrobné zprávy k odeslání
      • Řízení podrobných zpráv k odeslání
      • Datový typ: řetězec
      • Povinné: Ne

Odeslání zprávy do tématu služby Service Bus

Tato akce odešle řetězcovou reprezentaci události JSON do zadaného tématu služby Azure Service Bus. Další informace najdete v tématu Vytvoření tématu a odběrů služby Service Bus pomocí webu Azure Portal.

  • ID příjemce: azureServiceBus
  • ID akce: serviceBusTopicSend
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • connectionString
      • připojovací řetězec SAS
      • SAS (sdílený přístupový podpis) připojovací řetězec použít pro připojení ke službě Azure Service Bus. Tento připojovací řetězec je k dispozici na webu Azure Portal.
      • Datový typ: řetězec
      • Povinné: Ano
    • topicName
      • Název tématu
      • Název tématu, do které chcete zprávu odeslat. Název může obsahovat pouze písmena, číslice, tečky, pomlčky, lomítka a podtržítka. Název musí začínat a končit písmenem nebo číslem. Pokud toto téma neexistuje, vytvoří se, pokud zadaný připojovací řetězec má potřebná oprávnění.
      • Datový typ: řetězec
      • Povinné: Ano
    • resourceDetailsToSend
      • Podrobnosti o zdroji k odeslání
      • Řízení polí zdrojů k odeslání
      • Datový typ: řetězec
      • Povinné: Ne
    • messagesToSend
      • Zprávy k odeslání
      • Řízení zpráv, které se mají odeslat
      • Datový typ: řetězec
      • Povinné: Ne
    • detailedMessagesToSend
      • Podrobné zprávy k odeslání
      • Řízení podrobných zpráv k odeslání
      • Datový typ: řetězec
      • Povinné: Ne

Azure Storage

Poskytuje integraci se službou Microsoft Azure Storage.

Vložení zprávy do fronty úložiště

Tato akce vloží řetězcovou reprezentaci události JSON do zadané fronty úložiště Azure. Další informace najdete v tématu Co jsou fronty Azure?

  • ID příjemce: azureStorageQueue
  • ID akce: enqueue
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • accountName
      • Název účtu úložiště
      • Název přidružený k vašemu účtu úložiště Azure (například https://STORAGE_ACCOUNT_NAME.queue.core.windows.net).
      • Datový typ: řetězec
      • Povinné: Ano
    • accountKey
      • Klíč účtu úložiště
      • Klíč přidružený k vašemu účtu úložiště Azure.
      • Datový typ: řetězec
      • Povinné: Ano
    • queueName
      • Název fronty
      • Název fronty pouze malými písmeny, který se má použít v rámci úložiště Azure. Fronta podle tohoto názvu se vytvoří, pokud ještě neexistuje.
      • Datový typ: řetězec
      • Povinné: Ano
    • visiTimeout
      • Časový limit viditelnosti zpráv (v sekundách)
      • Určuje hodnotu časového limitu viditelnosti (v sekundách) pro zprávu ve frontě vzhledem k času serveru. Hodnota musí být větší nebo rovna 0 a nesmí být větší než sedm dní nebo 604 800 sekund. Časový limit viditelnosti musí být nastaven na hodnotu menší než hodnota časového limitu zprávy.
      • Datový typ: číslo
      • Povinné: Ano
    • hodnota ttl
      • Doba přenosu zpráv (v sekundách)
      • Určuje interval mezi časem pro zprávu fronty v sekundách. Maximální povolený časový limit je sedm dní nebo 604 800 sekund.
      • Datový typ: číslo
      • Povinné: Ano
    • resourceDetailsToSend
      • Podrobnosti o zdroji k odeslání
      • Řízení polí zdrojů k odeslání
      • Datový typ: řetězec
      • Povinné: Ne
    • messagesToSend
      • Zprávy k odeslání
      • Řízení zpráv, které se mají odeslat
      • Datový typ: řetězec
      • Povinné: Ne
    • detailedMessagesToSend
      • Podrobné zprávy k odeslání
      • Řízení podrobných zpráv k odeslání
      • Datový typ: řetězec
      • Povinné: Ne

Jenkins

Jenkins je server kontinuální integrace, který umožňuje nepřetržitě vytvářet a testovat softwarové projekty.

Aktivace sestavení Git

Aktivuje sestavení nakonfigurované pro použití úložiště Git pomocí modulu plug-in Jenkins Git.

  • ID příjemce: jenkins
  • ID akce: triggerGitBuild
  • Podporované události: git.push
  • Nastavení:
    • serverBaseUrl
      • Základní adresa URL Jenkinse
      • Základní adresa URL, která je hostitelem serveru Jenkins
      • Datový typ: identifikátor URI
      • Povinné: Ano
    • uživatelské jméno
      • Jméno uživatele
      • Uživatelské jméno Jenkinse uživatele, který může aktivovat sestavení
      • Datový typ: řetězec
      • Povinné: Ano
    • heslo
      • Token uživatelského rozhraní API (nebo heslo)
      • Token rozhraní API uživatele, který je k dispozici na stránce konfigurace uživatele Jenkins. Token rozhraní API je nový od verze 1.426. V dřívějších verzích Jenkinse je nutné zadat skutečné uživatelské heslo.
      • Datový typ: řetězec
      • Povinné: Ano

Aktivace obecného sestavení

Aktivuje obecné sestavení Jenkinse, které vyvolá adresu URL sestavení Jenkinse.

  • ID příjemce: jenkins
  • ID akce: triggerGenericBuild
  • Podporované události: git.push, build.complete, tfvc.checkin
  • Nastavení:
    • serverBaseUrl
      • Základní adresa URL Jenkinse
      • Základní adresa URL, která je hostitelem serveru Jenkins
      • Datový typ: identifikátor URI
      • Povinné: Ano
    • uživatelské jméno
      • Jméno uživatele
      • Uživatelské jméno Jenkinse uživatele, který může aktivovat sestavení
      • Datový typ: řetězec
      • Povinné: Ano
    • heslo
      • Token uživatelského rozhraní API (nebo heslo)
      • Token rozhraní API uživatele, který je k dispozici na stránce konfigurace uživatele Jenkins. Token rozhraní API je nový od verze 1.426. V dřívějších verzích Jenkinse je nutné zadat skutečné uživatelské heslo.
      • Datový typ: řetězec
      • Povinné: Ano
    • buildName
      • Sestavení
      • Název sestavení, který se má aktivovat
      • Datový typ: řetězec
      • Povinné: Ano
    • buildAuthToken
      • Token sestavení
      • Autorizační token ve formě řetězce tak, aby sestavení tohoto projektu mohli vzdáleně aktivovat jenom uživatelé, kteří ho znají.
      • Datový typ: řetězec
      • Povinné: Ne
    • buildParameterized
      • Přijímá parametry
      • Označuje, jestli je sestavení parametrizované nebo ne (parametry sestavení jsou volitelně zadány dříve).
      • Datový typ: logická hodnota
      • Povinné: Ne
    • buildParams
      • Parametry sestavení
      • Sestavení názvů parametrů a hodnot oddělených dvojtečkami (například "param1:value1") s každou dvojicí název-hodnota, která se zobrazí na vlastním řádku textu
      • Datový typ: řetězec
      • Povinné: Ne

Trello

Poskytuje integraci s Trello.

Vytvoření karty

Tato akce vytvoří kartu na existujícím seznamu v Trello. Karta může představovat úkol, problém, událost nebo něco jiného. Stav karty se obvykle určuje podle toho, na jakém seznamu se nachází. Další informace najdete v tématu Vytvoření háku služby pomocí Trello.

  • ID příjemce: trello
  • ID akce: createCard
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • userToken
      • Token uživatele (Potřebujete ho? Získat.)
      • Váš uživatelský token poskytl Trello. Pokud chcete zjistit, jak tento token získat, vyberte odkaz v dříve popsaném popisu akce.
      • Datový typ: řetězec
      • Povinné: Ano
    • boardId
      • Prkno
      • Název desky, na které se vytvoří karta Trello.
      • Datový typ: řetězec
      • Povinné: Ano
    • listId
      • List
      • Název seznamu, na kterém se vytvoří karta Trello.
      • Datový typ: řetězec
      • Povinné: Ano
    • popisky
      • Popisky
      • Seznam barev štítků oddělený čárkami, které se mají použít na vytvořenou kartu. Platné názvy barev popisků jsou červené, oranžové, žluté, zelené, modré a fialové.
      • Datový typ: řetězec
      • Povinné: Ne
    • addToTop
      • Vytvoření na začátku seznamu
      • Označuje, zda má být karta vytvořena na začátku seznamu Trello namísto konce.
      • Datový typ: logická hodnota
      • Povinné: Ne

Vytvořit seznam

Tato akce vytvoří seznam na existující desce v Trello. Seznam slouží k uspořádání karet na panelu a obvykle představuje stav. Další informace najdete v tématu Vytvoření háku služby pomocí Trello.

  • ID příjemce: trello
  • ID akce: createList
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • userToken
      • Token uživatele (potřebujete ho? Získat.)
      • Váš uživatelský token poskytl Trello. Pokud chcete zjistit, jak tento token získat, vyberte odkaz v dříve popsaném popisu akce.
      • Datový typ: řetězec
      • Povinné: Ano
    • boardId
      • Prkno
      • Název desky, na které se vytvoří seznam Trello.
      • Datový typ: řetězec
      • Povinné: Ano
    • addToBottom
      • Vytvoření v dolní části panelu
      • Označuje, jestli se má seznam vytvořit v dolní části panelu místo horní části panelu.
      • Datový typ: logická hodnota
      • Povinné: Ne

Webhooky

Webhooky poskytují komunikaci událostí prostřednictvím protokolu HTTP.

Publikování prostřednictvím protokolu HTTP

Tato akce publikuje reprezentaci objektu JSON události na zadanou adresu URL. Koncové body HTTPS se doporučují kvůli možnému využití privátních dat v datové části události. Další informace naleznete v tématu Webhooky.

  • ID příjemce: webHooky
  • ID akce: httpRequest
  • Podporované události: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
  • Nastavení:
    • adresa URL
      • Adresa URL
      • Adresa URL, na kterou se odešle HTTP POST.
      • Datový typ: identifikátor URI
      • Povinné: Ano
    • HttpHeaders
      • Záhlaví HTTP
      • Klíče hlaviček HTTP a hodnoty oddělené dvojtečkami (například Key1:value1) s každou dvojicí klíč-hodnota se zobrazí na vlastním řádku textu.
      • Datový typ: řetězec
      • Povinné: Ne
    • basicAuthUsername
      • Základní ověřovací uživatelské jméno
      • Zadejte uživatelské jméno pro standardní ověřování HTTP. Základní ověřování HTTP odesílá přihlašovací údaje ve formátu prostého textu (nešifrované), což znamená, že byste měli použít adresu URL začínající řetězcem https k povolení šifrování těchto přihlašovacích údajů prostřednictvím zabezpečené přenosové vrstvy (SSL).
      • Datový typ: řetězec
      • Povinné: Ne
    • basicAuthPassword
      • Základní ověřovací heslo
      • Zadejte heslo pro standardní ověřování HTTP. Základní ověřování HTTP odesílá přihlašovací údaje ve formátu prostého textu (nešifrované), což znamená, že byste k povolení šifrování těchto přihlašovacích údajů přes SSL měli použít adresu URL začínající řetězcem https.
      • Datový typ: řetězec
      • Povinné: Ne
    • resourceDetailsToSend
      • Podrobnosti o zdroji k odeslání
      • Řízení polí zdrojů k odeslání
      • Datový typ: řetězec
      • Povinné: Ne
    • messagesToSend
      • Zprávy k odeslání
      • Řízení zpráv, které se mají odeslat
      • Datový typ: řetězec
      • Povinné: Ne
    • detailedMessagesToSend
      • Podrobné zprávy k odeslání
      • Řízení podrobných zpráv k odeslání
      • Datový typ: řetězec
      • Povinné: Ne

Zendesk

Zendesk je sada SaaS, která nabízí lístky helpdesku, sledování problémů a zákaznickou podporu.

Vytvoření soukromého komentáře v lístku

Pomocí Zendesku můžete vytvořit soukromý komentář v lístku.

  • ID příjemce: zendesk
  • ID akce: createPrivateComment
  • Podporované události: workitem.commented
  • Nastavení:
    • accountName
      • Název účtu
      • Název účtu Zendesk, například https://{account name}.zendesk.com
      • Datový typ: řetězec
      • Povinné: Ano
    • uživatelské jméno
      • Jméno uživatele
      • Uživatelské jméno uživatele Zendesku, který aktualizuje lístky
      • Datový typ: řetězec
      • Povinné: Ano
    • apiToken
      • Token rozhraní API
      • Token rozhraní API Zendesk (najdete ho v aplikaci Zendesk v rozhraní API kanálů > pro správu>).
      • Datový typ: řetězec
      • Povinné: Ano