取得執行個體資訊

本頁說明如何取得 Filestore 執行個體的相關資訊。

事前準備

如要使用本頁中的指令列範例,請安裝 gcloud CLI,啟用 gcloud 指令列工具。

查看專案中的所有執行個體

Google Cloud 控制台

您可以前往 Filestore 執行個體頁面,取得 Filestore 執行個體的相關資訊,並查看專案中的所有執行個體:

前往 Filestore 執行個體頁面

gcloud

您可以執行 instances list 指令,取得 Filestore 執行個體的相關資訊,並查看專案中的所有執行個體:

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

其中:

  • project-id 是包含 Filestore 執行個體的 Google Cloud 專案 ID。如果 Filestore 執行個體位於 gcloud 預設專案中,您可以略過這個標記。您可以執行下列指令來設定預設專案:

      gcloud config set project project-id
    
  • zone 是您要列出 Filestore 執行個體的區域。如果您略過此標記,系統會傳回所有區域的執行個體。執行 gcloud filestore zones list 指令,取得支援的區域清單。

instances list 指令的回應如下所示:

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

範例

以下指令會列出專案 myproject 中的 Filestore 執行個體:

  gcloud filestore instances list --project=myproject

REST API

  1. 安裝並初始化 gcloud CLI,這樣您就能為 Authorization 標頭產生存取權杖。

  2. 使用 cURL 呼叫 Filestore API

    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"

    其中:

    • PROJECT 是執行個體所在專案的名稱。例如:my-genomics-project
    • LOCATION 是您要搜尋的位置。如要搜尋專案中任何位置的所有例項,請使用 -

取得特定執行個體的相關資訊

請使用下列其中一個程序,取得特定 Filestore 執行個體的相關資訊。

Google Cloud 控制台

  1. 前往 Filestore 執行個體頁面。

    前往 Filestore 執行個體頁面

  2. 按一下執行個體 ID,開啟執行個體詳細資料頁面。

gcloud

執行 instances describe 指令,取得 Filestore 執行個體的相關資訊:

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

instances describe 指令的回應如下所示:

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

這些欄位代表下列值:

  • createTime:執行個體的建立時間,採用 RFC 3339 格式。
  • fileShares
  • capacityGb:以二進位 GB (GB) 為單位的 Filestore 檔案共用區大小,其中 1 GB = 10243 個位元組。
  • name:Filestore 檔案共用項目的名稱。您可以使用檔案共用區名稱和 ipAddresses 值指定的 IP 位址,在用戶端上掛接檔案共用區。
  • name:執行個體的完整名稱。
  • ipAddresses:執行個體的 IP 位址。如要在用戶端掛接 Filestore 檔案共用區,請搭配使用這個值和檔案共用區名稱。
  • network:執行個體使用的虛擬私有雲網路名稱。
  • customPerformanceSupported:指出執行個體是否支援自訂效能。如果未列出,則表示不支援自訂效能。
  • performanceConfig:自訂成效的自訂設定。
  • performanceLimits:根據執行個體的效能計算的強制效能限制。
  • reservedIpRange:為執行個體保留的 IP 位址區塊。
  • state:執行個體的狀態。
  • tier:執行個體的 Filestore 服務層級。

範例

下列指令會提供 us-central1 區域中專案 myprojecttest-nfs 執行個體相關資訊。

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

REST API

  1. 安裝並初始化 gcloud CLI,這樣您就能為 Authorization 標頭產生存取權杖。

  2. 使用 cURL 呼叫 Filestore API

    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"

    其中:

    • PROJECT 是執行個體所在專案的名稱。例如:my-genomics-project
    • LOCATION 是執行個體所在的位置。例如:us-west1-a
    • INSTANCE_NAME 是您要查看的執行個體名稱。例如:my-genomics-instance

取得 Filestore 執行個體掛接點的相關資訊

以下各節將說明如何取得不同類型的執行個體掛載資訊。

列出執行個體的掛載點

您可以執行以下指令,列出 Filestore 執行個體掛接的所有掛接點:

    sudo showmount -a INSTANCE_IP

範例

下列指令會列出 IP 位址為 10.77.67.226 的 Filestore 執行個體的所有掛接點:

    sudo showmount -a 10.77.67.226

回應如下所示:

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

取得執行個體的掛載點數

如要取得 Filestore 執行個體的掛接點總數,請執行以下指令:

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

範例

以下指令會顯示 IP 位址為 10.77.67.226 的執行個體掛載點數量:

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

後續步驟