本頁說明如何取得 Filestore 執行個體的相關資訊。
事前準備
如要使用本頁中的指令列範例,請安裝 gcloud CLI,啟用 gcloud
指令列工具。
查看專案中的所有執行個體
Google Cloud 控制台
您可以前往 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
使用
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 控制台
前往 Filestore 執行個體頁面。
按一下執行個體 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 檔案共用區大小,其中 1GB
= 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
使用
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
後續步驟
- 建立其他執行個體。
- 在 Compute Engine VM 執行個體中掛接 Filestore 檔案共用區。
- 從 Google Kubernetes Engine 叢集存取 Filestore 執行個體。