全部產品
Search
文件中心

Object Storage Service:Rename

更新時間:Jun 19, 2024

Rename介面用於重新命名目錄(Directory)或者檔案(Object)。只有開啟階層命名空間的Bucket支援調用此介面。

注意事項

將來源目錄或者源檔案重新命名為目標目錄或者目標檔案時,有如下注意事項:

  • 您必須有來源目錄或者源檔案的DeleteObject許可權以及目標目錄或者目標檔案的PutObject許可權。

  • 來源目錄或者源檔案以及目標目錄或者目標檔案的父級目錄必須存在。

  • 目標目錄或者目標檔案的父級目錄中不能存在同名的目錄和檔案。

請求文法

POST /dstObjectName?x-oss-rename HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-rename-source:srcPathName

要求標頭

名稱

類型

是否必選

描述

x-oss-rename-source

字串

來源目錄或者源檔案的絕對路徑,例如desktop/oss/a。該路徑必須存在。

此介面還需包含Host、Date等公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

回應標頭

此介面僅包含公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

樣本

請求樣本

以下樣本用於將desktop目錄下osstest目錄中的a重新命名為b。

POST /desktop/osstest/b?x-oss-rename HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 29 Apr 2021 05:21:12 GMT
Authorization: OSS qn6q**************:77Dv****************
x-oss-rename-source: desktop/osstest/a

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Date: Thu, 29 Apr 2021 05:21:12 GMT
Connection: keep-alive
Server: AliyunOSS

SDK

Java SDK:重新命名

錯誤碼

錯誤碼

HTTP狀態代碼

描述

AccessDenied

403

返回該錯誤的可能原因如下:

  • 使用者對設定的Bucket沒有存取權限。

  • 使用者對目錄或檔案沒有存取權限。

NoSuchKey

404

返回該錯誤的可能原因如下:

  • 來源目錄或者源檔案不存在。

  • 目標目錄或者目標檔案的父級目錄不存在。

FileAlreadyExists

409

目標目錄或者目標檔案已存在。