# virt.instance.stop

Stop an instance.

Timeout is how long it should wait for the instance to shutdown cleanly.

This method is a job.

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: id

#### id

Type: string

##### Parameter 2: stop_args

#### stop_args

Type: object Default: {"timeout": -1, "force": false}
No Additional Properties

##

#### Timeout

Type: integer Default: -1

##

#### Force

Type: boolean Default: false

##

#### Result

Type: boolean

Required roles: VIRT_INSTANCE_WRITE