En esta página, se muestra cómo subir objetos a tu bucket de Cloud Storage desde tu sistema de archivos local. Un objeto subido consiste en los datos que deseas almacenar junto con los metadatos asociados. Para obtener una descripción general conceptual, incluido cómo elegir el método de carga óptimo en función del tamaño del archivo, consulta Cargas de objetos.
Para obtener instrucciones sobre cómo subir objetos desde la memoria, consulta Sube objetos desde la memoria.
Roles obligatorios
Para obtener los permisos que necesitas a fin de subir objetos a un bucket, pídele a tu administrador que te otorgue el rol de IAM Usuario de objetos de almacenamiento (roles/storage.objectUser) para el bucket. Este rol predefinido contiene los permisos necesarios para subir un objeto a un bucket. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
storage.objects.createstorage.objects.delete- Este permiso solo es necesario para las cargas que reemplazan un objeto existente.
storage.objects.get- Este permiso solo es necesario si planeas usar Google Cloud CLI para realizar las tareas en esta página.
storage.objects.list- Este permiso solo es necesario si planeas usar Google Cloud CLI para realizar las tareas en esta página. Este permiso también es necesario si deseas usar la consola de Google Cloud para verificar los objetos que subiste.
Si planeas usar la consola de Google Cloud para realizar las tareas de esta página, también necesitarás el permiso storage.buckets.list, que no se incluye en el rol Usuario de objetos de almacenamiento (roles/storage.objectUser). Para obtener este permiso, pídele a tu administrador que te otorgue el rol Administrador de almacenamiento (roles/storage.admin) en el proyecto.
También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.
Para obtener más información sobre cómo otorgar roles en los buckets, consulta Configura y administra políticas de IAM en buckets.
Subirás un objeto a un bucket.
Sigue los pasos a continuación para subir un objeto a un bucket:
Console
- En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
En la lista de buckets, haz clic en el nombre del bucket al que deseas subir un objeto.
En la pestaña Objetos del bucket, realiza una de las siguientes acciones:
Arrastra archivos desde tu escritorio o administrador de archivos al panel principal en la consola de Google Cloud .
Haz clic en Subir > Subir archivos, selecciona los archivos que deseas subir en el cuadro de diálogo que aparece y, luego, haz clic en Abrir.
Para obtener información sobre cómo ver detalles de errores acerca de operaciones fallidas de Cloud Storage en la Google Cloud consola, consulta Solución de problemas.
Línea de comandos
Usa el comando gcloud storage cp:
gcloud storage cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME
Donde:
OBJECT_LOCATIONes la ruta de acceso local a tu objeto. Por ejemplo,Desktop/dog.png.DESTINATION_BUCKET_NAMEes el nombre del bucket al que subes el objeto. Por ejemplo,my-bucket
Si se ejecuta de forma correcta, la respuesta se parece al siguiente ejemplo:
Completed files 1/1 | 164.3kiB/164.3kiB
Puedes configurar metadatos de objetos de clave fija y personalizada como parte de la carga de objetos mediante marcas de comandos.
Bibliotecas cliente
C++
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C++.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
C#
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage C#.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.
Go
Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage Go.
Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.