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 nesta página, ative a ferramenta de linha de comando gcloud instalando a CLI gcloud.

Conferir todas as instâncias em um projeto

Google Cloud Console do

Para informações sobre suas instâncias do Filestore e para conferir 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 informações sobre suas instâncias do Filestore e para conferir todas as instâncias em um projeto, execute o instances list comando:

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

em que:

  • project-id é o ID do projeto do Google Cloud projeto 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. Tenha 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 dentro de 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.

Google Cloud Console do

  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

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

    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'
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: 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.
  • customPerformanceSupported: indica se o desempenho personalizado é compatível com a instância. Se não estiver listado, o desempenho personalizado não será compatível.
  • performanceConfig: a configuração personalizada para desempenho personalizado.
  • performanceLimits: os limites de desempenho aplicados, calculados com base no desempenho da instância.
  • 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 região us-central1.

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

API REST

  1. Tenha 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 conferir. Por exemplo, my-genomics-instance.

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

As seções a seguir mostram como receber diferentes tipos de informações de ativação de instâncias.

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

Como conseguir 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