获取 SFTP 服务器信息

本文档介绍了如何获取 Cloud FTP 服务器的相关信息。您可以列出项目和位置中的所有 SFTP 服务器。您还可以获取有关特定服务器的详细信息，例如服务器的状态及其连接详细信息。

所需的角色

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

此预定义角色包含 获取 SFTP 服务器相关信息所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

获取 SFTP 服务器相关信息需要以下权限：

• 列出服务器： ftp.servers.list
• 获取服务器详细信息： ftp.servers.get

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

列出服务器

gcloud

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

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

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

执行以下命令：

Linux、macOS 或 Cloud Shell

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (PowerShell)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (cmd.exe)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

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

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

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"

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

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

获取服务器的详细信息

如需获取有关特定服务器的详细信息，包括服务器的 IP 地址或服务连接、状态、凭据和服务代理电子邮件地址，请按以下步骤操作。

gcloud

如需获取 SFTP 服务器的详细信息，请运行 gcloud alpha storage ftp servers describe 命令。

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

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

执行以下命令：

Linux、macOS 或 Cloud Shell

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

Windows (PowerShell)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

Windows (cmd.exe)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

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

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

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"

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

响应正文是一个 Server 资源。