Skip to content

engines:delete

Terminal window
rai engines:delete [OPTIONS]

Deletes a RelationalAI (RAI) engine. The CDC engine can only be deleted with the --force flag. Requires the eng_admin application role.

OptionTypeDescription
--nameTextThe name of the engine to delete. If missing, you are prompted to enter the name interactively.
--forceFlagIf set, forces the deletion of the engine. Required to delete the CDC Engine.

Use the engines:delete command to delete a RAI engine:

Terminal window
$ rai engines:delete --name my_engine
---------------------------------------------------
▰▰▰▰ Engine 'my_engine' deleted!
---------------------------------------------------

If no engine named my_engine exists, an error message is displayed:

Terminal window
$ rai engines:delete --name my_engine
---------------------------------------------------
Engine 'my_engine' not found
---------------------------------------------------

If the --name option is missing, you are prompted to select the engine name interactively:

Terminal window
$ rai engines:delete
---------------------------------------------------
▰▰▰▰ Fetched engines
? Select an engine:
┌──────────────────────────────────────────────────┐
│❯ 3/3
│❯ [REFETCH LIST]
my_engine
my_other_engine
└──────────────────────────────────────────────────┘
▰▰▰▰ Engine 'my_engine' deleted!
---------------------------------------------------

Use the up and down arrow keys to navigate the list of engines. You can search for an engine by typing part of its name in the prompt.

The app’s CDC engine cannot be deleted without the --force flag:

Terminal window
$ rai engines:delete --name CDC_MANAGED_ENGINE --force
---------------------------------------------------
▰▰▰▰ Engine 'CDC_MANAGED_ENGINE' deleted!
---------------------------------------------------

See Compute Resources for more information on RAI engines and engine management.