Recupera informazioni sull'istanza

Questa pagina mostra come ottenere informazioni sulle istanze di Filestore.

Prima di iniziare

Se vuoi utilizzare gli esempi di riga di comando in questa pagina, abilita lo strumento a riga di comando gcloud installando gcloud CLI.

Visualizza tutte le istanze in un progetto

Console Google Cloud

Puoi ottenere informazioni sulle tue istanze Filestore e visualizzare tutte le istanze di un progetto andando alla pagina delle istanze Filestore:

Vai alla pagina Istanze di Filestore

gcloud

Puoi ottenere informazioni sulle tue istanze Filestore e visualizzare tutte le istanze in un progetto eseguendo il comando instances list:

  gcloud filestore instances list --project=project-id --zone=zone

dove:

  • project-id è l'ID del progetto Google Cloud che contiene l'istanza Filestore. Puoi saltare questo flag se l'istanza Filestore si trova nel progetto gcloud predefinito. Puoi impostare il progetto predefinito eseguendo:

      gcloud config set project project-id

  • zone è la zona per cui vuoi elencare le istanze Filestore. Se salti questo flag, vengono restituite le istanze in tutte le zone. Esegui il comando gcloud filestore zones list per ottenere un elenco delle zone supportate.

La risposta al comando instances list è simile alla seguente:

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

Esempio

Il comando seguente elenca le istanze Filestore nel progetto myproject:

  gcloud filestore instances list --project=myproject

API REST

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare 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"

    Dove:

    • PROJECT è il nome del progetto in cui si trova l'istanza. Ad esempio, my-genomics-project.
    • LOCATION è la località che vuoi cercare. Per cercare tutte le istanze in qualsiasi località all'interno di un progetto, utilizza -.

Recuperare informazioni su un'istanza specifica

Utilizza una delle seguenti procedure per ottenere informazioni su un'istanza Filestore specifica.

Console Google Cloud

  1. Vai alla pagina delle istanze Filestore.

    Vai alla pagina Istanze di Filestore

  2. Fai clic sull'ID istanza per aprire la pagina dei dettagli dell'istanza.

gcloud

Per ottenere informazioni su un'istanza Filestore, esegui il comando instances describe:

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

La risposta al comando instances describe è simile alla seguente:

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

Questi campi rappresentano i seguenti valori:

  • createTime: l'ora di creazione dell'istanza, nel formato RFC 3339.
  • fileShares:
  • capacityGb: le dimensioni della condivisione file Filestore in gigabyte binari (GB), dove 1 GB = 10243 byte.
  • name: il nome della condivisione file Filestore. Utilizza il nome della condivisione file con l'indirizzo IP identificato dal valore ipAddresses per montare la condivisione file su un client.
  • name: il nome completo dell'istanza.
  • ipAddresses: L'indirizzo IP dell'istanza. Per montare la condivisione file Filestore su un client, utilizza questo valore insieme al nome della condivisione file.
  • network: il nome della rete VPC utilizzata dall'istanza.
  • customPerformanceSupported: indica se le prestazioni personalizzate sono supportate per l'istanza. Se non è presente nell'elenco, le prestazioni personalizzate non sono supportate.
  • performanceConfig: La configurazione personalizzata per le prestazioni personalizzate.
  • performanceLimits: i limiti di prestazioni applicati, calcolati in base alle prestazioni dell'istanza.
  • reservedIpRange: Il blocco di indirizzi IP riservato all'utilizzo dell'istanza.
  • state: lo stato dell'istanza.
  • tier: Il livello di servizio Filestore dell'istanza.

Esempio

Il seguente comando fornisce informazioni sull'istanza test-nfs nel progetto myproject, nella regione us-central1.

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

API REST

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare 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"

    Dove:

    • PROJECT è il nome del progetto in cui si trova l'istanza. Ad esempio, my-genomics-project.
    • LOCATION è la località in cui si trova l'istanza. Ad esempio, us-west1-a.
    • INSTANCE_NAME è il nome dell'istanza che vuoi visualizzare. Ad esempio, my-genomics-instance.

Recupera informazioni sui montaggi delle istanze Filestore

Le sezioni seguenti mostrano come ottenere diversi tipi di informazioni sul montaggio delle istanze.

Elenca i punti di montaggio per un'istanza

Puoi elencare tutti i punti di montaggio in cui è montata un'istanza Filestore eseguendo:

    sudo showmount -a INSTANCE_IP

Esempio

Il seguente comando elenca tutti i punti di montaggio per un'istanza Filestore con l'indirizzo IP 10.77.67.226:

    sudo showmount -a 10.77.67.226

La risposta è simile alla seguente:

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

Recupera il numero di punti di montaggio per un'istanza

Puoi ottenere il numero totale di punti di montaggio per un'istanza Filestore eseguendo:

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

Esempio

Il comando seguente mostra il numero di punti di montaggio per un'istanza con l'indirizzo IP 10.77.67.226:

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

Passaggi successivi