Obtenir des informations sur l'instance

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 :

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 -.

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