terminate
*********


Description
===========

Terminates the specified instance. Any attached VNICs and volumes are
automatically detached when the instance terminates.

To preserve the boot volume associated with the instance, specify
*true* for *PreserveBootVolumeQueryParam*. To delete the boot volume
when the instance is deleted, specify *false* or do not specify a
value for *PreserveBootVolumeQueryParam*.

This is an asynchronous operation. The instance's *lifecycleState*
will change to TERMINATING temporarily until the instance is
completely removed.


Usage
=====

   oci compute instance terminate [OPTIONS]


Options
=======


--instance-id [text]
--------------------

The OCID of the instance. [required]


--if-match [text]
-----------------

For optimistic concurrency control. In the PUT or DELETE call for a
resource, set the *if-match* parameter to the value of the etag from a
previous GET or POST response for that resource.  The resource will be
updated or deleted only if the etag you provide matches the resource's
current etag value.


--preserve-boot-volume [boolean]
--------------------------------

Specifies whether to delete or preserve the boot volume when
terminating an instance. The default value is false.


--force
-------

Perform deletion without prompting for confirmation.


--wait-for-state [PROVISIONING|RUNNING|STARTING|STOPPING|STOPPED|CREATING_IMAGE|TERMINATING|TERMINATED]
-------------------------------------------------------------------------------------------------------

This operation creates, modifies or deletes a resource that has a
defined lifecycle state. Specify this option to perform the action and
then wait until the resource reaches a given lifecycle state.


--max-wait-seconds [integer]
----------------------------

The maximum time to wait for the resource to reach the lifecycle state
defined by --wait-for-state. Defaults to 1200 seconds.


--wait-interval-seconds [integer]
---------------------------------

Check every --wait-interval-seconds to see whether the resource to see
if it has reached the lifecycle state defined by --wait-for-state.
Defaults to 30 seconds.


--from-json [text]
------------------

Provide input to this command as a JSON document from a file.

Options can still be provided on the command line. If an option exists
in both the JSON document and the command line then the command line
specified value will be used


-?, -h, --help
--------------

Show this message and exit.
