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 メソッドと URL:

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 メソッドと URL:

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 サーバーを削除する