Szolgáltatáshook-fogyasztók
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Szolgáltatáshook-felhasználók használatával programozott módon hozhat létre előfizetést. Az előfizetés meghatározza az eseményt, a fogyasztót és a műveletet.
Válassza ki az előfizetésében használni kívánt fogyasztót a következő fogyasztók közül. Az elérhető szolgáltatásokról további információt az Integrálás a szolgáltatáshookokkal és az Elérhető szolgáltatásokkal című témakörben talál.
Azure Service Bus
Integrációt biztosít a Microsoft Azure Service Bus szolgáltatással, beleértve a Notification Hubs szolgáltatást is.
Üzenet küldése értesítési központba
Ez a művelet általános sablonértesítést küld a megadott Azure Notification Hubnak. További információkért tekintse meg az áttekintést.
- Fogyasztói azonosító: azureServiceBus
- Műveletazonosító: serviceBusNotificationHubSend
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- connectionString
- SAS-kapcsolati sztring
- Az SAS (közös hozzáférésű jogosultságkód) kapcsolati sztring az Azure Service Bushoz való csatlakozáshoz. Ez a kapcsolati sztring az Azure Portalon érhető el.
- Adattípus: sztring
- Kötelező: Igen
- notificationHubName
- Értesítési központ neve
- Annak az értesítési központnak a neve, amelybe el szeretné küldeni az értesítést. A név csak betűket, számokat, pontokat, kötőjeleket, perjeleket és aláhúzásjeleket tartalmazhat. A névnek betűvel vagy számmal kell kezdődnie és végződnie. A központnak már léteznie kell.
- Adattípus: sztring
- Kötelező: Igen
- tagsExpression
- Címkék
- A címkék kifejezése (adott eszközkészletek megcélzására). További információ.
- Adattípus: sztring
- Kötelező: Nem
- connectionString
Üzenet küldése Service Bus-üzenetsorba
Ez a művelet az esemény JSON-sztring-ábrázolását küldi el a megadott Azure Service Bus-üzenetsorba. További információ: Service Bus-üzenetsorok, cikkek és előfizetések.
- Fogyasztói azonosító: azureServiceBus
- Műveletazonosító: serviceBusQueueSend
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- connectionString
- SAS-kapcsolati sztring
- Az SAS (közös hozzáférésű jogosultságkód) kapcsolati sztring az Azure Service Bushoz való csatlakozáshoz. Ez a kapcsolati sztring az Azure Portalon érhető el.
- Adattípus: sztring
- Kötelező: Igen
- queueName
- Üzenetsor neve
- Annak az üzenetsornak a neve, amelybe az üzenetet el szeretné küldeni. A név csak betűket, számokat, pontokat, kötőjeleket, perjeleket és aláhúzásjeleket tartalmazhat. A névnek betűvel vagy számmal kell kezdődnie és végződnie. Ha az üzenetsor nem létezik, akkor akkor jön létre, ha a megadott kapcsolati sztring rendelkezik a szükséges engedélyekkel.
- Adattípus: sztring
- Kötelező: Igen
- resourceDetailsToSend
- Elküldendő erőforrás részletei
- A küldendő erőforrásmezők szabályozása
- Adattípus: sztring
- Kötelező: Nem
- messagesToSend
- Elküldendő üzenetek
- A küldendő üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- detailedMessagesToSend
- Részletes elküldendő üzenetek
- A küldendő részletes üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- connectionString
Üzenet küldése Service Bus-témakörnek
Ez a művelet az esemény JSON-sztring-ábrázolását küldi el a megadott Azure Service Bus-témakörnek. További információ: Service Bus-témakör és előfizetések létrehozása az Azure Portalon.
- Fogyasztói azonosító: azureServiceBus
- Műveletazonosító: serviceBusTopicSend
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- connectionString
- SAS-kapcsolati sztring
- Az SAS (közös hozzáférésű jogosultságkód) kapcsolati sztring az Azure Service Bushoz való csatlakozáshoz. Ez a kapcsolati sztring az Azure Portalon érhető el.
- Adattípus: sztring
- Kötelező: Igen
- topicName
- Témakör neve
- Annak a témakörnek a neve, amelybe el szeretné küldeni az üzenetet. A név csak betűket, számokat, pontokat, kötőjeleket, perjeleket és aláhúzásjeleket tartalmazhat. A névnek betűvel vagy számmal kell kezdődnie és végződnie. Ha a témakör nem létezik, akkor akkor jön létre, ha a megadott kapcsolati sztring rendelkezik a szükséges engedélyekkel.
- Adattípus: sztring
- Kötelező: Igen
- resourceDetailsToSend
- Elküldendő erőforrás részletei
- A küldendő erőforrásmezők szabályozása
- Adattípus: sztring
- Kötelező: Nem
- messagesToSend
- Elküldendő üzenetek
- A küldendő üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- detailedMessagesToSend
- Részletes elküldendő üzenetek
- A küldendő részletes üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- connectionString
Azure Storage
Integrációt biztosít a Microsoft Azure Storage szolgáltatással.
Üzenet beszúrása tárolási üzenetsorba
Ez a művelet beszúrja az esemény JSON-sztring-ábrázolását a megadott Azure Storage-üzenetsorba. További információ: Mik azok az Azure-üzenetsorok?.
- Fogyasztói azonosító: azureStorageQueue
- Műveletazonosító: enqueue
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- accountName
- Tárfiók neve
- Az Azure Storage-fiókhoz társított név (például
https://STORAGE_ACCOUNT_NAME.queue.core.windows.net
). - Adattípus: sztring
- Kötelező: Igen
- accountKey
- Tárfiók kulcsa
- Az Azure Storage-fiókhoz társított kulcs.
- Adattípus: sztring
- Kötelező: Igen
- queueName
- Üzenetsor neve
- Az Azure Storage-ban használandó üzenetsor csak kisbetűs neve. Ha még nem létezik, létrejön egy ilyen nevű üzenetsor.
- Adattípus: sztring
- Kötelező: Igen
- visiTimeout
- Üzenet láthatóságának időtúllépése (másodpercben)
- A lekérdezett üzenet láthatósági időtúllépési értékét adja meg másodpercben a kiszolgálói időhöz viszonyítva. Az értéknek 0-nál nagyobbnak vagy egyenlőnek kell lennie, és nem lehet nagyobb hét napnál vagy 604 800 másodpercnél. A láthatósági időtúllépést az üzenet élettartamánál kisebb értékre kell állítani.
- Adattípus: szám
- Kötelező: Igen
- Ttl
- Üzenet élettartam (másodpercben)
- Az üzenetsor üzenetének élettartamát adja meg másodpercben. A maximális élettartam hét nap, azaz 604 800 másodperc.
- Adattípus: szám
- Kötelező: Igen
- resourceDetailsToSend
- Elküldendő erőforrás részletei
- A küldendő erőforrásmezők szabályozása
- Adattípus: sztring
- Kötelező: Nem
- messagesToSend
- Elküldendő üzenetek
- A küldendő üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- detailedMessagesToSend
- Részletes elküldendő üzenetek
- A küldendő részletes üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- accountName
Jenkins
A Jenkins egy folyamatos integrációs kiszolgáló, amely lehetővé teszi szoftverprojektek folyamatos kiépítését és tesztelését.
Git-build aktiválása
Elindít egy Git-adattár használatára konfigurált buildet a Jenkins Git beépülő modullal.
- Fogyasztói azonosító: jenkins
- Műveletazonosító: triggerGitBuild
- Támogatott események: git.push
- Beállítások:
- serverBaseUrl
- Jenkins alap URL-címe
- A Jenkins-kiszolgálót üzemeltető alap URL-cím
- Adattípus: uri
- Kötelező: Igen
- felhasználónév
- Felhasználónév
- Egy olyan felhasználó Jenkins-felhasználóneve, aki aktiválhatja a buildet
- Adattípus: sztring
- Kötelező: Igen
- jelszó
- Felhasználói API-jogkivonat (vagy jelszó)
- A felhasználó API-jogkivonata, amely a Jenkins felhasználói konfigurációs oldalán érhető el. Az API-jogkivonat az 1.426-os verzió óta új. A Jenkins korábbi verzióihoz meg kell adni a valódi felhasználói jelszót.
- Adattípus: sztring
- Kötelező: Igen
- serverBaseUrl
Általános build aktiválása
Aktivál egy általános Jenkins-buildet, amely a Jenkins build URL-címét használja.
- Fogyasztói azonosító: jenkins
- Műveletazonosító: triggerGenericBuild
- Támogatott események: git.push, build.complete, tfvc.checkin
- Beállítások:
- serverBaseUrl
- Jenkins alap URL-címe
- A Jenkins-kiszolgálót üzemeltető alap URL-cím
- Adattípus: uri
- Kötelező: Igen
- felhasználónév
- Felhasználónév
- Egy olyan felhasználó Jenkins-felhasználóneve, aki aktiválhatja a buildet
- Adattípus: sztring
- Kötelező: Igen
- jelszó
- Felhasználói API-jogkivonat (vagy jelszó)
- A felhasználó API-jogkivonata, amely a Jenkins felhasználói konfigurációs oldalán érhető el. Az API-jogkivonat az 1.426-os verzió óta új. A Jenkins korábbi verzióihoz meg kell adni a valódi felhasználói jelszót.
- Adattípus: sztring
- Kötelező: Igen
- buildName
- Létrehozás
- Az eseményindító build neve
- Adattípus: sztring
- Kötelező: Igen
- buildAuthToken
- Build jogkivonat
- Az engedélyezési jogkivonat sztring formájában, hogy csak azok a felhasználók aktiválhassák távolról a projekt buildjeinek aktiválását, akik tudják
- Adattípus: sztring
- Kötelező: Nem
- buildParameterized
- Paraméterek elfogadása
- Azt jelzi, hogy a build paraméterezett-e vagy sem (a buildparaméterek megadása opcionálisan korábban történik)
- Adattípus: logikai
- Kötelező: Nem
- buildParams
- Buildparaméterek
- Paraméterek neveinek és értékeinek összeállítása kettősponttal (például "param1:value1") elválasztva, és mindegyik név-érték pár a saját szövegsorán jelenik meg
- Adattípus: sztring
- Kötelező: Nem
- serverBaseUrl
Trello
Integrációt biztosít a Trello-val.
Kártya létrehozása
Ez a művelet létrehoz egy kártyát egy meglévő listán Trello-ban. A kártyák feladatokat, problémákat, eseményeket vagy akár bármit is képviselhetnek. A kártya állapotát általában az határozza meg, hogy melyik listán szerepel. További információt a Trello szolgáltatáshook létrehozása című témakörben talál.
- Fogyasztói azonosító: trello
- Műveletazonosító: createCard
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- userToken
- Felhasználói jogkivonat (szüksége van rá? Szerezze be most.)
- A Trello által biztosított felhasználói jogkivonat. A jogkivonat beszerzésének megismeréséhez válassza ki a hivatkozást a korábban ismertetett műveletleírásban.
- Adattípus: sztring
- Kötelező: Igen
- boardId
- Beszáll
- Annak a táblának a neve, amelyen a Trello-kártya létrejön.
- Adattípus: sztring
- Kötelező: Igen
- listId
- Lista
- Annak a listának a neve, amelyen a Trello-kártya létrejön.
- Adattípus: sztring
- Kötelező: Igen
- Címkék
- Címkék
- A létrehozott kártyára alkalmazandó címkeszínek vesszővel tagolt listája. Az érvényes címkeszínek neve piros, narancssárga, sárga, zöld, kék és lila.
- Adattípus: sztring
- Kötelező: Nem
- addToTop
- Létrehozás a lista elején
- Azt jelzi, hogy a kártyát a Trello lista elején kell-e létrehozni a vég helyett.
- Adattípus: logikai
- Kötelező: Nem
- userToken
Lista létrehozása
Ez a művelet létrehoz egy listát egy meglévő táblán Trello-ban. A listák a kártyák táblán való rendszerezésére szolgálnak, és általában egy állapotot jelölnek. További információt a Trello szolgáltatáshook létrehozása című témakörben talál.
- Fogyasztói azonosító: trello
- Műveletazonosító: createList
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- userToken
- Felhasználói jogkivonat (szüksége van rá? Szerezze be most.)
- A Trello által biztosított felhasználói jogkivonat. A jogkivonat beszerzésének megismeréséhez válassza ki a hivatkozást a korábban ismertetett műveletleírásban.
- Adattípus: sztring
- Kötelező: Igen
- boardId
- Beszáll
- Annak a táblának a neve, amelyen a Trello-lista létrejön.
- Adattípus: sztring
- Kötelező: Igen
- addToBottom
- Létrehozás a tábla alján
- Azt jelzi, hogy a listát a tábla alján kell-e létrehozni a felül helyett.
- Adattípus: logikai
- Kötelező: Nem
- userToken
Webhookok
A webhookok HTTP-en keresztül biztosítják az eseménykommunikációt.
Közzététel HTTP-en keresztül
Ez a művelet közzéteszi az esemény JSON-objektumábrázolását a megadott URL-címre. A HTTPS-végpontok az esemény hasznos adataiban rejlő privát adatok miatt ajánlottak. További információ: Webhookok.
- Fogyasztói azonosító: webHooks
- Műveletazonosító: httpRequest
- Támogatott események: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Beállítások:
- URL-cím
- URL-cím
- Az AZ URL-cím, amelyre a HTTP POST-et küldi.
- Adattípus: uri
- Kötelező: Igen
- httpHeaders
- HTTP-fejlécek
- HTTP-fejléckulcsok és értékek kettősponttal (például "Key1:value1") elválasztva, és mindegyik kulcs-érték pár a saját szövegsorán jelenik meg.
- Adattípus: sztring
- Kötelező: Nem
- basicAuthUsername
- Egyszerű hitelesítési felhasználónév
- Adjon meg egy felhasználónevet a szabványos HTTP-hitelesítéshez. Az alapszintű HTTP-hitelesítés egyszerű szövegben (titkosítatlan) küld hitelesítő adatokat, ami azt jelenti, hogy a hitelesítő adatok titkosításának biztonságos átviteli rétegen (SSL) keresztül történő engedélyezéséhez a "https" kezdetű URL-címet kell használnia.
- Adattípus: sztring
- Kötelező: Nem
- basicAuthPassword
- Egyszerű hitelesítési jelszó
- Adjon meg egy jelszót a szabványos HTTP-hitelesítéshez. Az alapszintű HTTP-hitelesítés egyszerű szövegben (titkosítatlan) küld hitelesítő adatokat, ami azt jelenti, hogy a hitelesítő adatok SSL-en keresztüli titkosításának engedélyezéséhez a "https" kezdetű URL-címet kell használnia.
- Adattípus: sztring
- Kötelező: Nem
- resourceDetailsToSend
- Elküldendő erőforrás részletei
- A küldendő erőforrásmezők szabályozása
- Adattípus: sztring
- Kötelező: Nem
- messagesToSend
- Elküldendő üzenetek
- A küldendő üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- detailedMessagesToSend
- Részletes elküldendő üzenetek
- A küldendő részletes üzenetek szabályozása
- Adattípus: sztring
- Kötelező: Nem
- URL-cím
Zendesk
A Zendesk egy SaaS-csomag, amely ügyfélszolgálati jegyekkel, problémakövetéssel és ügyfélszolgálati támogatással rendelkezik.
Privát megjegyzés létrehozása jegyben
A Zendesk használatával privát megjegyzést hozhat létre egy jegyben.
- Fogyasztói azonosító: zendesk
- Műveletazonosító: createPrivateComment
- Támogatott események: workitem.commented
- Beállítások:
- accountName
- Számla neve
- Zendesk-fiók neve, mint
https://{account name}.zendesk.com
- Adattípus: sztring
- Kötelező: Igen
- felhasználónév
- Felhasználónév
- Egy jegyfrissítést végző felhasználó Zendesk-felhasználóneve
- Adattípus: sztring
- Kötelező: Igen
- apiToken
- API-jogkivonat
- A Zendesk API-jogkivonat (a Zendesk alkalmazásban található a Felügyeleti > csatornák > API-ban)
- Adattípus: sztring
- Kötelező: Igen
- accountName