Iniciar ou interromper um servidor SFTP

É possível interromper ou iniciar um servidor SFTP para gerenciar o estado dele, controlar o acesso e ajudar a otimizar os custos.

A interrupção de um servidor desativa o acesso e reduz o uso de recursos. Por exemplo, se você suspeitar de acesso não autorizado a um servidor, poderá interromper todas as transferências ativas e bloquear novas conexões. Como outro exemplo, é possível reduzir os custos de tempo de atividade do servidor pausando-o durante períodos em que não há transferências de dados.

Quando você inicia um servidor, o acesso é restaurado e os usuários podem se conectar a ele.

Funções exigidas

Para receber a permissão necessária para iniciar ou interromper um servidor SFTP, peça ao administrador para conceder a você o papel do IAM de Administrador do Cloud FTP (roles/ftp.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a ftp.servers.update permissão, que é necessária para iniciar ou interromper um servidor SFTP.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Interromper um servidor

Quando você interrompe um servidor, as seguintes ações acontecem:

• O acesso é negado e as conexões ativas são descartadas. Os usuários que têm uma conexão ativa podem receber uma mensagem de erro como esta:

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

• Não é possível estabelecer novas conexões.

Para interromper um servidor, siga estas etapas.

REST

Para interromper um servidor, use o servers.stop método.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

• PROJECT_ID: o Google Cloud ID do projeto do servidor.
• LOCATION_ID: o Google Cloud local do servidor, como us-west1.
• SERVER_ID: o ID do servidor.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$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

A resposta identifica uma operação de longa duração.

Iniciar um servidor

REST

Para iniciar um servidor, use o servers.start método.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

• PROJECT_ID: o Google Cloud ID do projeto do servidor.
• LOCATION_ID: o Google Cloud local do servidor, como us-west1.
• SERVER_ID: o ID do servidor.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$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

A resposta identifica uma operação de longa duração. Leva alguns minutos para o servidor iniciar.

A seguir

• Excluir usuários de um servidor SFTP
• Excluir um servidor SFTP