Obtenir des informations sur l'instance

Cette page vous explique comment obtenir des informations sur des instances Filestore.

Avant de commencer

Si vous souhaitez utiliser les exemples de ligne de commande de cette page, activez l'outil de ligne de commande gcloud en installant la gcloud CLI.

Afficher toutes les instances d'un projet

Console Google Cloud

Vous pouvez obtenir des informations sur vos instances Filestore et afficher toutes les instances d'un projet en accédant à la page "Instances Filestore" :

Accéder à la page des instances Filestore

gcloud

Vous pouvez obtenir des informations sur vos instances Filestore et afficher toutes les instances d'un projet en exécutant la commande instances list:

  gcloud filestore instances list --project=project-id --zone=zone

où :

• project-id est l'ID du projet Google Cloud contenant l'instance Filestore. Vous pouvez ignorer cette option si l'instance Filestore se trouve dans le projet par défaut gcloud. Vous pouvez définir le projet par défaut en exécutant la commande suivante :

    gcloud config set project project-id
  

• zone est la zone pour laquelle vous souhaitez répertorier les instances Filestore. Si vous ignorez cet indicateur, vous obtiendrez la liste des instances dans toutes les zones. Exécutez la commande gcloud filestore zones list pour obtenir la liste des zones compatibles.

La réponse à la commande instances list est similaire à la suivante :

Remarque :Pour en savoir plus sur les types d'instances disponibles, consultez la section Niveaux de service.

INSTANCE_NAME  ZONE            TIER       CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS  STATE   CREATE_TIME
nfs-loc        europe-west1-b  BASIC_HDD  1024         nfs1             10.0.5.2    READY   2017-10-09T22:11:28
nfs3           us-central1-c   BASIC_HDD  1024         acme             10.0.6.2    READY   2017-11-06T09:37:18

Exemple

La commande suivante répertorie les instances Filestore dans le projet myproject:

  gcloud filestore instances list --project=myproject

API REST

1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

2. Utilisez cURL pour appeler l'API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

   Où :

   • PROJECT correspond au nom du projet dans lequel se trouve votre instance. Exemple :my-genomics-project
   • LOCATION correspond à l'emplacement que vous souhaitez rechercher. Pour rechercher toutes les instances à n'importe quel emplacement dans un projet, utilisez -.

Obtenir des informations sur une instance spécifique

Utilisez l'une des procédures suivantes pour obtenir des informations sur une instance Filestore spécifique.

Console Google Cloud

1. Accéder à la page des instances Filestore

   Accéder à la page des instances Filestore

2. Cliquez sur l'identifiant de l'instance pour ouvrir la page d'informations de l'instance.

gcloud

Obtenez des informations sur une instance Filestore en exécutant la commande instances describe:

    gcloud filestore instances describe instance-id --project=project-id --location=location

La réponse à la commande instances describe est similaire à la suivante :

createTime: '2021-10-11T17:28:23.340943077Z'
fileShares:
- capacityGb: '1024'
 name: vol1
kmsKeyName: projects/example-project/locations/us-central1/keyRings/example-ring/cryptoKeys/example-key
labels:
 key:val
name: projects/yourproject/locations/us-central1-c/instances/nfs-server
networks:
- ipAddresses:
 - 10.0.0.2
 network: default
 reservedIpRange: 10.0.0.0/26
state: READY
tier: ENTERPRISE

Ces champs représentent les valeurs suivantes :

• createTime : heure de création de l'instance, au format RFC 3339.
• fileShares
• capacityGb : taille du partage de fichiers Filestore en gigaoctets binaires (GB), où 1 GB = 1024³ octets.
• name : nom du partage de fichiers Filestore. Vous utilisez le nom de partage de fichiers avec l'adresse IP identifiée par la valeur ipAddresses pour installer le partage de fichiers sur un client.
• name : nom complet de l'instance.
• ipAddresses : adresse IP de l'instance. Pour installer le partage de fichiers Filestore sur un client, utilisez cette valeur avec le nom du partage de fichiers.
• network : nom du réseau VPC utilisé par l'instance.
• reservedIpRange : bloc d'adresses IP réservé à l'utilisation de l'instance.
• state : état de l'instance.
• tier : niveau de service Filestore de l'instance.

Exemple

La commande suivante fournit des informations sur l'instance test-nfs du projet myproject, dans la zone us-central1-c.

gcloud filestore instances describe test-nfs --project=myproject --zone=us-central1-c

API REST

1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

2. Utilisez cURL pour appeler l'API Filestore:

   curl -s \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header "Content-Type: application/json" \
     GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

   Où :

   • PROJECT correspond au nom du projet dans lequel se trouve votre instance. Exemple :my-genomics-project
   • LOCATION est l'emplacement de votre instance. Exemple :us-west1-a
   • INSTANCE_NAME est le nom de l'instance que vous souhaitez afficher. Exemple :my-genomics-instance

Obtenir des informations sur les installations d'instances Filestore

Les sections suivantes vous expliquent comment obtenir différents types d'informations de montage d'instance.

Lister les points d'installation d'une instance

Vous pouvez répertorier tous les points d'installation d'une instance Filestore en exécutant la commande suivante:

    sudo showmount -a INSTANCE_IP

Exemple

La commande suivante répertorie tous les points d'installation d'une instance Filestore avec l'adresse IP 10.77.67.226:

    sudo showmount -a 10.77.67.226

La sortie ressemble à ceci :

All mount points on 10.77.67.226:
10.128.0.1:/fileshare
10.128.0.2:/fileshare
10.128.0.3:/fileshare

Obtenir le nombre de points d'installation pour une instance

Vous pouvez obtenir le nombre total de points d'installation pour une instance Filestore en exécutant la commande suivante:

    sudo showmount -a INSTANCE_IP --no-headers | wc -l

Exemple

La commande suivante affiche le nombre de points d'installation pour une instance avec l'adresse IP 10.77.67.226:

    sudo showmount -a 10.77.67.226 --no-headers | wc -l

Étape suivante

• Créez une autre instance.
• Installez le partage de fichiers Filestore sur une instance de VM Compute Engine.
• Accéder aux instances Filestore à partir d'un cluster Google Kubernetes Engine