Get File Upload Job Response
Function name:m3ter_GetUploadJobResponse
Category: READ
HTTP method: GET
Destination: m3ter
Get the file upload job response using the UUID of the file upload job.
Part of the file upload service for measurements ingest.
Parameters
Exits
List File Upload Jobs
Function name:m3ter_ListJobs
Category: READ
HTTP method: GET (paginated)
Destination: m3ter
Lists the File Upload jobs. Part of the File Upload service for measurements ingest:
- You can use the
dateCreatedStartanddateCreatedEndoptional Query parameters to define a date range to filter the File Uploads jobs returned for this call. - If
dateCreatedStartanddateCreatedEndQuery parameters are not used, then all File Upload jobs are returned.
Parameters
Exits
Get Original File Download URL
Function name:m3ter_GetJobOriginalFileDownloadUrl
Category: READ
HTTP method: GET
Destination: m3ter
Use the original file upload job id to obtain a download URL, which you can then use to retrieve the file you originally uploaded to the file upload service:
- A download URL is returned together with a download job id.
- You can then use a
GETusing the returned download URL as the endpoint to retrieve the file you originally uploaded.
Parameters
Exits
Generate Upload URL
Function name:m3ter_GenerateUploadUrl
Category: WRITE
HTTP method: POST
Destination: m3ter
Generate a URL for uploading a file containing measurements to the platform in preparation for the measurements it contains to be ingested:
- An upload URL is returned together with an upload job id:
- You can then upload your data measurements file using a
PUTrequest using the returned upload URL as the endpoint. - You can use the returned upload job id with other calls to the File Upload Service for any follow-up or troubleshooting.
- The
contentLengthrequest parameter is required. - The upload URL is time limited - it is valid for one minute.