取得安全檔案傳輸通訊協定使用者資訊

本文說明如何取得 Cloud FTP 使用者的相關資訊。您可以列出伺服器的所有使用者。您也可以取得特定使用者的詳細資訊，例如使用者的 Cloud Storage 目錄對應和權限。

必要的角色

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

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

所需權限

如要取得 SFTP 使用者資訊，必須具備下列權限：

• 列出使用者： ftp.users.list
• 取得使用者詳細資料： ftp.users.get

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

列出使用者

REST

如要列出伺服器的安全檔案傳輸通訊協定使用者，請使用 servers.users.list 方法。

使用任何要求資料之前，請先修改下列項目的值：

• 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/users

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

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/users"

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/users" | Select-Object -Expand Content

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

取得使用者詳細資料

如要取得特定使用者的詳細資訊，例如使用者的 Cloud Storage 目錄對應和權限、代表使用者存取 Cloud Storage 資源的服務帳戶電子郵件地址，以及使用者的憑證，請按照下列步驟操作。

REST

如要取得 SFTP 使用者的詳細資料，請使用 servers.users.get 方法。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID： Google Cloud 專案 ID。
• LOCATION_ID：伺服器的位置，例如 us-west1。
• SERVER_ID：安全檔案傳輸通訊協定伺服器 ID。
• USERNAME：SFTP 使用者的使用者名稱。

HTTP 方法和網址：

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

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

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/users/USERNAME"

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/users/USERNAME" | Select-Object -Expand Content

回應主體是 User 資源。