Measurements
Get Failed Ingest File Download URL
Returns a presigned download URL for failed ingest file download based on the file path provided.
If a usage data ingest measurement you submit to the m3ter platform fails, an ingest.validation.failure Event is generated. Use this call to obtain a download URL which you can then use to download a file containing details of what went wrong with the attempted usage data measurement ingest, and allowing you to follow-up and resolve the issue.
To obtain the file query parameter:
- Use the List Events call with the ingest.validation.failure for the eventName query parameter.
- The response contains a getDownloadUrl response parameter and this contains the file path you can use to obtain the failed ingest file download URL.
Notes:
- The presigned Url returned to use for failed ingest file download is time-bound and expires after 5 minutes.
- If you make a List Events call for ingest.validation.failure Events in your Organization, then you can perform this GET call using the full URL returned for any ingest failure Event to obtain a failed ingest file download URL for the Event.
get/organizations/{orgId}/measurements/failedIngest/getDownloadUrl
Path parameters
orgIdstring required
UUID of the Organization
Query parameters
filestring
The file path
Response
Returns a presigned URL for failed ingest file download