Renommer - Object Storage Service - Centre de documentation Alibaba Cloud

Cette opération permet de renommer un répertoire ou un objet. Elle est uniquement prise en charge par les buckets pour lesquels la fonctionnalité d'espace de noms hiérarchique est activée.

Notes d'utilisation

Lors de l'appel de l'opération Rename pour renommer le répertoire ou l'objet source vers sa destination, tenez compte des points suivants :

Vous devez disposer de l'autorisation DeleteObject sur le répertoire ou l'objet source, ainsi que de l'autorisation PutObject sur le répertoire ou l'objet de destination.
Le répertoire parent inclus dans les noms du répertoire ou de l'objet source et de destination doit exister.
Le nouveau nom du répertoire ou de l'objet source ne doit pas être identique à celui d'un répertoire ou d'un objet existant dans le répertoire parent de la destination.

Structure de la requête

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

En-têtes de requête

Header

Type

Required

Description

x-oss-rename-source

String

Yes

Chemin absolu du répertoire ou de l'objet source. Exemple : desktop/oss/a. Le chemin doit exister dans le bucket source.

Pour plus d'informations sur les en-têtes de requête communs inclus dans les requêtes Rename, tels que Host et Date, consultez la section En-têtes de requête communs.

En-têtes de réponse

La réponse à une requête Rename contient uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes de réponse communs.

Exemples

Exemples de requêtes

L'exemple suivant montre comment renommer l'objet a situé dans le répertoire desktop/osstest/ en 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

Exemples de réponses

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

SDK OSS pour Java

Codes d'erreur

Error code	HTTP status code	Description
AccessDenied	403	Causes possibles : Vous ne disposez pas des autorisations nécessaires pour accéder au bucket spécifié dans la requête. Vous ne disposez pas des autorisations nécessaires pour accéder au répertoire ou à l'objet que vous souhaitez renommer.
NoSuchKey	404	Causes possibles : Le répertoire ou l'objet source que vous souhaitez renommer n'existe pas. Le répertoire parent inclus dans le nom du répertoire ou de l'objet source n'existe pas.
FileAlreadyExists	409	Le message d'erreur indique que le nouveau nom attribué au répertoire ou à l'objet source est identique à celui d'un répertoire ou d'un objet existant.