Sube objetos

En esta página, se describen opciones para subir objetos a tu depósito de Cloud Storage. Un objeto subido consiste en los datos que deseas almacenar junto con metadatos asociados. A fin de obtener una descripción general de los objetos, lee los Términos clave y consulta los Requisitos para nombrar objetos.

Console

Abre el navegador de Cloud Storage en Google Cloud Platform Console.
Abrir el navegador de Cloud Storage
En la lista de depósitos, haz clic en el nombre del depósito en el que deseas subir un objeto.
En la pestaña de objetos para el depósito, realiza una de estas dos acciones:
- Arrastra y suelta los archivos deseados desde tu escritorio o administrador de archivos en el panel principal en GCP Console.
- Haz clic en el botón Subir archivos, selecciona los archivos que deseas subir en el cuadro de diálogo que aparece y haz clic en Abrir.
Nota: Si usas el navegador Chrome, las cargas de carpetas también son compatibles.

gsutil

Usa el comando gsutil cp:

gsutil cp [OBJECT_LOCATION] gs://[DESTINATION_BUCKET_NAME]/

donde:

[OBJECT_LOCATION] es la ruta local hacia tu objeto. Por ejemplo, Desktop/dog.png.
[DESTINATION_BUCKET_NAME] es el nombre del depósito al que subes el objeto. Por ejemplo, my-bucket.

Si es correcto, la respuesta se parece al siguiente ejemplo:

Operation completed over 1 objects/58.8 KiB.

Ejemplos de código

C++

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string file_name, std::string bucket_name,
   std::string object_name) {
  // Note that the client library automatically computes a hash on the
  // client-side to verify data integrity during transmission.
  StatusOr<gcs::ObjectMetadata> object_metadata = client.UploadFile(
      file_name, bucket_name, object_name, gcs::IfGenerationMatch(0));

  if (!object_metadata) {
    throw std::runtime_error(object_metadata.status().message());
  }

  std::cout << "Uploaded " << file_name << " to object "
            << object_metadata->name() << " in bucket "
            << object_metadata->bucket()
            << "\nFull metadata: " << *object_metadata << "\n";
}

C#

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.

Ver en GitHub Comentarios

private void UploadFile(string bucketName, string localPath,
    string objectName = null)
{
    var storage = StorageClient.Create();
    using (var f = File.OpenRead(localPath))
    {
        objectName = objectName ?? Path.GetFileName(localPath);
        storage.UploadObject(bucketName, objectName, null, f);
        Console.WriteLine($"Uploaded {objectName}.");
    }
}

Go

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.

Ver en GitHub Comentarios

f, err := os.Open("notes.txt")
if err != nil {
	return err
}
defer f.Close()

wc := client.Bucket(bucket).Object(object).NewWriter(ctx)
if _, err = io.Copy(wc, f); err != nil {
	return err
}
if err := wc.Close(); err != nil {
	return err
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

Ver en GitHub Comentarios

Storage storage = StorageOptions.getDefaultInstance().getService();
BlobId blobId = BlobId.of("bucket", "blob_name");
BlobInfo blobInfo = BlobInfo.newBuilder(blobId).setContentType("text/plain").build();
Blob blob = storage.create(blobInfo, "Hello, Cloud Storage!".getBytes(UTF_8));

Node.js

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.

Ver en GitHub Comentarios

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';
// const filename = 'Local file to upload, e.g. ./local/path/to/file.txt';

// Uploads a local file to the bucket
await storage.bucket(bucketName).upload(filename, {
  // Support for HTTP requests made with `Accept-Encoding: gzip`
  gzip: true,
  // By setting the option `destination`, you can change the name of the
  // object you are uploading to a bucket.
  metadata: {
    // Enable long-lived HTTP caching headers
    // Use only if the contents of the file will never change
    // (If the contents will change, use cacheControl: 'no-cache')
    cacheControl: 'public, max-age=31536000',
  },
});

console.log(`${filename} uploaded to ${bucketName}.`);

PHP

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.

Ver en GitHub Comentarios

use Google\Cloud\Storage\StorageClient;

/**
 * Upload a file.
 *
 * @param string $bucketName the name of your Google Cloud bucket.
 * @param string $objectName the name of the object.
 * @param string $source the path to the file to upload.
 *
 * @return Psr\Http\Message\StreamInterface
 */
function upload_object($bucketName, $objectName, $source)
{
    $storage = new StorageClient();
    $file = fopen($source, 'r');
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->upload($file, [
        'name' => $objectName
    ]);
    printf('Uploaded %s to gs://%s/%s' . PHP_EOL, basename($source), $bucketName, $objectName);
}

Python

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.

Usa los métodos Blob.upload_from_file(), Blob.upload_from_filename() o Blob.upload_from_string() para subir un objeto.

Ver en GitHub Comentarios

def upload_blob(bucket_name, source_file_name, destination_blob_name):
    """Uploads a file to the bucket."""
    storage_client = storage.Client()
    bucket = storage_client.get_bucket(bucket_name)
    blob = bucket.blob(destination_blob_name)

    blob.upload_from_filename(source_file_name)

    print('File {} uploaded to {}.'.format(
        source_file_name,
        destination_blob_name))

Ruby

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.

Ver en GitHub Comentarios

# project_id        = "Your Google Cloud project ID"
# bucket_name       = "Your Google Cloud Storage bucket name"
# local_file_path   = "Path to local file to upload"
# storage_file_path = "Path to store the file in Google Cloud Storage"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new project_id: project_id
bucket  = storage.bucket bucket_name

file = bucket.create_file local_file_path, storage_file_path

puts "Uploaded #{file.name}"

API de REST

API de JSON

Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
Usa cURL para llamar a la API de JSON con una solicitud de objeto POST:
```
curl -X POST --data-binary @[OBJECT_LOCATION] \
-H "Authorization: Bearer [OAUTH2_TOKEN]" \
-H "Content-Type: [OBJECT_CONTENT_TYPE]" \
"https://www.googleapis.com/upload/storage/v1/b/[BUCKET_NAME]/o?uploadType=media&name=[OBJECT_NAME]"
```
donde:
- [OBJECT_LOCATION] es la ruta local hacia tu objeto. Por ejemplo, Desktop/dog.png.
- [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
- [OBJECT_CONTENT_TYPE] es el tipo de contenido del objeto. Por ejemplo, image/png.
- [BUCKET_NAME] es el nombre del depósito al que subes el objeto. Por ejemplo, my-bucket.
- [OBJECT_NAME] es el nombre nuevo que deseas dar a tu objeto. Por ejemplo, pets/dog.png.

API de XML

Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
Usa cURL para llamar a la API de XML con una solicitud de objeto PUT:
```
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]"
```
donde:
- [OBJECT_LOCATION] es la ruta local hacia tu objeto. Por ejemplo, Desktop/dog.png.
- [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
- [OBJECT_CONTENT_TYPE] es el tipo de contenido del objeto. Por ejemplo, image/png.
- [BUCKET_NAME] es el nombre del depósito al que subes el objeto. Por ejemplo, my-bucket.
- [OBJECT_NAME] es el nombre nuevo que deseas dar a tu objeto. Por ejemplo, pets/dog.png.

Qué sigue

Haz que tus datos sean de acceso público.
Visualiza y edita los metadatos de tu objeto.
Obtén más información sobre cómo trabajar con objetos en tus depósitos de Cloud Storage.
Controla quién tiene acceso a tus objetos y depósitos.
Obtén información sobre cargas paralelas y objetos compuestos.

¿Te sirvió esta página? Envíanos tu opinión:

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Última actualización: Noviembre 21, 2019

Sube objetos

Console

gsutil

Ejemplos de código

C++

C#

Go

Java

Node.js

PHP

Python

Ruby

API de REST

API de JSON

API de XML

Qué sigue

Enviar comentarios sobre…