启动或停止 SFTP 服务器

您可以停止或启动 SFTP 服务器，以管理其状态、控制访问权限并帮助优化费用。

停止服务器会停用访问权限并减少资源用量。例如，如果您怀疑服务器遭到未经授权的访问，可以通过停止服务器来中止所有正在进行的传输并阻止新的连接。再举一个例子，您可以在预计不会发生数据传输的时段暂停服务器，从而降低服务器正常运行时间费用。

当您启动服务器后，访问权限会恢复，用户可以连接到服务器。

所需的角色

如需获得启动或停止 SFTP 服务器所需的权限，请让管理员为您授予项目的 Cloud FTP Admin (roles/ftp.admin) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含启动或停止 SFTP 服务器所需的 ftp.servers.update 权限。

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

停止服务器

停止服务器时，会发生以下情况：

• 访问遭拒，并且活跃连接被舍弃。已建立有效连接的用户可能会看到类似如下的错误消息：

  Connection is terminated: Connection closed by remote host
  client_loop: send disconnect: Broken pipe
  Connection closed
  

• 无法建立新的连接。

如需停止服务器，请按以下步骤操作。

REST

如需停止服务器，请使用 servers.stop 方法。

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

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

HTTP 方法和网址：

POST https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:stop

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

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:stop"

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 POST `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:stop" | Select-Object -Expand Content

该响应用于标识长时间运行的操作。

启动服务器

REST

如需启动服务器，请使用 servers.start 方法。

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

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

HTTP 方法和网址：

POST https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:start

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

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:start"

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 POST `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID:start" | Select-Object -Expand Content

该响应用于标识长时间运行的操作。服务器需要几分钟时间才能启动。

后续步骤

• 从 SFTP 服务器中删除用户
• 删除 SFTP 服务器