Object Storage Service:Renomear

Observações de uso

Ao usar a operação Rename para renomear o diretório ou objeto source para o diretório ou objeto de destino, observe os seguintes pontos:

• Você deve ter a permissão DeleteObject no diretório ou objeto source e a permissão PutObject no diretório ou objeto de destino.

• O diretório pai presente nos nomes do diretório ou objeto source e do diretório ou objeto de destino deve existir.

• O novo nome atribuído ao diretório ou objeto source não pode ser igual ao de um diretório ou objeto já existente no diretório pai especificado no caminho de destino.

Estrutura da solicitação

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

Cabeçalhos da solicitação

Para obter mais informações sobre os cabeçalhos de solicitação comuns incluídos nas solicitações Rename, como Host e Date, consulte Cabeçalhos de solicitação comuns.

Cabeçalhos da resposta

A resposta a uma solicitação Rename contém apenas cabeçalhos de resposta comuns. Para mais detalhes, consulte Cabeçalhos de resposta comuns.

Exemplos

Exemplos de solicitações

O exemplo abaixo mostra uma solicitação enviada para renomear um objeto chamado a, localizado no diretório desktop/osstest/, para 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

Exemplos de respostas

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

Códigos de erro