Avvia code scan (API Devin)
Avvia un nuovo code scan Devin su un repository di un’organizzazione tramite l’API Enterprise v3, facoltativamente con un profilo di scansione o un commit
Autorizzazioni
UseAccountCodeScans a livello aziendale.
Comportamento
repo_name nell’organizzazione specificata. Il code scan viene avviato in modo asincrono dal dispatcher delle scansioni; la risposta contiene il record del code scan con uno status iniziale di waiting o pending. Esegui il polling di Elencare i code scan per monitorarne l’avanzamento e di Elencare i risultati dei code scan (filtrati per scan_id) per leggere i risultati quando il code scan raggiunge lo stato completed.
Il code scan è attribuito al principal chiamante, ovvero l’utente di servizio o il PAT che ha effettuato la richiesta.
Campi della richiesta
repo_name(obbligatorio): nome completo del repository, ad es.owner/repo. Il repository deve essere già accessibile tramite l’integrazione Git dell’organizzazione.host: host Git del repository, se non può essere dedotto.profile_id: un profilo di scansione da applicare. Usa Avvia scansione di ingestione per i profili in modalitàingest.scan_type: tipo di scansione da eseguire. Deve corrispondere al tipo di scansione del profilo se viene specificatoprofile_id. Per impostazione predefinita, usa il tipo del profilo oppuresecurityper le scansioni senza profilo. I tipi di scansione non di sicurezza richiedono un profilo.commit_sha: commit su cui effettuare il checkout prima della scansione. Per impostazione predefinita, viene usato l’HEAD del branch predefinito del repository.
Errori
400quandoscan_typeè in conflitto con il profilo oppure viene specificato unscan_typenon relativo alla sicurezza senza un profilo.403quando l’organizzazione è limitata alle sole scansioni di ingestione e non viene specificato un profilo in modalitàingest.404quando l’organizzazione, il repository o il profilo non sono visibili all’account Enterprise.409quando il backlog delle scansioni dell’organizzazione ha raggiunto il limite. Riprova più tardi.
Autorizzazioni
Credenziale dell'utente del servizio (prefisso: cog_)
Parametri del percorso
ID dell'organizzazione (prefisso: org-)
"org-abc123def456"
Corpo
Corpo della richiesta per avviare un nuovo code scan.
Nome completo del repository da sottoporre a scansione.
Commit da estrarre prima della scansione.
Host Git del repository, se noto.
Profilo di scansione da applicare alla scansione.
Tipo di scansione da eseguire. Deve corrispondere al tipo di scansione del profilo quando viene fornito un profilo; per impostazione predefinita usa il tipo del profilo oppure 'security' per le scansioni senza profilo. I tipi diversi da security richiedono un profilo e vengono rifiutati senza di esso.
security, performance, db-queries, test-coverage, dead-code, code-quality, telemetry, accessibility, general, migration-docs Risposta
Risposta riuscita
Un singolo code scan.
Momento in cui lo scan è stato creato (secondi Unix).
Host Git della repository, se noto.
Organizzazione a cui appartiene lo scan.
Profilo con cui è stato eseguito lo scan, se presente.
Repository principale dello scan. Gli scan multi-repo coprono repository aggiuntive non elencate qui.
Identificatore univoco dello scan.
Tipo di scansione, definito al momento della creazione.
security, performance, db-queries, test-coverage, dead-code, code-quality, telemetry, accessibility, general, migration-docs Stato dello scan: waiting, pending, running, awaiting_user_input, completed, failed o cancelled.
waiting, pending, running, awaiting_user_input, completed, failed, cancelled 
