本文說明如何取得 Cloud FTP 伺服器的相關資訊。您可以列出專案和位置中的所有安全檔案傳輸通訊協定伺服器。您也可以取得特定伺服器的詳細資訊,例如伺服器狀態和連線詳細資料。
必要的角色
如要取得查看 SFTP 伺服器資訊所需的權限,請要求管理員授予您專案的 Cloud FTP 檢視者 (roles/ftp.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這個預先定義的角色具備取得 SFTP 伺服器資訊所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能取得 SFTP 伺服器的相關資訊:
-
清單伺服器:
ftp.servers.list -
取得伺服器詳細資料:
ftp.servers.get
列出伺服器
控制台
- 前往 Google Cloud 控制台的「Cloud FTP」頁面。
系統會顯示伺服器清單。
gcloud
如要列出 SFTP 伺服器,請執行 gcloud alpha storage ftp servers list 指令。
使用下列任何指令資料之前,請先替換以下項目:
- LOCATION_ID:伺服器的位置,例如
us-west1。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows (PowerShell)
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows (cmd.exe)
gcloud alpha storage ftp servers list --location=LOCATION_ID
REST
如要列出 SFTP 伺服器,請使用 servers.list 方法。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案 ID。
- LOCATION_ID:伺服器的位置,例如
us-west1。
HTTP 方法和網址:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers
請展開以下其中一個選項,以傳送要求:
回應主體是 JSON 物件,內含 Server 資源清單。
用戶端程式庫
C#
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP C# API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP Go API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱「Cloud FTP Java API 參考文件」。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP Node.js API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP PHP API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱「Cloud FTP Python API 參考文件」。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP Ruby API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
取得伺服器詳細資料
如要取得特定伺服器的詳細資訊,包括伺服器的 IP 位址或服務連結、狀態、憑證和服務代理電子郵件地址,請按照下列步驟操作。
控制台
- 前往 Google Cloud 控制台的「Cloud FTP」頁面。
按一下伺服器名稱。
gcloud
如要取得 SFTP 伺服器的詳細資料,請執行 gcloud alpha storage ftp servers describe 指令。
使用下列任何指令資料之前,請先替換以下項目:
- SERVER_ID:SFTP 伺服器 ID。
- LOCATION_ID:伺服器的位置,例如
us-west1。
執行下列指令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows (PowerShell)
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows (cmd.exe)
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
REST
如要取得 SFTP 伺服器的詳細資料,請使用 servers.get 方法。
使用任何要求資料之前,請先修改下列項目的值:
- PROJECT_ID: Google Cloud 專案 ID。
- LOCATION_ID:伺服器的位置,例如
us-west1。 - SERVER_ID:SFTP 伺服器 ID。
HTTP 方法和網址:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID
請展開以下其中一個選項,以傳送要求:
回應主體是 Server 資源。
用戶端程式庫
C#
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP C# API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Go
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP Go API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Java
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱「Cloud FTP Java API 參考文件」。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
Node.js
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱「Cloud FTP Node.js API 參考文件」。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
PHP
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱「Cloud FTP PHP API 參考文件」。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。
Python
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱 Cloud FTP Python API 參考文件。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證機制」。
Ruby
如要瞭解如何安裝及使用 Cloud FTP 的用戶端程式庫,請參閱「Cloud FTP 用戶端程式庫」。詳情請參閱「Cloud FTP Ruby API 參考文件」。
如要向 Cloud FTP 進行驗證,請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。