Object Storage Service:CopyObject

Versionamento

Por padrão, x-oss-copy-source copia a versão atual de um objeto. Para copiar uma versão específica, inclua o ID da versão em x-oss-copy-source. Se a versão de origem especificada for um marcador de exclusão, o OSS retornará um erro 404, indicando que o objeto não existe.

Restaure uma versão anterior de um objeto como a versão atual copiando-a para o mesmo bucket. O OSS definirá essa versão anterior como a versão atual.

Se o versionamento estiver ativado no bucket de destino, o OSS gerará automaticamente um ID de versão exclusivo para o novo objeto copiado. Esse ID de versão é retornado no cabeçalho de resposta x-oss-version-id. Caso o versionamento esteja desativado ou suspenso no bucket de destino, o OSS gerará uma versão com ID nulo para o novo objeto. Essa nova versão substituirá qualquer versão existente que possua um ID de versão nulo.

Limites

• Limites de tamanho do objeto

  • Quando os buckets de origem e destino são iguais e você não altera o método de criptografia nem a classe de armazenamento do objeto durante a cópia, o objeto pode ter mais de 5 GB.

  • Se os buckets de origem e destino forem diferentes e não houver alteração no método de criptografia ou na classe de armazenamento durante a cópia, o tamanho máximo permitido será de 5 GB.

  • Ao modificar o método de criptografia ou a classe de armazenamento do objeto durante a operação de cópia, o limite de tamanho será de 1 GB. Para objetos maiores que 1 GB nessas condições, utilize a operação UploadPartCopy.

• Permissões

  As operações CopyObject e UploadPartCopy exigem permissões de leitura no objeto de origem.

• Ao usar a operação CopyObject em um bucket com versionamento desativado, onde os objetos de origem e destino são idênticos:

  • Sem alterações no método de criptografia ou na classe de armazenamento, o OSS modifica apenas os metadados do objeto, sem copiar seu conteúdo.

  • Caso haja mudança no método de criptografia ou na classe de armazenamento, o OSS atualiza os metadados e também copia o conteúdo do objeto.

• Objeto de origem é um link simbólico

  Ao executar a operação CopyObject em um link simbólico, apenas o link é copiado. O conteúdo do arquivo referenciado pelo link simbólico não é transferido.

• Namespace hierárquico ativado no bucket

  Não é possível copiar diretórios se o namespace hierárquico estiver ativado para o bucket.

• Prevenção de conflitos de sobrescrita de arquivos

  Se você ativar a opção Prevent File Overwrite, não será possível usar o CopyObject para alterar a classe de armazenamento de um arquivo, como de Standard para Archive Storage. Nesse caso, prefira a conversão automática por ciclo de vida.

Permissões

Uma conta Alibaba Cloud possui permissões totais por padrão. Usuários RAM ou funções RAM vinculados a essa conta não têm nenhuma permissão inicialmente. A conta Alibaba Cloud ou o administrador deve conceder as permissões operacionais necessárias por meio de políticas do RAM ou Bucket Policy.

Faturamento

• Cada chamada à operação CopyObject conta como uma requisição PUT para o bucket de destino.

• A operação CopyObject aumenta o uso de armazenamento do bucket de destino.

• Alterar a classe de armazenamento de um objeto com a operação CopyObject envolve sobrescrita de dados. Por exemplo, se um objeto Infrequent Access (IA) for sobrescrito e tiver sua classe alterada para Standard dentro de 10 dias após a criação, haverá cobrança referente a 20 dias de armazenamento IA, pois a duração mínima não foi atingida. Para mais detalhes sobre taxas de armazenamento, consulte Taxas de armazenamento.

• Ao chamar a operação CopyObject, se o objeto de origem for do tipo IA, incorre-se em taxa de recuperação de dados de armazenamento IA. Se o objeto de origem for Archive Storage, ainda não restaurado via RestoreObject, e o acesso em tempo real a objetos Archive estiver ativado no bucket, aplica-se a taxa de recuperação para acesso em tempo real. Essas cobranças recaem sobre a conta proprietária do bucket de origem. Consulte Taxas de processamento de dados para mais informações sobre faturamento.

Sintaxe da requisição

PUT /DestObjectName HTTP/1.1
Host: DestBucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-copy-source: /SourceBucketName/SourceObjectName

Cabeçalhos da requisição

Todos os cabeçalhos de requisição para uma operação de cópia começam com x-oss-. Portanto, adicione todos esses cabeçalhos à string de assinatura.

Esta operação também utiliza cabeçalhos de requisição comuns, como Host e Date. Para mais informações, consulte Cabeçalhos de requisição comuns.

Cabeçalhos de resposta

Esta operação utiliza apenas cabeçalhos de resposta comuns. Consulte Cabeçalhos de resposta comuns para mais detalhes.

Elementos de resposta

Exemplos

• Versionamento desativado

  Requisição de exemplo

  PUT /test%2FAK.txt HTTP/1.1
  Host: tesx.oss-cn-zhangjiakou.aliyuncs.com
  Accept-Encoding: identity
  User-Agent: aliyun-sdk-python/2.6.0(Windows/7/AMD64;3.7.0)
  Accept: text/html
  Connection: keep-alive
  x-oss-copy-source: /test/AK.txt
  date: Fri, 28 Dec 2018 09:41:55 GMT
  authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Length: 0

  Resposta de exemplo

  x-oss-hash-crc64ecma indica o valor CRC de 64 bits do objeto. Esse valor é calculado conforme o padrão CRC-64/XZ. A operação CopyObject não garante que o objeto gerado possua um valor CRC de 64 bits.

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Fri, 28 Dec 2018 09:41:56 GMT
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  x-oss-request-id: 5C25EFE4462CE00EC6D87156
  ETag: "F2064A169EE92E9775EE5324D0B1****"
  x-oss-hash-crc64ecma: 12753002859196105360
  x-oss-server-time: 150
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"F2064A169EE92E9775EE5324D0B1****"</ETag>
    <LastModified>2018-12-28T09:41:56.000Z</LastModified>
  </CopyObjectResult>

• Copiar um objeto sem especificar ID de versão

  Requisição de exemplo

  PUT /dest-object-example HTTP/1.1
  Host: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /versioning-copy-source/source-object

  Resposta de exemplo

  Neste exemplo, x-oss-copy-source-version-id representa o ID de versão do objeto de origem, correspondendo neste caso à versão atual. Já x-oss-version-id indica o ID de versão do novo objeto copiado.

  HTTP/1.1 200 OK
  x-oss-copy-source-version-id: CAEQNRiBgIC28uaA0BYiIDY5OGIwNmNlNjYyMTRjNTc4N2M2OGNiMjZkZTQ2****
  x-oss-version-id: CAEQNxiBgIDG8uaA0BYiIGZhZDRkZTk5Zjg3YzRhNzdiMWEwZGViNDM1NTFh****
  x-oss-request-id: 5CAC155CB7AEADE01700****
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C81E728D9D4C2F636F067F89CC14****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult>

• Copiar um objeto especificando o ID de versão

  Requisição de exemplo

  PUT /dest-object-example HTTP/1.1
  Host: versioning-copy.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  x-oss-copy-source: /versioning-copy-source/source-object?versionId=CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy****

  Resposta de exemplo

  Neste cenário, x-oss-copy-source-version-id refere-se ao ID de versão do objeto de origem, conforme especificado no cabeçalho de requisição x-oss-copy-source. O campo x-oss-version-id contém o ID de versão atribuído ao novo objeto copiado.

  HTTP/1.1 200 OK
  x-oss-copy-source-version-id: CAEQNRiBgICv8uaA0BYiIDliZDc3MTc1NjE5MjRkMDI4ZGU4MTZkYjY1ZDgy****
  x-oss-version-id: CAEQNxiBgMDP8uaA0BYiIDIyNGNhZDQ1M2M3NzRkZThiNzE0N2I3ZDkxOWY4****
  x-oss-request-id: 5CAC155CB7AEADE01700****
  Content-Type: application/xml
  Content-Length: 184
  Connection: keep-alive
  Date: Tue, 09 Apr 2019 03:45:32 GMT
  Server: AliyunOSS
  <?xml version="1.0" encoding="UTF-8"?>
  <CopyObjectResult>
    <ETag>"C4CA4238A0B923820DCC509A6F75****"</ETag>
    <LastModified>2019-04-09T03:45:32.000Z</LastModified>
  </CopyObjectResult>

SDKs

Utilize os kits de desenvolvimento de software (SDKs) das linguagens abaixo para chamar esta operação.

• Java

• Python V2

• PHP V2

• Go V2

• Harmony

• C

• .NET

• Android

• iOS

• Node.js

• Ruby

• Browser.js

• C++

Ferramenta de linha de comando ossutil

Para o comando ossutil correspondente à operação CopyObject, consulte copy-object.

Códigos de erro

Perguntas frequentes

O CopyObject suporta cópia em lote de arquivos?

Não. A operação CopyObject serve para copiar um único arquivo. Para copiar vários arquivos em lote, utilize o ossutil. Para mais informações, consulte cp (copiar arquivos).