Vai al contenuto principale
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.

available_devin_modes
enum<string>[]

Modalità attualmente accettate da session_settings.devin_mode per una nuova selezione con l'identità di automazione dell'organizzazione: le modalità stabili che questa identità può avviare e, quando il rollout delle anteprime dell'organizzazione lo consente, le Research Preview. Una modalità memorizzata che non rientra in questo elenco viene mantenuta se le modifiche non la riguardano.

Opzioni disponibili:
normal,
fast,
lite,
ultra,
fusion,
swe-2-medium,
swe-2-high,
swe-2-max
default_fallback_devin_mode
enum<string> | null

Modalità stabile con cui precompilare session_settings.fallback_devin_mode quando viene selezionata una Research Preview: la modalità predefinita dell'organizzazione, se stabile e disponibile, altrimenti la prima modalità stabile disponibile; null se non ne è disponibile nessuna.

Opzioni disponibili:
normal,
fast,
lite,
ultra,
fusion
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.