啟動或停止 SFTP 伺服器

您可以停止或啟動 SFTP 伺服器，藉此管理伺服器狀態、控管存取權，以及協助最佳化費用。

停止伺服器會停用存取權並減少資源用量。舉例來說，如果懷疑有人未經授權存取伺服器，可以停止伺服器，藉此暫停所有進行中的傳輸作業，並封鎖新的連線。舉例來說，如果預期不會有資料移轉作業，您可以在這段期間暫停伺服器，藉此降低伺服器正常運作時間的成本。

啟動伺服器後，存取權就會恢復，使用者即可連線至伺服器。

必要的角色

如要取得啟動或停止 SFTP 伺服器所需的權限，請要求管理員在專案中授予您「Cloud FTP 管理員 」(roles/ftp.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 ftp.servers.update 權限，可啟動或停止 SFTP 伺服器。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

停止伺服器

停止伺服器時，會發生下列情況：

• 存取遭拒，且有效連線已中斷。如果使用者連線中，可能會看到類似以下的錯誤訊息：

  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 伺服器刪除使用者
• 刪除安全檔案傳輸通訊協定伺服器