Descargar objetos

En esta página, se muestra cómo descargar objetos de tus depósitos en Cloud Storage. Para obtener una descripción general de los objetos, consulta los Términos clave.

Nota: Si usas claves de encriptación proporcionadas por los clientes con tus objetos, consulta Usa claves de encriptación proporcionadas por los clientes para obtener instrucciones de descarga.

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 que contiene el objeto que quieres descargar y navega hacia él.

3. Haz clic derecho en el objeto que quieres descargar.

4. Guarda el objeto en la carpeta local que desees.

   Para el navegador Chrome, la opción de guardar aparece como Guardar vínculo como…

gsutil

Usa el comando gsutil cp y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

gsutil cp gs://[BUCKET_NAME]/[OBJECT_NAME] [OBJECT_DESTINATION]

Si se realiza de forma correcta, la respuesta se verá como el ejemplo a continuación:

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

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;
[](gcs::Client client, std::string bucket_name, std::string object_name) {
  gcs::ObjectReadStream stream = client.ReadObject(bucket_name, object_name);
  int count = 0;
  while (!stream.eof()) {
    std::string line;
    std::getline(stream, line, '\n');
    ++count;
  }
  std::cout << "The object has " << count << " lines" << std::endl;
}

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 DownloadObject(string bucketName, string objectName,
    string localPath = null)
{
    var storage = StorageClient.Create();
    localPath = localPath ?? Path.GetFileName(objectName);
    using (var outputFile = File.OpenWrite(localPath))
    {
        storage.DownloadObject(bucketName, objectName, outputFile);
    }
    Console.WriteLine($"downloaded {objectName} to {localPath}.");
}

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

rc, err := client.Bucket(bucket).Object(object).NewReader(ctx)
if err != nil {
	return nil, err
}
defer rc.Close()

data, err := ioutil.ReadAll(rc)
if err != nil {
	return nil, err
}
return data, nil

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

// The name of the bucket to access
// String bucketName = "my-bucket";

// The name of the remote file to download
// String srcFilename = "file.txt";

// The path to which the file should be downloaded
// Path destFilePath = Paths.get("/local/path/to/file.txt");

// Instantiate a Google Cloud Storage client
Storage storage = StorageOptions.getDefaultInstance().getService();

// Get specific file from specified bucket
Blob blob = storage.get(BlobId.of(bucketName, srcFilename));

// Download file to specified path
blob.downloadTo(destFilePath);

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 srcFilename = 'Remote file to download, e.g. file.txt';
// const destFilename = 'Local destination for file, e.g. ./local/path/to/file.txt';

const options = {
  // The path to which the file should be downloaded, e.g. "./file.txt"
  destination: destFilename,
};

// Downloads the file
await storage
  .bucket(bucketName)
  .file(srcFilename)
  .download(options);

console.log(
  `gs://${bucketName}/${srcFilename} downloaded to ${destFilename}.`
);

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;

/**
 * Download an object from Cloud Storage and save it as a local file.
 *
 * @param string $bucketName the name of your Google Cloud bucket.
 * @param string $objectName the name of your Google Cloud object.
 * @param string $destination the local destination to save the encrypted object.
 *
 * @return void
 */
function download_object($bucketName, $objectName, $destination)
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->object($objectName);
    $object->downloadToFile($destination);
    printf('Downloaded gs://%s/%s to %s' . PHP_EOL,
        $bucketName, $objectName, basename($destination));
}

Python

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

Ver en GitHub Comentarios

def download_blob(bucket_name, source_blob_name, destination_file_name):
    """Downloads a blob from the bucket."""
    storage_client = storage.Client()
    bucket = storage_client.get_bucket(bucket_name)
    blob = bucket.blob(source_blob_name)

    blob.download_to_filename(destination_file_name)

    print('Blob {} downloaded to {}.'.format(
        source_blob_name,
        destination_file_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"
# file_name   = "Name of file in Google Cloud Storage to download locally"
# local_path  = "Destination path for downloaded file"

require "google/cloud/storage"

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

file.download local_path

puts "Downloaded #{file.name}"

API de REST

API de JSON

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura la zona de pruebas para que use tus propias credenciales de OAuth.
2. Usa cURL para llamar a la API de JSON con una solicitud de objeto GET y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

   curl -X GET \
       -H "Authorization: Bearer [OAUTH2_TOKEN]" \
       -o "[SAVE_TO_LOCATION]" \
       "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]?alt=media"

API de XML

1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura la zona de pruebas para que use tus propias credenciales de OAuth.
2. Usa cURL para llamar a la API de XML con una solicitud de objeto GET y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

   curl -X GET \
       -H "Authorization: Bearer [OAUTH2_TOKEN]" \
       -o "[SAVE_TO_LOCATION]" \
       "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]"

Para descargar con facilidad todos los objetos de un depósito o subdirectorio, usa el comando gsutil cp.

Pasos siguientes

• Sube objetos a tu depósito.
• Borra objetos de tu depósito.
• Mira y edita metadatos de objetos.
• Obtén información sobre cómo facturar a los solicitantes los cargos de acceso a Cloud Storage.
• Obtén información sobre cómo Cloud Storage puede entregar archivos en formato gzip sin comprimir.