vulns.co
/
GKData.io MCP and API Buy me a coffee

Google

Google long-running operations: cancellation requests and completion evidence

Requesting cancellation does not prove that a long-running operation stopped, and a wait response may still report unfinished work. Google's approved guidance separates failures before execution from failures during it. The linked Operation contract also distinguishes best-effort cancellation, final outcomes and deletion of the resource used to track the work.

Open the referenceImplementation GuideReviewed 2026-10-04

How to use this reference

Editorial synthesis: distinguish what the client requested, what the service acknowledged, the operation's final outcome and any effects already committed. Do not mark an action as reversed or release a reserved entitlement just because cancellation was requested. Define what evidence is needed to establish the service's final outcome and account for changes already made.

Before reading

  • Basic asynchronous API and application state-machine concepts

Context and limits

  • The linked contract says successful cancellation retains the operation with a CANCELLED error. Deleting the operation expresses disinterest in its result and does not cancel execution.
  • The done field marks completion, not success; the outcome can be failure or cancellation. Some services may omit result data, so missing results must not be treated as proof of success.
  • Neither reviewed source guarantees rollback of prior effects or specifies a universal authorization policy for reading, cancelling or deleting operations. Authorization is therefore not assigned as a topic.
  • The 2025-02-04 changelog entry was committed on 2025-02-07. These maintenance signals and the 2019-07-25 page headers are distinct from publication or edition-release dates.
  • These are Google API contracts and design guidance, not universal asynchronous-API guarantees, an implementation audit, vulnerability claim, bounty evidence or testing authorization.

Sources

  1. AIP-151: Long-running operationsGoogle · reviewed 2026-10-04
  2. Google long-running operation contract at reviewed revisionGoogle · reviewed 2026-10-04
  3. AIP-151 error-propagation clarification commitGoogle AIP project · reviewed 2026-10-04

Record reviewed 2026-10-04. Snapshot af2809c308fc. Open the complete JSON contract.

Library synced 2026-11-18 · cases last reviewed 2026-10-05

af2809c308fc · JSON exports & schemas · CC BY 4.0 content / MIT software