modelarts-umn/api-ref/source/devenviron/managing_a_development_environment_instance.rst

Managing a Development Environment Instance

Function

This API is used to startor stop a notebook instance.

URI

POST /v1/{project_id}/demanager/instances/{instance_id}/action

Table 1 describes the required parameters.

Table 1 Parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID and Name.
instance_id	Yes	String	Instance ID

Request Body

Table 2 describes the request parameters.

Table 2 Parameters

Parameter	Mandatory	Type	Description
action	Yes	String	Operation on a development environment instance. The options are as follows: start stop

Response Body

Table 3 describes the response parameters.

Table 3 Parameters

Parameter	Type	Description
current_status	String	Current status of an instance
previous_state	String	Previous status of an instance

Samples

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

• Sample request

  {
      "action": "start"
  }

• Successful sample response

  {
      "current_status": "STARTING",
      "previous_state": "STOPPED"
  }

• Failed sample response

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

Status Code

For details about the status code, see Status Code.