Gérer les instances Google Cloud Managed Lustre

Une fois que vous avez créé une instance, Google Cloud Managed Lustre vous permet de la lister, de l'obtenir, de la mettre à jour et de la supprimer.

Lorsque vous mettez à jour des instances Managed Lustre, seuls la description et les libellés peuvent être modifiés.

Répertorier les instances

Pour lister toutes les instances d'un projet :

Google Cloud Console

  1. Accédez à la page Managed Lustre dans la Google Cloud console.

    Accéder à Managed Lustre

    Les instances de votre projet sont listées.

Gcloud CLI

Exécutez la gcloud lustre instances list commande :

gcloud lustre instances list --location=LOCATION

Remplacez LOCATION par une zone spécifique pour lister toutes les instances de cet emplacement. Pour afficher les projets dans tous les emplacements, saisissez - comme valeur. Exemple :

gcloud lustre instances list --location=-

REST

Pour lister les instances à l'aide de l'API REST, envoyez une requête au point de terminaison suivant :

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Vous devez spécifier les valeurs suivantes :

  • PROJECT_ID correspond à l'ID de votre Google Cloud projet.

  • ZONE correspond à la zone pour laquelle lister toutes les instances. Pour lister les instances de toutes les zones, utilisez - comme valeur.

Pour en savoir plus, consultez la documentation de référence de l'API instances.list.

Obtenir une instance

Pour obtenir les détails d'une instance :

Google Cloud Console

  1. Accédez à la page Managed Lustre dans la Google Cloud console.

    Accéder à Managed Lustre

  2. Cliquez sur le nom de l'instance pour afficher les détails d'une instance spécifique.

Gcloud CLI

Exécutez la gcloud lustre instances describe commande :

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Pour obtenir des informations sur une instance particulière à l'aide de l'API REST, envoyez une requête au point de terminaison suivant :

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Vous devez spécifier les valeurs suivantes :

  • PROJECT_ID correspond à l'ID de votre Google Cloud projet.

  • ZONE doit être une Google Cloud zone valide compatible avec Managed Lustre. Pour obtenir la liste complète, consultez la section Emplacements compatibles.

  • INSTANCE_NAME correspond au nom de l'instance Managed Lustre à renvoyer.

Pour en savoir plus, consultez la documentation de référence de l'API instances.get.

Mettre à jour une instance

Vous pouvez mettre à jour les propriétés suivantes d'une instance existante :

  • description
  • labels
  • capacité de rangement

Pour savoir comment augmenter la capacité de stockage d'une instance, consultez la section Augmenter la capacité d'une instance.

Pour mettre à jour une instance :

Google Cloud Console

  1. Accédez à la page Managed Lustre dans la Google Cloud console.

    Accéder à Managed Lustre

  2. Cliquez sur le nom de l'instance à mettre à jour. La page de présentation de l'instance s'affiche.

  3. Cliquez sur Modifier.

  4. Saisissez la ou les nouvelles valeurs.

  5. Cliquez sur Envoyer.

Google Cloud CLI

Exécutez la gcloud lustre instances update commande :

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

Où :

  • INSTANCE_NAME correspond à l'instance à mettre à jour.
  • LOCATION correspond à la zone dans laquelle réside l'instance.
  • NEW_CAPACITY correspond à la nouvelle capacité de stockage de cette instance en gibioctets (Gio). La valeur ne peut pas dépasser la capacité maximale autorisée et doit être un multiple de la taille de l'étape. Pour en savoir plus, consultez la section Augmenter la capacité d'une instance.
  • NEW_DESCRIPTION correspond à une nouvelle valeur pour le champ de description, qui écrase toute description existante.

Pour mettre à jour les libellés, consultez les commandes disponibles dans la documentation de gcloud lustre instances update.

REST

Pour mettre à jour une instance à l'aide de l'API REST, envoyez une requête PATCH à son point de terminaison spécifique :

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  }
}

Vous devez spécifier les valeurs suivantes :

  • PROJECT_ID correspond à l'ID de votre Google Cloud projet.
  • ZONE correspond à la Google Cloud zone de l'instance.
  • INSTANCE_NAME correspond au nom de l'instance Managed Lustre à mettre à jour.
  • UPDATE_MASK correspond à une liste de champs à mettre à jour, séparés par une virgule. Un champ ne sera écrasé que s'il figure dans le masque.

Le corps de la requête doit contenir un ou plusieurs des champs suivants :

  • capacityGiB correspond à la nouvelle capacité de stockage de cette instance en gibioctets (Gio). La valeur ne peut pas dépasser la capacité maximale autorisée et doit être un multiple de la taille de l'étape. Pour en savoir plus, consultez la section Augmenter la capacité d'une instance.
  • description correspond à la nouvelle description de cette instance.
  • labels correspond au nouvel ensemble de libellés pour cette instance. La valeur de labels est un objet JSON contenant une ou plusieurs paires clé/valeur.

Pour en savoir plus, consultez la documentation de référence de l'API instances.patch.

Supprimer une instance

Pour supprimer une instance :

Google Cloud Console

  1. Accédez à la page Managed Lustre dans la Google Cloud console.

    Accéder à Managed Lustre

  2. Sélectionnez le menu à trois points à côté de l'instance à supprimer.

  3. Sélectionnez Supprimer l'instance. Confirmez la suppression en cliquant de nouveau sur Supprimer.

Gcloud CLI

Exécutez la gcloud lustre instances delete commande :

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Vous êtes invité à confirmer la suppression. Saisissez Y ou appuyez sur Entrée pour continuer.

REST

Pour supprimer une instance à l'aide de l'API REST, envoyez une requête au point de terminaison suivant :

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Vous devez spécifier les valeurs suivantes :

  • PROJECT_ID correspond à l'ID de votre Google Cloud projet.

  • ZONE correspond à la Google Cloud zone dans laquelle se trouve l'instance.

  • INSTANCE_NAME correspond au nom de l'instance Managed Lustre à supprimer.

Pour en savoir plus, consultez la documentation de référence de l'API instances.delete.

Les requêtes de suppression sont des requêtes de longue durée et renvoient un ID d'opération qui peut être interrogé pour connaître l'état de l'opération. Pour en savoir plus, consultez la documentation de référence sur operations.get.