title | description | ms.date | ms.topic | ms.custom |
---|---|---|---|---|
Configuring proxies when using Azure libraries |
Use HTTP[S]_PROXY environment variables to define a proxy for an entire script or app, or use optional named arguments for client constructors or operation methods. |
08/24/2021 |
conceptual |
devx-track-python |
A proxy server URL has of the form http[s]://[username:password@]<ip_address_or_domain>:<port>/
where the username:password combination is optional.
You can then configure a proxy globally by using environment variables, or you can specify a proxy by passing an argument named proxies
to an individual client constructor or operation method.
To configure a proxy globally for your script or app, define HTTP_PROXY
or HTTPS_PROXY
environment variables with the server URL. These variables work any version of the Azure libraries.
These environment variables are ignored if you pass the parameter use_env_settings=False
to a client object constructor or operation method.
:::code language="python" source="~/../python-sdk-docs-examples/proxy/set_http_proxy.py" range="1-7":::
:::code language="cmd" source="~/../python-sdk-docs-examples/proxy/set_proxy.cmd":::
:::code language="bash" source="~/../python-sdk-docs-examples/proxy/set_proxy.sh":::
To configure a proxy for a specific client object or operation method, specify a proxy server with an argument named proxies
.
For example, the following code from the article Example: use Azure storage specifies an HTTPS proxy with user credentials with the BlobClient
constructor. In this case, the object comes from the azure.storage.blob library, which is based on azure.core.
:::code language="python" source="~/../python-sdk-docs-examples/proxy/set_http_proxy.py" range="9-26":::