Crea depósitos de almacenamiento

En esta página, se muestra cómo crear depósitos de Cloud Storage. Para obtener una descripción general de los depósitos, consulta los Términos clave. Si no está especificado de otra manera en tu solicitud, los depósitos se crean en la ubicación multirregional us y tienen la clase de almacenamiento predeterminada Standard Storage.

Nota: A fin de crear un depósito en un proyecto, un usuario debe tener el permiso de proyecto storage.objects.create para el proyecto. Si trabajas dentro de un proyecto que no creaste, tal vez necesites que el propietario del proyecto te asigne una función con este permiso, como Editor, Propietario o Administrador de almacenamiento.

Para crear un depósito de almacenamiento nuevo, sigue estos pasos:

Console

1. Abre el navegador de Cloud Storage en Google Cloud Platform Console.
   Abrir el navegador de Cloud Storage
2. Haz clic en Create bucket (Crear depósito).
3. Especifica un Name (Nombre), sujeto a los requisitos del nombre de depósitos.
4. Selecciona una Default storage class (Clase de almacenamiento predeterminada) para el depósito. La clase de almacenamiento predeterminada se asignará de manera predeterminada a todos los objetos subidos en el depósito.

   Nota: Haz clic en Compare storage classes (Comparar clases de almacenamiento) para comparar las estimaciones de costos mensuales y las clases de almacenamiento.

5. Una Location (Ubicación) donde se almacenarán los datos del depósito.



6. Haz clic en Create (Crear).

gsutil

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

gsutil mb gs://[BUCKET_NAME]/

Configura las siguientes marcas opcionales para tener un mayor control sobre la creación de tu depósito:

• -p: especifica el proyecto con el que se va a asociar tu depósito.
• -c: especifica la clase de almacenamiento predeterminada de tu depósito.
• -l: especifica la ubicación de tu depósito.

Por ejemplo:

  gsutil mb -p [PROJECT_NAME] -c [STORAGE_CLASS] -l [BUCKET_LOCATION] gs://[BUCKET_NAME]/

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_bucket_samples.cc

Ver en GitHub Comentarios

namespace gcs = google::cloud::storage;
using google::cloud::StatusOr;
[](gcs::Client client, std::string bucket_name) {
  StatusOr<gcs::BucketMetadata> meta =
      client.CreateBucket(bucket_name, gcs::BucketMetadata());
  if (!meta.ok()) {
    std::cerr << "Could not create bucket " << bucket_name << std::endl;
    return;
  }
  std::cout << "Bucket " << meta->name() << " created."
            << "\nFull Metadata: " << *meta << 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 CreateBucket(string bucketName)
{
    var storage = StorageClient.Create();
    storage.CreateBucket(s_projectId, bucketName);
    Console.WriteLine($"Created {bucketName}.");
}

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

bucket := client.Bucket(bucketName)
if err := bucket.Create(ctx, projectID, &storage.BucketAttrs{
	StorageClass: "COLDLINE",
	Location:     "asia",
}); 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

Bucket bucket =
    storage.create(
        BucketInfo.newBuilder(bucketName)
            // See here for possible values: http://g.co/cloud/storage/docs/storage-classes
            .setStorageClass(StorageClass.COLDLINE)
            // Possible values: http://g.co/cloud/storage/docs/bucket-locations#location-mr
            .setLocation("asia")
            .build());

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 line before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';

// Creates a new bucket
await storage.createBucket(bucketName, {
  location: 'ASIA',
  storageClass: 'COLDLINE',
});

console.log(`Bucket ${bucketName} created.`);

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;

/**
 * Create a Cloud Storage Bucket.
 *
 * @param string $bucketName name of the bucket to create.
 * @param string $options options for the new bucket.
 *
 * @return Google\Cloud\Storage\Bucket the newly created bucket.
 */
function create_bucket($bucketName, $options = [])
{
    $storage = new StorageClient();
    $bucket = $storage->createBucket($bucketName, $options);
    printf('Bucket created: %s' . PHP_EOL, $bucket->name());
}

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 create_bucket(bucket_name):
    """Creates a new bucket."""
    storage_client = storage.Client()
    bucket = storage_client.create_bucket(bucket_name)
    print('Bucket {} created'.format(bucket.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   = "Name of Google Cloud Storage bucket to create"
# location      = "Location of where to create Cloud Storage bucket"
# storage_class = "Storage class of Cloud Storage bucket"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new project_id: project_id
bucket  = storage.create_bucket bucket_name,
                                location:      location,
                                storage_class: storage_class

puts "Created bucket #{bucket.name} in #{location}" +
     " with #{storage_class} class"

API de REST

API de JSON

A fin de obtener más información sobre las clases de almacenamiento disponibles para configurar como predeterminadas en tu depósito, consulta las Clases de almacenamiento.

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. Crea un archivo .json que contenga la siguiente información y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

{
  "name": "[BUCKET_NAME]",
  "location": "[BUCKET_LOCATION]",
  "storageClass": "[STORAGE_CLASS]"
}

3. Usa cURL para llamar a la API de JSON y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

   curl -X POST --data-binary @[JSON_FILE_NAME].json \
        -H "Authorization: Bearer [OAUTH2_TOKEN]" \
        -H "Content-Type: application/json" \
        "https://www.googleapis.com/storage/v1/b?project=[PROJECT_ID]"

API de XML

A fin de obtener más información sobre las clases de almacenamiento disponibles para configurar como predeterminadas en tu depósito, consulta las Clases de almacenamiento.

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. Crea un archivo .xml que contenga la siguiente información y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

<CreateBucketConfiguration>
   <LocationConstraint>[BUCKET_LOCATION]</LocationConstraint>
   <StorageClass>[STORAGE_CLASS]</StorageClass>
</CreateBucketConfiguration>

3. Usa cURL para llamar a la API de XML y reemplaza [VALUES_IN_BRACKETS] por los valores adecuados:

   curl -X PUT --data-binary @[XML_FILE_NAME].xml \
        -H "Authorization: Bearer [OAUTH2_TOKEN]" \
        -H "x-goog-project-id: [PROJECT_ID]" \
        "https://storage.googleapis.com/[BUCKET_NAME]"

Pasos siguientes

• Crea una lista de depósitos en el proyecto.
• Obtén información del depósito.
• Mueve o cambia el nombre de un depósito.
• Borra un depósito.
• Sube un objeto a tu depósito.
• Conoce los conceptos básicos sobre el uso de Cloud Storage con Google Cloud Platform Console.