Nesta página, mostramos como fazer o upload de objetos para um bucket do Cloud Storage. Um objeto enviado por upload consiste nos dados que você quer armazenar com os metadados associados. Para uma visão geral conceitual, consulte Uploads e downloads.
Console
- Abra o navegador do Cloud Storage no Console do Google Cloud.
Abrir o navegador do Cloud Storage Na lista de buckets, clique no nome daquele que receberá o upload de um objeto.
Na guia Objetos do bucket, realize uma destas ações:
Arraste e solte os arquivos que você quer enviar da área de trabalho ou do gerenciador de arquivos para o painel principal no Console do Cloud.
Clique no botão Fazer upload de arquivos, selecione os arquivos que você quer enviar na caixa de diálogo exibida e clique em Abrir.
Consulte a Solução de problemas para informações detalhadas sobre erros de operações com falha no navegador do Cloud Storage.
gsutil
Use o comando gsutil cp
:
gsutil cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME/
Em que:
OBJECT_LOCATION
é o caminho local do objeto. Por exemplo,Desktop/dog.png
.DESTINATION_BUCKET_NAME
é o nome do bucket para o qual você está fazendo o upload do objeto. Por exemplo,my-bucket
.
Se funcionar, a resposta será parecida com esta:
Operation completed over 1 objects/58.8 KiB.
Amostras de código
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage para C++.
C#
Para mais informações, consulte a documentação de referência da API Cloud Storage para C#.
Go
Para mais informações, consulte a documentação de referência da API Cloud Storage para Go.
Java
Para mais informações, consulte a documentação de referência da API Cloud Storage para Java.
Node.js
Para mais informações, consulte a documentação de referência da API Cloud Storage para Node.js.
Para mais informações sobre como fazer upload de um stream, string ou buffer, consulte File.save().PHP
Para mais informações, consulte a documentação de referência da API Cloud Storage para PHP.
Python
Para mais informações, consulte a documentação de referência da API Cloud Storage para Python.
Use o método Blob.upload_from_file(), Blob.upload_from_filename() ou Blob.upload_from_string() para fazer upload de um objeto.Ruby
Para mais informações, consulte a documentação de referência da API Cloud Storage para Ruby.
APIs REST
API JSON
Upload de solicitação única sem metadados de objeto
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth.
Use
cURL
para chamar a API JSON com uma solicitação de objetoPOST
:curl -X POST --data-binary @OBJECT_LOCATION \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ "https://storage.googleapis.com/upload/storage/v1/b/BUCKET_NAME/o?uploadType=media&name=OBJECT_NAME"
Em que:
OBJECT_LOCATION
é o caminho local do objeto. Por exemplo,Desktop/dog.png
.OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;OBJECT_CONTENT_TYPE
é o tipo de conteúdo do objeto. Por exemplo,image/png
.BUCKET_NAME
é o nome do bucket para o qual você está fazendo o upload do objeto. Por exemplo,my-bucket
.OBJECT_NAME
é o nome que você quer dar ao objeto. Por exemplo,pets/dog.png
.
Upload de solicitação única com metadados de objeto
- Receba um token de acesso de autorização do OAuth 2.0 Playground. Configure o Playground para usar suas credenciais do OAuth.
Crie um arquivo
multipart/related
com estas informações:--BOUNDARY_STRING Content-Type: application/json; charset=UTF-8 OBJECT_METADATA --BOUNDARY_STRING Content-Type: OBJECT_CONTENT_TYPE OBJECT_DATA --BOUNDARY_STRING--
Em que:
BOUNDARY_STRING
é uma string que você define e identifica as partes do arquivo de várias partes. Por exemplo,my-boundary
.OBJECT_METADATA
são os metadados que você quer incluir no arquivo, no formato JSON. No mínimo, essa seção precisa incluir um atributoname
para o objeto, por exemplo,{"name": "myObject"}
OBJECT_CONTENT_TYPE
é o tipo de conteúdo do objeto. Por exemplo,image/png
.OBJECT_DATA
são os dados do objeto.
Use
cURL
para chamar a API JSON com uma solicitação de objetoPOST
:curl -X POST --data-binary @MULTIPART_FILE_LOCATION \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: multipart/related; boundary=BOUNDARY_STRING" \ -H "Content-Length: MULTIPART_FILE_SIZE" \ "https://storage.googleapis.com/upload/storage/v1/b/BUCKET_NAME/o?uploadType=multipart"
Em que:
MULTIPART_FILE_LOCATION
é o caminho local para o arquivo de várias partes criado na etapa 2. Por exemplo,Desktop/my-upload.multipart
.OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;BOUNDARY_STRING
é a string de limite definida na etapa 2. Por exemplo,my-boundary
.MULTIPART_FILE_SIZE
é o tamanho total, em bytes, do arquivo de várias partes criado na etapa 2. Por exemplo,2000000
.BUCKET_NAME
é o nome do bucket de upload do objeto. Por exemplo,my-bucket
.
Se a solicitação for bem-sucedida, o servidor retornará o código
de status HTTP 200 OK
junto com os metadados do arquivo.
API XML
- Consiga um token de acesso de autorização do OAuth 2.0 Playground (em inglês). Configure o Playground para usar suas credenciais do OAuth.
Use
cURL
para chamar a API XML com uma solicitação de objetoPUT
:curl -X PUT --data-binary @OBJECT_LOCATION \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Em que:
OBJECT_LOCATION
é o caminho local do objeto. Por exemplo,Desktop/dog.png
.OAUTH2_TOKEN
é o token de acesso gerado na etapa 1;OBJECT_CONTENT_TYPE
é o tipo de conteúdo do objeto. Por exemplo,image/png
.BUCKET_NAME
é o nome do bucket para o qual você está fazendo o upload do objeto. Por exemplo,my-bucket
.OBJECT_NAME
é o nome que você quer dar ao objeto. Por exemplo,pets/dog.png
.
A seguir
- Consulte a visão geral conceitual para saber mais sobre uploads e downloads.
- Saiba mais sobre requisitos de nomenclatura para objetos.
- Transferir objetos da instância do Compute Engine.
- Torne seus dados acessíveis publicamente.
- Veja e edite os metadados do objeto.
- Controle o acesso aos objetos e buckets.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Novos clientes também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Faça uma avaliação gratuita do Cloud Storage