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 se especifica lo contrario en tu solicitud, los depósitos se crean en la ubicación multirregional us y tienen una clase de almacenamiento predeterminada de Standard Storage .

Nota: Para 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 Crear depósito (Create bucket) para abrir el formulario de creación de depósito.



3. Ingresa la información de tu depósito y haz clic en Continuar para completar cada paso:
• Especifica un Nombre, sujeto a los requisitos del nombre de depósitos.
• Selecciona una Clase de almacenamiento predeterminada para el depósito. La clase de almacenamiento predeterminada se asignará por defecto a todos los objetos subidos en el depósito. Luego, selecciona Ubicación donde se almacenarán los datos del depósito de forma permanente.

  Nota: El panel Estimación de costo mensual en el panel derecho calcula los costos mensuales del depósito en función de la clase y ubicación de almacenamiento seleccionadas, así como el tamaño y las operaciones de datos esperados.

• Selecciona un Modelo de control de acceso para determinar cómo controlas el acceso a los objetos del depósito.
• Opcionalmente, puedes agregar etiquetas de depósito, establecer una política de retención y elegir un método de encriptación.
4. Haz clic en Listo.

gsutil

Usa el comando gsutil mb:

gsutil mb gs://[BUCKET_NAME]/

donde:

• [BUCKET_NAME] es el nombre que quieres asignar a tu depósito, sujeto a los requisitos de denominación. Por ejemplo, my-bucket.

Configura los siguientes marcadores 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. Por ejemplo, my-project.
• -c: especifica la clase de almacenamiento predeterminada de tu depósito. Por ejemplo, nearline.
• -l: especifica la ubicación de tu depósito. Por ejemplo, us-east1.
• -b: habilita la opción Solo política del depósito para tu depósito.

Por ejemplo:

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

Ejemplos de código

Nota: Puedes encontrar otras opciones a fin de crear un depósito nuevo en la referencia de la API de JSON para bucket.insert

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 bucket_name) {
  StatusOr<gcs::BucketMetadata> bucket_metadata =
      client.CreateBucket(bucket_name, gcs::BucketMetadata());

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

  std::cout << "Bucket " << bucket_metadata->name() << " created."
            << "\nFull Metadata: " << *bucket_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 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 in the Asia region with the coldline default storage
// class. Leave the second argument blank for default settings.
//
// For default values see: https://cloud.google.com/storage/docs/locations and
// https://cloud.google.com/storage/docs/storage-classes
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.
 *
 */
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

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. Crea un archivo .json que contenga la siguiente información:

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

donde:

• [BUCKET_NAME] es el nombre que quieres asignar a tu depósito, sujeto a los requisitos de denominación. Por ejemplo, my-bucket.
• [BUCKET_LOCATION] es la ubicación en la que deseas almacenar los datos de objeto de tu depósito. Por ejemplo, us-east1.
• [STORAGE_CLASS] es la clase de almacenamiento predeterminada de tu depósito. Por ejemplo, nearline.
3. Usa cURL para llamar a la API de JSON:

   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]"

   donde:

   • [JSON_FILE_NAME] es el nombre del archivo JSON que creaste en el paso 2.
   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [PROJECT_ID] es el ID del proyecto con el que se asociará tu depósito. Por ejemplo, my-project.

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. Crea un archivo XML que contenga la siguiente información:

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

donde:

• [BUCKET_LOCATION] es la ubicación en la que deseas almacenar los datos de objeto de tu depósito. Por ejemplo, us-east1.
• [STORAGE_CLASS] es la clase de almacenamiento predeterminada de tu depósito. Por ejemplo, nearline.
3. Utiliza cURL para llamar a la API de XML:

   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]"

   donde:

   • [XML_FILE_NAME] es el nombre del archivo XML que creaste en el paso 2.
   • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
   • [PROJECT_ID] es el ID del proyecto con el que se asociará tu depósito. Por ejemplo, my-project.
   • [BUCKET_NAME] es el nombre que quieres asignar a tu depósito, sujeto a los requisitos de denominación. Por ejemplo, my-bucket.

Qué sigue

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