Skip to main content
GET
Recupera gli schemi degli eventi di automazione

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ViewOrgAutomations a livello dell’organizzazione.

Utilizzo

Chiama questo endpoint prima di creare automazioni: restituisce tutti i tipi di eventi trigger supportati (raggruppati prima per sorgente, poi per nome dell’evento), con i relativi campi payload, gli operatori supportati dalle condizioni e i verbi replies validi. In questo modo puoi costruire triggers validi per gli endpoint di creazione e aggiornamento. Le sorgenti non abilitate per l’organizzazione vengono omesse.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Parametri della query

security_profile_id
string | null

Determina default_net_policy e security_profile per un'operazione di creazione che imposta security_profile.profile_id sull'ID di questo profilo. Richiede l'autorizzazione per la gestione dei profili di sicurezza.

Risposta

Risposta riuscita

default_net_policy
AutomationNetPolicy · object | null
obbligatorio

Policy di rete che i client devono usare come base per le nuove automazioni: la policy della distribuzione che consente solo Git Manager (aggiungere solo le destinazioni necessarie per l'attività), oppure null quando il profilo di sicurezza applicabile (vedere security_profile) ha una policy di rete. In tal caso, le sessioni usano la policy del profilo; omettere session_settings.net_policy a meno che l'attività non richieda ulteriori restrizioni.

sources
Sources · object
obbligatorio

Sorgente dell'evento → nome dell'evento → schema.

update_semantics
string
obbligatorio

Semantica PATCH attiva per questa organizzazione: 'replace_groups' (un gruppo di configurazione presente nella richiesta sostituisce interamente il gruppo memorizzato) o 'merge_patch' (RFC 7396 per gli oggetti: i membri omessi di un gruppo presente mantengono i valori memorizzati, i valori null espliciti cancellano; l'appartenenza a una lista viene comunque sostituita interamente — per eliminare un elemento, reinviare la lista senza quell'elemento — ma ogni elemento inviato viene unito all'elemento memorizzato dello stesso tipo quando tale tipo compare esattamente una volta su entrambi i lati; i tipi ripetuti devono essere ridefiniti completamente). Enum aperta: i client devono tollerare nuovi valori.

security_profile
AutomationSchemasSecurityProfile · object | null

Profilo di sicurezza che regola le sessioni di automazione di questa organizzazione, oppure null se non si applica alcun profilo.