

# Editar metadados de objeto no console do Amazon S3
<a name="add-object-metadata"></a>

Você pode usar o console do Amazon S3 para editar metadados de objetos do S3 existentes por meio da ação **Copiar**. Para editar metadados, você copia objetos para o mesmo destino e especifica os novos metadados que deseja aplicar, os quais substituem os metadados antigos do objeto. Alguns metadados são definidos pelo Amazon S3 quando você faz upload do objeto. Por exemplo, `Content-Length` e `Last-Modified` são campos de metadados de objetos definidos pelo sistema que não podem ser modificados por um usuário.

Você também pode definir metadados definidos pelo usuário ao carregar o objeto e depois substituí-lo conforme suas necessidades mudarem. Por exemplo, você pode ter um conjunto de objetos que você armazena inicialmente na classe de armazenamento `STANDARD`. Com o tempo, pode ser que você não precise mais que esses dados estejam altamente disponíveis. Desse modo, você pode alterar a classe de armazenamento para `GLACIER` substituindo o valor da chave `x-amz-storage-class` de `STANDARD` para `GLACIER`.

**nota**  
Considere o seguinte ao substituir metadados de objeto no Amazon S3:  
É necessário especificar os metadados existentes que deseja reter, os que deseja adicionar e os que deseja editar.
Se o objeto tiver menos de 5 GB, você poderá usar a ação **Copiar** no console do S3 para substituir os metadados do objeto. Se o objeto tiver mais de 5 GB, você poderá substituir os metadados do objeto ao copiá-lo com multipart upload usando a [AWS CLI](mpu-upload-object.md#UsingCLImpUpload) ou os [SDKs da AWS](CopyingObjectsMPUapi.md). Para obter mais informações, consulte [Copiar um objeto usando multipart upload](CopyingObjectsMPUapi.md).
Para obter uma lista das permissões adicionais necessárias para substituir metadados, consulte [Permissões obrigatórias para operações de API do Amazon S3](using-with-s3-policy-actions.md). Para ver exemplos das políticas que concedem essas permissões, consulte [Exemplos de políticas baseadas em identidade para o Amazon S3](example-policies-s3.md).
Essa ação cria uma *cópia* do objeto com configurações atualizadas e a data da última modificação. Se o versionamento do S3 estiver habilitado, uma nova versão do objeto será criada e o objeto existente se tornará uma versão mais antiga. Se a funcionalidade Versionamento do S3 não estiver habilitada, uma nova cópia do objeto substituirá o original. A Conta da AWS associada ao perfil do IAM que altera a propriedade também se torna a proprietária do novo objeto ou (versão do objeto).
Ao editar os metadados, os valores referentes a nomes de chave existentes são substituídos.
Objetos criptografados com chaves de criptografia fornecidas pelo cliente (SSE-C) não podem ser copiados usando o console. Você deve usar a AWS CLI, o AWS SDK ou a API REST do Amazon S3.
Ao copiar um objeto usando o console do Amazon S3, você pode receber a seguinte mensagem de erro: “Não é possível verificar os metadados copiados.” O console usa cabeçalhos para recuperar e definir metadados para o objeto. Se a configuração da rede ou do navegador modificar as solicitações de rede, esse comportamento poderá fazer com que metadados não intencionais (como cabeçalhos `Cache-Control` modificados) sejam gravados no objeto copiado. O Amazon S3 não pode verificar esses metadados não intencionais.  
Para resolver esse problema, verifique a configuração da rede e do navegador para garantir que não modifique cabeçalhos, como `Cache-Control`. Para ter mais informações, consulte o [Modelo de Responsabilidade Compartilhada](https://docs.aws.amazon.com/whitepapers/latest/applying-security-practices-to-network-workload-for-csps/the-shared-responsibility-model.html).

**Atenção**  
Ao substituir metadados referentes a pastas, aguarde a conclusão da ação **Copiar** antes de adicionar novos objetos à pasta. Caso contrário, novos objetos também podem ser editados.

Os tópicos a seguir descrevem como substituir metadados de um objeto usando a ação **Copiar** no console do Amazon S3.

## Substituir metadados definidos pelo sistema
<a name="add-object-metadata-system"></a>

Você pode configurar alguns metadados definidos pelo sistema para um objeto do S3. Para ter uma lista de metadados definidos pelo sistema e de valores que você pode modificar, consulte [Metadados do objeto definidos pelo sistema](UsingMetadata.md#SysMetadata).

**Como substituir metadados definidos pelo sistema de um objeto**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de uso geral** ou **Buckets de diretórios**.

1. Na lista de buckets, escolha o nome do bucket que contém os objetos que você deseja alterar.

1. Marque a caixa de seleção referente aos objetos que você quer alterar.

1. No menu **Ações**, escolha **Copiar** na lista de opções exibida.

1. Para especificar o caminho de destino, escolha **Procurar S3**, navegue até o mesmo destino dos objetos de origem e marque a caixa de seleção do destino. Escolha **Choose destination** (Escolher destino) no canto inferior direito. 

   Outra alternativa é inserir o caminho de destino. 

1. Se o versionamento de bucket *não* estiver habilitado, você verá um aviso recomendando que o habilite para ajudar a impedir a substituição ou exclusão involuntária de objetos. Se você quiser manter todas as versões de objetos neste bucket, selecione **Enable Bucket Versioning** (Ativar versionamento de bucket). Você também pode atualizar as propriedades de criptografia padrão e do Bloqueio de Objetos em **Detalhes do destino**.

1. Em **Configurações adicionais de cópia**, escolha **Especificar configurações** para especificar configurações para **Metadados**.

1. Role até a seção **Metadados** e escolha **Substituir todos os metadados**.

1. Escolha **Add Metadata** (Adicionar metadados).

1. Para **Type (Tipo)** de metadados, selecione **System-defined (Definidos pelo sistema)**.

1. Especifique uma **key (chave)** exclusiva e o **value (valor)** dos metadados.

1. Para editar metadados adicionais, escolha **Add metadata (Adicionar metadados)**. Você também pode escolher **Remove (Remover)** para remover um conjunto de valores de chave de tipo.

1. Escolha **Copiar**. O Amazon S3 salva as alterações feitas nos metadados.

## Substituir metadados definidos pelo usuário
<a name="add-object-metadata-user-defined"></a>

Você pode substituir metadados definidos pelo usuário de um objeto usando o prefixo de metadados, `x-amz-meta-`, e um nome escolhido para criar uma chave personalizada. Por exemplo, se você adicionar o nome personalizado `alt-name`, a chave de metadados será `x-amz-meta-alt-name`. 

Metadados definidos pelo usuário podem ter até 2 KB no total. Para calcular o tamanho total dos metadados definidos pelo usuário, some o número de bytes na codificação UTF-8 referente a cada chave e valor. As duas chaves e seus valores devem estar em conformidade com os padrões US-ASCII. Para obter mais informações, consulte [Metadados do objeto definidos pelo usuário](UsingMetadata.md#UserMetadata).

**Como substituir metadados definidos pelo usuário de um objeto**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação, escolha **Buckets** e selecione a guia **Buckets de uso geral** ou **Buckets de diretório**. Acesse o bucket ou pasta do Amazon S3 que contém os objetos que você quer alterar.

1. Marque a caixa de seleção referente aos objetos que você quer alterar.

1. No menu **Ações**, escolha **Copiar** na lista de opções exibida.

1. Para especificar o caminho de destino, escolha **Procurar S3**, navegue até o mesmo destino dos objetos de origem e marque a caixa de seleção do destino. Escolha **Choose destination (Escolher destino)**. 

   Outra alternativa é inserir o caminho de destino. 

1. Se o versionamento de bucket *não* estiver habilitado, você verá um aviso recomendando que o habilite para ajudar a impedir a substituição ou exclusão involuntária de objetos. Se você quiser manter todas as versões de objetos neste bucket, selecione **Enable Bucket Versioning** (Ativar versionamento de bucket). Você também pode atualizar as propriedades de criptografia padrão e do Bloqueio de Objetos em **Detalhes do destino**.

1. Em **Configurações adicionais de cópia**, escolha **Especificar configurações** para especificar configurações para **Metadados**.

1. Role até a seção **Metadados** e escolha **Substituir todos os metadados**.

1. Escolha **Add Metadata** (Adicionar metadados).

1. Para **Type (Tipo)** de metadados, escolha **User-defined (Definido pelo usuário)**.

1. Insira uma **Key (Chave)** personalizada única após `x-amz-meta-`. Insira também um **value (valor)** dos metadados.

1. Para adicionar metadados extras, escolha **Add metadata (Adicionar metadados)**. Você também pode escolher **Remove (Remover)** para remover um conjunto de valores de chave de tipo. 

1. Escolha **Copiar**. O Amazon S3 salva as alterações feitas nos metadados.