Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Yeniden adlandırma

Son Güncelleme:Oct 01, 2026

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


Üst Bilgi


Tür


Gerekli


Açıklama


x-oss-rename-source


Dize


Evet


Kaynak dizinin veya nesnenin mutlak yolu. Örnek: desktop/oss/a. Yolun kaynak pakette mevcut olması gerekir.

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

Java için OSS SDK

Hata kodları

Hata kodu

HTTP durum kodu

Açıklama

AccessDenied

403

Olası nedenler:

  • İstekte belirtilen pakete erişim izniniz yok.

  • Yeniden adlandırmak istediğiniz dizine veya nesneye erişim izniniz yok.

NoSuchKey

404

Olası nedenler:

  • Yeniden adlandırmak istediğiniz kaynak dizin veya nesne mevcut değil.

  • Kaynak dizin veya nesnenin adında yer alan üst dizin mevcut değil.

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ü.