Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite erfahren Sie, wie Sie Informationen zu Filestore-Instanzen abrufen.
Hinweise
Wenn Sie die Befehlszeilenbeispiele auf dieser Seite verwenden möchten, müssen Sie das gcloud-Befehlszeilentool aktivieren. Installieren Sie dazu die gcloud CLI.
Alle Instanzen in einem Projekt aufrufen
Google Cloud console
Sie können Informationen zu Ihren Filestore-Instanzen abrufen und sich alle Instanzen in einem Projekt ansehen, indem Sie die Seite „Filestore-Instanzen“ aufrufen:
Sie können Informationen zu Ihren Filestore-Instanzen abrufen und sich alle Instanzen in einem Projekt ansehen, indem Sie den Befehl instances list ausführen:
gcloud filestore instances list --project=project-id --zone=zone
Dabei gilt:
project-id ist die Projekt-ID des Google Cloud Projekts, das die Filestore-Instanz enthält. Sie können dieses Flag überspringen, wenn sich die Filestore-Instanz im Standardprojekt gcloud befindet. Sie können das Standardprojekt folgendermaßen festlegen:
gcloud config set project project-id
zone ist die Zone, für die Sie Filestore-Vorgänge auflisten möchten. Wenn Sie dieses Flag überspringen, werden Instanzen in allen Zonen zurückgegeben. Führen Sie den Befehl gcloud filestore zones list aus, um eine Liste der unterstützten Zonen abzurufen.
Die Antwort auf den Befehl instances list ähnelt der folgenden:
PROJECT ist der Name des Projekts, in dem sich Ihre Instanz befindet. Beispiel: my-genomics-project.
LOCATION ist der Ort, nach dem Sie suchen möchten.
Wenn Sie nach allen Instanzen an einem beliebigen Ort in einem Projekt suchen möchten, verwenden Sie -.
Informationen zu einer bestimmten Instanz abrufen
Verwenden Sie eines der folgenden Verfahren, um Informationen zu einer bestimmten Filestore-Instanz abzurufen.
createTime: Die Zeit, zu der die Instanz erstellt wurde, im RFC3339-Format.
fileShares:
capacityGb: Die Größe der Filestore-Dateifreigabe in binären Gigabyte (GB), wobei 1 GB = 10243 Bytes.
name: Der Name der Filestore-Dateifreigabe. Sie verwenden den Namen der Dateifreigabe mit der IP-Adresse, die durch den Wert ipAddresses identifiziert wird, um die Dateifreigabe auf einem Client bereitzustellen.
name: Der voll qualifizierte Name der Instanz.
ipAddresses: Die IP-Adresse für die Instanz. Verwenden Sie diesen Wert zusammen mit dem Dateifreigabenamen, um die Filestore-Dateifreigabe auf einem Client bereitzustellen.
network: Der Name des VPC-Netzwerks, das die Instanz verwendet.
customPerformanceSupported: Gibt an, ob die benutzerdefinierte Leistung für die Instanz unterstützt wird. Wenn die Option nicht aufgeführt ist, wird die benutzerdefinierte Leistung nicht unterstützt.
performanceConfig: Die benutzerdefinierte Konfiguration für die benutzerdefinierte Leistung.
performanceLimits: Die erzwungenen Leistungsgrenzwerte, die anhand der Leistung der Instanz berechnet werden.
reservedIpRange: Der IP-Adressblock, der für die Verwendung der Instanz reserviert ist.
state: Der Status der Instanz.
tier: Die Filestore-Dienststufe der Instanz.
Beispiel
Der folgende Befehl enthält Informationen zur test-nfs-Instanz in Projekt myproject in Region us-central1.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (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)."]]
