如果僅需要檔案中的部分資料，您可以使用範圍下載，下載指定範圍內的資料。
注意事項
使用本文樣本前您需要先通過自訂網域名、STS等方式建立OSSClient，具體請參見初始化（iOS SDK）。
說明
所建立儲存空間的所屬地區取決於初始化配置的endpoint地區資訊。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
GetObject |
| 下載Object。 |
| 下載Object時，如果通過versionId指定了Object的版本，則需要授予此操作的許可權。 | |
| 下載Object時，如果Object的中繼資料套件含X-Oss-Server-Side-Encryption: KMS，則需要此操作的許可權。 |
範圍下載適用於下載較大的Object。如果在要求標頭中使用Range參數，則返回訊息中會包含整個檔案的長度和此次返回的範圍。
範例程式碼
以下代碼用於範圍下載：
OSSGetObjectRequest * request = [OSSGetObjectRequest new];
// 填寫Bucket名稱，例如examplebucket。
request.bucketName = @"examplebucket";
// 填寫不包含Bucket名稱在內的Object完整路徑，例如exampledir/exampleobject.txt。
request.objectKey = @"exampledir/exampleobject.txt";
request.range = [[OSSRange alloc] initWithStart:1 withEnd:99]; // bytes=1-99
// request.range = [[OSSRange alloc] initWithStart:-1 withEnd:99]; // bytes=-99
// request.range = [[OSSRange alloc] initWithStart:10 withEnd:-1]; // bytes=10-
request.downloadProgress = ^(int64_t bytesWritten, int64_t totalBytesWritten, int64_t totalBytesExpectedToWrite) {
NSLog(@"%lld, %lld, %lld", bytesWritten, totalBytesWritten, totalBytesExpectedToWrite);
};
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];相關文檔
關於範圍下載的API介面說明，請參見GetObject。
關於初始化OSSClient，請參見如何初始化OSSClient執行個體。