:original_name: modelarts_03_0114.html

.. _modelarts_03_0114:

Deleting a Development Environment Instance
===========================================

Function
--------

This API is used to delete a development environment instance.

URI
---

DELETE /v1/{project_id}/demanager/instances/{instance_id}

:ref:`Table 1 <modelarts_03_0114__en-us_topic_0136223953_table569625523811>` describes the required parameters.

.. _modelarts_03_0114__en-us_topic_0136223953_table569625523811:

.. table:: **Table 1** Parameter description

   +-------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------+
   | Parameter   | Mandatory | Type   | Description                                                                                                        |
   +=============+===========+========+====================================================================================================================+
   | project_id  | Yes       | String | Project ID. For details about how to obtain the project ID, see :ref:`Obtaining a Project ID <modelarts_03_0147>`. |
   +-------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------+
   | instance_id | Yes       | String | Instance ID                                                                                                        |
   +-------------+-----------+--------+--------------------------------------------------------------------------------------------------------------------+

Request Body
------------

None

Response Body
-------------

:ref:`Table 2 <modelarts_03_0114__en-us_topic_0136223953_table14581542113111>` describes the response parameters.

.. _modelarts_03_0114__en-us_topic_0136223953_table14581542113111:

.. table:: **Table 2** Parameter description

   =========== ====== ===========
   Parameter   Type   Description
   =========== ====== ===========
   instance_id String Instance ID
   =========== ====== ===========

Samples
-------

The following shows how to delete instance **6fa459ea-ee8a-3ca4-894e-db77e160355e**.

-  Sample request

   .. code-block:: text

      DELETE https://endpoint/v1/{project_id}/demanager/instances/6fa459ea-ee8a-3ca4-894e-db77e160355e

-  Successful sample response

   .. code-block::

      {
          "instance_id": "6fa459ea-ee8a-3ca4-894e-db77e160355e"
      }

-  Failed sample response

   .. code-block::

      {
          "error_message": "The instance does not exist.",
          "error_code": "ModelArts.6309"
      }

Status Code
-----------

For details about the status code, see :ref:`Status Code <modelarts_03_0094>`.

Error Codes
-----------

See :ref:`Error Codes <modelarts_03_0095>`.