Użytkownicy wpięć usługi
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Programowe tworzenie subskrypcji przy użyciu punktów zaczepienia usługi. Subskrypcja określa zdarzenie, odbiorcę i akcję.
Wybierz użytkownika, którego chcesz użyć w ramach subskrypcji od następujących odbiorców. Aby uzyskać więcej informacji na temat dostępnych usług, zobacz Integrowanie z punktami zaczepienia usług, Dostępne usługi.
Azure Service Bus
Zapewnia integrację z usługą Microsoft Azure Service Bus, w tym z usługą Notification Hubs.
Wysyłanie komunikatu do centrum powiadomień
Ta akcja wysyła ogólne powiadomienie o szablonie do określonego centrum powiadomień platformy Azure. Aby uzyskać więcej informacji, zobacz omówienie.
- Identyfikator odbiorcy: azureServiceBus
- Identyfikator akcji: serviceBusNotificationHubSend
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- connectionString
- Parametry połączenia sygnatury dostępu współdzielonego
- Sygnatura dostępu współdzielonego (sygnatura dostępu współdzielonego) parametry połączenia używana do nawiązywania połączenia z usługą Azure Service Bus. Ta parametry połączenia jest dostępna w witrynie Azure Portal.
- Typ danych: ciąg
- Wymagane: Tak
- notificationHubName
- Nazwa centrum powiadomień
- Nazwa centrum powiadomień do wysłania powiadomienia. Nazwa może zawierać tylko litery, cyfry, kropki, łączniki, ukośniki i podkreślenia. Nazwa musi zaczynać się i kończyć literą lub cyfrą. Koncentrator powinien już istnieć.
- Typ danych: ciąg
- Wymagane: Tak
- tagsExpression
- Tagi
- Wyrażenie tagów (przeznaczone dla określonych zestawów urządzeń). Dowiedz się więcej.
- Typ danych: ciąg
- Wymagane: Nie
- connectionString
Wysyłanie komunikatu do kolejki usługi Service Bus
Ta akcja wysyła ciąg JSON reprezentujący zdarzenie do określonej kolejki usługi Azure Service Bus. Aby uzyskać więcej informacji, zobacz Kolejki, artykuły i subskrypcje usługi Service Bus.
- Identyfikator odbiorcy: azureServiceBus
- Identyfikator akcji: serviceBusQueueSend
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- connectionString
- Parametry połączenia sygnatury dostępu współdzielonego
- Sygnatura dostępu współdzielonego (sygnatura dostępu współdzielonego) parametry połączenia używana do nawiązywania połączenia z usługą Azure Service Bus. Ta parametry połączenia jest dostępna w witrynie Azure Portal.
- Typ danych: ciąg
- Wymagane: Tak
- queueName
- Nazwa kolejki
- Nazwa kolejki do wysłania komunikatu. Nazwa może zawierać tylko litery, cyfry, kropki, łączniki, ukośniki i podkreślenia. Nazwa musi zaczynać się i kończyć literą lub cyfrą. Jeśli kolejka nie istnieje, zostanie utworzona, jeśli określona parametry połączenia ma niezbędne uprawnienia.
- Typ danych: ciąg
- Wymagane: Tak
- resourceDetailsToSend
- Szczegóły zasobu do wysłania
- Kontrolowanie pól zasobów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- messagesToSend
- Komunikaty do wysłania
- Kontrolowanie komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- detailedMessagesToSend
- Szczegółowe komunikaty do wysłania
- Kontrolowanie szczegółowych komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- connectionString
Wysyłanie komunikatu do tematu usługi Service Bus
Ta akcja wysyła reprezentację ciągu JSON zdarzenia do określonego tematu usługi Azure Service Bus. Aby uzyskać więcej informacji, zobacz Tworzenie tematu i subskrypcji usługi Service Bus przy użyciu witryny Azure Portal.
- Identyfikator odbiorcy: azureServiceBus
- Identyfikator akcji: serviceBusTopicSend
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- connectionString
- Parametry połączenia sygnatury dostępu współdzielonego
- Sygnatura dostępu współdzielonego (sygnatura dostępu współdzielonego) parametry połączenia używana do nawiązywania połączenia z usługą Azure Service Bus. Ta parametry połączenia jest dostępna w witrynie Azure Portal.
- Typ danych: ciąg
- Wymagane: Tak
- nazwa tematu
- Nazwa tematu
- Nazwa tematu do wysłania wiadomości. Nazwa może zawierać tylko litery, cyfry, kropki, łączniki, ukośniki i podkreślenia. Nazwa musi zaczynać się i kończyć literą lub cyfrą. Jeśli temat nie istnieje, zostanie utworzony, jeśli określony parametry połączenia ma niezbędne uprawnienia.
- Typ danych: ciąg
- Wymagane: Tak
- resourceDetailsToSend
- Szczegóły zasobu do wysłania
- Kontrolowanie pól zasobów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- messagesToSend
- Komunikaty do wysłania
- Kontrolowanie komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- detailedMessagesToSend
- Szczegółowe komunikaty do wysłania
- Kontrolowanie szczegółowych komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- connectionString
Azure Storage
Zapewnia integrację z usługą Microsoft Azure Storage.
Wstawianie komunikatu w kolejce magazynu
Ta akcja wstawia ciąg JSON reprezentujący zdarzenie do określonej kolejki usługi Azure Storage. Aby uzyskać więcej informacji, zobacz Co to są kolejki platformy Azure?.
- Identyfikator odbiorcy: azureStorageQueue
- Identyfikator akcji: enqueue
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- accountName
- Nazwa konta magazynu
- Nazwa skojarzona z kontem usługi Azure Storage (na przykład
https://STORAGE_ACCOUNT_NAME.queue.core.windows.net
). - Typ danych: ciąg
- Wymagane: Tak
- accountKey
- Klucz konta magazynu
- Klucz skojarzony z kontem usługi Azure Storage.
- Typ danych: ciąg
- Wymagane: Tak
- queueName
- Nazwa kolejki
- Mała nazwa kolejki, która ma być używana w usłudze Azure Storage. Kolejka o tej nazwie zostanie utworzona, jeśli jeszcze nie istnieje.
- Typ danych: ciąg
- Wymagane: Tak
- visiTimeout
- Limit czasu widoczności komunikatu (w sekundach)
- Określa wartość limitu czasu widoczności w sekundach dla komunikatu w kolejce względem czasu serwera. Wartość musi być większa lub równa 0 i nie może być większa niż siedem dni lub 604 800 sekund. Limit czasu widoczności musi być ustawiony na wartość mniejszą niż wartość czasu wygaśnięcia komunikatu.
- Typ danych: liczba
- Wymagane: Tak
- Ttl
- Czas wygaśnięcia komunikatu (w sekundach)
- Określa interwał czasu wygaśnięcia komunikatu kolejki w sekundach. Maksymalny dozwolony czas wygaśnięcia wynosi siedem dni lub 604 800 sekund.
- Typ danych: liczba
- Wymagane: Tak
- resourceDetailsToSend
- Szczegóły zasobu do wysłania
- Kontrolowanie pól zasobów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- messagesToSend
- Komunikaty do wysłania
- Kontrolowanie komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- detailedMessagesToSend
- Szczegółowe komunikaty do wysłania
- Kontrolowanie szczegółowych komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- accountName
Jenkins
Jenkins to serwer ciągłej integracji, który umożliwia ciągłe kompilowanie i testowanie projektów oprogramowania.
Wyzwalanie kompilacji usługi Git
Wyzwala kompilację skonfigurowaną do korzystania z repozytorium Git przy użyciu wtyczki Git serwera Jenkins.
- Identyfikator odbiorcy: jenkins
- Identyfikator akcji: triggerGitBuild
- Obsługiwane zdarzenia: git.push
- Ustawienia:
- serverBaseUrl
- Podstawowy adres URL usługi Jenkins
- Podstawowy adres URL hostujący serwer Jenkins
- Typ danych: identyfikator URI
- Wymagane: Tak
- nazwa użytkownika
- User name
- Nazwa użytkownika usługi Jenkins, który może wyzwolić kompilację
- Typ danych: ciąg
- Wymagane: Tak
- hasło
- Token interfejsu API użytkownika (lub hasło)
- Token interfejsu API użytkownika, który jest dostępny na stronie konfiguracji użytkownika usługi Jenkins. Token interfejsu API jest nowy od wersji 1.426. W przypadku wcześniejszych wersji serwera Jenkins należy określić rzeczywiste hasło użytkownika.
- Typ danych: ciąg
- Wymagane: Tak
- serverBaseUrl
Wyzwalanie kompilacji ogólnej
Wyzwala ogólną kompilację serwera Jenkins, wywołując adres URL kompilacji narzędzia Jenkins.
- Identyfikator odbiorcy: jenkins
- Identyfikator akcji: triggerGenericBuild
- Obsługiwane zdarzenia: git.push, build.complete, tfvc.checkin
- Ustawienia:
- serverBaseUrl
- Podstawowy adres URL usługi Jenkins
- Podstawowy adres URL hostujący serwer Jenkins
- Typ danych: identyfikator URI
- Wymagane: Tak
- nazwa użytkownika
- User name
- Nazwa użytkownika usługi Jenkins, który może wyzwolić kompilację
- Typ danych: ciąg
- Wymagane: Tak
- hasło
- Token interfejsu API użytkownika (lub hasło)
- Token interfejsu API użytkownika, który jest dostępny na stronie konfiguracji użytkownika usługi Jenkins. Token interfejsu API jest nowy od wersji 1.426. W przypadku wcześniejszych wersji serwera Jenkins należy określić rzeczywiste hasło użytkownika.
- Typ danych: ciąg
- Wymagane: Tak
- buildName
- Kompilacja
- Nazwa kompilacji do wyzwolenia
- Typ danych: ciąg
- Wymagane: Tak
- buildAuthToken
- Token kompilacji
- Token autoryzacji w postaci ciągu, dzięki czemu tylko użytkownicy, którzy wiedzą, że będzie mógł zdalnie wyzwolić kompilacje tego projektu
- Typ danych: ciąg
- Wymagane: Nie
- buildParameterized
- Akceptuje parametry
- Wskazuje, czy kompilacja jest sparametryzowana, czy nie (parametry kompilacji są opcjonalnie określone wcześniej)
- Typ danych: wartość logiczna
- Wymagane: Nie
- buildParams
- Parametry kompilacji
- Nazwy parametrów kompilacji i wartości oddzielone dwukropkiem (na przykład "param1:value1") z każdą parą name-value wyświetlaną we własnym wierszu tekstu
- Typ danych: ciąg
- Wymagane: Nie
- serverBaseUrl
Trello
Zapewnia integrację z aplikacją Trello.
Utwórz kartę
Ta akcja powoduje utworzenie karty na istniejącej liście w aplikacji Trello. Karta może reprezentować zadanie, problem, zdarzenie lub prawie wszystko. Stan karty jest zwykle określany przez listę, na której jest włączona. Aby uzyskać więcej informacji, zobacz Create a service hook with Trello (Tworzenie elementu zaczepienia usługi za pomocą aplikacji Trello).
- Identyfikator odbiorcy: trello
- Identyfikator akcji: createCard
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- userToken
- Token użytkownika (potrzebujesz go? Pobierz go teraz.)
- Token użytkownika dostarczony przez firmę Trello. Aby dowiedzieć się, jak uzyskać ten token, wybierz link we wcześniej opisanym opisie akcji.
- Typ danych: ciąg
- Wymagane: Tak
- boardId
- Board (płytka drukowana)
- Nazwa tablicy, na której zostanie utworzona karta Trello.
- Typ danych: ciąg
- Wymagane: Tak
- listId
- List
- Nazwa listy, na której zostanie utworzona karta Trello.
- Typ danych: ciąg
- Wymagane: Tak
- Etykiety
- Etykiety
- Rozdzielona przecinkami lista kolorów etykiet, które mają być stosowane do utworzonej karty. Prawidłowe nazwy kolorów etykiet to czerwony, pomarańczowy, żółty, zielony, niebieski i fioletowy.
- Typ danych: ciąg
- Wymagane: Nie
- addToTop
- Utwórz na początku listy
- Wskazuje, czy karta powinna zostać utworzona na początku listy Trello, a nie na końcu.
- Typ danych: wartość logiczna
- Wymagane: Nie
- userToken
Utwórz listę
Ta akcja tworzy listę na istniejącej tablicy w aplikacji Trello. Lista służy do organizowania kart na tablicy i zazwyczaj reprezentuje stan. Aby uzyskać więcej informacji, zobacz Create a service hook with Trello (Tworzenie elementu zaczepienia usługi za pomocą aplikacji Trello).
- Identyfikator odbiorcy: trello
- Identyfikator akcji: createList
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- userToken
- Token użytkownika (potrzebujesz go? Pobierz go teraz.)
- Token użytkownika dostarczony przez firmę Trello. Aby dowiedzieć się, jak uzyskać ten token, wybierz link we wcześniej opisanym opisie akcji.
- Typ danych: ciąg
- Wymagane: Tak
- boardId
- Board (płytka drukowana)
- Nazwa tablicy, na której zostanie utworzona lista Trello.
- Typ danych: ciąg
- Wymagane: Tak
- addToBottom
- Utwórz w dolnej części tablicy
- Wskazuje, czy lista powinna zostać utworzona w dolnej części tablicy, a nie u góry.
- Typ danych: wartość logiczna
- Wymagane: Nie
- userToken
Elementy webhook
Elementy webhook zapewniają komunikację zdarzeń za pośrednictwem protokołu HTTP.
Publikowanie za pośrednictwem protokołu HTTP
Ta akcja powoduje opublikowanie reprezentacji obiektu JSON zdarzenia do określonego adresu URL. Zalecane są punkty końcowe HTTPS ze względu na potencjalne dane prywatne w ładunku zdarzenia. Aby uzyskać więcej informacji, zobacz Webhooks (Elementy webhook).
- Identyfikator odbiorcy: elementy webHook
- Identyfikator akcji: httpRequest
- Obsługiwane zdarzenia: build.complete, git.push, tfvc.checkin, workitem.created, workitem.commented, workitem.updated
- Ustawienia:
- adres URL
- URL
- Adres URL, do którego jest wysyłany wpis HTTP.
- Typ danych: identyfikator URI
- Wymagane: Tak
- httpHeaders
- Nagłówki HTTP
- Klucze nagłówka HTTP i wartości oddzielone dwukropkiem (na przykład "Key1:value1") z każdą parą klucz-wartość-wartość wyświetlaną we własnym wierszu tekstu.
- Typ danych: ciąg
- Wymagane: Nie
- basicAuthUsername
- Nazwa użytkownika uwierzytelniania podstawowego
- Wprowadź nazwę użytkownika standardowego uwierzytelniania HTTP. Podstawowe uwierzytelnianie HTTP wysyła poświadczenia w postaci zwykłego tekstu (niezaszyfrowanego), co oznacza, że należy użyć adresu URL rozpoczynającego się od "https", aby włączyć szyfrowanie tych poświadczeń za pośrednictwem bezpiecznej warstwy transportu (SSL).
- Typ danych: ciąg
- Wymagane: Nie
- basicAuthPassword
- Hasło uwierzytelniania podstawowego
- Wprowadź hasło do standardowego uwierzytelniania HTTP. Podstawowe uwierzytelnianie HTTP wysyła poświadczenia w postaci zwykłego tekstu (niezaszyfrowanego), co oznacza, że należy użyć adresu URL rozpoczynającego się od "https", aby włączyć szyfrowanie tych poświadczeń za pośrednictwem protokołu SSL.
- Typ danych: ciąg
- Wymagane: Nie
- resourceDetailsToSend
- Szczegóły zasobu do wysłania
- Kontrolowanie pól zasobów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- messagesToSend
- Komunikaty do wysłania
- Kontrolowanie komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- detailedMessagesToSend
- Szczegółowe komunikaty do wysłania
- Kontrolowanie szczegółowych komunikatów do wysłania
- Typ danych: ciąg
- Wymagane: Nie
- adres URL
Zendesk
Zendesk to pakiet SaaS, który oferuje bilet pomocy technicznej, śledzenie problemów i pomoc techniczną.
Tworzenie prywatnego komentarza w bilecie
Użyj aplikacji Zendesk, aby utworzyć prywatny komentarz w bilecie.
- Identyfikator odbiorcy: zendesk
- Identyfikator akcji: createPrivateComment
- Obsługiwane zdarzenia: workitem.commented
- Ustawienia:
- accountName
- Nazwa konta
- Nazwa konta zendesk, na przykład
https://{account name}.zendesk.com
- Typ danych: ciąg
- Wymagane: Tak
- nazwa użytkownika
- User name
- Nazwa użytkownika aplikacji Zendesk, który aktualizuje bilety
- Typ danych: ciąg
- Wymagane: Tak
- apiToken
- Token interfejsu API
- Token interfejsu API zendesk (można go znaleźć w aplikacji Zendesk w interfejsie API kanałów > administracyjnych>)
- Typ danych: ciąg
- Wymagane: Tak
- accountName