Bu işlemi bir dizini veya nesneyi yeniden adlandırmak için çağırabilirsiniz. Bu işlem yalnızca hiyerarşik ad alanı özelliği etkinleştirilmiş paketler için desteklenir.
Kullanım notları
Kaynak dizini veya nesneyi hedef dizine ya da nesneye yeniden adlandırmak için Rename işlemini çağırırken aşağıdaki hususlara dikkat edin:
Kaynak dizin veya nesne üzerinde DeleteObject iznine ve hedef dizin veya nesne üzerinde PutObject iznine sahip olmanız gerekir.
Hem kaynak dizin veya nesnenin hem de hedef dizin veya nesnenin adlarında yer alan üst dizin mevcut olmalıdır.
Kaynak dizin veya nesneyi yeniden adlandırmak için kullandığınız ad, hedef dizin veya nesnenin adında bulunan üst dizindeki mevcut bir dizin veya nesnenin adıyla aynı olamaz.
İstek yapısı
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
İstek üst bilgileri
|
|
|
|
|
|
|
|
|
|
Host ve Date gibi Rename isteklerinde yer alan ortak istek üst bilgileri hakkında daha fazla bilgi için bkz. Ortak istek üst bilgileri.
Yanıt üst bilgileri
Rename isteğine verilen yanıt yalnızca ortak yanıt üst bilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üst bilgileri.
Örnekler
Örnek istekler
Aşağıdaki örnek istek, desktop/osstest/ dizinindeki a adlı bir nesneyi b olarak yeniden adlandırmak için gönderilir.
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
Örnek yanıtlar
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
Hata kodları
|
Hata kodu |
HTTP durum kodu |
Açıklama |
|
AccessDenied |
403 |
Olası nedenler:
|
|
NoSuchKey |
404 |
Olası nedenler:
|
|
FileAlreadyExists |
409 |
Kaynak dizin veya nesneyi yeniden adlandırmak için kullandığınız ad, mevcut bir dizin veya nesnenin adıyla aynı olduğu için hata döndürüldü. |