Obtén información de las instancias

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

Antes de comenzar

Si deseas usar los ejemplos de la línea de comandos de esta página, habilita la herramienta de línea de comandos de gcloud. Para ello, instala gcloud CLI.

Cómo ver todas las instancias de un proyecto

Consola de Google Cloud

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

Vaya a la página de 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 de Google Cloud que contiene la instancia de Filestore. Puedes omitir esta marca si la instancia de Filestore está en el proyecto predeterminado gcloud. Para configurar el proyecto predeterminado, ejecuta el siguiente comando:

    gcloud config set project project-id
  

• zone es la zona para la que deseas enumerar las instancias de Filestore. Si omites esta marca, se mostrarán las instancias en todas las zonas. Ejecuta el comando gcloud filestore zones list para obtener una lista de las zonas compatibles.

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

Nota: Para obtener más información sobre los tipos de instancias disponibles, consulta Niveles de servicio.

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 enumera las instancias de Filestore del proyecto myproject:

  gcloud filestore instances list --project=myproject

API de REST

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

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

   Aquí:

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

Obtén información sobre una instancia específica

Utilice uno de los siguientes procedimientos para obtener información sobre una instancia específica de Filestore.

Consola de Google Cloud

1. Vaya a la página de instancias de Filestore

   Vaya a la página de 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'
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

Estos campos representan los valores siguientes:

• createTime: La hora en que se creó la instancia, en formato RFC 3339.
• fileShares:
• capacityGb: el tamaño del archivo compartido de Filestore en gigabytes binarios (GB), donde 1 GB = 1024 ³ bytes.
• name: Es el nombre del archivo compartido de Filestore. Usa el nombre del archivo compartido con la dirección IP identificada por el valor ipAddresses para activar el archivo compartido en un cliente.
• name: el nombre completamente calificado de la instancia.
• ipAddresses: Es la dirección IP de la instancia. Para activar el archivo compartido de Filestore en un cliente, usa este valor junto con el nombre del archivo compartido.
• network: Es el nombre de la red de VPC que usa la instancia.
• reservedIpRange: el bloque de la dirección IP reservado para el uso de la instancia.
• state: Es el estado de la instancia.
• tier: el nivel del servicio de Filestore de la instancia.

Ejemplo

Con el siguiente comando, se proporciona información sobre la instancia test-nfs en el proyecto myproject, en la zona us-central1-c.

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

API de REST

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

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

   Aquí:

   • 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 se encuentra la instancia. Por ejemplo, us-west1-a
   • INSTANCE_NAME es el nombre de la instancia que deseas ver. Por ejemplo, my-genomics-instance

Obtén información sobre las activaciones de instancias de Filestore

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

Enumera los puntos de activación de una instancia

Para enumerar todos los puntos de activación en los que se activa una instancia de Filestore, ejecuta lo siguiente:

    sudo showmount -a INSTANCE_IP

Ejemplo

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

    sudo showmount -a 10.77.67.226

El resultado es 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

Obtén la cantidad de puntos de activación para una instancia

Para obtener la cantidad total de puntos de activación de una instancia de Filestore, ejecuta lo siguiente:

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

Ejemplo

El siguiente comando muestra la cantidad de puntos de activación de una instancia con la dirección IP 10.77.67.226:

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

¿Qué sigue?

• Crea otra instancia.
• Activar el archivo compartido de Filestore en una instancia de VM de Compute Engine.
• Accede a instancias de Filestore desde un clúster de Google Kubernetes Engine.