Stacks

StartUpdateForRefresh

Starts execution of a previously created refresh update. The update must have been created via CreateUpdateForRefresh first. Returns a lease token and version number for tracking the update. Returns 404 if the update does not exist, or 409 if another update is already in progress on the stack.

post/api/stacks/{orgName}/{projectName}/{stackName}/refresh/{updateID}

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/stacks/{orgName}/{projectName}/{stackName}/refresh/{updateID}
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

projectNamestring required

The project name

stackNamestring required

The stack name

updateIDstring required

The update ID

Request body

journalVersioninteger

JournalVersion indicates the maximum journal version the client supports. If 0, journaling is not supported.

tagsobject

Tags contains an updated set of Tags for the stack. If non-nil, will replace the current set of tags associated with the stack.

Response

OK

journalVersioninteger

JournalVersion indicates the maximum version of journal entries that should be sent to the server. Is expected to be less or equal than the JournalVersion we sent in the update request. If 0, journaling is disabled.

tokenstring

Token is the lease token (if any) to be used to authorize operations on this update.

tokenExpirationinteger

TokenExpiration is a UNIX timestamp by which the token will expire.

versioninteger required

Version is the version of the program once the update is complete. (Will be the current, unchanged value for previews.)

Changes

No recorded changes to this operation across all 1 revision of this API.