Editar metadados de objeto no console do Amazon S3 - Amazon Simple Storage Service

Editar metadados de objeto no console do Amazon S3

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:

  • Você deve 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 carregamento fracionado usando a AWS CLI ou os SDKs da AWS. Para ter mais informações, consulte Copiar um objeto usando multipart upload.

  • 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. Para ver exemplos das políticas que concedem essas permissões, consulte Exemplos de políticas baseadas em identidade para o Amazon S3.

  • 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 o versionamento do S3 não estiver habilitado, 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.

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.

Você pode configurar alguns metadados definidos pelo sistema para um objeto do S3. Para obter uma lista de metadados definidos pelo sistema e de valores que você pode modificar, consulte Metadados do objeto definidos pelo sistema.

Como substituir metadados definidos pelo sistema de um objeto

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. 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.

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

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

  5. 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.

  6. 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.

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

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

  9. Escolha Add Metadata (Adicionar metadados).

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

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

  12. 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.

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

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 ter mais informações, consulte Metadados do objeto definidos pelo usuário.

Como substituir metadados definidos pelo usuário de um objeto

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. 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.

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

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

  5. 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.

  6. 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.

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

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

  9. Escolha Add Metadata (Adicionar metadados).

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

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

  12. 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.

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