Obtener información de instancias

En esta página se explica cómo obtener información sobre las instancias de Filestore.

Antes de empezar

Si quieres usar los ejemplos de línea de comandos de esta página, habilita la gcloudherramienta de línea de comandos instalando la CLI de gcloud.

Ver todas las instancias de un proyecto

Google Cloud consola

Para obtener información sobre tus instancias de Filestore y ver todas las instancias de un proyecto, ve a la página Instancias de Filestore:

Ve a la página Instancias de Filestore.

gcloud

Para obtener información sobre tus instancias de Filestore y ver todas las instancias de un proyecto, ejecuta el comando instances list:

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

donde:

  • project-id es el ID del proyecto que contiene la instancia de Filestore. Google Cloud Puedes omitir esta marca si la instancia de Filestore está en el proyecto gcloudpredeterminado. Para definir el proyecto predeterminado, ejecuta el siguiente comando:

      gcloud config set project project-id
    
  • zone es la zona de la que quieres obtener una lista de instancias de Filestore. Si omite esta marca, se devolverán las instancias de todas las zonas. Ejecuta el comando gcloud filestore zones list para obtener una lista de las zonas admitidas.

La respuesta al comando instances list es similar a la siguiente:

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

Ejemplo

El siguiente comando muestra las instancias de Filestore del proyecto myproject:

  gcloud filestore instances list --project=myproject

API REST

  1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la 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"

    Donde:

    • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project.
    • LOCATION es la ubicación que quieres buscar. Para buscar todas las instancias de cualquier ubicación de un proyecto, usa -.

Obtener información sobre una instancia específica

Sigue uno de estos procedimientos para obtener información sobre una instancia de Filestore específica.

Google Cloud consola

  1. Ve a la página Instancias de Filestore.

    Ve a la página Instancias de Filestore.

  2. Haz clic en el ID de la instancia para abrir la página de detalles de la instancia.

gcloud

Para obtener información sobre una instancia de Filestore, ejecuta el comando instances describe:

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

La respuesta al comando instances describe es similar a la siguiente:

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

Estos campos representan los siguientes valores:

  • createTime: hora en la que se creó la instancia, en formato RFC 3339.
  • fileShares:
  • capacityGb: tamaño del recurso compartido de archivos de Filestore en gigabytes binarios (GB), donde 1 GB = 10243 bytes.
  • name: nombre del recurso compartido de archivos de Filestore. Para activar el sistema de archivos compartidos en un cliente, debes usar el nombre del sistema de archivos compartido con la dirección IP identificada por el valor ipAddresses.
  • name: nombre completo de la instancia.
  • ipAddresses: la dirección IP de la instancia. Para montar el sistema de archivos compartido de Filestore en un cliente, utilice este valor junto con el nombre del sistema de archivos compartido.
  • network: nombre de la red de VPC que usa la instancia.
  • customPerformanceSupported: indica si se admite el rendimiento personalizado en la instancia. Si no aparece en la lista, no se admite el rendimiento personalizado.
  • performanceConfig: la configuración personalizada para el rendimiento personalizado.
  • performanceLimits: los límites de rendimiento aplicados, calculados a partir del rendimiento de la instancia.
  • reservedIpRange: bloque de direcciones IP reservado para el uso de la instancia.
  • state: estado de la instancia.
  • tier: el nivel de servicio de Filestore de la instancia.

Ejemplo

El siguiente comando proporciona información sobre la instancia test-nfs del proyecto myproject en la región us-central1.

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

API REST

  1. Tener instalada e inicializadala CLI de gcloud, que te permite generar un token de acceso para el encabezado Authorization.

  2. Usa cURL para llamar a la 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"

    Donde:

    • PROJECT es el nombre del proyecto en el que se encuentra tu instancia. Por ejemplo, my-genomics-project.
    • LOCATION es la ubicación en la que reside tu instancia. Por ejemplo, us-west1-a.
    • INSTANCE_NAME es el nombre de la instancia que quieres ver. Por ejemplo, my-genomics-instance.

Obtener información sobre los montajes de instancias de Filestore

En las siguientes secciones se muestra cómo obtener diferentes tipos de información de montaje de instancias.

Mostrar los puntos de montaje de una instancia

Puedes enumerar todos los puntos de montaje en los que se ha montado una instancia de Filestore ejecutando el siguiente comando:

    sudo showmount -a INSTANCE_IP

Ejemplo

El siguiente comando muestra todos los puntos de montaje de una instancia de Filestore con la dirección IP 10.77.67.226:

    sudo showmount -a 10.77.67.226

La respuesta tiene un aspecto similar al siguiente:

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

Obtener el número de puntos de montaje de una instancia

Para obtener el número total de puntos de montaje de una instancia de Filestore, ejecuta lo siguiente:

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

Ejemplo

El siguiente comando muestra el número de puntos de montaje de una instancia con la dirección IP 10.77.67.226:

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

Siguientes pasos