Documentação do Oracle Cloud Infrastructure

Upload de um Objeto do Object Storage para um Bucket

Faça upload de um objeto para um bucket ou pasta no Object Storage.

Para fazer upload dos objetos maiores que 64 MiB, a Console usa uploads em várias partes. Você precisa das permissões OBJECT_CREATE e OBJECT_OVERWRITE para executar uploads em várias partes. Para obter detalhes, consulte Uploads Multiparte do Serviço Object Storage e Detalhes do Serviço Object Storage, do Serviço Archive Storage e do Serviço Data Transfer.

Use a opção de prefixo para pré-anexar um valor de prefixo ao nome de qualquer objeto que você fizer upload para o bucket. Você pode usar o prefixo para procurar no bucket apenas os objetos cujos nomes correspondam ao prefixo. Por exemplo, se você incluiu o prefixo "test" durante o upload de um objeto, todos os nomes de objetos incluídos são pré-anexados com esse valor de prefixo. Um objeto chamado "my-object.txt" é submetido a upload para o bucket como "testmy-object.txt".

Para obter mais informações sobre a criação de prefixos para objetos, consulte Nomenclatura de Objetos Usando Prefixos e Hierarquias.

Para obter mais informações sobre como procurar objetos em um bucket usando a opção de prefixo, Procurando Objetos em um Bucket.

    1. Na página de lista Buckets, selecione o bucket do serviço Object Storage com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o bucket, consulte Listando Buckets.
    2. Na página de detalhes do bucket, selecione Objetos.
      A guia Objetos é aberta. Todos os objetos no bucket selecionado são exibidos em uma tabela.
    3. Selecione Fazer Upload. Para fazer upload de objetos para uma pasta ou subpasta na lista Objetos, abra essa pasta e selecione Fazer Upload.
    4. Especifique as informações a seguir:
      • Prefixo de nome de objeto: (opcional) Se fornecido, este prefixo é pré-anexado a cada um dos arquivos que você fez upload.
        • Strings de prefixo com um delimitador de barra ("/") para simular hierarquia e criar pastas ou subpastas.
        • Strings de prefixo sem delimitador para fins de correspondência na execução de operações em massa permitidas.

        Para obter detalhes, consulte Nomeação de Objetos Usando Prefixos e Hierarquias.

      • Camada de armazenamento: Especifique o tipo de camada de armazenamento ao qual o objeto que está sendo submetido a upload pertence:
        • Camada padrão
        • Acesso não frequente
        • Arquivamento

        Consulte Camadas do Serviço Object Storage para obter descrições dos tipos de camada de armazenamento.

        Observação

        Os buckets da camada de armazenamento padrão podem conter uma mistura de objetos com diferentes designações da camada de armazenamento. Um objeto permanece no bucket Padrão, mesmo se for arquivado, restaurado ou se a designação de camada for alterada.
    5. Selecione os objetos dos quais você deseja fazer upload na caixa Escolher arquivos do seu computador usando um dos seguintes métodos:
      • Arraste um ou mais arquivos do computador para a caixa.
      • Selecione o link selecionar arquivos para exibir uma caixa de diálogo de seleção de arquivos na qual você pode navegar até os arquivos dos quais deseja fazer upload.

      Os arquivos selecionados para upload são exibidos em uma lista. Para remover o upload de um arquivo selecionado, selecione o X ao lado do nome do arquivo.

      Se os arquivos selecionados para upload já estiverem armazenados no bucket ou na pasta com o mesmo nome, a Console exibirá mensagens advertindo você sobre uma substituição.

    6. (Opcional) Selecione Cabeçalhos e metadados de resposta opcionais para especificar valores para cabeçalhos e metadados de resposta opcionais a serem exibidos na caixa de diálogo Detalhes do objeto.
      1. Selecione o tipo de atributo que você está adicionando:
        • Para adicionar um cabeçalho de resposta, selecione um valor na lista Nome e, em seguida, digite um valor na caixa Valor.
        • Para adicionar metadados, digite um valor na caixa Nome e, em seguida, digite um valor na caixa Valor.
      2. Para adicionar outro atributo, selecione Adicionar mais cabeçalhos ou metadados. Para excluir um atributo, selecione o X ao lado do atributo.
    7. Selecione Fazer Upload. Os objetos selecionados são transferidos por upload e exibidos na lista de objetos no bucket ou na pasta.

  • Use o comando oci os object put e os parâmetros necessários para fazer upload de um objeto para um bucket:

    oci os object put --bucket-name bucket_name --file file_location [OPTIONS]

    onde file_location é o caminho para o diretório de origem do objeto que está sendo carregado, como C:\workspace\Uploads\MyFile.txt ou /home/user/Documents/Uploads/MyFile.txt. O nome de objeto carregado não inclui as informações do caminho (por exemplo, C:\workspace\Uploads\), apenas o nome de arquivo real por si mesmo (MyFile.txt).

    O upload de um objeto pode ser feito como uma única parte ou como várias partes (multiparte). Use a opção --no-multipart para fazer upload como uma única parte. Para obter informações detalhadas sobre uploads em várias partes, consulte Uploads em Várias Partes do Serviço Object Storage.

    Para obter mais informações sobre atributos que você pode adicionar ao fazer upload de um objeto, consulte Cabeçalhos e Metadados de Resposta Opcionais.

    Para adicionar pares chave-valor de metadados personalizados, use a opção --metadata:

    oci os object put --bucket-name bucket_name --file file_location --name object_name  --metadata json_formatted_key-value_pairs
    em que JSON-formatted_key-value_pair é uma entrada de par de chave/valor como JSON formatado válido. Consulte Especificando Entrada de Dados Complexa e Usando um Arquivo JSON para Entrada de Dados Complexa para obter mais informações sobre a formatação JSON.

    Por exemplo:

    oci os object put --bucket-name MyBucket --file C:\workspace\MyFile.txt --metadata '{"Department": "Finance"}'
{
  "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e",
  "last-modified": "Wed, 20 Nov 2019 04:37:29 GMT",
  "opc-content-md5": "1B2M2Y8AsgTpgAmY7PhCfg=="
}

    Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

    Especificando a Camada de Armazenamento do Objeto Submetido a Upload

    Inclua o parâmetro storage-tier para designar uma camada de armazenamento ao objeto que você está fazendo upload.

    oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]

    Por exemplo, se você estiver fazendo upload para um bucket configurado pela camada Padrão e quiser designar o objeto à camada de armazenamento InfrequentAccess, inclua --storage-tier InfrequentAccess no comando:

    oci os object put --bucket-name MyStandardBucket --file C:\workspace\Uploads\MyDocument.txt --storage-tier InfrequentAccess
{
	"etag": "6b292c1a-b01b-4f36-97c8-4567fb43d071",
	"last-modified": "Sat, 12 Dec 2020 12:58:01 GMT",
	"opc-content-md5": "9P61OSaYe4fXxaeK8siuDw=="
}

    Consulte Camadas do Serviço Object Storage para obter mais informações sobre como as camadas de armazenamento funcionam.

    Se você não especificar uma camada de armazenamento no comando, o objeto será designado e transferido por upload automaticamente para a camada de armazenamento padrão do bucket (Padrão ou Arquivo Compactado).

    Nomeando o Objeto Submetido a Upload

    Inclua o parâmetro name para nomear o objeto de upload, excluindo seu caminho. Esse parâmetro será obrigatório se o objeto estiver sendo lido no STDIN. Por exemplo:

    oci os object put --bucket-name MyBucket --file C:\workspace\Uploads\MyFile.txt --name AboutMyCompany
{
	"etag": "cadb9f8a-3292-45e6-a1e8-f075699fb619",
	"last-modified": "Fri, 11 Dec 2020 14:04:19 GMT",
	"opc-content-md5": "9P61OSaYe4fXxaeK8siuDw=="
}

    Se você não incluir o parâmetro name, o nome do arquivo será usado como o nome do objeto submetido a upload (se não estiver sendo lido no STDIN)

  • Execute a operação PutObject para fazer upload de um objeto para um bucket.

    O serviço Object Storage pré-anexa a string de namespace do Object Storage e o nome do bucket ao nome do objeto ao construir um URL para uso com a API:

    /n/object_storage_namespace/b/bucket/o/object_name

    O nome do objeto é tudo após /o/, o que pode incluir níveis de hierarquia e strings de prefixo.