Descarga 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 el cliente con tus objetos, consulta el uso de claves de encriptación proporcionadas por el cliente 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 este.

3. Haz clic en el menú desplegable asociado con el objeto.

   El menú desplegable aparece como tres puntos verticales en el extremo derecho.

4. Selecciona Descargar.

gsutil

Usa el comando gsutil cp:

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

Donde:

• [BUCKET_NAME] es el nombre del depósito que contiene el objeto que se descargará. Por ejemplo, my-bucket.

• [OBJECT_NAME] es el nombre del objeto que se descargará. Por ejemplo, pets/dog.png.

• [SAVE_TO_LOCATION] es la ruta local en la que guardas tu objeto. Por ejemplo, Desktop/Images.

Si tienes éxito, 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 GitHubComentarios

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;
  std::string line;
  while (std::getline(stream, line, '\n')) {
    ++count;
  }

  std::cout << "The object has " << count << " lines\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 GitHubComentarios

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 GitHubComentarios

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 GitHubComentarios

// 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 GitHubComentarios

// 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 GitHubComentarios

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 GitHubComentarios

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 GitHubComentarios

# 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 acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de JSON con una solicitud de objeto GET:

   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"

   Donde:

   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [SAVE_TO_LOCATION] es la ruta local en la que guardas tu objeto. Por ejemplo, Desktop/Images.
   • [BUCKET_NAME] es el nombre del depósito que contiene el objeto que se descargará. Por ejemplo, my-bucket.
   • [OBJECT_NAME] es el nombre del objeto que se descargará. Por ejemplo, pets/dog.png. Si deseas obtener información sobre cómo codificar en URL los nombres de objetos a fin de que sean seguros para la ruta, consulta la codificación de partes de ruta URI.

API de XML

1. Obtén un token de acceso de autorización de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.

2. Usa cURL para llamar a la API de XML con una solicitud de objeto GET:

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

   Donde:

   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [SAVE_TO_LOCATION] es la ruta local en la que guardas tu objeto. Por ejemplo, Desktop/Images.
   • [BUCKET_NAME] es el nombre del depósito que contiene el objeto que se descargará. Por ejemplo, my-bucket.
   • [OBJECT_NAME] es el nombre del objeto que se descargará. Por ejemplo, pets/dog.png.

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

Próximos pasos

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