本文档介绍了如何获取有关 Cloud FTP 服务器的信息。您可以列出项目和位置中的所有 SFTP 服务器。您还可以获取有关特定服务器的详细信息,例如服务器的状态及其连接详细信息。
所需角色
如需获得获取有关 SFTP 服务器的信息所需的权限,请让您的管理员向您授予项目的 Cloud FTP Viewer (roles/ftp.viewer) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供 获取有关 SFTP 服务器的信息所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
获取有关 SFTP 服务器的信息需要以下权限:
-
列出服务器:
ftp.servers.list -
获取服务器详细信息:
ftp.servers.get
列出服务器
控制台
- 在 Google Cloud 控制台中,前往 Cloud FTP 页面。
系统会显示服务器列表。
gcloud
如需列出 SFTP 服务器,请运行
gcloud alpha storage ftp servers list 命令。
在使用以下任何命令数据之前, 请先进行以下替换:
- LOCATION_ID:服务器的位置,例如
us-west1。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows (PowerShell)
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows (cmd.exe)
gcloud alpha storage ftp servers list --location=LOCATION_ID
REST
如需列出 SFTP 服务器,请使用
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
如需发送您的请求,请展开以下选项之一:
响应正文是一个 JSON 对象,其中包含
Server 资源列表。
客户端库
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 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置身份验证。
获取有关服务器的详细信息
如需获取有关特定服务器的详细信息,包括服务器的 IP 地址或服务连接、状态、凭据和服务代理电子邮件地址,请按以下步骤操作。
控制台
- 在 Google Cloud 控制台中,前往 Cloud FTP 页面。
点击服务器名称。
gcloud
如需获取有关 SFTP 服务器的详细信息,请运行
gcloud alpha storage ftp servers describe 命令。
在使用以下任何命令数据之前, 请先进行以下替换:
- SERVER_ID:SFTP 服务器 ID。
- LOCATION_ID:服务器的位置,例如
us-west1。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows (PowerShell)
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows (cmd.exe)
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:SFTP 服务器 ID。
HTTP 方法和网址:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID
如需发送您的请求,请展开以下选项之一:
响应正文是一个
Server 资源。
客户端库
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 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅 为本地开发环境设置身份验证。