Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

edits f Scott

pull/1861/head
Kelly 2020-11-19 11:34:15 -08:00
parent 699773c117
commit f835373730
1 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
content/influxdb/cloud/write-data/delete-data.md
View File

@ -53,28 +53,27 @@ Use the `influx` CLI or the InfluxDB API [`/delete`](/influxdb/v2.0/api/#/paths/
## Delete data using the influx CLI ## Delete data using the influx CLI
{{% note %}} {{% note %}}
If you haven't already, download the [`influx` CLI](/influxdb/cloud/get-started/#optional-download-install-and-use-the-influx-cli). If you haven't already, download and set up the [`influx` CLI](/influxdb/cloud/get-started/#optional-download-install-and-use-the-influx-cli). Following these setup instructions creates a configuration profile that stores your credentials, including your organization and token.
{{% /note %}} {{% /note %}}
1. Use the [`influx delete` command](/influxdb/v2.0/reference/cli/influx/delete/) to delete points from InfluxDB. 1. Use the [`influx delete` command](/influxdb/v2.0/reference/cli/influx/delete/) to delete points from InfluxDB.
2. Specify your organization, bucket, and authentication token. 2. If you set up a configuration profile with your organization and token, specify the bucket (`-b`) to delete from. Otherwise, specify your organization (`-o`), bucket (`-b`), and authentication token (`-t`) with write permissions.
3. Define the time range to delete data from with the `--start` and `--stop` flags. 3. Define the time range to delete data from with the `--start` and `--stop` flags.
4. (Optional) Specify which points to delete using the predicate parameter and [delete predicate syntax](/influxdb/v2.0/reference/syntax/delete-predicate/). 4. (Optional) Specify which points to delete using the predicate parameter and [delete predicate syntax](/influxdb/v2.0/reference/syntax/delete-predicate/).
#### Example #### Example
```sh ```sh
influx delete -o my-org -b my-bucket -t $INFLUX_TOKEN \ influx delete --bucket my-bucket \
 --start '1970-01-01T00:00:00.00Z' \ --start '1970-01-01T00:00:00.00Z' \
 --stop '2020-01-01T00:00:00.00Z' \ --stop '2020-01-01T00:00:00.00Z' \
 --predicate '_measurement="sensors" and sensorID="abc123"'
``` ```
## Delete data using the API ## Delete data using the API
1. Use the InfluxDB API `/delete` endpoint to delete points from InfluxDB. 1. Use the InfluxDB API `/delete` endpoint to delete points from InfluxDB.
2. Include your organization and bucket as query parameters in the request URL. 2. Include your organization and bucket as query parameters in the request URL.
3. Use the `Authorization` header to provide your InfluxDB authentication token. 3. Use the `Authorization` header to provide your InfluxDB authentication token with write permissions.
4. In your request payload, define the time range to delete data from with `start` and `stop`. 4. In your request payload, define the time range to delete data from with `start` and `stop`.
5. (Optional) Specify which points to delete using the `predicate` parameter and [delete predicate syntax](/influxdb/v2.0/reference/syntax/delete-predicate/). 5. (Optional) Specify which points to delete using the `predicate` parameter and [delete predicate syntax](/influxdb/v2.0/reference/syntax/delete-predicate/).
@ -82,11 +81,11 @@ influx delete -o my-org -b my-bucket -t $INFLUX_TOKEN \
```sh ```sh
curl --request POST \ curl --request POST \
https://us-west-2-1.aws.cloud2.influxdata.com/api/v2/delete?orgID=<ORGID> \ https://cloud2.influxdata.com/api/v2/delete?org=<org-name>&bucket=<bucket-name> \
--header 'Authorization: Token <TOKEN WITH WRITE PERMISSIONS' \ --header 'Authorization: Token <INFLUXDB_AUTH_TOKEN>' \
--header 'Content-Type: application/json' \ --header 'Content-Type: application/json' \
--data '{ --data '{
"predicate": "_measurement=\"<MEASUREMENT NAME>\" and _field=\"<FIELD>\"", "predicate": "_measurement=\"example-measurement\" and _field=\"example-field\"",
"start": "2020-08-16T08:00:00Z", "start": "2020-08-16T08:00:00Z",
"stop": "2020-08-17T08:00:00Z" "stop": "2020-08-17T08:00:00Z"
}' }'