Table of Contents | ||
---|---|---|
|
Introduction
Main steps
Info | ||
---|---|---|
| ||
|
How to report a problem
Info | ||
---|---|---|
| ||
Who to contact: servicedesk@ecmwf.int What information you will need to pass:
Where to find this information:
|
Your job list
Info | |||||
---|---|---|---|---|---|
| |||||
|
1. General issues
Info |
---|
Browse our online Web-API FAQ for help with common user questions. |
1.1 long running request
Info | |||||||
---|---|---|---|---|---|---|---|
|
1.2 aborted request
Info |
---|
|
1.3 restricted access to valid data
Code Block | ||
---|---|---|
| ||
'mars - ERROR - 20160712.064620 - Request validation failed:', 'mars - ERROR - 20160712.064620 - restricted access to valid data.', 'mars - ERROR - 20160712.064620 - For more information, look at ', 'mars - ERROR - 20160712.064620 - https://software.ecmwf.int/wiki/display/UDOC/MARS+access+restrictions#valid.', 'mars - ERROR - 20160712.064620 - For any queries, please, contact User Support', 'mars - ERROR - 20160712.064620 - Some errors reported', |
...
Info |
---|
|
1.4 Cannot retrieve more than XXX.XXX fields in one request via the WebAPI. Please, split your request
Code Block | ||
---|---|---|
| ||
mars - ERROR - 20160712.133205 - UserError: Cannot retrieve more than XXX.XXX fields in one request via the WebAPI. Please, split your request [marsode] mars - ERROR - 20160712.133205 - Error code is -2 mars - ERROR - 20160712.133205 - Request failed mars - INFO - 20160712.133205 - Request time: wall: 1 sec mars - ERROR - 20160712.133205 - Some errors reported |
...
Info |
---|
|
1.5 ecmwfapi.api.APIException: u'ecmwf.API error 1: TaskError: Maximum retrieve size XX.XX GB reached. Please split your request.'
Info |
---|
|
2. HTTP status issues
2.1 HTTP Error 404: NOT FOUND
2.1.1 Resource not found: datasets/None'
Info |
---|
if you are using the Access ECMWF Public Datasets service and you get this error it means that the mandatory keyword "dataset" is not set. Review the request and add this keyword. If you are an authorized user with MARS access you can use WebAPI FAQ#Can I use the Python requests to retrieve data using API MARS service? |
2.1.2 Resource not found: datasets/interim_daily or Resource not found: datasets/interim_full
Info |
---|
The datasets |
2.2 HTTP Error 403: FORBIDDEN
2.2.1 ecmwfapi.api.APIException: u"ecmwf.API error 1: User '...' has no access to services/mars"
Info |
---|
|
2.3 HTTP 429 errors
2.3.1 HTTP 429: Too Many Requests
Info | ||
---|---|---|
Reason: The rate limit of the http requests on the API service has been exceeded. Current limit: 10 http requests/sec Action: Please try again after 1 minute.
|
2.4 HTTP Error 5xx
Info |
---|
Please check the ECMWF Service Status before reporting the problem If the WEB-SERVICES status is green, it might be an Internal ECMWF server issue. Please report the problem |
3. Web-API issues
3.1 Invalid or missing key or token
Make sure you get a valid key from https://api.ecmwf.int/v1/key/. The file in $HOME/.ecmwfapirc
should contain something like:
...
Including the curly brackets.
3.2 Python issues
3.2.1 ECMWF API at None
3.2.1.1 ValueError: unknown url type: None/who-am-i?offset=0&limit=500
Info |
---|
|
3.2.1.2 WARNING: httplib2.URLError received None <urlopen error unknown url type: https>
Info | |||||
---|---|---|---|---|---|
Access to ECMWF servers is done over HTTPS. Your Python version does not support SSL (Secure Socket Layer) used by HTTPS. To verify if SSL is enabled in your python , try the following:
|
3.2.1.3 WARNING: httplib2.URLError received None <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed
Info | |||||||
---|---|---|---|---|---|---|---|
Symptoms: A Python WebAPI script terminates with "Error contacting the WebAPI, retrying in 60 seconds ...". The WebAPI retries 10 times, followed by "WARNING: httplib2.URLError received None <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed" The problem may be that the SSL library used in this Python version doesn't look in the correct certificate path.
Here we can see QuoVadis Root CA 2 G3 is the Root CA for api.ecmwf.int and can be downloaded from https://www.quovadisglobal.com/QVRepository/DownloadRootsAndCRL.aspx and installed locally (as per the commands specified above on the specific OS). If you have the SSL error in the last step of your request (Transferring from...), you need to install the Root CA for "stream.ecmwf.int": QuoVadis Global SSL ICA G2
|
3.2.2 Python socket module was not compiled with SSL support. Aborting...
Info |
---|
Access to ECMWF servers is done over HTTPS. Your Python version does not support HTTPS. See above on how to check the ssl support in Python. |
3.2.3 assert total == size AssertionError or "Transfer interrupted, retrying..."
Info |
---|
This means that the Web API client script failed to transfer the data from the ECMWF servers to your local machine. The reasons can be:
|
3.3 Perl issues
Can't connect to ... (certificate verify failed) or LWP::Protocol::https::Socket: SSL connect attempt failed with unknown error
Try to set the environment variable PERL_LWP_SSL_VERIFY_HOSTNAME
to 0
:
...
Code Block | ||
---|---|---|
| ||
BEGIN { $ENV{"PERL_LWP_SSL_VERIFY_HOSTNAME"} = 0; } |
3.4 Other
3.4.1 ERROR 101 (USER_QUEUED_LIMIT_EXCEEDED)
Info |
---|
Status: rejected Reason: The total Nr of queued requests per user, allowed, on the API service has been exceeded Current limit: 20 queued requests per user Action: Please limit the Nr of your queued requests and try later |
3.4.2 ERROR 102 (SYSTEM_QUEUED_LIMIT_EXCEEDED)
Info |
---|
Status: rejected Reason: The total Nr of queued requests in the API service has been exceeded. Presumably the API service is currently busy. Please accept our apologies for any inconvenience this may cause. Current limit: 2000 requests in total Action: try later you may also wish to check the Web-API activity |
3.4.3 ERROR 103 (ERA5_QUEUED_LIMIT_EXCEEDED)
Info |
---|
Status: rejected Reason: The total Nr of queued requests for the C3S ERA 5, in the API service has been exceeded. Current limit: 4 queued requests per user for C3S ERA 5 Action: ERA 5 is now available via the CDS, see how to migrate your scripts C3S ERA5: Web API to CDS API |
3.4.4 ERROR 103 (FIELDS_LIMIT_EXCEEDED)
Info |
---|
Status: rejected Reason: The Nr of fields per request has been exceeded. Current limit: 600.000 fields per request. Action: Split your request |
3.4.5 ERROR 15X (DATASET_LIMIT_EXCEEDED)
Info |
---|
Status: rejected Reason: The allowed Nr of requests, per user for this dataset has been exceeded. Action: Please limit the Nr of your queued requests for this dataset and try later |
3.4.6 ERROR 17X (DATASET_PHASED_OUT)
Info |
---|
Status: rejected Reason:This dataset has been phased out and it is not any more available from our services. It is likely that the dataset has been superseded by a new dataset which is currently available. Action: See the corresponding link for more details or contact us. |
3.4.7 ERROR 19X
Info |
---|
Status: rejected Reason: The dataset is not any more available via the ECMWF public datasets. It has been either migrated to another service or phased-out etc Action: see below |
3.4.7.1 ERROR 191 C3S Seasonal migrated to CDS
Info |
---|
Status: rejected Reason: The dataset has been migrated to Copernicus Climate Data Store (CDS) Action: Please migrate your scripts to the new service. |
3.4.7.2 ERROR 192 ERA 5 migrated to CDS
Info |
---|
Status: rejected Reason: The dataset has been migrated to Copernicus Climate Data Store (CDS) Action: Please migrate your scripts to the new service. |
3.4.7.3 ERROR 199 Dataset phased out
Info |
---|
Status: rejected Reason: The dataset has been phased out. In most cases a phased out datasets has been superseded by another dataset. Action: We encourage users to have a look on the project documentation. Contact servicedesk@ecmwf.int if you have any further questions. |
4. ecCodes issues
grib_to_netcdf: Why do I get the error "Wrong number of fields... Try using the -T option"?
Info |
---|
5. MARS issues
General MARS Troubleshooting
Info |
---|
|
5.1 MARS messages
Info | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
5.2 mars - WARN - 20130522.082222 - connect : marsxyz 9000 (Connection refused)
Info |
---|
|
5.3 mars - FATAL - 20160712.162606 - Signal 15 received
Info |
---|
|
5.4 ERROR 1 MARS_REQUEST_TOO_LARGE
Info |
---|
|
5.5 ERROR 2 MARS_TOO_MANY_FIELDS
Info |
---|
|
5.6 ERROR 3 (or 4 or 5) MARS_RESTRICTED_ACCESS_TO_XXX
Info |
---|
|
5.7 ERROR 6 MARS_EXPECTED_FIELDS
Info |
---|
|
5.8 UserError: ERA5 1979-1999 will only be available via the Copernicus Climate Data Store
Info |
---|
|
5.9 ERROR 99
Info |
---|
For any other MARS problem you can visit the MARS Trouble-shooting |
5.10 Assertion issues
Info |
---|
The problem is that you repeat some MARS keyword values see also https://confluence.ecmwf.int/display/UDOC/Retrieve#Retrieve-Assertionfailed |
5.11 Failed HPSS call
Info |
---|
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. see also |
...