Receber informações da instância

Nesta página, mostramos como receber informações sobre instâncias do Filestore.

Antes de começar

Se você quiser usar os exemplos de linha de comando desta página, ative a ferramenta de linha de comando gcloud instalando a CLI gcloud.

Conferir todas as instâncias em um projeto

Console do Google Cloud

Para informações sobre suas instâncias do Filestore e visualizar todas as instâncias em um projeto, acesse a página de instâncias do Filestore:

Acessar a página de instâncias do Filestore

gcloud

Para conferir informações sobre suas instâncias do Filestore e visualizar todas as instâncias em um projeto, execute o comando instances list:

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

em que:

  • project-id é o ID do projeto do Google Cloud que contém a instância do Filestore. É possível ignorar essa sinalização se a instância do Filestore estiver no projeto padrão gcloud. Para definir o projeto padrão, execute:

      gcloud config set project project-id

  • zone é a zona em que você quer listar as instâncias do Filestore. Se você ignorar essa sinalização, as instâncias em todas as zonas serão retornadas. Execute o comando gcloud filestore zones list para ver uma lista de zonas compatíveis.

A resposta ao comando instances list é semelhante a esta:

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 a seguir 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 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"

    Em que:

    • PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, my-genomics-project.
    • LOCATION é o local que você quer pesquisar. Para pesquisar todas as instâncias em qualquer local em um projeto, use -.

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

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

Console do Google Cloud

  1. Acessar a página de instâncias do Filestore.

    Acessar a página de instâncias do Filestore

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

gcloud

Para receber informações sobre uma instância do Filestore, execute o comando instances describe:

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

A resposta ao comando instances describe é semelhante a esta:

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

Estes campos representam os seguintes valores:

  • createTime: o horário em que a instância foi criada, no formato RFC 3339.
  • fileShares:
  • capacityGb: o tamanho do compartilhamento de arquivos do Filestore em gigabytes binários (GB), em que 1 GB = 1024 3 bytes.
  • name: o nome do compartilhamento de arquivos do Filestore. Use o nome do compartilhamento de arquivos com o endereço IP identificado pelo valor ipAddresses para ativar o compartilhamento de arquivos em um cliente.
  • name: o nome totalmente qualificado da instância.
  • ipAddresses: o endereço IP da instância. Para ativar o compartilhamento de arquivos do Filestore em um cliente, use esse valor junto com o nome do compartilhamento de arquivos.
  • network: o nome da rede VPC que a instância usa.
  • reservedIpRange: o bloco de endereços IP reservado para o uso da instância.
  • state: o estado da instância.
  • tier: o nível de serviço do Filestore da instância.

Exemplo

O comando a seguir fornece informações sobre a instância test-nfs no projeto myproject, na zona us-central1-c.

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

API REST

  1. Ter a CLI gcloud instalada e inicializada, o que 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"

    Em que:

    • PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, my-genomics-project.
    • LOCATION é o local em que a instância reside. Por exemplo, us-west1-a.
    • INSTANCE_NAME é o nome da instância que você quer consultar. Por exemplo, my-genomics-instance.

Receber informações sobre as ativações de instâncias do Filestore

As seções a seguir mostram como receber diferentes tipos de informações de montagem de instância.

Listar os pontos de montagem de uma instância

Para listar todos os pontos de ativação em que uma instância do Filestore é ativada, execute:

    sudo showmount -a INSTANCE_IP

Exemplo

O comando a seguir lista 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 será semelhante a:

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

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

Para ver o número total de pontos de montagem de uma instância do Filestore, execute:

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

Exemplo

O comando a seguir exibe o número de pontos de montagem de uma instância com o endereço IP 10.77.67.226:

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

A seguir