---
id: alibabacloud-oss-v2
version: "1.3.2"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# alibabacloud-oss-v2 — Alibaba Cloud OSS (Object Storage Service) SDK V2 for Python

License: permissive · Maintenance: active · Downloads: 5.0M/mo

## What it is and what it does

The Alibaba Cloud OSS Python SDK v2 is the official client library for interacting with Alibaba Cloud's Object Storage Service. It provides methods to list buckets, list objects within buckets, upload files, download files, and manage object metadata through a paginated, request-response API pattern. The SDK handles authentication via environment variables or custom credential providers and abstracts the underlying HTTP communication through the requests library.

The package is designed for developers building applications that need to store or retrieve files from Alibaba Cloud's cloud storage infrastructure. It supports Python 3.8 through 3.12 and is currently in Beta status. The SDK uses pycryptodome for cryptographic operations and crcmod-plus for checksum validation, ensuring data integrity during transfers.

Use it for:

- Upload application logs or user-generated content to OSS for long-term archival and backup.
- Build a file management system that lists, retrieves, and serves files stored in OSS buckets.
- Integrate OSS as a data lake backend for batch processing or analytics pipelines.
- Implement a media hosting service that stores images or videos and serves them via OSS.
- Sync local files to OSS as part of a disaster recovery or data replication workflow.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Uploads, downloads, and manages files on Alibaba Cloud Object Storage Service (OSS) from Python applications using the official v2 SDK.

Yes, if you are building on Alibaba Cloud infrastructure and need to interact with OSS. The SDK is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. It is Beta status, so verify that its API stability and feature set meet your production requirements before committing to it.

## Install

pip install alibabacloud-oss-v2
uv add alibabacloud-oss-v2
poetry add alibabacloud-oss-v2

## Installing alibabacloud-oss-v2

Before you install: Low install friction with a pure-wheel distribution. Actively maintained as of 2026-08-12 with recent releases. Depends on three stable runtime libraries: requests, pycryptodome, and crcmod-plus.

License in practice: Licensed under Apache License 2.0 (permissive), allowing commercial use, modification, and redistribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install alibabacloud-oss-v2

import alibabacloud_oss_v2 as oss

credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
cfg = oss.config.load_default()
cfg.credentials_provider = credentials_provider
cfg.region = "cn-hangzhou"
client = oss.Client(cfg)
paginator = client.list_buckets_paginator()
for page in paginator.iter_page(oss.ListBucketsRequest()):
    for bucket in page.buckets:
        print(bucket.name)

Requires Python 3.8 or above and Alibaba Cloud OSS credentials (access key ID and secret) set as environment variables.

Verify before relying:

- Whether the SDK supports multipart uploads or streaming for large files.
- Performance characteristics when handling high-throughput or large-scale object operations.
- Availability of comprehensive error handling and retry logic documentation.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 5.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

alibaba cloud oss storage, aliyun object storage python, cloud file upload download, alibaba oss sdk, object storage service client, aliyun storage management, cloud-storage, alibaba-cloud

[View on SkillFed](https://skillfed.io/packages/alibabacloud-oss-v2) · [View on PyPI](https://pypi.org/project/alibabacloud-oss-v2/)