Skip to main content
PATCH
Aggiornare il contenuto e/o la posizione di un blueprint

Autorizzazioni

Richiede un utente di servizio 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 blueprint a livello org o repo.

È possibile fornire qualsiasi sottoinsieme di campi. I campi non impostati restano invariati. Se si fornisce position per un blueprint a livello org, viene restituito 400: solo i blueprint a livello repo hanno una posizione. NON attiva 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.

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