Obtenha informações da instância

Esta página mostra como obter informações sobre instâncias do Filestore.

Antes de começar

Se quiser usar os exemplos de linhas de comando nesta página, ative a gcloudferramenta de linhas de comando instalando a CLI gcloud.

Veja todas as instâncias num projeto

Google Cloud consola

Pode obter informações sobre as suas instâncias do Filestore e ver todas as instâncias num projeto acedendo à página de instâncias do Filestore:

Aceda à página de instâncias do Filestore

gcloud

Pode obter informações sobre as suas instâncias do Filestore e ver todas as instâncias num projeto executando o comando instances list:

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

where:

  • project-id é o ID do projeto do projeto que contém a instância do Filestore. Google Cloud Pode ignorar esta flag se a instância do Filestore estiver no projeto gcloud predefinido. Pode definir o projeto predefinido executando o seguinte comando:

      gcloud config set project project-id

  • zone é a zona para a qual quer listar instâncias do Filestore. Se ignorar esta flag, são devolvidas instâncias em todas as zonas. Execute o comando gcloud filestore zones list para obter uma lista de zonas suportadas.

A resposta ao comando instances list é semelhante à seguinte:

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

Exemplo

O comando seguinte lista as instâncias do Filestore no projeto myproject:

  gcloud filestore instances list --project=myproject

API REST

  1. Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho Authorization.

  2. Use cURL para chamar a 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"

    Onde:

    • PROJECT é o nome do projeto onde a sua instância está localizada. Por exemplo, my-genomics-project.
    • LOCATION é a localização que quer pesquisar. Para pesquisar todas as instâncias em qualquer localização num projeto, use -.

Receba informações sobre uma instância específica

Use um dos seguintes procedimentos para obter informações sobre uma instância do Filestore específica.

Google Cloud consola

  1. Aceda à página de instâncias do Filestore.

    Aceda à página de instâncias do Filestore

  2. Clique no ID da instância para abrir a página de detalhes da instância.

gcloud

Obtenha informações sobre uma instância do Filestore executando o comando instances describe:

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

A resposta ao comando instances describe é semelhante à seguinte:

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

Estes campos representam os seguintes valores:

  • createTime: a hora em que a instância foi criada, no formato RFC 3339.
  • fileShares:
  • capacityGb: o tamanho da partilha de ficheiros do Filestore em gigabytes binários (GB), em que 1 GB = 10243 bytes.
  • name: o nome da partilha de ficheiros do Filestore. Usa o nome da partilha de ficheiros com o endereço IP identificado pelo valor ipAddresses para montar a partilha de ficheiros num cliente.
  • name: o nome totalmente qualificado da instância.
  • ipAddresses: O endereço IP da instância. Para montar a partilha de ficheiros do Filestore num cliente, use este valor juntamente com o nome da partilha de ficheiros.
  • network: o nome da rede VPC que a instância usa.
  • customPerformanceSupported: indica se o desempenho personalizado é suportado para a instância. Se não estiver listado, o desempenho personalizado não é suportado.
  • performanceConfig: a configuração personalizada para o desempenho personalizado.
  • performanceLimits: os limites de desempenho aplicados, calculados a partir do desempenho da instância.
  • reservedIpRange: o bloco de endereços IP reservado para utilização da instância.
  • state: o estado da instância.
  • tier: o nível de serviço do Filestore da instância.

Exemplo

O comando seguinte fornece informações sobre a instância test-nfs no projeto myproject, na região us-central1.

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

API REST

  1. Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho Authorization.

  2. Use cURL para chamar a 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"

    Onde:

    • PROJECT é o nome do projeto onde a sua instância está localizada. Por exemplo, my-genomics-project.
    • LOCATION é a localização onde a sua instância reside. Por exemplo, us-west1-a.
    • INSTANCE_NAME é o nome da instância que quer ver. Por exemplo, my-genomics-instance.

Receba informações sobre as montagens de instâncias do Filestore

As secções seguintes mostram como obter diferentes tipos de informações de montagem de instâncias.

Liste os pontos de montagem de uma instância

Pode listar todos os pontos de montagem onde uma instância do Filestore está montada executando:

    sudo showmount -a INSTANCE_IP

Exemplo

O comando seguinte apresenta uma lista de todos os pontos de montagem de uma instância do Filestore com o endereço IP 10.77.67.226:

    sudo showmount -a 10.77.67.226

A resposta tem um aspeto semelhante ao seguinte:

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

Obtenha o número de pontos de montagem de uma instância

Pode obter o número total de pontos de montagem para uma instância do Filestore executando o seguinte comando:

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

Exemplo

O comando seguinte apresenta o número de pontos de montagem para uma instância com o endereço IP 10.77.67.226:

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

O que se segue?