Zum Hauptinhalt springen
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

Anmeldedaten für Service-Benutzer (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Abfrageparameter

security_profile_id
string | null

Bezieht default_net_policy und security_profile für einen Erstellungsvorgang, bei dem security_profile.profile_id auf dieses Profil gesetzt wird. Erfordert die Berechtigung zur Verwaltung von Sicherheitsprofilen.

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.

update_semantics
string
erforderlich

Für diese Organisation aktive PATCH-Semantik: 'replace_groups' (eine in der Anfrage vorhandene 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 Werte; Listenmitgliedschaften werden 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). Offene Enumeration — Clients müssen neue Werte unterstützen.

sources
Sources · object
erforderlich

Ereignisquelle → Ereignisname → Schema.

skills_serve_playbooks
boolean
Standard:false

Gibt an, ob dieses Konto Fähigkeiten anstelle von Playbooks verwendet.

security_profile
AutomationSchemasSecurityProfile · object | null

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

available_devin_modes
enum<string>[]

Modi, die session_settings.devin_mode aktuell bei einer neuen Auswahl unter der Automatisierungsidentität der Organisation akzeptiert: die stabilen Modi, die diese Identität starten kann, sowie die Research Previews, sofern der Preview-Rollout der Organisation dies zulässt. Ein gespeicherter Modus außerhalb dieser Liste bleibt bei Änderungen erhalten, die diesen Modus nicht betreffen.

Verfügbare Optionen:
normal,
fast,
lite,
ultra,
fusion,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
default_fallback_devin_mode
enum<string> | null

Stabiler Modus, mit dem session_settings.fallback_devin_mode bei Auswahl einer Research Preview vorbelegt wird: der Standardmodus der Organisation, sofern er stabil und verfügbar ist, andernfalls der erste verfügbare stabile Modus; null, wenn keiner verfügbar ist.

Verfügbare Optionen:
normal,
fast,
lite,
ultra,
fusion,
fast-ultra
script_check_available
boolean
Standard:false

Gibt an, ob diese Organisation einen skriptbasierten Preflight-Check konfigurieren kann (Rollout von automation-code-step). Bei false wird das Feld script_check mit dem Statuscode 403 abgelehnt.