マルチパートアップロード は、大容量ファイルを複数の パート に分割して同時に転送することで、再開可能な アップロード を実現し、不安定な ネットワーク での パフォーマンス を向上させます。
仕組み
マルチパートアップロードは、大容量ファイルを個別に転送できるパートに分割します。パートの転送が失敗した場合、そのパートのみを再アップロードすれば済みます。UploadId はアップロードタスクを識別し、すべてのパートを関連付けます。このプロセスは、3 つのステップで構成されています。
-
アップロードの初期化: InitiateMultipartUpload API を呼び出してマルチパートアップロードを作成し、後続の操作を識別するための一意の UploadId を取得します。
-
ファイルパートのアップロード:ファイルパートを並行してアップロードします。各パートのサイズは 100 KB から 5 GB の範囲です。再開可能なアップロードが可能です。
-
アップロードの完了: CompleteMultipartUpload API を呼び出して、すべてのパートをパート番号順に結合し、完全なオブジェクトを作成します。
マルチパートアップロードの実装
コンプライアンスとセキュリティを向上させるためのポリシー変更により、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 を呼び出さない場合、アップロードされたパートはバケット内に残り、ストレージ料金が継続的に発生 します。不要なコストを回避するために、これらのパートをクリーンアップしてください。
コンソールの使用
-
バケット 一覧に移動し、対象のバケットをクリックします。
-
[オブジェクト] 一覧で、[パート] をクリックしてパートを表示および削除します。
ライフサイクルルールの使用
ライフサイクルルールは、期限切れのパートを自動的にクリーンアップし、手動メンテナンスを削減します。詳細については、「ライフサイクルルールを使用した期限切れパートのクリーンアップ」をご参照ください。
ツールの使用
-
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 リクエスト |
成功したリクエスト数に基づいて料金を計算します。 重要
|
|
ListMultipartUploads |
GET リクエスト |
成功したリクエスト数に基づいて料金を計算します。 |
|
ListParts |
GET リクエスト |
成功したリクエスト数に基づいて料金を計算します。 |
UploadPartCopy を使用して既存のオブジェクトからデータをコピーし、パートとしてアップロードする場合、ソースオブジェクトのストレージクラスが低頻度アクセス (IA)、アーカイブ、またはコールドアーカイブであれば、データ取得料金が発生します (ソースオブジェクトがアーカイブストレージクラスで、アーカイブオブジェクトのリアルタイムアクセスが有効になっている場合は、アーカイブオブジェクトのリアルタイムアクセス料金が発生します)。また、IA、アーカイブ、コールドアーカイブなどのストレージクラスには、最低保存期間および最小課金サイズの要件があり、最低ストレージ料金が発生する場合があります。
API 権限
Alibaba Cloud アカウントは、デフォルトですべての API 権限を持っています。RAM ユーザーおよび RAM ロールは、各 API オペレーションに対して明示的な権限が必要です。詳細については、「RAM ポリシー」および「RAM ポリシーの一般的な例」をご参照ください。
|
API |
アクション |
説明 |
|
InitiateMultipartUpload |
|
マルチパートアップロードを初期化します。 |
|
|
マルチパートアップロードを初期化する際に x-oss-tagging を使用してオブジェクトタグを指定する場合、この権限が必要です。 |
|
|
|
オブジェクトをアップロードする際にオブジェクトメタデータに X-Oss-Server-Side-Encryption: KMS が含まれている場合、これらの権限が必要です。 |
|
|
|
||
|
UploadPart |
|
パートをアップロードします。 |
|
UploadPartCopy |
|
既存のオブジェクトからデータをコピーしてパートをアップロードする場合、ソースオブジェクトの読み取り権限が必要です。 |
|
|
既存のオブジェクトからデータをコピーしてパートをアップロードする場合、コピー先オブジェクトへの書き込み権限が必要です。 |
|
|
|
既存のオブジェクトからデータをコピーしてパートをアップロードする際に versionId を使用してオブジェクトバージョンを指定する場合、ソースオブジェクトの指定されたバージョンの読み取り権限が必要です。 |
|
|
CompleteMultipartUpload |
|
パートをオブジェクトに結合します。 |
|
|
パートをオブジェクトに結合する際に x-oss-tagging を使用してオブジェクトタグを指定する場合、この権限が必要です。 |
|
|
AbortMultipartUpload |
|
マルチパートアップロードイベントを中止し、対応するパートデータを削除します。 |
|
ListMultipartUploads |
|
進行中のすべてのマルチパートアップロードイベントを一覧表示します。これらは、開始されたがまだ完了または中止されていないイベントです。 |
|
ListParts |
|
指定された UploadId に紐づく、アップロードに成功したすべてのパートを一覧表示します。 |