Delete an Annotation
With this method, you can delete the specified annotation.
The ETag value is mandatory to delete annotation. You must retrieve the ETag value of the annotation using the GET (/ThingConfiguration/v1/Annotations('<annotation name>')) service. The ETag value is assigned to the request header parameter If-Match in the PATCH request. If you do not include the ETag value in the request header or if the ETag value is not correct, the server displays an error message.
Request
URI: /ThingConfiguration/v1/Annotations('<annotation name>')
Operation Type: CRUD
HTTP Method: DELETE
Permissions: <thingconf>.d
Request Headers
| Header | Required | Values |
|---|---|---|
| If-Match | Yes | Latest ETag value of a annotation that is updated using the PATCH request. |
Request Parameters
| Parameter | Required | Data Type | Description |
|---|---|---|---|
| Name | Yes | String | Unique name of the annotation |
Request Example
/ThingConfiguration/v1/Annotations('core.automobiles:Pressure108')Response
Response Status and Error Codes
| Code | Description |
|---|---|
| 204 | Annotation deleted successfully |