取得安全檔案傳輸通訊協定伺服器資訊

本文說明如何取得 Cloud FTP 伺服器的相關資訊。您可以列出專案和位置中的所有 SFTP 伺服器。您也可以取得特定伺服器的詳細資訊，例如伺服器狀態和連線詳細資料。

必要的角色

如要取得查看 SFTP 伺服器資訊所需的權限，請要求管理員在專案中授予您「Cloud FTP 檢視者 」(roles/ftp.viewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備取得 SFTP 伺服器相關資訊所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要取得 SFTP 伺服器的相關資訊，必須具備下列權限：

• 列出伺服器： ftp.servers.list
• 取得伺服器詳細資料： ftp.servers.get

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

列出伺服器

控制台

• 前往 Google Cloud 控制台的「Cloud FTP」頁面。

  前往 Cloud FTP

  系統會顯示伺服器清單。

gcloud

如要列出 SFTP 伺服器，請執行 gcloud alpha storage ftp servers list 指令。

使用下方的任何指令資料之前，請先替換以下項目：

• LOCATION_ID：伺服器的位置，例如 us-west1。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請務必執行下列任一指令，透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (PowerShell)

注意： 請務必執行下列任一指令，透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (cmd.exe)

注意： 請務必執行下列任一指令，透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud alpha storage ftp servers list --location=LOCATION_ID

REST

如要列出安全檔案傳輸通訊協定伺服器，請使用 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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers" | Select-Object -Expand Content

回覆主體是 JSON 物件，內含 Server 資源清單。

取得伺服器的詳細資料

如要取得特定伺服器的詳細資訊，包括伺服器的 IP 位址或服務附件、狀態、憑證和服務代理商電子郵件地址，請按照下列步驟操作。

控制台

1. 前往 Google Cloud 控制台的「Cloud FTP」頁面。

   前往 Cloud FTP

2. 按一下伺服器名稱。

gcloud

如要取得 SFTP 伺服器的詳細資料，請執行 gcloud alpha storage ftp servers describe 指令。

使用下方的任何指令資料之前，請先替換以下項目：

• SERVER_ID：安全檔案傳輸通訊協定伺服器 ID。
• LOCATION_ID：伺服器的位置，例如 us-west1。

執行下列指令：

Linux、macOS 或 Cloud Shell

注意： 請務必執行下列任一指令，透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

Windows (PowerShell)

注意： 請務必執行下列任一指令，透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

Windows (cmd.exe)

注意： 請務必執行下列任一指令，透過驗證和專案初始化 Google Cloud CLI： gcloud init； 或 gcloud auth login 和 gcloud config set project。

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：安全檔案傳輸通訊協定伺服器 ID。

HTTP 方法和網址：

GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID" | Select-Object -Expand Content

回應主體是 Server 資源。