Object Storage Service：iOS追加上傳

注意事項

• 使用本文樣本前您需要先通過自訂網域名、STS等方式建立OSSClient，具體請參見初始化。

  說明

  所建立儲存空間的所屬地區取決於初始化配置的endpoint地區資訊。

• 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見Java配置訪問憑證。

• 要追加上傳，您必須有oss:GetObjectoss:PutObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

• 當檔案不存在時，調用AppendObject介面會建立一個追加類型檔案。

• 當檔案已存在時：

  • 如果檔案為追加類型檔案，且設定的追加位置和檔案當前長度相等，則直接在該檔案末尾追加內容。

  • 如果檔案為追加類型檔案，但是設定的追加位置和檔案當前長度不相等，則拋出PositionNotEqualToLength異常。

  • 如果檔案為非追加類型的檔案時，例如通過簡單上傳的檔案類型為Normal的檔案，則拋出ObjectNotAppendable異常。

• 追加類型檔案暫不支援CopyObject操作。

範例程式碼

以下代碼用於追加上傳檔案。

OSSAppendObjectRequest * append = [OSSAppendObjectRequest new];
// 配置以下必要欄位，其中bucketName為儲存空間名稱；objectKey等同於objectName，表示追加上傳檔案到OSS時需要指定包含檔案尾碼在內的完整路徑，例如abc/efg/123.jpg。
append.bucketName = @"<bucketName>";
append.objectKey = @"<objectKey>";
// 指定首次進行追加上傳的位置。
append.appendPosition = 0; 
NSString * docDir = [self getDocumentDirectory];
append.uploadingFileURL = [NSURL fileURLWithPath:@"<filepath>"];
// 以下為可選欄位。
append.uploadProgress = ^(int64_t bytesSent, int64_t totalByteSent, int64_t totalBytesExpectedToSend) {
    NSLog(@"%lld, %lld, %lld", bytesSent, totalByteSent, totalBytesExpectedToSend);
};
// append.contentType = @"";
// append.contentMd5 = @"";
// append.contentEncoding = @"";
// append.contentDisposition = @"";
OSSTask * appendTask = [client appendObject:append];
[appendTask continueWithBlock:^id(OSSTask *task) {
    NSLog(@"objectKey: %@", append.objectKey);
    if (!task.error) {
        NSLog(@"append object success!");
        OSSAppendObjectResult * result = task.result;
        NSString * etag = result.eTag;
        long nextPosition = result.xOssNextAppendPosition;
    } else {
        NSLog(@"append object failed, error: %@" , task.error);
    }
    return nil;
}];

相關文檔

• 關於追加上傳的API介面說明，請參見AppendObject。

• 關於初始化OSSClient，請參見如何初始化OSSClient執行個體。