Skip to main content
PATCH
Aggiorna il contenuto, la posizione, la sorgente e/o le impostazioni di build al commit di un modello

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageRepoBlueprints a livello di organizzazione. Per creare o aggiornare blueprint a livello org è necessaria l’autorizzazione ManageOrgSnapshots.

Comportamento

Aggiorna il contenuto e/o la posizione di un blueprint. Non avvia automaticamente una build.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

blueprint_id
string
obbligatorio
org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json

Aggiornamento parziale per un modello a livello org o repo.

È possibile fornire qualsiasi sottoinsieme di campi. I campi non impostati restano invariati. Se si fornisce position, source o un'impostazione di build dei commit per un modello a livello org, viene restituito 400 — solo i modelli di livello repo hanno questi campi. NON attiva una build.

build_on_default_branch_commit
boolean | null

Se impostato, attiva o disattiva la build dell'ambiente a ogni push sul branch predefinito. Accettato solo nel modello radice di un repo github.com. Ogni push di questo tipo mette in coda una build.

contents
string | null

Se impostato, sostituisce il corpo YAML del blueprint con una nuova versione.

position
integer | null

Se impostato, aggiorna la posizione di esecuzione di questo blueprint di livello repo. Le posizioni non devono essere necessariamente univoche; in caso di parità, il server le risolve arbitrariamente durante l'ordinamento per l'esecuzione.

report_check_runs
boolean | null

Se impostato, attiva o disattiva la segnalazione della build di ogni commit come run di un controllo GitHub. Per abilitarla, 'build_on_default_branch_commit' deve essere attivo.

source
enum<string> | null

Se impostato, cambia la sorgente del blueprint del repo. È accettato solo per il blueprint radice del repo (i blueprint con ambito specifico la ereditano). 'git' recupera .devin/blueprint.yaml dal branch predefinito (404 se assente) e non può essere combinato con 'contents'; 'database' mantiene lo YAML corrente (o 'contents', se fornito) e interrompe la sincronizzazione dal repo. Non ha alcun effetto se il blueprint è già in quella modalità.

Opzioni disponibili:
git,
database

Risposta

Risposta riuscita

Forma pubblica della risorsa Blueprint.

Note: l'enum type potrebbe estendersi in futuro; i client DEVONO gestire correttamente i valori sconosciuti. Il contenuto YAML viene recuperato separatamente tramite GET /blueprints/{id}/contents.

blueprint_id
string
obbligatorio
created_at
integer
obbligatorio
repo_name
string | null
obbligatorio
type
enum<string>
obbligatorio
Opzioni disponibili:
enterprise,
org,
repo
updated_at
integer
obbligatorio
build_on_default_branch_commit
boolean | null

Indica se ogni push al branch predefinito del repo avvia la build dell'ambiente. null se non si tratta del modello radice di un repo.

report_check_runs
boolean | null

Indica se ogni build di un commit viene riportata sul commit come run di un controllo GitHub. null se non si tratta del modello radice di un repo.

source
enum<string> | null

Dove viene creato il file YAML: 'git' (sincronizzato da .devin/blueprint.yaml nel repository) o 'database' (modificato tramite API/interfaccia utente). Sempre null per i blueprint a livello enterprise e org.

Opzioni disponibili:
git,
database