本文档介绍了如何获取有关 Cloud FTP 用户的信息。您可以列出服务器的所有用户。您还可以获取有关特定用户的详细信息,例如用户的 Cloud Storage 目录映射和权限。
所需的角色
如需获得获取 SFTP 用户相关信息所需的权限,请让您的管理员为您授予项目的 Cloud FTP Viewer (roles/ftp.viewer) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含获取 SFTP 用户相关信息所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
您需要拥有以下权限才能获取 SFTP 用户的信息:
-
列出用户:
ftp.users.list -
获取用户详细信息:
ftp.users.get -
如果您使用 Google Cloud 控制台执行此任务:
-
ftp.servers.list -
ftp.servers.get
-
列出用户
控制台
- 在 Google Cloud 控制台中,前往 Cloud FTP 页面。
点击服务器 ID。
点击用户列表标签页。
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 资源列表。
客户端库
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 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。
获取用户的详细信息
如需获取有关特定用户的详细信息,例如用户的 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 资源。
客户端库
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 进行身份验证,请设置应用默认凭据。如需了解详情,请参阅为本地开发环境设置身份验证。