stop a training job by using the DLC command line tool - Platform For AI

You can use the Deep Learning Containers (DLC) client to stop training jobs. This topic describes the details about the command that is used to stop training jobs, including the syntax and the parameters. This topic also provides examples.

The stop command

Feature description
The command is used to stop a job that is running or being created. If you run the stop command on a job that is in the Stopped or Closed state, the system returns a warning.
Syntax
```
./dlc stop job <yourJobId> [--force]
```

Parameter description

Parameter	Required	Description	Type
<yourJobId>	Yes	The ID of the job that you want to stop.	STRING
[--force]	No	If you use this parameter when you stop a job, the job can be stopped without your confirmation. Otherwise, the job is stopped only after your confirmation.	N/A

Examples
- Stop a job that is in the Stopped state. In this example, the job whose ID is dlc14qrqbpo1**** is in the stopped state).
```
./dlc stop job dlc14qrqbpo1****
```
  The system returns a warning similar to the following one:
```
[FAILED] code: 400, Job can't be stopped, because it is Stopped request id: 63C1C116-2DAA-58B0-9E35-E0F9A92BBCE1
```
- Stop a running job. In this example, the job whose ID is dlc14qrqbpo1**** is in the Running state.
```
./dlc stop job dlc14qrqbpo1**** --force
```
  The system returns information similar to the following output:
```
[OK] Job [dlc14qrqbpo1****] was stopped successfully
```