Object Storage Service:名前の変更

使用上の注意

名前変更操作を呼び出してソースディレクトリまたはオブジェクトの名前を宛先ディレクトリまたはオブジェクトに変更する場合は、次の点に注意してください。

• ソースディレクトリまたはオブジェクトに対する 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

リクエストヘッダー

Host や Date など、名前変更リクエストに含まれる一般的なリクエストヘッダーの詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

名前変更リクエストへのレスポンスには、一般的なレスポンスヘッダーのみが含まれます。詳細については、「共通レスポンスヘッダー」をご参照ください。

例

リクエストの例

次のリクエスト例は、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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
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 用 OSS SDK

エラーコード