Sube objetos

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

Console

1. Abre el navegador de Cloud Storage en Google Cloud Platform Console.
   Abrir el navegador de Cloud Storage

2. En la lista de depósitos, haz clic en el nombre del depósito en el que quieres subir un objeto.

3. 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, también son compatibles las subidas de carpetas.

gsutil

Usa el comando gsutil cp para reemplazar [VALUES_IN_BRACKETS] con los valores adecuados:

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

Si se realiza con éxito, la respuesta se verá como en el ejemplo a continuación:

Operation completed over 1 objects/58.8 KiB.

Ejemplos de código

C++

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

Alfa

Esta es una versión Alfa de C++ Client Library for Cloud Storage. En esta biblioteca se pueden producir cambios que generen incompatibilidad con versiones anteriores y is no se recomienda su uso en fase de producción. No está is sujetas a ningún ANS o política de baja del servicio.

google/cloud/storage/examples/storage_object_samples.cc

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> meta = client.UploadFile(
      file_name, bucket_name, object_name, gcs::IfGenerationMatch(0));
  if (!meta.ok()) {
    std::cerr << "Error uploading file " << file_name << " to bucket "
              << bucket_name << " as object " << object_name
              << ", status=" << meta.status() << std::endl;
    return;
  }
  std::cout << "Uploaded " << file_name << " to object " << meta->name()
            << " in bucket " << meta->bucket() << "\nFull metadata: " << *meta
            << std::endl;
}

C#

A fin de 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

A fin de 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

A fin de 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

A fin de 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,
  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

A fin de 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

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

Usa el método 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

A fin de 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

1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas para usar tus propias credenciales de OAuth.
2. Agrega los datos del objeto al cuerpo de la solicitud.
3. Usa cURL para llamar a la API de JSON, con una solicitud de Objeto POST, reemplaza [VALUES_IN_BRACKETS] con los valores apropiados:

   curl -X POST --data-binary @[OBJECT] \
       -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]"

Consulta Realiza una carga simple para obtener más información sobre cómo subir objetos con la API de JSON.

API de XML

1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura la zona de pruebas para usar tus propias credenciales de OAuth.
2. Agrega los datos del objeto al cuerpo de la solicitud.
3. Usa cURL para llamar a la API de XML, con una solicitud de Objeto PUT, reemplaza [VALUES_IN_BRACKETS] con los valores apropiados:

   curl -X PUT --data-binary @[OBJECT] \
       -H "Authorization: Bearer [OAUTH2_TOKEN]" \
       -H "Content-Type: [OBJECT_CONTENT_TYPE]" \
       "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]"

Pasos siguientes

• 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 subidas paralelas y objetos para redactar.