取得執行個體資訊

本頁說明如何取得 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 區域中專案 myproject 的 test-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

後續步驟