获取 SFTP 用户信息

本文档介绍了如何获取有关 Cloud FTP 用户的信息。您可以列出服务器的所有用户。您还可以获取有关特定用户的详细信息，例如用户的 Cloud Storage 目录映射和权限。

所需的角色

如需获得获取 SFTP 用户相关信息所需的权限，请让您的管理员为您授予项目的 Cloud FTP Viewer (roles/ftp.viewer) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供获取 SFTP 用户相关信息所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需获取有关 SFTP 用户的信息，需要以下权限：

  • 列出用户： ftp.users.list
  • 获取用户详细信息： ftp.users.get

您也可以使用自定义角色或其他预定义角色来获取这些权限。

列出用户

gcloud

如需列出服务器的 SFTP 用户，请运行 gcloud alpha storage ftp users list 命令。

在使用下面的命令数据之前，请先进行以下替换：

  • LOCATION_ID：服务器的位置，例如 us-west1。
  • SERVER_ID：服务器 ID。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

Windows (PowerShell)

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

Windows (cmd.exe)

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

REST

如需列出服务器的 SFTP 用户，请使用 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

如需发送您的请求，请展开以下选项之一：

响应正文是一个 JSON 对象，其中包含 User 资源的列表。

获取有关用户的详细信息

如需获取有关特定用户的详细信息，例如用户的 Cloud Storage 目录映射和权限、代表用户访问 Cloud Storage 资源的服务账号的电子邮件地址，以及用户的凭据，请按以下步骤操作。

gcloud

如需获取有关 SFTP 用户的详细信息，请运行 gcloud alpha storage ftp users describe 命令。

在使用下面的命令数据之前，请先进行以下替换：

  • USERNAME：SFTP 用户的用户名。
  • LOCATION_ID：服务器的位置，例如 us-west1。
  • SERVER_ID：SFTP 服务器 ID。

执行以下命令：

Linux、macOS 或 Cloud Shell

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID \
    --server=SERVER_ID

Windows (PowerShell)

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID `
    --server=SERVER_ID

Windows (cmd.exe)

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID ^
    --server=SERVER_ID

REST

如需获取有关 SFTP 用户的详细信息，请使用 servers.users.get 方法。

在使用任何请求数据之前，请先进行以下替换：

  • PROJECT_ID： Google Cloud 项目 ID。
  • LOCATION_ID：服务器的位置，例如 us-west1。
  • SERVER_ID：SFTP 服务器 ID。
  • USERNAME：SFTP 用户的用户名。

HTTP 方法和网址：

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

如需发送您的请求，请展开以下选项之一：

响应正文是一个 User 资源。