Updated on 2024-11-06 GMT+08:00

Delete an Instance

Function

This API is used to delete an IoTDA instance with the pay-per-use billing mode.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

DELETE /v5/iot/{project_id}/iotda-instances/{instance_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description: project ID. For details, see Obtaining a Project ID.

instance_id

Yes

String

Parameter description: instance ID. Value: Enter up to 36 characters, including lowercase letters (a-f), digits, and hyphens (-).

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

No

String

Parameter description: user token. You can obtain the token by calling the IAM API Obtaining a User Token Through Password Authentication. In the returned response header, X-Subject-Token is the desired user token. For details about how to obtain the token, see Token Authentication.

Minimum: 0

Maximum: 1024000

Response Parameters

None

Example Requests

Deleting a specified instance.

DELETE https://{endpoint}/v5/iot/{project_id}/iotda-instances/{instance_id}

Example Responses

None

Status Codes

Status Code

Description

204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

Error Codes

See Error Codes.