You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 59e0739
Browse filesBrowse the repository at this point in the historyBrowse files
feat(MARSOHS-1935): list DELETING as a workspace state in the help text
The API has a sixth workspace state, DELETING, shown while a delete runs, and
accepts it as the --state filter. List it in the flag and the list help, say that
a create retried with the key of a workspace being deleted is refused with a
conflict, and that a workspace shows DELETING while its delete runs.
AddStringFlag(cmdList, doctl.ArgAgentWorkspaceState, "", "", "Only list workspaces in this state: AVAILABLE, ATTACHING, ATTACHED, RELEASINGor FAILED")
61
+
AddStringFlag(cmdList, doctl.ArgAgentWorkspaceState, "", "", "Only list workspaces in this state: AVAILABLE, ATTACHING, ATTACHED, RELEASING, FAILED or DELETING")
62
62
AddIntFlag(cmdList, doctl.ArgAgentPageSize, "", 0, "Maximum number of workspaces to return per page")
63
63
AddStringFlag(cmdList, doctl.ArgAgentPageToken, "", "", "Pagination cursor from a previous list response")
64
64
cmdList.Example=`doctl harness-runtime workspace list --page-size 10; doctl harness-runtime workspace list --state AVAILABLE`
Copy file name to clipboardExpand all lines: commands/agents_help.go
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -321,17 +321,17 @@ Create one, then give it to a new session with ` + "`--workspace <id>`" + ` on `
321
321
322
322
constagentsWorkspaceCreateHelpMD=`Create a persistent workspace. `+"`--size-gib`"+` is required: a whole number from 1 to 100, and your team's limit may be lower. The size cannot be changed later. `+"`--name`"+` is an optional label and is not unique.
323
323
324
-
**Safe to retry.** Each run sends one idempotency key, so a request that doctl repeats within the run cannot create a second workspace. doctl makes up a key unless you pass `+"`--idempotency-key`"+`. A script that re-runs the whole command must pass its own key: without one, every run is a new workspace. Within 24 hours the same key with the same size and name returns the first workspace; the same key with different values is rejected.`
324
+
**Safe to retry.** Each run sends one idempotency key, so a request that doctl repeats within the run cannot create a second workspace. doctl makes up a key unless you pass `+"`--idempotency-key`"+`. A script that re-runs the whole command must pass its own key: without one, every run is a new workspace. Within 24 hours the same key with the same size and name returns the first workspace; the same key with different values is rejected. If the workspace that key created is being deleted, the retry is refused with a conflict; try again in a moment and the key then creates a new workspace.`
325
325
326
-
constagentsWorkspaceListHelpMD=`List persistent workspaces, newest first. Show only one state with `+"`--state`"+` (AVAILABLE, ATTACHING, ATTACHED, RELEASINGor FAILED); use `+"`--state AVAILABLE`"+` to see the workspaces a new session can use. Paginate with `+"`--page-size`"+` and `+"`--page-token`"+`.
326
+
constagentsWorkspaceListHelpMD=`List persistent workspaces, newest first. Show only one state with `+"`--state`"+` (AVAILABLE, ATTACHING, ATTACHED, RELEASING, FAILED or DELETING); use `+"`--state AVAILABLE`"+` to see the workspaces a new session can use. Paginate with `+"`--page-size`"+` and `+"`--page-token`"+`.
327
327
328
328
A page can hold fewer workspaces than `+"`--page-size`"+`, even none, while a next page token is printed. Keep listing with that token until none is printed.`
329
329
330
330
constagentsWorkspaceGetHelpMD=`Print details for one persistent workspace: its state, size, how much is used, the session that holds it, and when it was last saved.`
331
331
332
332
constagentsWorkspaceDeleteHelpMD=`Permanently delete a persistent workspace and everything saved in it. This cannot be undone. Asks for confirmation unless `+"`--force`"+` is given.
333
333
334
-
A workspace a session still holds cannot be deleted: remove the session, wait until the workspace is available again, then delete it. Removing a session never deletes its workspace.`
334
+
A workspace a session still holds cannot be deleted: remove the session, wait until the workspace is available again, then delete it. Removing a session never deletes its workspace. A workspace shows DELETING while its delete runs; once it finishes, the workspace no longer exists.`
335
335
336
336
constagentsTriggersRootHelpMD=`Webhook and cron triggers that start agent runs on external events or a schedule.
0 commit comments