注意事項

• 使用本文示例前您需要先通過自定義域名、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實例。