Il est possible qu'une partie ou l'ensemble des informations de cette page ne s'appliquent pas au Cloud de confiance S3NS.

Cette page a été traduite par l'API Cloud Translation.

Découvrir le stockage d'objets avec l'outil gcloud

Cette page explique comment effectuer des tâches de base dans Cloud Storage à l'aide de l'outil de ligne de commande gcloud.

Vous ne payez que pour les ressources que vous utilisez dans Cloud Storage. Ce guide de démarrage rapide utilise généralement moins de 0,01 USD de ressources Cloud Storage.

Avant de commencer

Install the Google Cloud CLI.
Configurez la gcloud CLI pour utiliser votre identité fédérée.

Pour en savoir plus, consultez Se connecter à gcloud CLI avec votre identité fédérée.
Pour initialiser gcloudCLI, exécutez la commande suivante :
```
gcloud init
```
Create or select a Trusted Cloud project.

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.

Créer un bucket

Les buckets sont les conteneurs de base dans lesquels sont stockées vos données dans Cloud Storage.

Pour créer un bucket :

Ouvrez une fenêtre de terminal.
Exécutez la commande gcloud storage buckets create et utilisez un nom unique pour créer un bucket :
```
gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access --location=LOCATION_NAME
```
Cette commande utilise un bucket nommé "my-awesome-bucket". Vous devez choisir un nom unique pour votre bucket.
Consultez les règles de dénomination des buckets pour en savoir plus.
- Les noms de buckets ne peuvent contenir que des lettres minuscules, des chiffres, des tirets (-) et des traits de soulignement (_). Les espaces ne sont pas autorisées.
- Les noms de buckets doivent commencer et se terminer par un chiffre ou une lettre.
- Les noms de buckets doivent compter entre 3 et 63 caractères. Ceux qui comportent des points peuvent contenir jusqu'à 222 caractères, mais chaque composant séparé par un point ne peut pas posséder plus de 63 caractères.
- Les noms de buckets ne peuvent pas correspondre à une adresse IP au format décimal à points (par exemple, 192.168.5.4).
- Les noms de buckets ne peuvent pas commencer par le préfixe "goog".
- Les noms de buckets ne peuvent pas contenir "google" ni des termes semblables tels que "g00gle".
Attention : N'incluez aucune information sensible dans le nom des buckets, car leur espace de noms est global et visible par tous.

Si l'opération réussit, la commande renvoie le résultat suivant :
```
Creating gs://my-awesome-bucket/...
```

Vous venez de créer un bucket dans lequel vous pouvez stocker vos données.

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

Réessayez en donnant un autre nom au bucket.

Importer un objet dans un bucket

Image d'un chaton à importer dans le bucket.

Cliquez avec le bouton droit sur l'image ci-dessus et enregistrez-la sur votre ordinateur, par exemple sur le bureau.

Remarque : Si vous utilisez une instance Compute Engine, téléchargez l'image à l'aide de la commande suivante : wget https://cloud.google.com/storage/images/kitten.png
Exécutez la commande gcloud storage cp pour copier l'image à partir de l'emplacement où vous l'avez enregistrée dans le bucket que vous avez créé :
```
gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket
```
Si l'opération réussit, la commande renvoie le résultat suivant :
```
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
```
Vous venez de stocker un objet dans votre bucket.

Télécharger l'objet à partir du bucket

Exécutez la commande gcloud storage cp pour télécharger l'image que vous avez stockée dans votre bucket sur votre ordinateur, par exemple sur le bureau :
```
gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png
```
Si l'opération réussit, la commande renvoie le résultat suivant :
```
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
```
Vous venez de télécharger un objet à partir de votre bucket.

Copier l'objet dans un dossier du bucket

Utilisez la commande gcloud storage cp pour créer un dossier et y copier l'image :
```
gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png
```
Remarque : Les dossiers de Cloud Storage présentent des restrictions par rapport aux systèmes de fichiers locaux, mais de nombreuses opérations identiques sont acceptées.
Si la commande est bien exécutée, elle renvoie le résultat suivant :
```
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
```
Vous venez de copier votre image dans un nouveau dossier de votre bucket.

Afficher le contenu d'un bucket ou d'un dossier

Utilisez la commande gcloud storage ls pour répertorier le contenu du niveau supérieur de votre bucket :
```
gcloud storage ls gs://my-awesome-bucket
```
Si l'opération réussit, la commande renvoie un message semblable à celui-ci :
```
gs://my-awesome-bucket/kitten.png
gs://my-awesome-bucket/just-a-folder/
```
Vous venez d'afficher le contenu du niveau supérieur de votre bucket.

Afficher les détails d'un objet

Exécutez la commande gcloud storage ls avec l'option --long pour obtenir des détails sur l'une de vos images :
```
gcloud storage ls gs://my-awesome-bucket/kitten.png --long
```
Si l'opération réussit, la commande renvoie un message semblable à celui-ci :
```
2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)
```
Vous venez d'obtenir des informations sur la taille et la date de création de l'image.

Rendre les objets accessibles au public

Exécutez la commande gcloud storage buckets add-iam-policy-binding pour autoriser tous les utilisateurs à lire les images stockées dans votre bucket :
```
gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
La commande aboutit si votre réponse contient les éléments suivants :
```
bindings:
  - members:
    - allUsers
    role: roles/storage.objectViewer
```
Désormais, tout le monde peut obtenir vos images.
Pour supprimer cet accès, exécutez la commande suivante :
```
gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer
```
La commande aboutit si aucune erreur n'est affichée.

Vous avez supprimé l'accès public aux images de votre bucket.

Autoriser l'accès au bucket

Exécutez la commande gcloud storage buckets add-iam-policy-binding pour autoriser une adresse e-mail spécifique à ajouter des objets à votre bucket :

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

La commande aboutit si votre réponse contient les éléments suivants :

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

Un autre utilisateur peut maintenant ajouter des éléments à votre bucket.

Pour supprimer cette autorisation, exécutez la commande suivante :

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

La commande aboutit si aucune erreur n'est affichée.

Vous venez de supprimer l'accès de l'utilisateur à ce bucket.

Supprimer un objet

Exécutez la commande gcloud storage rm pour supprimer l'une de vos images :
```
gcloud storage rm gs://my-awesome-bucket/kitten.png
```
Si l'opération réussit, la commande renvoie le résultat suivant :
```
Removing gs://my-awesome-bucket/kitten.png...
```
Cette copie de l'image n'est plus stockée dans Cloud Storage (mais la copie que vous en avez faite dans le dossier just-a-folder/ existe encore).

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Trusted Cloud , supprimez le projet Trusted Cloud contenant les ressources.

Ouvrez une fenêtre de terminal (si aucune n'est déjà ouverte).
Utilisez la commande gcloud storage rm avec l'option --recursive pour supprimer le bucket et tout ce qu'il contient :
```
gcloud storage rm gs://my-awesome-bucket --recursive
```
Si l'opération réussit, la commande renvoie un message semblable à celui-ci :
```
Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
Removing gs://my-awesome-bucket/...
```
Vous venez de supprimer votre bucket et son contenu.

Étapes suivantes

Consultez les pages de référence des commandes Google Cloud CLI, telles que créer un bucket (buckets create), copier (cp), lister (ls), ajouter des accès (buckets add-iam-policy-binding) et supprimer (rm).