Ganti Nama - Object Storage Service

Operasi ini digunakan untuk mengganti nama direktori atau objek dan hanya mendukung bucket dengan fitur namespace hierarkis diaktifkan.

Catatan penggunaan

Saat menggunakan operasi Ganti Nama untuk mengubah nama direktori atau objek sumber menjadi direktori atau objek tujuan, perhatikan hal-hal berikut:

Anda memerlukan izin DeleteObject pada direktori atau objek sumber serta izin PutObject pada direktori atau objek tujuan.
Direktori induk dari direktori atau objek sumber dan tujuan harus sudah ada.
Nama baru yang diberikan untuk direktori atau objek sumber tidak boleh sama dengan nama direktori atau objek lain yang sudah ada dalam direktori induk tujuan.

Struktur permintaan

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

Header permintaan

Header	Tipe	Diperlukan	Deskripsi
x-oss-rename-source	String	Ya	Jalur absolut dari direktori atau objek sumber. Contoh: desktop/oss/a. Jalur tersebut harus ada di bucket sumber.

Untuk informasi lebih lanjut tentang header permintaan umum seperti Host dan Date, lihat Header Permintaan Umum.

Header respons

Respons terhadap permintaan Ganti Nama hanya mencakup header respons umum. Untuk detail lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

Permintaan berikut mengganti nama objek bernama a di direktori desktop/osstest/ menjadi 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

Contoh Respons

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

OSS SDK for Java

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
AccessDenied	403	Penyebab yang mungkin: Anda tidak memiliki izin untuk mengakses bucket yang ditentukan dalam permintaan. Anda tidak memiliki izin untuk mengakses direktori atau objek yang ingin Anda ganti namanya.
NoSuchKey	404	Penyebab yang mungkin: Direktori atau objek sumber yang ingin Anda ganti namanya tidak ada. Direktori induk yang termasuk dalam nama direktori atau objek sumber tidak ada.
FileAlreadyExists	409	Pesan kesalahan yang dikembalikan karena nama yang Anda gunakan untuk mengganti nama direktori atau objek sumber sama dengan nama direktori atau objek yang sudah ada.