本文档介绍了如何获取有关 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 资源的列表。
客户端库
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 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置身份验证。