Es posible que parte o toda la información de esta página no se aplique a Trusted Cloud by S3NS. Para obtener más información, consulta las diferencias con Google Cloud.

Esta página se ha traducido con Cloud Translation API.

Descubrir el almacenamiento de objetos con la herramienta gcloud

En esta página se muestra cómo realizar tareas básicas en Cloud Storage con la herramienta de línea de comandos gcloud.

Los costes que se te aplican en Cloud Storage se basan en los recursos que utilizas. En esta guía de inicio rápido se suelen usar recursos de Cloud Storage por un valor inferior a 0,01 USD.

Antes de empezar

Install the Google Cloud CLI.
Configura gcloud CLI para que use tu identidad federada.

Para obtener más información, consulta el artículo Iniciar sesión en la CLI de gcloud con tu identidad federada.
Para inicializar gcloud CLI, ejecuta el siguiente comando:
```
gcloud init
```
Create or select a Trusted Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
- Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
- Create a Trusted Cloud project:
```
gcloud projects create PROJECT_ID
```
  Replace PROJECT_ID with a name for the Trusted Cloud project you are creating.
- Select the Trusted Cloud project that you created:
```
gcloud config set project PROJECT_ID
```
  Replace PROJECT_ID with your Trusted Cloud project name.
Verify that billing is enabled for your Trusted Cloud project.
Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/storage.admin
```
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
```
Replace the following:
- PROJECT_ID: your project ID.
- USER_IDENTIFIER: the identifier for your user account. For examples, see Represent workforce pool users in IAM policies.
- ROLE: the IAM role that you grant to your user account.

Crear un segmento

Los segmentos son los contenedores básicos que almacenan tus datos en Cloud Storage.

Para crear un segmento, sigue estas instrucciones:

Abre una ventana de terminal.
Usa el comando gcloud storage buckets create y un nombre único para crear un segmento:
```
gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access --location=LOCATION_NAME
```
En este ejemplo, se usa un segmento llamado "my-awesome-bucket". Para empezar, tienes que elegir un nombre para tu segmento, que debe ser único de forma global.
Consulta los requisitos de nomenclatura de los segmentos.
- Los nombres de los segmentos solo pueden contener letras minúsculas, caracteres numéricos, guiones (-) y guiones bajos (_). No se permiten espacios.
- Los nombres de depósito deben empezar y acabar por un número o por una letra.
- Los nombres de los contenedores deben tener entre 3 y 63 caracteres. Los nombres que contienen puntos pueden tener hasta 222 caracteres, pero cada componente separado por puntos no puede tener más de 63 caracteres.
- Los nombres de los contenedores no se pueden representar como una dirección IP en notación decimal punteada (por ejemplo, 192.168.5.4).
- Los nombres de depósito no pueden empezar por el prefijo "goog".
- Los nombres de los contenedores no pueden incluir "google" ni palabras con errores ortográficos similares, como "g00gle".
Precaución: No incluyas información sensible en el nombre del segmento, ya que este espacio de nombres es público y visible para todos los usuarios.

Si la acción se realiza correctamente, el comando mostrará lo siguiente:
```
Creating gs://my-awesome-bucket/...
```

Acabas de crear un segmento en el que puedes almacenar tus datos.

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

En este caso, vuelve a intentar este paso con un nombre de segmento diferente.

Subir un objeto a un segmento

La imagen de un gatito que se va a subir al contenedor.

Haz clic con el botón derecho en la imagen de arriba y guárdala en algún lugar de tu ordenador, como el escritorio.

Nota: Si usas una instancia de Compute Engine, descarga la imagen con el siguiente comando: wget https://cloud.google.com/storage/images/kitten.png

Usa el comando gcloud storage cp para copiar la imagen de la ubicación en la que la guardaste al segmento que has creado:

gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

Si la acción se realiza correctamente, el comando mostrará lo siguiente:

Copying file://Desktop/kitten.png [Content-Type=image/png]...
Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

Acabas de almacenar un objeto en tu segmento.

Descargar el objeto de tu contenedor

Usa el comando gcloud storage cp para descargar la imagen que has almacenado en tu segmento en alguna ubicación de tu ordenador, como el escritorio:
```
gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png
```
Si la acción se realiza correctamente, el comando mostrará lo siguiente:
```
Copying gs://my-awesome-bucket/kitten.png...
Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB
```
Acabas de descargar algo de tu contenedor.

Copia el objeto en una carpeta del segmento

Usa el comando gcloud storage cp para crear una carpeta y copiar la imagen en ella:
```
gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png
```
Nota: Las carpetas de Cloud Storage tienen limitaciones en comparación con los sistemas de archivos locales, pero se admiten muchas de las mismas operaciones.

Si la acción se realiza correctamente, el comando mostrará lo siguiente:
```
Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB
```
Acabas de copiar la imagen en una carpeta nueva de tu contenedor.

Mostrar el contenido de un segmento o una carpeta

Usa el comando gcloud storage ls para enumerar el contenido del nivel superior de tu contenedor:
```
gcloud storage ls gs://my-awesome-bucket
```
Si la acción se realiza correctamente, el comando devuelve un mensaje similar al siguiente:
```
gs://my-awesome-bucket/kitten.png
gs://my-awesome-bucket/just-a-folder/
```
Acabas de ver el contenido del nivel superior de tu contenedor.

Mostrar los detalles de un objeto

Usa el comando gcloud storage ls con la marca --long para obtener información sobre una de tus imágenes:
```
gcloud storage ls gs://my-awesome-bucket/kitten.png --long
```
Si la acción se realiza correctamente, el comando devuelve un mensaje similar al siguiente:
```
2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)
```
Acabas de obtener información sobre el tamaño y la fecha de creación de la imagen.

Hacer que los objetos sean de acceso público

Usa el comando gcloud storage buckets add-iam-policy-binding para conceder permiso a todos los usuarios para leer las imágenes almacenadas en tu segmento:
```
gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
El comando se habrá ejecutado correctamente si tu respuesta contiene lo siguiente:
```
bindings:
  - members:
    - allUsers
    role: roles/storage.objectViewer
```
Ahora cualquier persona puede obtener tus imágenes.
Para quitar este acceso, usa el comando:
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
El comando se ejecuta correctamente si no se devuelve ningún error.

Has eliminado el acceso público a las imágenes de tu segmento.

Dar acceso a un usuario a tu cubo

Usa el comando gcloud storage buckets add-iam-policy-binding para dar permiso a una dirección de correo específica para añadir objetos a tu segmento:

gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns.iam.gserviceaccount.com --role=roles/storage.objectCreator

El comando se habrá ejecutado correctamente si tu respuesta contiene lo siguiente:

bindings:
  - members:
    - user:example-service-account@example-project.s3ns.iam.gserviceaccount.com
    role: roles/storage.objectCreator

Ahora, otra persona puede añadir elementos a tu contenedor.

Para quitar este permiso, usa el comando:

gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:example-service-account@example-project.s3ns.iam.gserviceaccount.com --role=roles/storage.objectCreator

El comando se ejecuta correctamente si no se devuelve ningún error.

Has quitado el acceso del usuario a este contenedor.

Eliminar un objeto

Utiliza el comando gcloud storage rm para eliminar una de tus imágenes:
```
gcloud storage rm gs://my-awesome-bucket/kitten.png
```
Si la acción se realiza correctamente, el comando mostrará lo siguiente:
```
Removing gs://my-awesome-bucket/kitten.png...
```
Esta copia de la imagen ya no está almacenada en Cloud Storage (aunque la copia que hiciste en la carpeta just-a-folder/ sigue existiendo).

Limpieza

Para evitar que se apliquen cargos en tu Trusted Cloud cuenta por los recursos utilizados en esta página, elimina el Trusted Cloud proyecto con los recursos.

Abre una ventana de terminal (si aún no lo has hecho).
Usa el comando gcloud storage rm con la marca --recursive para eliminar el contenedor y todo lo que haya en él:
```
gcloud storage rm gs://my-awesome-bucket --recursive
```
Si la acción se realiza correctamente, el comando devuelve un mensaje similar al siguiente:
```
Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
Removing gs://my-awesome-bucket/...
```
Se eliminarán el segmento y su contenido.

Siguientes pasos

Consulta las páginas de referencia de los comandos de Google Cloud CLI, como make bucket (buckets create), copy (cp), list (ls), add access (buckets add-iam-policy-binding) y remove (rm).