Skip to content

Updated documentation for setting different endpoints #552

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
anjaliratnam-msft wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Updated documentation for setting different endpoints #552

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d55897d
fixed protocol stripping for sovereign cloud urls
anjaliratnam-msft Jun 15, 2026
b2bec85
removed changes/updated documentation
anjaliratnam-msft Jun 24, 2026
b2eeb25
updates
anjaliratnam-msft Jun 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,5 +84,27 @@ The `AzureBlobFileSystem` accepts [all of the Async BlobServiceClient arguments]

By default, write operations create BlockBlobs in Azure, which, once written can not be appended. It is possible to create an AppendBlob using `mode="ab"` when creating and operating on blobs. Currently, AppendBlobs are not available if hierarchical namespaces are enabled.

### Connecting to different endpoints
By default, adlfs connects to the Azure public cloud (`blob.core.windows.net`). To set a different endpoint, you can pass in the `account_host` parameter alongside `account_name`:
```python
# Generic custom endpoint
fs = AzureBlobFileSystem(
account_name="myaccount",
account_host="myaccount.<your-endpoint>",
)

# Azure China cloud
fs = AzureBlobFileSystem(
account_name="myaccount",
account_host="myaccount.blob.core.chinacloudapi.cn",
)

# Microsoft OneLake
fs = AzureBlobFileSystem(
account_name="onelake",
account_host="onelake.dfs.fabric.microsoft.com",
)
```

### Older versions
ADLS Gen1 filesystem has officially been [retired](https://learn.microsoft.com/en-us/lifecycle/products/azure-data-lake-storage-gen1). Hence the adl:// method, which was designed to connect to ADLS Gen1 is obsolete.
Loading