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
錯誤碼
錯誤碼 | HTTP狀態代碼 | 描述 |
AccessDenied | 403 | 返回該錯誤的可能原因如下:
|
NoSuchKey | 404 | 返回該錯誤的可能原因如下:
|
FileAlreadyExists | 409 | 目標目錄或者目標檔案已存在。 |