Instanzinformationen abrufen

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:

Zur Seite mit den Filestore-Instanzen

gcloud

Sie können Informationen zu Ihren Filestore-Instanzen abrufen und alle Instanzen in einem Projekt aufrufen, 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:

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. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

  2. Verwenden Sie cURL, um die Filestore API aufzurufen:

    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"

    Wobei:

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

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 Befehl instances describe 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'
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

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-Netzwerks, das die Instanz verwendet.
  • 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 Zone us-central1-c.

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

REST API

  1. Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den Header Authorization zu generieren.

  2. Verwenden Sie cURL, um die Filestore API aufzurufen:

    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"

    Wobei:

    • PROJECT ist der Name des Projekts, in dem sich Ihre Instanz befindet. Beispiel: my-genomics-project.
    • LOCATION ist der Speicherort Ihrer Instanz. 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 zum Bereitstellen von Instanzen 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