Subchapter 32.8
references/stopping.mdMarkdown7 KBView on GitHub
Cover this in the DISCLOSE notice, before anything is created — not only when they ask. A founder deciding whether to enable a metered agent needs to know the exit before they take the entrance.
Say all four. A partial answer makes the pause look safer than it is:
A pause turns off what starts work automatically and cancels what is running. It does not stop the user starting an investigation or review themselves, from the console or a coding agent, and that work bills as usual, so never say a pause stops all charges. Setup is preserved, so resuming does not mean starting over. Say both parts — the second is what makes pausing feel safe enough to actually use.
A pause turns off everything that starts a task automatically and cancels the tasks still running. Tell the user each step below, including what they will redo to resume, and wait for their yes before changing anything. Then, in the Agent Space they mean:
Turn off what starts tasks first, then cancel what is running, so nothing starts in between.
list-associations), set the
RELEASE_READINESS_REVIEW and RELEASE_READINESS_REVIEW_AUTOMATED_TESTING capabilities to
enabled: false with update-association, keeping every other field of its configuration. The
repositories stay connected and their filters are kept, so re-enabling restores them.disassociate-service. This removes them from this space only: the registration in the account
stays, so reconnecting needs no new sign-in. Warn the user first that the webhook goes with the
association, so after reconnecting they paste the new webhook URL into that tool again. Keep the AWS
account associations, the repositories and Slack.list-triggers) to Inactive with
update-trigger --status Inactive, and each goal’s evaluation schedule (list-goals) to disabled with
update-goal --evaluation-schedule state=DISABLED.Do not disable the Operator App to pause. It only turns off sign-in to the web app; investigations, reviews and scheduled evaluations keep running and billing.
If a step fails or is denied, say which one and what can still bill. Do not report the pause as done.
An investigation runs 5–8 minutes and bills per second throughout. If a user starts one by mistake, cancel it rather than letting it finish — that is real money, roughly $0.50 per minute.
If the user names the tasks to cancel (by task ID), cancel exactly those. Otherwise, find out what is running before cancelling anything:
For each task, set its status to CANCELED with UpdateBacklogTask, then read it back and confirm the
status changed. Do not assume it stopped:
aws devops-agent update-backlog-task --agent-space-id <id> --task-id <id> --task-status CANCELED --region <region>
aws devops-agent get-backlog-task --agent-space-id <id> --task-id <id> --region <region> --query task.statusDisconnecting the MCP server stops this client from invoking the agent. It does not disable the agent itself — anything scheduled or autonomous inside the Agent Space keeps running and keeps billing.
So when a user says “turn it off,” establish which they mean:
Pausing and removing the MCP config delete neither the Agent Space, the access role, nor investigation records. Remove those only when the user explicitly asks to delete the setup. Rolling back resources applies only to an onboarding the user cancelled before it finished.
Getting this wrong is the expensive direction. If in doubt, do both and say so.
If a bearer token was used and may be exposed:
Rotating preserves the token’s name, scopes, and IP allowlist while invalidating the old value — usually what someone wants when a token has simply aged rather than leaked.
The Operator App is the Agent Space’s web app. disable-operator-app turns off sign-in to it, and nothing
else: investigations, reviews, scheduled evaluations and billing continue. Use it only when the user wants
to remove web app access; to stop spend, pause or delete the Agent Space.
To turn it back on, enable-operator-app needs a role whose trust policy lets aidevops.amazonaws.com
assume it for this Agent Space (aws:SourceArn) with sts:AssumeRole and sts:TagSession. A role
created for another space is rejected.
Do not pause, disable, revoke, or cancel on the user’s behalf without asking — even when it would clearly save them money. Pausing during an active incident could leave them blind at the worst moment.
Surface the cost, recommend the action, and let them decide. The decision is theirs to make.