Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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" :
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 :
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.
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 = 10243 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.
customPerformanceSupported: indique si les performances personnalisées sont compatibles avec l'instance. Si ce n'est pas le cas, les performances personnalisées ne sont pas acceptées.
performanceConfig: configuration personnalisée pour les performances personnalisées.
performanceLimits: limites de performances appliquées, calculées à partir des performances de 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 région us-central1.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eYou can view all Filestore instances within a project using the Google Cloud console or by running the \u003ccode\u003egcloud filestore instances list\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eTo get details about a specific Filestore instance, navigate to the instance details page in the Google Cloud console or use the \u003ccode\u003egcloud filestore instances describe\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe REST API allows you to get a list of Filestore instances or details of a specific instance through \u003ccode\u003ecURL\u003c/code\u003e commands.\u003c/p\u003e\n"],["\u003cp\u003eYou can list all mount points of a Filestore instance using the \u003ccode\u003esudo showmount -a INSTANCE_IP\u003c/code\u003e command, or get the total number of mount points with \u003ccode\u003esudo showmount -a INSTANCE_IP --no-headers | wc -l\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Get instance information\n\nThis page shows you how to get information about Filestore\ninstances.\n\nBefore you begin\n----------------\n\nIf you want to use the command-line examples in this page, enable the `gcloud`\ncommand-line tool by [installing the gcloud CLI](/sdk/downloads).\n\nView all instances in a project\n-------------------------------\n\n### Google Cloud console\n\nYou can get information about your Filestore instances, and view\nall instances in a project, by going to the Filestore instances\npage:\n\n[Go to the Filestore instances page](https://console.cloud.google.com/filestore/instances)\n\n### gcloud\n\nYou can get information about your Filestore instances, and view\nall instances in a project, by running the [`instances list`](/sdk/gcloud/reference/filestore/instances/list)\ncommand: \n\n gcloud filestore instances list --project=\u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e --zone=\u003cvar translate=\"no\"\u003ezone\u003c/var\u003e\n\nwhere:\n\n- \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e is the project ID of the Google Cloud project that\n contains the Filestore instance. You can skip this\n flag if the Filestore instance is in the `gcloud` default\n project. You can set the default project by running:\n\n gcloud config set project \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e\n\n- \u003cvar translate=\"no\"\u003ezone\u003c/var\u003e is the zone for which you want to list\n Filestore instances. If you skip this flag, instances in all\n zones are returned. Run the `gcloud filestore zones list` command to get a\n list of supported zones.\n\nThe response to the `instances list` command is similar to the following:\n**Note:** For more information regarding the types of available instances, see [Service tiers](/filestore/docs/service-tiers). \n\n```\nINSTANCE_NAME ZONE TIER CAPACITY_GB FILE_SHARE_NAME IP_ADDRESS STATE CREATE_TIME\nnfs-loc europe-west1-b BASIC_HDD 1024 nfs1 10.0.5.2 READY 2017-10-09T22:11:28\nnfs3 us-central1-c BASIC_HDD 1024 acme 10.0.6.2 READY 2017-11-06T09:37:18\n```\n\n### Example\n\nThe following command lists the Filestore instances in project\n`myproject`: \n\n gcloud filestore instances list --project=myproject\n\n### REST API\n\n1. Have gcloud CLI [installed and initialized](/sdk/docs/install), which lets\n you generate an access token for the `Authorization` header.\n\n\n2.\n\n Use [`cURL`](http://curl.haxx.se/) to call the [Filestore API](/filestore/docs/reference/rest/v1/projects.locations.instances/list): \n\n ```\n curl -s \\\n --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n --header \"Content-Type: application/json\" \\\n GET \"https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances\"\n ```\n\n Where:\n - \u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e is the name of the project where your instance is located. For example, `my-genomics-project`.\n - \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e is the location you want to search. To search all instances in any location within a project, use [`-`](/filestore/docs/reference/rest/v1/projects.locations.instances/list).\n\nGet information about a specific instance\n-----------------------------------------\n\nUse one of the following procedures to get information about a specific\nFilestore instance. \n\n### Google Cloud console\n\n1. Go to the Filestore instances page.\n\n [Go to the Filestore instances page](https://console.cloud.google.com/filestore/instances)\n2. Click the instance ID to open the instance details page.\n\n### gcloud\n\nGet information about a Filestore instance by running the\n[`instances describe`](/sdk/gcloud/reference/filestore/instances/describe)\ncommand: \n\n gcloud filestore instances describe \u003cvar translate=\"no\"\u003einstance-id\u003c/var\u003e --project=\u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e --location=\u003cvar translate=\"no\"\u003elocation\u003c/var\u003e\n\nThe response to the `instances describe` command is similar to the following: \n\n```\ncreateTime: '2021-10-11T17:28:23.340943077Z'\ncustomPerformanceSupported: true\nfileShares:\n- capacityGb: '1024'\n name: vol1\nkmsKeyName: projects/example-project/locations/us-central1/keyRings/example-ring/cryptoKeys/example-key\nlabels:\n key:val\nname: projects/yourproject/locations/us-central1/instances/nfs-server\nnetworks:\n- ipAddresses:\n - 10.0.0.2\n network: default\n reservedIpRange: 10.0.0.0/26\nperformanceConfig:\n iopsPerTb:\n maxIopsPerTb: '17000'\nperformanceLimits:\n maxIops: '17000'\n maxReadIops: '17000'\n maxReadThroughputBps: '417792000'\n maxWriteIops: '5100'\n maxWriteThroughputBps: '139264000'\nstate: READY\ntier: REGIONAL\n```\n\nThese fields represent the following values:\n\n- `createTime`: The time the instance was created, in [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format.\n- `fileShares`:\n- `capacityGb`: The size of the Filestore file share in binary gigabytes (`GB`), where 1 `GB` = 1024^3^ bytes.\n- `name`: The name of the Filestore file share. You use the file share name with the IP address identified by the `ipAddresses` value to mount the file share on a client.\n- `name`: The fully qualified name of the instance.\n- `ipAddresses`: The IP address for the instance. To mount the Filestore file share on a client, use this value along with the file share name.\n- `network`: The name of the VPC network that the instance uses.\n- `customPerformanceSupported`: Indicates whether custom performance is supported for the instance. If not listed, custom performance is not supported.\n- `performanceConfig`: The custom configuration for custom performance.\n- `performanceLimits`: The enforced performance limits, calculated from the instance's performance.\n- `reservedIpRange`: The IP address block reserved for the use of the instance.\n- `state`: The state of the instance.\n- `tier`: The Filestore service tier of the instance.\n\n### Example\n\nThe following command provides information about the `test-nfs` instance in\nproject `myproject`, in region `us-central1`. \n\n```\ngcloud filestore instances describe test-nfs --project=myproject --region=us-central1\n```\n\n### REST API\n\n1. Have gcloud CLI [installed and initialized](/sdk/docs/install), which lets\n you generate an access token for the `Authorization` header.\n\n\n2.\n\n Use [`cURL`](http://curl.haxx.se/) to call the [Filestore API](/filestore/docs/reference/rest/v1/projects.locations.instances/get): \n\n ```\n curl -s \\\n --header \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n --header \"Content-Type: application/json\" \\\n GET \"https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME\"\n ```\n\n Where:\n - \u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e is the name of the project where your instance is located. For example, `my-genomics-project`.\n - \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e is the location where your instance resides. For example, `us-west1-a`.\n - \u003cvar translate=\"no\"\u003eINSTANCE_NAME\u003c/var\u003e is the name of the instance you want to view. For example, `my-genomics-instance`.\n\nGet information about Filestore instance mounts\n-----------------------------------------------\n\nThe following sections show you how to get different kinds of instance mount\ninformation.\n\n### List the mount points for an instance\n\nYou can list all mount points where a Filestore instance is mounted\nby running: \n\n sudo showmount -a \u003cvar translate=\"no\"\u003eINSTANCE_IP\u003c/var\u003e\n\n#### Example\n\nThe following command lists all mount points for a Filestore\ninstance with the IP address `10.77.67.226`: \n\n sudo showmount -a 10.77.67.226\n\nThe response looks similar to the following: \n\n All mount points on 10.77.67.226:\n 10.128.0.1:/fileshare\n 10.128.0.2:/fileshare\n 10.128.0.3:/fileshare\n\n### Get the number of mount points for an instance\n\nYou can get the total number of mount points for a Filestore\ninstance by running: \n\n sudo showmount -a \u003cvar translate=\"no\"\u003eINSTANCE_IP\u003c/var\u003e --no-headers | wc -l\n\n#### Example\n\nThe following command displays the number of mount points for an instance\nwith the IP address `10.77.67.226`: \n\n sudo showmount -a 10.77.67.226 --no-headers | wc -l\n\nWhat's next\n-----------\n\n- [Create another instance](/filestore/docs/creating-instances).\n- [Mount the Filestore file share on a Compute Engine VM instance](/filestore/docs/mounting-fileshares).\n- [Access Filestore instances from a Google Kubernetes Engine cluster](/filestore/docs/csi-driver)."]]
