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

Object Storage Service:シンプルダウンロード (iOS SDK)

最終更新日:Nov 30, 2025

このトピックでは、シンプルダウンロードの実行方法について説明します。

注意事項

このトピックの例を使用する前に、カスタムドメイン名または Security Token Service (STS) を使用して OSSClient インスタンスを作成する必要があります。 詳細については、「初期化 (iOS SDK)」をご参照ください。

説明

バケットのリージョンは、初期化設定で指定されたエンドポイントのリージョンによって決まります。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。 Alibaba Cloud アカウントに属する RAM ユーザーまたは RAM ロールは、デフォルトでは何の権限も持っていません。 Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを介して操作権限を付与する必要があります。

API

アクション

説明

GetObject

oss:GetObject

オブジェクトをダウンロードします。

oss:GetObjectVersion

オブジェクトをダウンロードする際に、versionId を通じてオブジェクトのバージョンを指定する場合、この権限が必要です。

kms:Decrypt

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

オブジェクトをローカルファイルにダウンロードするか、NSData としてダウンロードできます。

OSSGetObjectRequest * request = [OSSGetObjectRequest new];

// バケット名を指定します。例:examplebucket
request.bucketName = @"examplebucket";
// オブジェクトの完全なパスを指定します。例:exampledir/exampleobject.txt。 オブジェクトの完全なパスにバケット名を含めることはできません。
request.objectKey = @"exampledir/exampleobject.txt";

// オプション。
request.downloadProgress = ^(int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite) {
    // 現在のセグメント長、ダウンロード済みの合計長、および期待される合計長。
    NSLog(@"%lld, %lld, %lld", bytesWritten, totalBytesWritten, totalBytesExpectedToWrite);
};
// request.range = [[OSSRange alloc] initWithStart:0 withEnd:99]; // bytes=0-99。 ダウンロードする範囲を指定します。
// request.downloadToFileURL = [NSURL fileURLWithPath:@"<filepath>"]; // オブジェクトを直接ファイルにダウンロードするには、保存先ファイルのパスを指定します。

OSSTask * getTask = [client getObject:request];

[getTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        NSLog(@"download object success!");
        OSSGetObjectResult * getResult = task.result;
        NSLog(@"download result: %@", getResult.downloadedData);
    } else {
        NSLog(@"download object failed, error: %@" ,task.error);
    }
    return nil;
}];

// [getTask waitUntilFinished];

// [request cancel];

関連ドキュメント