Zum Hauptinhalt springen
PATCH
Den Inhalt und/oder die Position eines Blueprints aktualisieren

Berechtigungen

Erforderlich ist ein Service-Benutzer mit der Berechtigung ManageRepoBlueprints auf Organisationsebene. Zum Erstellen oder Aktualisieren von Blueprints auf Org-Ebene ist die Berechtigung ManageOrgSnapshots erforderlich.

Verhalten

Aktualisiert den Inhalt und/oder die Position eines Blueprints. Ein Build wird nicht automatisch ausgelöst.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

blueprint_id
string
erforderlich
org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json

Partielle Aktualisierung für ein Blueprint auf Org- oder Repo-Ebene.

Es kann jede beliebige Teilmenge von Feldern angegeben werden. Nicht gesetzte Felder bleiben unverändert. Wenn position bei einem Blueprint auf Org-Ebene angegeben wird, wird 400 zurückgegeben — nur Blueprints auf Repo-Ebene haben eine Position. Löst KEINEN Build aus.

contents
string | null

Wenn gesetzt, ersetzt dies den YAML-Body des Blueprints durch eine neue Version.

position
integer | null

Wenn gesetzt, aktualisiert dies die Ausführungsposition dieses Blueprints auf Repo-Ebene. Positionen müssen nicht eindeutig sein; Gleichstände werden beim Sortieren für die Ausführung vom Server beliebig aufgelöst.

Antwort

Erfolgreiche Antwort

Öffentliches Ressourcenformat für Blueprint.

Hinweis: Das Enum type kann in Zukunft erweitert werden; Clients MÜSSEN unbekannte Werte robust verarbeiten. Der YAML-Inhalt wird separat über GET /blueprints/{id}/contents abgerufen.

blueprint_id
string
erforderlich
created_at
integer
erforderlich
repo_name
string | null
erforderlich
type
enum<string>
erforderlich
Verfügbare Optionen:
enterprise,
org,
repo
updated_at
integer
erforderlich