OSS不支援直接對檔案（Object）進行重新命名。如果您需要在同一個Bucket內對Object進行重新命名，您可以通過CopyObject介面將源Object拷貝至目標Object，然後通過DeleteObject介面刪除源Object。
注意事項
使用本文樣本前您需要先通過自訂網域名、STS等方式建立OSSClient，具體請參見初始化。
說明所建立儲存空間的所屬地區取決於初始化配置的endpoint地區資訊。
範例程式碼
以下代碼用於將examplebucket下的srcobject.txt重新命名為destobject.txt。
// 填寫Bucket名稱。
NSString *bucketName = @"examplebucket";
// 填寫不包含Bucket名稱在內源Object的完整路徑，例如srcobject.txt。
NSString *sourceObjectKey = @"sourceObjectKey";
// 填寫不包含Bucket名稱在內目標Object的完整路徑，例如destobject.txt。
NSString *objectKey = @"destobject.txt";
[[[OSSTask taskWithResult:nil] continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
// 將srcobject.txt拷貝至同一Bucket下的destobject.txt。
OSSCopyObjectRequest *copyRequest = [OSSCopyObjectRequest new];
copyRequest.bucketName = bucketName;
copyRequest.sourceBucketName = bucketName;
copyRequest.sourceObjectKey = sourceObjectKey;
copyRequest.objectKey = objectKey;
OSSTask *copyTask = [client copyObject:copyRequest];
[copyTask waitUntilFinished];
if (copyTask.error) {
return copyTask;
}
// 刪除srcobject.txt。
OSSDeleteObjectRequest *deleteObject = [OSSDeleteObjectRequest new];
deleteObject.bucketName = bucketName;
deleteObject.objectKey = sourceObjectKey;
OSSTask *deleteTask = [client deleteObject:deleteObject];
[deleteTask waitUntilFinished];
if (deleteTask.error) {
return deleteTask;
}
return nil;
}] continueWithBlock:^id _Nullable(OSSTask * _Nonnull task) {
if (task.error) {
NSLog(@"rename fail! error: %@", task.error);
} else {
NSLog(@"rename success!");
}
return nil;
}];說明
OSS也不支援直接對目錄進行重新命名。如果需要重新命名目錄，您可以參考以上樣本對該目錄下的子目錄和Object逐個進行重新命名操作。
相關文檔
關於重新命名檔案涉及的API介面說明，請分別參見CopyObject和DeleteObject。