Consumers - Get Consumer Action

Odwołanie

Service:: Service Hooks

API Version:: 7.1-preview.1

Uzyskaj szczegółowe informacje o określonej akcji konsumenta.

GET https://dev.azure.com/{organization}/_apis/hooks/consumers/{consumerId}/actions/{consumerActionId}?api-version=7.1-preview.1

With optional parameters:

GET https://dev.azure.com/{organization}/_apis/hooks/consumers/{consumerId}/actions/{consumerActionId}?publisherId={publisherId}&api-version=7.1-preview.1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
consumerActionId	path	True	string	Identyfikator identyfikatora consumerActionId.
consumerId	path	True	string	Identyfikator użytkownika.
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
api-version	query	True	string	Wersja interfejsu API do użycia. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.
publisherId	query		string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ConsumerAction	operacja zakończona powodzeniem

Zabezpieczenia

oauth2

Type: oauth2
Flow: accessCode
Authorization 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

Scopes

Nazwa	Opis
vso.work	Umożliwia odczytywanie elementów roboczych, zapytań, tablic, ścieżek obszaru i iteracji oraz innych metadanych powiązanych ze śledzeniem elementów roboczych. Umożliwia również wykonywanie zapytań, wyszukiwanie elementów roboczych i odbieranie powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.
vso.build	Umożliwia dostęp do artefaktów kompilacji, w tym wyników kompilacji, definicji i żądań oraz możliwość odbierania powiadomień o zdarzeniach kompilacji za pośrednictwem punktów zaczepienia usługi.
vso.code	Umożliwia odczytywanie kodu źródłowego i metadanych dotyczących zatwierdzeń, zestawów zmian, gałęzi i innych artefaktów kontroli wersji. Umożliwia również wyszukiwanie kodu i otrzymywanie powiadomień o zdarzeniach kontroli wersji za pośrednictwem punktów zaczepienia usługi.

Przykłady

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/hooks/consumers/zendesk/actions/createPrivateComment?api-version=7.1-preview.1

Sample Response

Status code:: 200

{
  "id": "createPrivateComment",
  "consumerId": "zendesk",
  "url": "https://dev.azure.com/fabrikam/_apis/hooks/consumers/zendesk/actions/createPrivateComment",
  "name": "Create a private comment in a ticket",
  "description": "Create a private comment in a ticket. <a href='http://go.microsoft.com/fwlink/?LinkId=396756'>Learn more.</a>",
  "supportedEventTypes": [
    "workitem.commented"
  ],
  "supportedResourceVersions": {
    "workitem.commented": [
      "1.0-preview.1"
    ]
  },
  "inputDescriptors": []
}

Definicje

Nazwa	Opis
ConsumerAction	Definiuje kontrakt danych akcji konsumenta.
InputDataType	Pobiera lub ustawia typ danych w celu zweryfikowania.
InputDescriptor	Opisuje dane wejściowe dla subskrypcji.
InputMode	Tryb, w którym należy wprowadzić wartość tego elementu wejściowego
InputValidation	Opisuje, jakie wartości są prawidłowe dla danych wejściowych subskrypcji
InputValue	Informacje o pojedynczej wartości dla danych wejściowych
InputValues	Informacje o możliwych/dozwolonych wartościach danych wejściowych danej subskrypcji
InputValuesError	Informacje o błędzie związane z wartością wejściową subskrypcji.
ReferenceLinks	Klasa reprezentująca kolekcję linków referencyjnych REST.

ConsumerAction

Definiuje kontrakt danych akcji konsumenta.

Nazwa	Typ	Opis
_links	ReferenceLinks	Łącza referencyjne
allowResourceVersionOverride	boolean	Pobiera lub ustawia flagę wskazującą, czy można zastąpić wersję zasobu podczas tworzenia lub edytowania subskrypcji.
consumerId	string	Pobiera lub ustawia identyfikator odbiorcy, do którego należy ta akcja.
description	string	Pobiera lub ustawia zlokalizowany opis tej akcji.
id	string	Pobiera lub ustawia identyfikator tej akcji.
inputDescriptors	InputDescriptor[]	Pobiera lub ustawia deskryptory wejściowe tej akcji.
name	string	Pobiera lub ustawia zlokalizowaną nazwę tej akcji.
supportedEventTypes	string[]	Pobiera lub ustawia obsługiwane identyfikatory zdarzeń tej akcji.
supportedResourceVersions	object	Pobiera lub ustawia obsługiwane wersje zasobów tej akcji.
url	string	Adres URL dla tego zasobu

InputDataType

Pobiera lub ustawia typ danych w celu zweryfikowania.

Nazwa	Typ	Opis
boolean	string	Reprezentuje wartość true lub false.
guid	string	Reprezentuje identyfikator GUID.
none	string	Nie określono żadnego typu danych.
number	string	Reprezentuje wartość liczbową.
string	string	Reprezentuje wartość tekstową.
uri	string	Reprezentuje identyfikator URI.

InputDescriptor

Opisuje dane wejściowe dla subskrypcji.

Nazwa	Typ	Opis
dependencyInputIds	string[]	Identyfikatory wszystkich danych wejściowych, od których zależy wartość tych danych wejściowych.
description	string	Opis używanych danych wejściowych
groupName	string	Zlokalizowana nazwa grupy, do której należy to dane wejściowe, i może być wyświetlana jako nagłówek kontenera, który będzie zawierać wszystkie dane wejściowe w grupie.
hasDynamicValueInformation	boolean	Jeśli wartość true, informacje o wartości dla tych danych wejściowych są dynamiczne i powinny być pobierane po zmianie wartości danych wejściowych zależności.
id	string	Identyfikator danych wejściowych subskrypcji
inputMode	InputMode	Tryb, w którym należy wprowadzić wartość tego elementu wejściowego
isConfidential	boolean	Pobiera informacje o tym, czy te dane wejściowe są poufne, takie jak hasło lub klucz aplikacji
name	string	Zlokalizowana nazwa, która może być wyświetlana jako etykieta danych wejściowych subskrypcji
properties	object	Właściwości niestandardowe dla danych wejściowych, które mogą być używane przez dostawcę usług
type	string	Podstawowy typ danych dla wartości wejściowej. Po określeniu tej wartości tryb InputMode, walidacja i wartości są opcjonalne.
useInDefaultDescription	boolean	Pobiera informacje o tym, czy te dane wejściowe są uwzględniane w domyślnym opisie wygenerowanej akcji.
validation	InputValidation	Informacje używane do sprawdzania poprawności wartości danych wejściowych
valueHint	string	Wskazówka dotycząca wartości wejściowej. Może być używany w interfejsie użytkownika jako symbol zastępczy danych wejściowych.
values	InputValues	Informacje o możliwych wartościach dla tych danych wejściowych

InputMode

Tryb, w którym należy wprowadzić wartość tego elementu wejściowego

Nazwa	Typ	Opis
checkBox	string	Pole wyboru powinno być wyświetlane (dla wartości true/false)
combo	string	Powinna zostać wyświetlona kontrolka wyboru/kombi
none	string	Te dane wejściowe nie powinny być wyświetlane w interfejsie użytkownika
passwordBox	string	Powinno zostać wyświetlone pole wprowadzania hasła
radioButtons	string	Przyciski radiowe powinny być wyświetlane
textArea	string	Powinien zostać wyświetlony obszar tekstu wielowierszowego
textBox	string	Powinno zostać wyświetlone pole tekstowe wejściowe

InputValidation

Opisuje, jakie wartości są prawidłowe dla danych wejściowych subskrypcji

Nazwa	Typ	Opis
dataType	InputDataType	Pobiera lub ustawia typ danych w celu zweryfikowania.
isRequired	boolean	Pobiera lub ustawia, jeśli jest to pole wymagane.
maxLength	integer	Pobiera lub ustawia maksymalną długość tego deskryptora.
maxValue	string	Pobiera lub ustawia minimalną wartość dla tego deskryptora.
minLength	integer	Pobiera lub ustawia minimalną długość tego deskryptora.
minValue	string	Pobiera lub ustawia minimalną wartość dla tego deskryptora.
pattern	string	Pobiera lub ustawia wzorzec w celu zweryfikowania.
patternMismatchErrorMessage	string	Pobiera lub ustawia błąd w przypadku niezgodności wzorca.

InputValue

Informacje o pojedynczej wartości dla danych wejściowych

Nazwa	Typ	Opis
data	object	Wszelkie inne dane dotyczące tych danych wejściowych
displayValue	string	Tekst do wyświetlenia tej wartości
value	string	Wartość do przechowywania dla tych danych wejściowych

InputValues

Informacje o możliwych/dozwolonych wartościach danych wejściowych danej subskrypcji

Nazwa	Typ	Opis
defaultValue	string	Wartość domyślna do użycia dla tych danych wejściowych
error	InputValuesError	Napotkano błędy podczas obliczania wartości dynamicznych.
inputId	string	Identyfikator danych wejściowych
isDisabled	boolean	Jeśli te dane wejściowe zostaną wyłączone
isLimitedToPossibleValues	boolean	Jeśli wartość powinna być ograniczona do jednej z wartości w parametrze PossibleValues (True) lub są wartościami w parametrze PossibleValues tylko sugestią (Fałsz)
isReadOnly	boolean	Jeśli te dane wejściowe mają być tylko do odczytu
possibleValues	InputValue[]	Możliwe wartości, które mogą przyjmować te dane wejściowe

InputValuesError

Informacje o błędzie związane z wartością wejściową subskrypcji.

Nazwa	Typ	Opis
message	string	Komunikat o błędzie.

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa	Typ	Opis
links	object	Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

Udostępnij za pośrednictwem