すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:マルチパートアップロード

最終更新日:Oct 27, 2026

マルチパートアップロード は、大容量ファイルを複数の パート に分割して同時に転送することで、再開可能な アップロード を実現し、不安定な ネットワーク での パフォーマンス を向上させます。

仕組み

マルチパートアップロードは、大容量ファイルを個別に転送できるパートに分割します。パートの転送が失敗した場合、そのパートのみを再アップロードすれば済みます。UploadId はアップロードタスクを識別し、すべてのパートを関連付けます。このプロセスは、3 つのステップで構成されています。

  1. アップロードの初期化: InitiateMultipartUpload API を呼び出してマルチパートアップロードを作成し、後続の操作を識別するための一意の UploadId を取得します。

  2. ファイルパートのアップロード:ファイルパートを並行してアップロードします。各パートのサイズは 100 KB から 5 GB の範囲です。再開可能なアップロードが可能です。

  3. アップロードの完了: CompleteMultipartUpload API を呼び出して、すべてのパートをパート番号順に結合し、完全なオブジェクトを作成します。

image

マルチパートアップロードの実装

重要

コンプライアンスとセキュリティを向上させるためのポリシー変更により、2025 年 3 月 20 日以降、新規 OSS ユーザーは、中国本土リージョンにある OSS バケットでデータ API オペレーションを実行するために、カスタムドメイン名 (CNAME) を使用する必要があります。これらの操作では、デフォルトのパブリックエンドポイントの使用が制限されます。影響を受ける操作の完全なリストについては、公式発表をご参照ください。HTTPS 経由でデータにアクセスする場合は、有効な SSL 証明書をカスタムドメインにバインドする必要があります。コンソールでは HTTPS が強制されるため、これはOSS コンソールへのアクセスに必須です。

グラフィカルツール、CLI ツール、または SDK を使用して、マルチパートアップロードを実装します。

説明
  • OSS コンソールはマルチパートアップロードをサポートしていません。

  • 暗号化された圧縮ファイルはアップロードできますが、ディレクトリはアップロードできません。

自動パート分割ツールの使用

開発、テスト、または O&M タスクでは、パート分割を自動的に処理するグラフィカルツールまたは CLI ツールを使用します。

  • グラフィカル管理ツール:OSS Browser

    ossbrowser 2.0 は、デフォルトでマルチパートアップロードを有効にし、アップロードの進捗を監視するためのビジュアルインターフェイスを提供します。

  • ossutil

    ossutil 2.0 の cp コマンドは、100 MiB を超えるファイルに対して自動的にマルチパートアップロードを有効にします。プロセスを手動で制御するには、initiate-multipart-upload、upload-part、および complete-multipart-upload コマンドを組み合わせて使用します。

    ossutil cp example.zip oss://example-bucket

SDK を使用したプログラムによる制御

SDK は、カスタムのパートサイズ、同時実行数、およびエラー処理でマルチパートアップロードをカプセル化します。以降のセクションでは、一般的な SDK の例を示します。他の言語については、 SDK リファレンス をご参照ください。

コードを実行する前に、SDK をインストールし、アクセス認証情報を環境変数として設定してください。RAM ユーザーまたは RAM ロールを使用する場合は、必要な権限を付与してください。詳細については、「API 権限」 をご参照ください。

Java SDK V2

import com.aliyun.sdk.service.oss2.OSSClient;
import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.StaticCredentialsProvider;
import com.aliyun.sdk.service.oss2.io.BoundedInputStream;
import com.aliyun.sdk.service.oss2.models.*;
import com.aliyun.sdk.service.oss2.transport.BinaryData;

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

/**
 * OSS マルチパートアップロードのサンプルです。
 * 大容量ファイルのマルチパートアップロードを実装します。
 */
public class MultipartUpload {

    public static void main(String[] args) {
        // 環境変数からアクセス認証情報を取得します。
        String accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");

        // OSS のリージョンとエンドポイントを設定します。
        String region = "cn-hangzhou";
        String endpoint = "oss-cn-hangzhou.aliyuncs.com";

        // バケットとファイル情報を設定します。
        String bucket = "example-bucket";
        String key = "dest.jpg";
        String filePath = "dest.jpg";

        // 認証情報プロバイダーを作成します。
        CredentialsProvider provider = new StaticCredentialsProvider(accessKeyId, accessKeySecret);

        // OSS クライアントを初期化します。
        OSSClient client = OSSClient.newBuilder()
                .credentialsProvider(provider)
                .region(region)
                .endpoint(endpoint)
                .build();

        try {
            // ステップ 1:マルチパートアップロードを初期化します。
            InitiateMultipartUploadResult initiateResult = client.initiateMultipartUpload(
                    InitiateMultipartUploadRequest.newBuilder()
                            .bucket(bucket)
                            .key(key)
                            .build());

            String uploadId = initiateResult.initiateMultipartUpload().uploadId();
            System.out.printf("Initiated multipart upload successfully. Status code: %d, Request ID: %s, Upload ID: %s\n",
                    initiateResult.statusCode(), initiateResult.requestId(), uploadId);

            // ステップ 2:パートをアップロードします。
            File file = new File(filePath);
            long fileSize = file.length();
            long partSize = 100 * 1024; // 1パートあたり 100 KB。
            int partNumber = 1;
            List<Part> uploadParts = new ArrayList<>();

            for (long start = 0; start < fileSize; start += partSize) {
                long curPartSize = Math.min(partSize, fileSize - start);

                // ファイルパートを読み込んでアップロードします。
                try (InputStream is = new FileInputStream(file)) {
                    is.skip(start);
                    BoundedInputStream boundedInputStream = new BoundedInputStream(is, curPartSize);

                    // パートをアップロードします。
                    UploadPartResult partResult = client.uploadPart(UploadPartRequest.newBuilder()
                            .bucket(bucket)
                            .key(key)
                            .uploadId(uploadId)
                            .partNumber((long) partNumber)
                            .body(BinaryData.fromStream(boundedInputStream))
                            .build());

                    System.out.printf("Status code: %d, Request ID: %s, Part number: %d, ETag: %s\n",
                            partResult.statusCode(), partResult.requestId(), partNumber, partResult.eTag());

                    uploadParts.add(Part.newBuilder()
                            .partNumber((long) partNumber)
                            .eTag(partResult.eTag())
                            .build());
                }
                partNumber++;
            }

            // ステップ 3:マルチパートアップロードを完了します。
            uploadParts.sort((p1, p2) -> p1.partNumber().compareTo(p2.partNumber()));

            CompleteMultipartUpload completeMultipartUpload = CompleteMultipartUpload.newBuilder()
                    .parts(uploadParts)
                    .build();

            CompleteMultipartUploadResult completeResult = client.completeMultipartUpload(
                    CompleteMultipartUploadRequest.newBuilder()
                            .bucket(bucket)
                            .key(key)
                            .uploadId(uploadId)
                            .completeMultipartUpload(completeMultipartUpload)
                            .build());

            System.out.printf("Completed multipart upload. Status code: %d, Request ID: %s, Bucket: %s, Key: %s, Location: %s, ETag: %s\n",
                    completeResult.statusCode(), completeResult.requestId(), 
                    completeResult.completeMultipartUpload().bucket(),
                    completeResult.completeMultipartUpload().key(), 
                    completeResult.completeMultipartUpload().location(),
                    completeResult.completeMultipartUpload().eTag());

        } catch (Exception e) {
            System.out.printf("Error:\n%s", e);
            e.printStackTrace();
        } finally {
            // クライアントを閉じます。
            try {
                client.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

Java SDK V1

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.*;

import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

/**
 * OSS マルチパートアップロードのサンプル (V1 SDK) です。
 * 大容量ファイルのマルチパートアップロードを実装します。
 */
public class MultipartUpload {

    public static void main(String[] args) {
        // 環境変数からアクセス認証情報を取得します。
        String accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");

        // OSS のリージョンとエンドポイントを設定します。
        String region = "cn-hangzhou";
        String endpoint = "oss-cn-hangzhou.aliyuncs.com";

        // バケットとファイル情報を設定します。
        String bucketName = "example-bucket";
        String objectName = "dest.jpg";
        String filePath = "dest.jpg";

        // 認証情報プロバイダーを作成します。
        DefaultCredentialProvider provider = new DefaultCredentialProvider(accessKeyId, accessKeySecret);

        // クライアントパラメータを設定します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);

        // OSS クライアントを初期化します。
        OSS ossClient = OSSClientBuilder.create()
                .credentialsProvider(provider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .endpoint(endpoint)
                .build();

        try {
            // ステップ 1:マルチパートアップロードを初期化します。
            InitiateMultipartUploadRequest initiateRequest = new InitiateMultipartUploadRequest(bucketName, objectName);
            InitiateMultipartUploadResult initiateResult = ossClient.initiateMultipartUpload(initiateRequest);
            String uploadId = initiateResult.getUploadId();
            System.out.printf("Initiated multipart upload successfully. Upload ID: %s\n", uploadId);

            // ステップ 2:パートをアップロードします。
            File file = new File(filePath);
            long fileLength = file.length();
            long partSize = 100 * 1024L; // 1パートあたり 100 KB。

            // パート数を計算します。
            int partCount = (int) (fileLength / partSize);
            if (fileLength % partSize != 0) {
                partCount++;
            }

            // アップロードされたパートの ETag を保存します。
            List<PartETag> partETags = new ArrayList<>();

            // 各パートを順にアップロードします。
            for (int i = 0; i < partCount; i++) {
                long startPos = i * partSize;
                long curPartSize = (i + 1 == partCount) ? (fileLength - startPos) : partSize;

                // アップロードパートリクエストを作成します。
                UploadPartRequest uploadPartRequest = new UploadPartRequest();
                uploadPartRequest.setBucketName(bucketName);
                uploadPartRequest.setKey(objectName);
                uploadPartRequest.setUploadId(uploadId);
                uploadPartRequest.setPartNumber(i + 1);
                uploadPartRequest.setPartSize(curPartSize);

                // ファイルパートを読み込んでアップロードします。
                try (InputStream instream = new FileInputStream(file)) {
                    instream.skip(startPos);
                    uploadPartRequest.setInputStream(instream);

                    UploadPartResult uploadPartResult = ossClient.uploadPart(uploadPartRequest);
                    partETags.add(uploadPartResult.getPartETag());

                    System.out.printf("Uploaded part %d/%d successfully. ETag: %s\n",
                            i + 1, partCount, uploadPartResult.getPartETag().getETag());
                }
            }

            // ステップ 3:マルチパートアップロードを完了します。
            CompleteMultipartUploadRequest completeRequest = new CompleteMultipartUploadRequest(
                    bucketName, objectName, uploadId, partETags);
            CompleteMultipartUploadResult completeResult = ossClient.completeMultipartUpload(completeRequest);

            System.out.printf("Completed multipart upload. ETag: %s\n", completeResult.getETag());

        } catch (Exception e) {
            System.out.printf("Error: %s\n", e.getMessage());
            e.printStackTrace();
        } finally {
            // クライアントをシャットダウンします。
            ossClient.shutdown();
        }
    }
}

Python SDK V2

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# OSS Python SDK V2 を使用したマルチパートアップロードのサンプルです。
# 大容量ファイルのマルチパートアップロードを実装します。

import alibabacloud_oss_v2 as oss
import os

def main():
    # 環境変数からアクセス認証情報を取得します。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # SDK のデフォルト設定をロードします。
    config = oss.config.load_default()
    config.credentials_provider = credentials_provider

    # OSS のリージョンとエンドポイントを設定します。
    config.region = "cn-hangzhou"
    config.endpoint = "oss-cn-hangzhou.aliyuncs.com"

    # OSS クライアントを初期化します。
    client = oss.Client(config)

    # バケットとファイル情報を設定します。
    bucket = "example-bucket"
    key = "dest.jpg"
    file_path = "dest.jpg"

    try:
        # ステップ 1:マルチパートアップロードを初期化します。
        initiate_result = client.initiate_multipart_upload(
            oss.InitiateMultipartUploadRequest(
                bucket=bucket,
                key=key
            ))

        upload_id = initiate_result.upload_id
        print(f"Initiated multipart upload successfully. Status code: {initiate_result.status_code}, "
              f"Request ID: {initiate_result.request_id}, Upload ID: {upload_id}")

        # ステップ 2:パートをアップロードします。
        file_size = os.path.getsize(file_path)
        part_size = 100 * 1024  # 1パートあたり 100 KB。
        part_number = 1
        upload_parts = []
        offset = 0

        with open(file_path, 'rb') as f:
            while offset < file_size:
                # 現在のパートのサイズを計算します。
                current_part_size = min(part_size, file_size - offset)
                
                # パートデータを読み込みます。
                f.seek(offset)
                part_data = f.read(current_part_size)

                # パートをアップロードします。
                part_result = client.upload_part(
                    oss.UploadPartRequest(
                        bucket=bucket,
                        key=key,
                        upload_id=upload_id,
                        part_number=part_number,
                        body=part_data
                    ))

                print(f"Status code: {part_result.status_code}, Request ID: {part_result.request_id}, "
                      f"Part number: {part_number}, ETag: {part_result.etag}")

                # アップロードされたパートの情報を記録します。
                upload_parts.append(oss.UploadPart(
                    part_number=part_number,
                    etag=part_result.etag
                ))

                offset += current_part_size
                part_number += 1

        # ステップ 3:マルチパートアップロードを完了します。
        upload_parts.sort(key=lambda p: p.part_number)

        complete_result = client.complete_multipart_upload(
            oss.CompleteMultipartUploadRequest(
                bucket=bucket,
                key=key,
                upload_id=upload_id,
                complete_multipart_upload=oss.CompleteMultipartUpload(
                    parts=upload_parts
                )
            ))

        print(f"Completed multipart upload. Status code: {complete_result.status_code}, "
              f"Request ID: {complete_result.request_id}, "
              f"Bucket: {complete_result.bucket}, "
              f"Key: {complete_result.key}, "
              f"Location: {complete_result.location}, "
              f"ETag: {complete_result.etag}")

    except Exception as e:
        print(f"Error: {e}")
        raise

if __name__ == "__main__":
    main()

Python SDK V1

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# OSS Python SDK V1 を使用したマルチパートアップロードのサンプルです。
# 大容量ファイルのマルチパートアップロードを実装します。

import os
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
from oss2 import SizedFileAdapter
from oss2.models import PartInfo

def main():
    # 環境変数からアクセス認証情報を取得します。
    auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())

    # OSS のリージョンとエンドポイントを設定します。
    region = "cn-hangzhou"
    endpoint = "oss-cn-hangzhou.aliyuncs.com"

    # バケットとファイル情報を設定します。
    bucket_name = "example-bucket"
    key = "dest.jpg"
    file_path = "dest.jpg"

    # OSS バケットを初期化します。
    bucket = oss2.Bucket(auth, endpoint, bucket_name, region=region)

    try:
        # ステップ 1:マルチパートアップロードを初期化します。
        upload_id = bucket.init_multipart_upload(key).upload_id
        print(f"Initiated multipart upload successfully. Upload ID: {upload_id}")

        # ステップ 2:パートをアップロードします。
        file_size = os.path.getsize(file_path)
        part_size = 100 * 1024  # 1パートあたり 100 KB。
        part_number = 1
        parts = []
        offset = 0

        with open(file_path, 'rb') as fileobj:
            while offset < file_size:
                # 現在のパートのサイズを計算します。
                current_part_size = min(part_size, file_size - offset)

                # パートをアップロードします。
                result = bucket.upload_part(
                    key,
                    upload_id,
                    part_number,
                    SizedFileAdapter(fileobj, current_part_size)
                )

                print(f"Part number: {part_number}, ETag: {result.etag}")

                # アップロードされたパートの情報を記録します。
                parts.append(PartInfo(part_number, result.etag))

                offset += current_part_size
                part_number += 1

        # ステップ 3:マルチパートアップロードを完了します。
        result = bucket.complete_multipart_upload(key, upload_id, parts)
        print(f"Completed multipart upload. ETag: {result.etag}")

    except Exception as e:
        print(f"Error: {e}")
        raise

if __name__ == "__main__":
    main()

Go SDK V2

package main

// OSS Go SDK V2 を使用したマルチパートアップロードのサンプルです。
// 大容量ファイルのマルチパートアップロードを実装します。

import (
	"context"
	"fmt"
	"io"
	"os"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func main() {
	// 環境変数からアクセス認証情報を取得します。
	// OSS クライアントを設定し、認証情報プロバイダーとエンドポイントを設定します。
	config := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion("cn-hangzhou").
		WithEndpoint("oss-cn-hangzhou.aliyuncs.com")

	// OSS クライアントを初期化します。
	client := oss.NewClient(config)

	// バケットとファイル情報を設定します。
	bucket := "example-bucket"
	key := "dest.jpg"
	filePath := "dest.jpg"

	// ステップ 1:マルチパートアップロードを初期化します。
	initResult, err := client.InitiateMultipartUpload(context.TODO(), &oss.InitiateMultipartUploadRequest{
		Bucket: oss.Ptr(bucket),
		Key:    oss.Ptr(key),
	})
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	uploadId := *initResult.UploadId
	fmt.Printf("Initiated multipart upload successfully. Upload ID: %s\n", uploadId)

	// ステップ 2:パートをアップロードします。
	file, err := os.Open(filePath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}
	defer file.Close()

	fileInfo, err := file.Stat()
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	fileSize := fileInfo.Size()
	partSize := int64(100 * 1024) // 1パートあたり 100 KB。
	partNumber := int32(1)
	var parts []oss.UploadPart

	for offset := int64(0); offset < fileSize; offset += partSize {
		// 現在のパートのサイズを計算します。
		currentPartSize := partSize
		if offset+partSize > fileSize {
			currentPartSize = fileSize - offset
		}

		// パートデータを読み込みます。
		file.Seek(offset, 0)
		partData := io.LimitReader(file, currentPartSize)

		// パートをアップロードします。
		partResult, err := client.UploadPart(context.TODO(), &oss.UploadPartRequest{
			Bucket:     oss.Ptr(bucket),
			Key:        oss.Ptr(key),
			UploadId:   oss.Ptr(uploadId),
			PartNumber: partNumber,
			Body:       partData,
		})
		if err != nil {
			fmt.Printf("Error: %v\n", err)
			return
		}

		fmt.Printf("Part number: %d, ETag: %s\n", partNumber, *partResult.ETag)

		// アップロードされたパートの情報を記録します。
		parts = append(parts, oss.UploadPart{
			PartNumber: partNumber,
			ETag:       partResult.ETag,
		})

		partNumber++
	}

	// ステップ 3:マルチパートアップロードを完了します。
	completeResult, err := client.CompleteMultipartUpload(context.TODO(), &oss.CompleteMultipartUploadRequest{
		Bucket:   oss.Ptr(bucket),
		Key:      oss.Ptr(key),
		UploadId: oss.Ptr(uploadId),
		CompleteMultipartUpload: &oss.CompleteMultipartUpload{
			Parts: parts,
		},
	})
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	fmt.Printf("Completed multipart upload. Bucket: %s, Key: %s, Location: %s, ETag: %s\n",
		*completeResult.Bucket, *completeResult.Key, *completeResult.Location, *completeResult.ETag)
}

Go SDK V1

package main

// OSS Go SDK V1 を使用したマルチパートアップロードのサンプルです。
// 大容量ファイルのマルチパートアップロードを実装します。

import (
	"fmt"
	"os"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 環境変数からアクセス認証情報を取得します。
	provider, _ := oss.NewEnvironmentVariableCredentialsProvider()

	// OSS クライアントインスタンスを作成します。
	client, _ := oss.New(
		"oss-cn-hangzhou.aliyuncs.com",
		"",
		"",
		oss.SetCredentialsProvider(provider),
		oss.AuthVersion(oss.AuthV4),
		oss.Region("cn-hangzhou"),
	)

	// バケットオブジェクトを取得します。
	bucket, _ := client.Bucket("example-bucket")

	// ファイル情報を設定します。
	key := "dest.jpg"
	filePath := "dest.jpg"

	// ステップ 1:マルチパートアップロードを初期化します。
	imur, err := bucket.InitiateMultipartUpload(key)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	fmt.Printf("Initiated multipart upload successfully. Upload ID: %s\n", imur.UploadID)

	// ステップ 2:パートをアップロードします。
	file, err := os.Open(filePath)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}
	defer file.Close()

	fileInfo, err := file.Stat()
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	fileSize := fileInfo.Size()
	partSize := int64(100 * 1024) // 1パートあたり 100 KB。

	// ファイルをパートに分割します。
	chunks, err := oss.SplitFileByPartSize(filePath, partSize)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	var parts []oss.UploadPart
	for _, chunk := range chunks {
		part, err := bucket.UploadPart(imur, file, chunk.Size, chunk.Number)
		if err != nil {
			fmt.Printf("Error: %v\n", err)
			return
		}

		fmt.Printf("Part number: %d, ETag: %s\n", chunk.Number, part.ETag)
		parts = append(parts, part)
	}

	// ステップ 3:マルチパートアップロードを完了します。
	_, err = bucket.CompleteMultipartUpload(imur, parts)
	if err != nil {
		fmt.Printf("Error: %v\n", err)
		return
	}

	fmt.Printf("Completed multipart upload. File size: %d bytes\n", fileSize)
}

不完全なパートのクリーンアップ

重要

コンプライアンスとセキュリティを向上させるためのポリシー変更により、2025 年 3 月 20 日以降、新規 OSS ユーザーは、中国本土リージョンにある OSS バケットでデータ API オペレーションを実行するために、カスタムドメイン名 (CNAME) を使用する必要があります。これらの操作では、デフォルトのパブリックエンドポイントの使用が制限されます。影響を受ける操作の完全なリストについては、公式発表をご参照ください。HTTPS 経由でデータにアクセスする場合は、有効な SSL 証明書をカスタムドメインにバインドする必要があります。コンソールでは HTTPS が強制されるため、これはOSS コンソールへのアクセスに必須です。

マルチパートアップロードが中断され、AbortMultipartUpload を呼び出さない場合、アップロードされたパートはバケット内に残り、ストレージ料金が継続的に発生 します。不要なコストを回避するために、これらのパートをクリーンアップしてください。

コンソールの使用

  1. バケット 一覧に移動し、対象のバケットをクリックします。

  2. [オブジェクト] 一覧で、[パート] をクリックしてパートを表示および削除します。

ライフサイクルルールの使用

ライフサイクルルールは、期限切れのパートを自動的にクリーンアップし、手動メンテナンスを削減します。詳細については、「ライフサイクルルールを使用した期限切れパートのクリーンアップ」をご参照ください。

ツールの使用

  • ossbrowser

    バケットのオブジェクト一覧ページで、[パート] をクリックしてパートを表示および削除します。

  • ossutil

    abort-multipart-upload コマンドを使用して、マルチパートアップロードをキャンセルし、パートデータを削除します。

    ossutil api abort-multipart-upload --bucket example-bucket --key dest.jpg --upload-id D9F4****************************

SDK の使用

AbortMultipartUpload を呼び出して、マルチパートアップロードをキャンセルし、パートデータを削除します。以下に、主要な SDK のサンプルコードを示します。その他の言語については、SDK リファレンスをご参照ください。

コードを実行する前に、SDK をインストールし、アクセス認証情報を環境変数として設定してください。RAM ユーザーまたは RAM ロールを使用する場合は、必要な権限を付与してください。詳細については、「API 権限」をご参照ください。

Java SDK V2

import com.aliyun.sdk.service.oss2.OSSClient;
import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.StaticCredentialsProvider;
import com.aliyun.sdk.service.oss2.models.AbortMultipartUploadRequest;
import com.aliyun.sdk.service.oss2.models.AbortMultipartUploadResult;

/**
 * OSS マルチパートアップロードをキャンセルするサンプル。
 * マルチパートアップロードをキャンセルする方法を示します。
 */
public class AbortMultipartUpload {

    public static void main(String[] args) {
        // 環境変数からアクセス認証情報を取得します。
        String accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");

        // OSS リージョンとエンドポイントを設定します。
        String region = "cn-hangzhou";
        String endpoint = "oss-cn-hangzhou.aliyuncs.com";

        // バケットとファイル情報を設定します。
        String bucket = "example-bucket";
        String key = "dest.jpg";
        String uploadId = "D9F4****************************";

        // 認証情報プロバイダーを作成します。
        CredentialsProvider provider = new StaticCredentialsProvider(accessKeyId, accessKeySecret);

        // OSS クライアントを初期化します。
        OSSClient client = OSSClient.newBuilder()
                .credentialsProvider(provider)
                .region(region)
                .endpoint(endpoint)
                .build();

        try {
            // マルチパートアップロードをキャンセルします。
            AbortMultipartUploadResult result = client.abortMultipartUpload(
                    AbortMultipartUploadRequest.newBuilder()
                            .bucket(bucket)
                            .key(key)
                            .uploadId(uploadId)
                            .build());

            System.out.printf("マルチパートアップロードのキャンセルに成功しました。ステータスコード: %d、リクエスト ID: %s\n",
                    result.statusCode(), result.requestId());

        } catch (Exception e) {
            System.out.printf("エラー: %s\n", e.getMessage());
            e.printStackTrace();
        } finally {
            // クライアントをクローズします。
            try {
                client.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

Java SDK V1

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.*;

/**
 * OSS マルチパートアップロードをキャンセルするサンプル (V1 SDK)。
 * マルチパートアップロードをキャンセルする方法を示します。
 */
public class AbortMultipartUpload {

    public static void main(String[] args) {
        // 環境変数からアクセス認証情報を取得します。
        String accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");

        // OSS リージョンとエンドポイントを設定します。
        String region = "cn-hangzhou";
        String endpoint = "oss-cn-hangzhou.aliyuncs.com";

        // バケットとファイル情報を設定します。
        String bucketName = "example-bucket";
        String objectName = "dest.jpg";
        String uploadId = "D9F4****************************";

        // 認証情報プロバイダーを作成します。
        DefaultCredentialProvider provider = new DefaultCredentialProvider(accessKeyId, accessKeySecret);

        // クライアントパラメーターを設定します。
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);

        // OSS クライアントを初期化します。
        OSS ossClient = OSSClientBuilder.create()
                .credentialsProvider(provider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .endpoint(endpoint)
                .build();

        try {
            // マルチパートアップロードをキャンセルします。
            AbortMultipartUploadRequest abortMultipartUploadRequest =
                    new AbortMultipartUploadRequest(bucketName, objectName, uploadId);
            ossClient.abortMultipartUpload(abortMultipartUploadRequest);

            System.out.printf("マルチパートアップロードのキャンセルに成功しました。アップロード ID: %s\n", uploadId);

        } catch (Exception e) {
            System.out.printf("エラー: %s\n", e.getMessage());
            e.printStackTrace();
        } finally {
            // クライアントをシャットダウンします。
            ossClient.shutdown();
        }
    }
}

Python SDK V2

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# OSS Python SDK V2 を使用してマルチパートアップロードをキャンセルするサンプル。
# マルチパートアップロードをキャンセルし、アップロードされたパートを削除します。

import alibabacloud_oss_v2 as oss

def main():
    # 環境変数からアクセス認証情報を取得します。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # SDK のデフォルト設定を読み込みます。
    config = oss.config.load_default()
    config.credentials_provider = credentials_provider

    # OSS リージョンとエンドポイントを設定します。
    config.region = "cn-hangzhou"
    config.endpoint = "oss-cn-hangzhou.aliyuncs.com"

    # OSS クライアントを初期化します。
    client = oss.Client(config)

    # バケットとファイル情報を設定します。
    bucket = "example-bucket"
    key = "dest.jpg"
    upload_id = "D9F4****************************"

    # マルチパートアップロードをキャンセルします。
    result = client.abort_multipart_upload(
        oss.AbortMultipartUploadRequest(
            bucket=bucket,
            key=key,
            upload_id=upload_id
        ))

    print(f"マルチパートアップロードのキャンセルに成功しました。ステータスコード: {result.status_code}、リクエスト ID: {result.request_id}")

if __name__ == "__main__":
    main()

Python SDK V1

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# OSS Python SDK V1 を使用してマルチパートアップロードをキャンセルするサンプル。

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

def main():
    # 環境変数からアクセス認証情報を取得します。
    auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
    
    # OSS リージョンとエンドポイントを設定します。
    region = "cn-hangzhou"
    endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
    
    # バケットとファイル情報を設定します。
    bucket_name = "example-bucket"
    key = "dest.jpg"
    upload_id = "D9F4****************************"
    
    # OSS クライアントを初期化します。
    bucket = oss2.Bucket(auth, endpoint, bucket_name, region=region)
    
    # マルチパートアップロードをキャンセルします。
    bucket.abort_multipart_upload(key, upload_id)
    
    print(f"マルチパートアップロードのキャンセルに成功しました。アップロード ID: {upload_id}")

if __name__ == "__main__":
    main()

Go SDK V2

package main

// OSS Go SDK V2 を使用してマルチパートアップロードをキャンセルするサンプル。

import (
	"context"
	"fmt"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func main() {
	// 環境変数からアクセス認証情報を取得します。
	// デフォルト設定を読み込み、認証情報プロバイダー、リージョン、エンドポイントを設定します。
	config := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion("cn-hangzhou").
		WithEndpoint("oss-cn-hangzhou.aliyuncs.com")

	// OSS クライアントを初期化します。
	client := oss.NewClient(config)

	// バケットとファイル情報を設定します。
	bucket := "example-bucket"
	key := "dest.jpg"
	uploadId := "D9F4****************************"

	// マルチパートアップロードをキャンセルします。
	client.AbortMultipartUpload(context.TODO(), &oss.AbortMultipartUploadRequest{
		Bucket:   oss.Ptr(bucket),
		Key:      oss.Ptr(key),
		UploadId: oss.Ptr(uploadId),
	})

	fmt.Printf("マルチパートアップロードのキャンセルに成功しました。アップロード ID: %s\n", uploadId)
}

Go SDK V1

package main

// OSS Go SDK V1 を使用してマルチパートアップロードをキャンセルするサンプル。

import (
	"fmt"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 環境変数からアクセス認証情報を取得します。
	provider, _ := oss.NewEnvironmentVariableCredentialsProvider()

	// OSS クライアントインスタンスを作成します。
	client, _ := oss.New(
		"oss-cn-hangzhou.aliyuncs.com",
		"",
		"",
		oss.SetCredentialsProvider(&provider),
		oss.AuthVersion(oss.AuthV4),
		oss.Region("cn-hangzhou"),
	)

	// バケットオブジェクトを取得します。
	bucket, _ := client.Bucket("example-bucket")

	// ファイル情報を設定します。
	key := "dest.jpg"
	uploadId := "D9F4****************************"

	// InitiateMultipartUploadResult オブジェクトを作成します。
	imur := oss.InitiateMultipartUploadResult{
		UploadID: uploadId,
		Key:      key,
	}

	// マルチパートアップロードをキャンセルします。
	bucket.AbortMultipartUpload(imur)

	fmt.Printf("マルチパートアップロードのキャンセルに成功しました。アップロード ID: %s\n", uploadId)
}

本番環境に適用

ベストプラクティス

  • パフォーマンスの最適化:アップロード速度と安定性の向上

    • 同時パート数の制御:利用可能な帯域幅とデバイスの負荷に応じて、同時実行のバランスを取ります。接続が多すぎると輻輳が発生し、少なすぎるとネットワークを十分に活用できません。

    • オブジェクト名におけるシーケンシャルプレフィックスの回避:オブジェクト名にタイムスタンプなどのシーケンシャルプレフィックスを使用しないでください。これにより、リクエストが単一のパーティションに集中し、ホットスポットが発生します。詳細については、「OSS のパフォーマンスに関するベストプラクティス」をご参照ください。

  • 信頼性の確保:再開可能なアップロードの実装

    マルチパートアップロードには有効期限はなく、一時停止と再開をサポートします。タスク識別子として UploadId を使用します。パートが失敗した場合は、ファイル全体ではなく、そのパートのみを再アップロードしてください。

  • コストの最適化:Deep Cold Archive のアップロード戦略の最適化

    Deep Cold Archive のコストを最適化するには、ファイルを Standard オブジェクトとしてアップロードし、ライフサイクルルールを使用して移行してください。これにより、直接アップロードによるリクエストごとの高い PUT 料金を回避できます。

  • プロキシまたは Function Compute を介したアップロード

    プロキシサーバーまたは Function Compute を介して大きなオブジェクトをアップロードすると、HTTP 524 エラーなどのゲートウェイタイムアウト制限により、アップロードが失敗することがあります。クライアントがプロキシレイヤーをバイパスして OSS に直接アップロードできるように、事前署名付き URL を使用することを推奨します。また、STS の一時的な認証情報を使用して、フロントエンドが OSS に直接アップロードすることもできます。アップロードがプロキシを経由する必要がある場合は、マルチパートアップロードを使用して大きなオブジェクトをより小さなパートに分割し、パートを 1 つずつアップロードすることで、単一リクエストでのタイムアウトのリスクを軽減します。

リスク防止

  • データセキュリティ:ファイルの上書き防止

    リクエストヘッダーで x-oss-forbid-overwrite を true に設定すると、データ損失の原因となる同名ファイルの上書きを防ぐことができます。また、バージョニングを有効にして、過去のバージョンを保持することもできます。

制限事項

制限

説明

単一ファイルのサイズ

最大 48.8 TB

パート数

1〜10,000

単一パートのサイズ

最小サイズは 100 KB、最大サイズは 5 GB です。最後のパートのサイズは 100 KB 未満でも構いません。

1 回の ListParts リクエストで返されるパートの最大数

1,000

1 回の ListMultipartUploads リクエストで返されるマルチパートアップロードイベントの最大数

1,000

課金

次の表に、マルチパートアップロード操作に関する課金項目を示します。課金の詳細については、「リクエスト料金」および「ストレージ料金」をご参照ください。

API

課金項目

説明

InitiateMultipartUpload

PUT リクエスト

成功したリクエスト数に基づいて料金を計算します。

UploadPart

PUT リクエスト

成功したリクエスト数に基づいて料金を計算します。

ストレージ料金

ストレージ料金は、パートのストレージクラス (オブジェクトと同じ)、実際のサイズ、および保存期間に基づいて課金されます。最小計測単位はありません。パートが削除されるか、完全なオブジェクトに結合されると、課金は停止します。

UploadPartCopy

PUT リクエスト

成功したリクエスト数に基づいて料金を計算します。

CompleteMultipartUpload

PUT リクエスト

成功したリクエスト数に基づいて料金を計算します。

ストレージ料金

ストレージ料金は、オブジェクトのストレージクラス、サイズ、および保存期間に基づいて課金されます。

AbortMultipartUpload

DELETE リクエスト

成功したリクエスト数に基づいて料金を計算します。

重要
  • 中国本土リージョンでは、ライフサイクルルールを使用して低頻度アクセス、アーカイブ、およびコールドアーカイブのパートを削除する際の PUT リクエスト料金は、標準パートを削除する場合よりも高くなります。ライフサイクルルールを使用してディープコールドアーカイブのパートを削除する場合、PUT リクエスト料金は課金されません。

  • 香港 (中国) リージョンおよび中国以外のリージョンでは、ライフサイクルルールを使用して任意のストレージクラスのパートを削除する場合、PUT リクエスト料金は課金されません。

ListMultipartUploads

GET リクエスト

成功したリクエスト数に基づいて料金を計算します。

ListParts

GET リクエスト

成功したリクエスト数に基づいて料金を計算します。

説明

UploadPartCopy を使用して既存のオブジェクトからデータをコピーし、パートとしてアップロードする場合、ソースオブジェクトのストレージクラスが低頻度アクセス (IA)、アーカイブ、またはコールドアーカイブであれば、データ取得料金が発生します (ソースオブジェクトがアーカイブストレージクラスで、アーカイブオブジェクトのリアルタイムアクセスが有効になっている場合は、アーカイブオブジェクトのリアルタイムアクセス料金が発生します)。また、IA、アーカイブ、コールドアーカイブなどのストレージクラスには、最低保存期間および最小課金サイズの要件があり、最低ストレージ料金が発生する場合があります。

API 権限

Alibaba Cloud アカウントは、デフォルトですべての API 権限を持っています。RAM ユーザーおよび RAM ロールは、各 API オペレーションに対して明示的な権限が必要です。詳細については、「RAM ポリシー」および「RAM ポリシーの一般的な例」をご参照ください。

API

アクション

説明

InitiateMultipartUpload

oss:PutObject

マルチパートアップロードを初期化します。

oss:PutObjectTagging

マルチパートアップロードを初期化する際に x-oss-tagging を使用してオブジェクトタグを指定する場合、この権限が必要です。

kms:GenerateDataKey

オブジェクトをアップロードする際にオブジェクトメタデータに X-Oss-Server-Side-Encryption: KMS が含まれている場合、これらの権限が必要です。

kms:Decrypt

UploadPart

oss:PutObject

パートをアップロードします。

UploadPartCopy

oss:GetObject

既存のオブジェクトからデータをコピーしてパートをアップロードする場合、ソースオブジェクトの読み取り権限が必要です。

oss:PutObject

既存のオブジェクトからデータをコピーしてパートをアップロードする場合、コピー先オブジェクトへの書き込み権限が必要です。

oss:GetObjectVersion

既存のオブジェクトからデータをコピーしてパートをアップロードする際に versionId を使用してオブジェクトバージョンを指定する場合、ソースオブジェクトの指定されたバージョンの読み取り権限が必要です。

CompleteMultipartUpload

oss:PutObject

パートをオブジェクトに結合します。

oss:PutObjectTagging

パートをオブジェクトに結合する際に x-oss-tagging を使用してオブジェクトタグを指定する場合、この権限が必要です。

AbortMultipartUpload

oss:AbortMultipartUpload

マルチパートアップロードイベントを中止し、対応するパートデータを削除します。

ListMultipartUploads

oss:ListMultipartUploads

進行中のすべてのマルチパートアップロードイベントを一覧表示します。これらは、開始されたがまだ完了または中止されていないイベントです。

ListParts

oss:ListParts

指定された UploadId に紐づく、アップロードに成功したすべてのパートを一覧表示します。