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

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

必要的角色

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

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

所需權限

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

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

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

列出伺服器

gcloud

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

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

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

執行下列指令：

Linux、macOS 或 Cloud Shell

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

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (PowerShell)

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

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (cmd.exe)

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

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 位址或服務附件、狀態、憑證和服務代理商電子郵件地址，請按照下列步驟操作。

gcloud

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

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

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

執行下列指令：

Linux、macOS 或 Cloud Shell

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

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

Windows (PowerShell)

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

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 資源。