Instanzinformationen abrufen

Auf dieser Seite erfahren Sie, wie Sie Informationen zu Filestore-Instanzen abrufen.

Hinweis

Wenn Sie die Befehlszeilenbeispiele auf dieser Seite verwenden möchten, aktivieren Sie das gcloud Befehlszeilentool, indem Sie die gcloud CLI installieren.

Alle Instanzen in einem Projekt ansehen

Google Cloud Console

Sie können Informationen zu Ihren Filestore-Instanzen abrufen und alle Instanzen in einem Projekt ansehen, indem Sie die Seite „Filestore-Instanzen“ aufrufen:

Zur Seite mit den Filestore-Instanzen

gcloud

Sie können Informationen zu Ihren Filestore-Instanzen abrufen und alle Instanzen in einem Projekt ansehen, indem Sie den instances list Befehl 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 gcloud-Standardprojekt 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:

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

Beispiel

Mit dem folgenden Befehl werden die Filestore-Instanzen im Projekt myproject aufgelistet:

  gcloud filestore instances list --project=myproject

REST API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization Header zu generieren.

  2. Rufen Sie die Filestore API mit cURL auf:

    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"

    Dabei gilt:

    • PROJECT ist der Name des Projekts, in dem sich die Instanz befindet. Beispiel: my-genomics-project.
    • LOCATION ist der Ort, an dem Sie suchen möchten. Wenn Sie alle 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.

Google Cloud Console

  1. Zur Seite mit den Filestore-Instanzen

    Zur Seite mit den Filestore-Instanzen

  2. Klicken Sie auf die Instanz-ID, um die Detailseite der Instanz zu öffnen.

gcloud

Rufen Sie mit dem instances describe Befehl Informationen zu einer Filestore-Instanz ab:

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

Die Antwort auf den Befehl instances describe ähnelt der folgenden:

createTime: '2021-10-11T17:28:23.340943077Z'
customPerformanceSupported: true
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/instances/nfs-server
networks:
- ipAddresses:
 - 10.0.0.2
 network: default
 reservedIpRange: 10.0.0.0/26
performanceConfig:
  iopsPerTb:
    maxIopsPerTb: '17000'
performanceLimits:
  maxIops: '17000'
  maxReadIops: '17000'
  maxReadThroughputBps: '417792000'
  maxWriteIops: '5100'
  maxWriteThroughputBps: '139264000'
state: READY
tier: REGIONAL

Diese Felder stellen die folgenden Werte dar:

  • 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-Netzwerk, das die Instanz verwendet.
  • customPerformanceSupported: Gibt an, ob die benutzerdefinierte Leistung für die Instanz unterstützt wird. Wenn nicht aufgeführt, wird die benutzerdefinierte Leistung nicht unterstützt.
  • performanceConfig: Die benutzerdefinierte Konfiguration für die benutzerdefinierte Leistung.
  • performanceLimits: Die erzwungenen Leistungslimits, berechnet aus der Leistung der Instanz.
  • 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 Instanz test-nfs im Projekt myproject in der Region us-central1.

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

REST API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization Header zu generieren.

  2. Rufen Sie die Filestore API mit cURL auf:

    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"

    Dabei gilt:

    • PROJECT ist der Name des Projekts, in dem sich die Instanz befindet. Beispiel: my-genomics-project.
    • LOCATION ist der Ort, an dem sich die Instanz befindet. Beispiel: us-west1-a.
    • INSTANCE_NAME ist der Name der Instanz, die Sie aufrufen möchten. Beispiel: my-genomics-instance.

Informationen zu Filestore-Instanzbereitstellungen abrufen

In den folgenden Abschnitten erfahren Sie, wie Sie verschiedene Arten von Informationen zur Instanzbereitstellung abrufen.

Bereitstellungspunkte für eine Instanz auflisten

Mit dem folgenden Befehl können Sie alle Bereitstellungspunkte auflisten, an denen eine Filestore-Instanz bereitgestellt wird:

    sudo showmount -a INSTANCE_IP

Beispiel

Mit dem folgenden Befehl werden alle Bereitstellungspunkte für eine Filestore-Instanz mit der IP-Adresse 10.77.67.226 aufgelistet:

    sudo showmount -a 10.77.67.226

Die Antwort sieht dann ungefähr so aus:

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

Anzahl der Bereitstellungspunkte für eine Instanz abrufen

Sie können die Gesamtzahl der Bereitstellungspunkte für eine Filestore-Instanz abrufen, indem Sie Folgendes ausführen:

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

Beispiel

Der folgende Befehl zeigt die Anzahl der Bereitstellungspunkte für eine Instanz mit der IP-Adresse 10.77.67.226 an:

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

Nächste Schritte