-
Total number of requests a user can submit - Web API FAQ (User Documentation) —
20 queued requests per user
-
How to download and install the Web API Python client - Web API FAQ (User Documentation) —
Follow the instructions here: https://pypi.org/project/ecmwf-api-client/
-
Limitations in the Public Datasets web interface - Web API FAQ (User Documentation) —
We have limited the time period selection for retrievals from the Web User Interface (UI), in order to improve the service performance but also to help the users to learn how to submit efficient MARS request
-
In the Public Datasets web interface some boxes are greyed out - Web API FAQ (User Documentation) —
The ECMWF Public Datasets Service is being decommissioned and access to most datasets closed on 1 June 2023. In a final step later this year, access to the remaining multi-model datasets S2S and TIGGE will be migrated to a different system. For more information and possible alternatives, please consult the dedicated page on Decommissioning of ECMWF Public Datasets service.
-
Example for the Public Datasets Web Interface - Web API FAQ (User Documentation) —
The ECMWF Public Datasets Service is being decommissioned and access to most datasets closed on 1 June 2023. In a final step later this year, access to the remaining multi-model datasets S2S and TIGGE will be migrated to a different system. For more information and possible alternatives, please consult the dedicated page on Decommissioning of ECMWF Public Datasets service.
-
How to download Public Datasets from ECMWF - Web API FAQ (User Documentation) —
This interface will help you to navigate through the public datasets in a dynamic and user-friendly way.
-
ERROR 17X (DATASET_PHASED_OUT) - Web API FAQ (User Documentation) —
Problem
ERROR 17X (DATASET_PHASED_OUT)
Status of the request: rejected
-
ecmwf.API error 1: User has no access to services mars - Web API FAQ (User Documentation) —
Problem
ecmwf.API error 1: User has no access to services mars
Solution
-
ERROR 70X (DHS_MOVE_TO_BOLOGNA) - Web API FAQ (User Documentation) —
Problem
ERROR 70 (DHS_MOVE_TO_BOLOGNA)
Status of the request: rejected
-
ERROR 700 DHS move - Web API FAQ (User Documentation) —
Problem
ERROR 700: The public datasets service will not be available during the DHS Move. For more information see https://confluence.ecmwf.int/x/jSKADQ
Status of the request: rejected
-
WARNING: httplib2.URLError received None <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed - Web API FAQ (User Documentation) —
Problem
WARNING: httplib2.URLError received None <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed
Solution
-
How to report a Web API issue - Web API FAQ (User Documentation) —
Please use the ECMWF Support Portal if you have any issue with the system. Problem accessing our products support
When you fill the form, please add the following information:
- Userid or mail address
-
ERROR 193 CAMS datasets migrated to CDS - Web API FAQ (User Documentation) —
Problem
ERROR 193 CAMS datasets migrated to CDS
Status of the request: rejected
-
ERROR 192 ERA 5 migrated to CDS - Web API FAQ (User Documentation) —
Problem
ERROR 192 ERA 5 migrated to CDS
Status of the request: rejected
-
ERROR 9 DATA_NOT_YET_AVAILABLE - Web API FAQ (User Documentation) —
Problem
ERROR 9 DATA_NOT_YET_AVAILABLE
This message will come with something like
-
ERROR 79 MARS_EXPECTED_FIELDS - Web API FAQ (User Documentation) —
Problem
ERROR 79 MARS_EXPECTED_FIELDS
This message will come with something like
-
ERROR 6 MARS_CACHE_CORRUPTION- Web API FAQ (User Documentation) —
Problem
ERROR 6 MARS_CACHE_CORRUPTION
This message will come with something like
-
How to use Python requests to list data from the Access MARS service - Web API FAQ (User Documentation) —
You can list data in the Access MARS service through ECMWF WebAPI using a Python script. This will allow any user with access to MARS to list data. The syntax is
-
HTTP 429: Too Many Requests - Web API FAQ (User Documentation) —
Problem
WARNING: HTTP received
429
{
"message"
:
"API rate limit exceeded."
,
"type"
:
"rate_limit_exceeded"
,
"documentation_url"
:
"https://confluence.ecmwf.int/display/WEBAPI"
}
Error contacting the WebAPI, retrying in
60
seconds ...
Solution
-
How to retrieve data in netCDF format - Web API FAQ (User Documentation) —
- Yes,You only have to add in your request "format" : "netcdf"
-
How to request a limited area region - Web API FAQ (User Documentation) —
Yes,If you have already set the "grid" keyword in your request, you can add the "area" : "coordinates" keyword
-
Using the Python client I have killed my request or the connection was interrupted - Web API FAQ (User Documentation) —
Solution
If you just kill a Web-API request on your local environment (e.g. by CTRL+C), the corresponding job, on the web-API service level, is NOT cancelled but still running.
- Your request will continue to be active in your job list.
-
The Web API flow chart - Web API FAQ (User Documentation) —
Web API python client, request is checked for validity and is visible in API job list.
-
The message download expired appears in my Job List - Web API FAQ (User Documentation) —
In my Job List the target file can not be downloaded, the result column shows "download expired"
Reasons:
If you are using the Web API Python client (Web API Downloads), the client will send a DELETE command to the server once the transfer of the target file has finished successfully. The file should be in your filesystem with the name specified on the 'target' keyword.
-
Differences between the full MARS client and Access MARS service - Web API FAQ (User Documentation) —
Some users might be used to the full MARS client to access MARS. There are some limitations if you use the Access MARS service compared to the full MARS client
-
ERROR 102 (SYSTEM_QUEUED_LIMIT_EXCEEDED) - Web API FAQ (User Documentation) —
Problem
ERROR 102 (SYSTEM_QUEUED_LIMIT_EXCEEDED)
Status of the request: rejected
-
ERROR 3 (or 4 or 5) MARS_RESTRICTED_ACCESS_TO_XXX - Web API FAQ (User Documentation) —
Problem
ERROR 3 (or 4 or 5) MARS_RESTRICTED_ACCESS_TO_XXX
You are trying to access restricted data.
-
-
Error contacting the WebAPI, retrying in 60 seconds - Web API FAQ (User Documentation) —
Problem
Error contacting the WebAPI, retrying in 60 seconds ...
Solution
-
FATAL - Signal 15 received - Web API FAQ (User Documentation) —
Problem
FATAL - Signal 15 received
Internal MARS problem.
-
ERROR 191 C3S Seasonal migrated to CDS - Web API FAQ (User Documentation) —
Problem
ERROR 191 C3S Seasonal migrated to CDS
Status of the request: rejected
-
ecmwf.API error 1: Resource not found: datasets NAME - Web API FAQ (User Documentation) —
Problem
ecmwf.API error 1: Resource not found: datasets/NAME
Solution
-
Assertion failed - Web API FAQ (User Documentation) —
Problem
Error messages starting with Assertion failed: followed by offset[i] > offset[i-1] or handle[n] != 0 hint at an attempt to retrieve the same field more than once, e.g. by specifying param=z/t/z or step=24/48/24. The actual message varies depending on how exactly the data is retrieved.
Solution
-
grib_to_netcdf: "Wrong number of fields... Try using the -T option" - Web API FAQ (User Documentation) —
Problem
grib_to_netcdf: "Wrong number of fields... Try using the -T option"
The request fail when it is trying to convert the GRIB file to netCDF.
-
Failed HPSS call: n = ::hpss_Read(fd_,buffer - Web API FAQ (User Documentation) —
Problem
Messages starting with Failed HPSS call: n = ::hpss_Read(fd_,buffer,... are HPSS errors. The actual message text can vary but they usually mean that the data is unavailable from tapes for some time.
Solution
-
ERROR 15X (DATASET_LIMIT_EXCEEDED) - Web API FAQ (User Documentation) —
Problem
ERROR 15X (DATASET_LIMIT_EXCEEDED)
Status of the request: rejected
-
ecmwf.API error 1: Resource not found: datasets None - Web API FAQ (User Documentation) —
Problem
ecmwf.API error 1: Resource not found: datasets None
Solution
-
How to use the MARS Activity web page - Web API FAQ (User Documentation) —
In MARS activity you can see only the requests that are currently "active" on the Web API level. A "queued" request is not visible in MARS activity
-
ERROR 101 (USER_QUEUED_LIMIT_EXCEEDED) - Web API FAQ (User Documentation) —
Problem
ERROR 101 (USER_QUEUED_LIMIT_EXCEEDED)
Status of the request: rejected
-
WARN - connect : marsxyz 9000 (Connection refused) - Web API FAQ (User Documentation) —
Problem
WARN - connect : marsxyz 9000 (Connection refused)
The application is attempting to connect to one of the MARS archive servers, which is down
-
ERROR 103 (FIELDS_LIMIT_EXCEEDED) - Web API FAQ (User Documentation) —
Problem
ERROR 103 (FIELDS_LIMIT_EXCEEDED)
Status of the request: rejected
-
WARNING: httplib2.URLError received None <urlopen error unknown url type: https> - Web API FAQ (User Documentation) —
Problem
WARNING: httplib2.URLError received None <urlopen error unknown url type: https>
Solution
-
ecmwf.API error 1: Invalid or missing key or token - Web API FAQ (User Documentation) —
Problem
ecmwfapi.api.APIException: u'ecmwf.API error 1: Invalid or missing key or token'
Solution
-
How to organise the output in separate files - Web API FAQ (User Documentation) —
Some applications require the input files separated each on them containing one single parameter or step. This is not the most efficient way to retrieve it from MARS but the solution is very easy.
-
Restricted access to valid data - Web API FAQ (User Documentation) —
Problem
mars - ERROR - 20190507.231202 - Request validation failed: mars - ERROR - 20190507.231202 - restricted access to valid data. mars - ERROR - 20190507.231202 - For more information, look at mars - ERROR - 20190507.231202 - https://confluence.ecmwf.int/display/UDOC/MARS+access+restrictions#valid.
-
Maximum retrieve size G reached. Please split your request - Web API FAQ (User Documentation) —
Problem
Maximum retrieve size XX.XX GB reached. Please split your request.
Solution
-
My request is queued for a long time - Web API FAQ (User Documentation) —
Problem
My requests is queued for a long period of time.
Solution
-
-
Cannot retrieve more than fields in one request via the WebAPI. Please, split your request - Web API FAQ (User Documentation) —
Problem
UserError: Cannot retrieve more than 600,000 fields in one request via the WebAPI. Please, split your request
Solution
-
Web API single request limits - Web API FAQ (User Documentation) —
There are limitations on the total number of fields
-
Fields interpolation - Web API FAQ (User Documentation) —
The transformation and interpolation is done by MARS using a library called MIR.
-
Definition of MARS request - Web API FAQ (User Documentation) —
MARS stands for Meteorological Archive System. MARS is the ECMWF archival system which handles the requests that are submitted externally through the Web-API
-
How to cancel a request - Web API FAQ (User Documentation) —
If you wish to cancel a request please visit your job list and click on the cancel button.
-
How to check your requests - Web API FAQ (User Documentation) —
Your job list can be used for tracing back tour requests.
-
How to write more complex scripts for large sets of data - Web API FAQ (User Documentation) —
You can find some examples here Retrieval efficiency.
Related articles
-
-
How to use Python requests to retrieve data from the Access MARS service - Web API FAQ (User Documentation) —
You can use the Access MARS service through ECMWF WebAPI using a Python script. This will allow any user with access to MARS to retrieve data. The syntax is
-
Data access restrictions - Web API FAQ (User Documentation) —
Yes, you can only access datasets that you have been given access rights to.
-
How to retrieve data using the Web API in Metview - Web API FAQ (User Documentation) —
Metview versions from 4.4.3 onwards have support for the Web API service. More information: Using the MARS Web API from Metview.
-
How to check the content of the archive - Web API FAQ (User Documentation) —
Our archive consists of several Public Datasets and each of them has its own availability.
Licensed and Member State users have access to MARS.
-
-
How to improve the efficiency of my requests - Web API FAQ (User Documentation) —
This is extremely useful if you wish to download large amounts of data. Follow the Guidelines to write efficient MARS requests
-
My first Web API request - Web API FAQ (User Documentation) —
You may start with the examples available on TIGGE sample scripts or by creating your request using our Datasets Web Interface.
-
How to write a Web API request - Web API FAQ (User Documentation) —
Presumably, before you start using Web-API you need to be able to write your own "request" which describes the data you wish to download
-
Total time of a request - Web API FAQ (User Documentation) —
The request may take some time ( from some minutes, to many hours ) to complete, depending on some factors and limitations.