Hoppa till innehållet
Stackship-dokumentation English

BlueprintsAnvändareMaskinöversatt

API-referens

Alla HTTP-slutpunkter i modulen blueprints: autentisering, IAM-åtgärd, parametrar, innehåll och statuskoder.

Genererad från modulens kod när dess image byggdes — redigera inte. Sökvägarna är relativa till https://api.example.com.

Blueprint Catalog Sources

GET /boundaries/{boundaryId}/resources/blueprints/sources

Repositories this boundary publishes its own blueprints from

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

POST /boundaries/{boundaryId}/resources/blueprints/sources

Register a repository as a private blueprint catalog source

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja

Begärans innehåll: CreateCatalogSourceRequest

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

DELETE /boundaries/{boundaryId}/resources/blueprints/sources/{sourceId}

Remove a catalog source and the blueprints it published

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
sourceId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

PATCH /boundaries/{boundaryId}/resources/blueprints/sources/{sourceId}

Change a catalog source's branch or path, or pause it

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
sourceId sökväg uuid Ja

Begärans innehåll: UpdateCatalogSourceRequest

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

POST /boundaries/{boundaryId}/resources/blueprints/sources/{sourceId}/sync

Pull a catalog source now

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
sourceId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

Blueprint Templates

POST /boundaries/{boundaryId}/resources/blueprints/templates

Create or replace a boundary-scoped blueprint template

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja

Begärans innehåll: TemplateContent

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

POST /boundaries/{boundaryId}/resources/blueprints/templates/validate

Validate a template document without storing it

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg string Ja

Begärans innehåll: TemplateContent

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

DELETE /boundaries/{boundaryId}/resources/blueprints/templates/{slug}

Delete a boundary-scoped blueprint template

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
slug sökväg string Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

Blueprints

POST /boundaries/{boundaryId}/resourcegroups/{resourceGroup}/resources/blueprints/{slug}/deploy

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
resourceGroup sökväg string Ja
slug sökväg string Ja
dryRun frågesträng boolean Nej

Begärans innehåll: DeployBlueprintRequest

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

POST /boundaries/{boundaryId}/resources/blueprints/catalog/refresh

Pull the blueprint catalog from its source now

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg string Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/templates/write på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints/catalog/status

Where the built-in catalog is pulled from, and when it last synced

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg string Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints/config

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg string Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints/deploys

Recent template deploys in this boundary, newest first

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
resourceGroup frågesträng string Nej
take frågesträng integer Nej

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints/deploys/{executionId}

One template deploy and its outcome

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
executionId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

POST /boundaries/{boundaryId}/resources/blueprints/deploys/{executionId}/retry

Queue a failed deploy again, as a new execution

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
executionId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints/{blueprintId}

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
blueprintId sökväg uuid Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

GET /boundaries/{boundaryId}/resources/blueprints/{slug}

  • Autentisering: krävs
  • IAM-åtgärd: blueprints/read — utvärderas på resursen i sökvägen

Parametrar

Namn Plats Typ Obligatorisk
boundaryId sökväg uuid Ja
slug sökväg string Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token
403 Anroparen har inte blueprints/read på det utvärderade omfånget

Docs

GET /docs/blueprints/manifest.json

  • Autentisering: krävs
  • Operationsnamn: DocsManifest_blueprints

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token

GET /docs/blueprints/{path}

  • Autentisering: krävs
  • Operationsnamn: DocsFile_blueprints

Parametrar

Namn Plats Typ Obligatorisk
path sökväg string Ja

Svar

Status Betydelse Innehåll
200 OK
401 Inte inloggad, eller ogiltig token

Övriga slutpunkter

GET /readyz

  • Autentisering: ingen — anonyma anrop accepteras
  • Operationsnamn: StackshipReadiness

Svar

Status Betydelse Innehåll

Scheman

CreateCatalogSourceRequest

Egenskap Typ Kan vara null
installationId string Ja
path string Ja
provider string Ja
ref string Ja
repositoryFullName string Ja
repositoryId string Ja
repositoryUrl string Ja

DeployBlueprintRequest

Egenskap Typ Kan vara null
blueprintId uuid Nej
clusterId uuid Nej
componentOverrides DeployComponentOverride [] Ja
name string Nej
parameters map (string) Nej

DeployComponentOverride

Egenskap Typ Kan vara null
computePlan string Ja
name string Nej
replicas integer Ja

TemplateContent

Egenskap Typ Kan vara null
content string Nej

UpdateCatalogSourceRequest

Egenskap Typ Kan vara null
enabled boolean Ja
path string Ja
ref string Ja