Skip to content

Latest commit

 

History

History
43 lines (25 loc) · 1.95 KB

azure-sdk-configure-proxy.md

File metadata and controls

43 lines (25 loc) · 1.95 KB
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

How to configure proxies for the Azure libraries

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.

Global configuration

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.

From Python code

:::code language="python" source="~/../python-sdk-docs-examples/proxy/set_http_proxy.py" range="1-7":::

From the CLI

:::code language="cmd" source="~/../python-sdk-docs-examples/proxy/set_proxy.cmd":::

:::code language="bash" source="~/../python-sdk-docs-examples/proxy/set_proxy.sh":::


Per-client or per-method configuration

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":::