Publishers - Get

Dienst:: Service Hooks

API-Version:: 7.1

Rufen Sie einen bestimmten Dienst-Hooks-Herausgeber ab.

GET https://dev.azure.com/{organization}/_apis/hooks/publishers/{publisherId}?api-version=7.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
publisherId	path	True	string	ID für einen Herausgeber.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name	Typ	Beschreibung
200 OK	Publisher	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token-URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Bereiche

Name	Beschreibung
vso.work	Gewährt die Möglichkeit, Arbeitsaufgaben, Abfragen, Boards, Flächen- und Iterationspfade und andere Metadaten zur Nachverfolgung von Arbeitsaufgaben zu lesen. Gewährt außerdem die Möglichkeit, Abfragen auszuführen, Arbeitsaufgaben zu durchsuchen und Benachrichtigungen über Arbeitsaufgabenereignisse über Dienst-Hooks zu erhalten.
vso.build	Gewährt die Möglichkeit, auf Buildartefakte zuzugreifen, einschließlich Buildergebnissen, Definitionen und Anforderungen sowie die Möglichkeit, Benachrichtigungen über Buildereignisse über Dienst-Hooks zu empfangen.
vso.code	Gewährt die Möglichkeit, Quellcode und Metadaten zu Commits, Changesets, Verzweigungen und anderen Versionskontrollartefakten zu lesen. Gewährt außerdem die Möglichkeit, Code zu durchsuchen und über Dienst-Hooks über Versionssteuerungsereignisse benachrichtigt zu werden.

Definitionen

Name	Beschreibung
EventTypeDescriptor	Beschreibt einen Ereignistyp
InputDataType	Ruft den zu überprüfenden Datentyp ab oder legt diesen fest.
InputDescriptor	Beschreibt eine Eingabe für Abonnements.
InputMode	Modus, in den der Wert dieser Eingabe eingegeben werden soll
InputValidation	Beschreibt, welche Werte für eine Abonnementeingabe gültig sind.
InputValue	Informationen zu einem einzelnen Wert für eine Eingabe
InputValues	Informationen zu den möglichen/zulässigen Werten für eine bestimmte Abonnementeingabe
InputValuesError	Fehlerinformationen im Zusammenhang mit einem Abonnementeingabewert.
Publisher	Definiert den Datenvertrag eines Ereignisherausgebers.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

EventTypeDescriptor

Objekt

Beschreibt einen Ereignistyp

Name	Typ	Beschreibung
description	string	Eine lokalisierte Beschreibung des Ereignistyps
id	string	Eine eindeutige ID für den Ereignistyp
inputDescriptors	InputDescriptor[]	Ereignisspezifische Eingaben
name	string	Ein lokalisierter Anzeigename für den Ereignistyp
publisherId	string	Eine eindeutige ID für den Herausgeber dieses Ereignistyps
supportedResourceVersions	string[]	Unterstützte Versionen für die Ressourcennutzlasten des Ereignisses.
url	string	Die URL für diese Ressource

InputDataType

Enumeration

Ruft den zu überprüfenden Datentyp ab oder legt diesen fest.

Wert	Beschreibung
none	Es wird kein Datentyp angegeben.
string	Stellt einen Textwert dar.
number	Stellt einen numerischen Wert dar.
boolean	Stellt einen Wert von "true" oder "false" dar.
guid	Stellt eine GUID dar.
uri	Stellt einen URI dar.

InputDescriptor

Objekt

Beschreibt eine Eingabe für Abonnements.

Name	Typ	Beschreibung
dependencyInputIds	string[]	Die IDs aller Eingaben, von denen der Wert dieser Eingabe abhängig ist.
description	string	Beschreibung, für welche Eingabe diese Eingabe verwendet wird
groupName	string	Der lokalisierte Name der Gruppe, zu der diese Eingabe gehört, und kann als Header für den Container angezeigt werden, der alle Eingaben in der Gruppe enthält.
hasDynamicValueInformation	boolean	Wenn true, sind die Wertinformationen für diese Eingabe dynamisch und sollten abgerufen werden, wenn sich der Wert von Abhängigkeitseingaben ändert.
id	string	Bezeichner für die Abonnementeingabe
inputMode	InputMode	Modus, in den der Wert dieser Eingabe eingegeben werden soll
isConfidential	boolean	Ruft ab, ob diese Eingabe vertraulich ist, z. B. für ein Kennwort oder einen Anwendungsschlüssel
name	string	Lokalisierter Name, der als Bezeichnung für die Abonnementeingabe angezeigt werden kann
properties	object	Benutzerdefinierte Eigenschaften für die Eingabe, die vom Dienstanbieter verwendet werden kann
type	string	Zugrunde liegender Datentyp für den Eingabewert. Wenn dieser Wert angegeben ist, sind InputMode, Validation und Values optional.
useInDefaultDescription	boolean	Ruft ab, ob diese Eingabe in der standardmäßig generierten Aktionsbeschreibung enthalten ist.
validation	InputValidation	Informationen zur Überprüfung des Werts dieser Eingabe
valueHint	string	Ein Hinweis für den Eingabewert. Sie kann in der Benutzeroberfläche als Eingabeplatzhalter verwendet werden.
values	InputValues	Informationen zu möglichen Werten für diese Eingabe

InputMode

Enumeration

Modus, in den der Wert dieser Eingabe eingegeben werden soll

Wert	Beschreibung
none	Diese Eingabe sollte nicht in der Benutzeroberfläche angezeigt werden.
textBox	Ein Eingabetextfeld sollte angezeigt werden.
passwordBox	Ein Kennworteingabefeld sollte angezeigt werden.
combo	Ein Auswahl-/Kombinationssteuerelement sollte angezeigt werden.
radioButtons	Optionsfelder sollten angezeigt werden
checkBox	Das Kontrollkästchen sollte angezeigt werden(für true/false-Werte)
textArea	Ein mehrzeiliges Textbereich sollte angezeigt werden.

InputValidation

Objekt

Beschreibt, welche Werte für eine Abonnementeingabe gültig sind.

Name	Typ	Beschreibung
dataType	InputDataType	Ruft den zu überprüfenden Datentyp ab oder legt diesen fest.
isRequired	boolean	Ruft ab oder legt fest, ob dies ein erforderliches Feld ist.
maxLength	integer (int32)	Dient zum Abrufen oder Festlegen der maximalen Länge dieses Deskriptors.
maxValue	string (decimal)	Ruft den Minimalwert für diesen Deskriptor ab oder legt diesen fest.
minLength	integer (int32)	Ruft die Mindestlänge dieses Deskriptors ab oder legt sie fest.
minValue	string (decimal)	Ruft den Minimalwert für diesen Deskriptor ab oder legt diesen fest.
pattern	string	Ruft das zu überprüfende Muster ab oder legt es fest.
patternMismatchErrorMessage	string	Ruft den Fehler bei musterkonflikten ab oder legt den Fehler fest.

InputValue

Objekt

Informationen zu einem einzelnen Wert für eine Eingabe

Name	Typ	Beschreibung
data	object	Alle anderen Daten zu dieser Eingabe
displayValue	string	Der Text, der für die Anzeige dieses Werts angezeigt werden soll
value	string	Der wert, der für diese Eingabe gespeichert werden soll

InputValues

Objekt

Informationen zu den möglichen/zulässigen Werten für eine bestimmte Abonnementeingabe

Name	Typ	Beschreibung
defaultValue	string	Der Standardwert, der für diese Eingabe verwendet werden soll
error	InputValuesError	Fehler beim Berechnen dynamischer Werte.
inputId	string	Die ID der Eingabe
isDisabled	boolean	Sollte diese Eingabe deaktiviert sein
isLimitedToPossibleValues	boolean	Sollte der Wert auf einen der Werte in den PossibleValues (True) beschränkt werden oder sind die Werte in PossibleValues nur ein Vorschlag (False)
isReadOnly	boolean	Sollte diese Eingabe schreibgeschützt gemacht werden
possibleValues	InputValue[]	Mögliche Werte, die diese Eingabe annehmen kann

InputValuesError

Objekt

Fehlerinformationen im Zusammenhang mit einem Abonnementeingabewert.

Name	Typ	Beschreibung
message	string	Die Fehlermeldung.

Publisher

Objekt

Definiert den Datenvertrag eines Ereignisherausgebers.

Name	Typ	Beschreibung
_links	ReferenceLinks	Referenzlinks
description	string	Ruft die lokalisierte Beschreibung dieses Herausgebers ab.
id	string	Ruft den Bezeichner dieses Herausgebers ab.
inputDescriptors	InputDescriptor[]	Publisher-spezifische Eingaben
name	string	Ruft den lokalisierten Namen dieses Herausgebers ab.
serviceInstanceType	string	Der Dienstinstanztyp des Herausgebers des ersten Anbieters.
supportedEvents	EventTypeDescriptor[]	Ruft die unterstützten Ereignistypen dieses Herausgebers ab.
url	string	Die URL für diese Ressource

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.