Skip to main content
GET
Ereignisschemas für Automatisierungen abrufen

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ViewOrgAutomations auf Organisationsebene.

Verwendung

Rufen Sie diesen Endpunkt auf, bevor Sie Automatisierungen erstellen: Er gibt alle unterstützten Trigger-Ereignistypen (nach Quelle und anschließend nach Ereignisname gruppiert) mit ihren Payload-Feldern, den von ihren Bedingungen unterstützten Operatoren und den gültigen replies-Verben zurück. So können Sie gültige triggers für die Endpunkte zum Erstellen und Aktualisieren erstellen. Quellen, die für die Organization nicht aktiviert sind, werden nicht berücksichtigt.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Abfrageparameter

security_profile_id
string | null

default_net_policy und security_profile für einen Erstellungsvorgang beziehen, der security_profile.profile_id auf dieses Profil setzt. Erfordert die Berechtigung zur Verwaltung von Security Profiles.

Antwort

Erfolgreiche Antwort

default_net_policy
AutomationNetPolicy · object | null
erforderlich

Netzwerkrichtlinie, die Clients als Ausgangspunkt für neue Automatisierungen verwenden sollten: die auf Git Manager beschränkte Richtlinie der Bereitstellung (nur die für die Aufgabe erforderlichen Ziele hinzufügen) oder null, wenn das maßgebliche Security Profile (siehe security_profile) eine Netzwerkrichtlinie hat. In diesem Fall verwenden Sitzungen die Richtlinie des Profils; session_settings.net_policy weglassen, sofern die Aufgabe keine weiteren Einschränkungen erfordert.

sources
Sources · object
erforderlich

Ereignisquelle → Ereignisname → Schema.

update_semantics
string
erforderlich

Für diese Organisation aktive PATCH-Semantik: 'replace_groups' (eine in der Anfrage enthaltene Konfigurationsgruppe ersetzt die gespeicherte Gruppe vollständig) oder 'merge_patch' (RFC 7396 für Objekte: Nicht angegebene Mitglieder einer vorhandenen Gruppe behalten ihre gespeicherten Werte, explizite null-Werte löschen sie; die Listenmitgliedschaft wird weiterhin vollständig ersetzt – zum Löschen wird die Liste ohne das Element erneut gesendet –, aber jedes gesendete Element wird mit dem gespeicherten Element desselben Typs zusammengeführt, wenn dieser Typ auf beiden Seiten genau einmal vorkommt; wiederholte Typen müssen vollständig erneut angegeben werden). Offenes Enum – Clients müssen neue Werte tolerieren.

security_profile
AutomationSchemasSecurityProfile · object | null

Security Profile, das für die Automatisierungssitzungen dieser Organisation gilt, oder null, wenn keines gilt.