In environments where HTTP requests must be routed through a forward HTTP proxy, PROC S3 statements fail with error messages similar to the following:
ERROR: Could not list bucket contents.
ERROR: Operation timed out.
You encounter this issue when you run code that is similar to the following:
proc s3;
list "/mybucket";
run;
Click the Hot Fix tab in this note to access the hot fix for this issue.
After you install the hot fix, PROC S3 uses the value of the HTTP_PROXY and HTTPS_PROXY environment variables. If these variables are set, PROC S3 requests are routed through the servers that are specified by these variables.
Examples
The following examples demonstrate how to set the HTTP_PROXY and HTTPS_PROXY environment variables.
On the command line in UNIX, enter code similar to the following:
export HTTPS_PROXY=http://myhost.example.com:8080
In a SAS® program via an OPTIONS statement, enter code similar to the following:
options set=HTTPS_PROXY="http://myhost.example.com:8080";
If credentials are required for accessing the proxy, specify them as shown in the following example:
export HTTPS_PROXY=http://user-name:password@host:port
In most cases, you should set HTTPS_PROXY instead of HTTP_PROXY. Here are some cases that are exceptions to this rule:
- You set NOSSL in the PROC S3 statement.
- You set an SSL value other than True or Yes in the PROC S3 configuration file.
For more information about PROC S3, see the "S3 Procedure" section in Base SAS® 9.4 Procedures Guide, Seventh Edition.
Operating System and Release Information
SAS System | Base SAS | Microsoft® Windows® for x64 | 9.4_M5 | 9.4_M6 | 9.4 TS1M5 | 9.4 TS1M6 |
64-bit Enabled AIX | 9.4_M5 | 9.4_M6 | 9.4 TS1M5 | 9.4 TS1M6 |
64-bit Enabled Solaris | 9.4_M5 | 9.4_M6 | 9.4 TS1M5 | 9.4 TS1M6 |
HP-UX IPF | 9.4_M5 | 9.4_M6 | 9.4 TS1M5 | 9.4 TS1M6 |
Linux for x64 | 9.4_M5 | 9.4_M6 | 9.4 TS1M5 | 9.4 TS1M6 |
Solaris for x64 | 9.4_M5 | 9.4_M6 | 9.4 TS1M5 | 9.4 TS1M6 |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.