Delete a file from Dynatrace Grail Resource Store with the File API by providing its fully qualified file path in the request body.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/files:delete |
Delete a file from the Grail Resource Store.
ATTENTION - This operation is irreversible.
The request body needs to contain the request parameters (see below) in JSON format.
filePath (required) - The fully qualified file path of the file. Example: /lookups/mydata.To execute this request, you need a platform token or OAuth access token with storage:files:delete scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| body | Resource | Request Details | body | Required |
ResourceDeleteRequest objectRequest Details
| Element | Type | Description | Required |
|---|---|---|---|
| filePath | string | The fully qualified file path of the tabular file to store the lookup data in Grail. | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"filePath": "/lookups/mydata"}
| Code | Type | Description |
|---|---|---|
| 204 | - | The requested file has been deleted successfully. |
| 400 | Error | Bad request for deleting the file. |
| 401 | Error | Unauthorized. |
| 403 | Error | Access forbidden. |
| 404 | Error | The file does not exist. |
| 500 | Error | Internal Server Error |
| 4XX | Error | Client Error |
| 5XX | Error | Server Error |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Exceptional | - |
ExceptionalReturn object| Element | Type | Description |
|---|---|---|
| code | integer | - |
| errorDetails | (Custom | - |
| message | string | - |
CustomValidationErrorInfo objectErrorInfo object| Element | Type | Description |
|---|---|---|
| message | string | - |
InvalidAuditEventsErrorInfo objectMediaTypeErrorInfo objectParameterErrorInfo objectProxyErrorInfo objectQueryFrontendRawErrorInfo objectRequestBodyErrorInfo object{"error": {"code": 400,"message": "File path must not be blank."}}