Cómo iniciar o detener un servidor SFTP

Puedes detener o iniciar un servidor SFTP para administrar su estado, controlar el acceso y ayudar a optimizar los costos.

Detener un servidor inhabilita el acceso y reduce el uso de recursos. Por ejemplo, si sospechas que hay un acceso no autorizado a un servidor, puedes detener todas las transferencias activas y bloquear las conexiones nuevas deteniendo el servidor. Como otro ejemplo, puedes reducir los costos de tiempo de actividad del servidor deteniéndolo durante los períodos en los que no se esperan transferencias de datos.

Cuando inicias un servidor, se restablece el acceso y los usuarios pueden conectarse a él.

Roles obligatorios

Para obtener el permiso que necesitas para iniciar o detener un servidor SFTP, pídele a tu administrador que te otorgue el rol de IAM Administrador de Cloud FTP (roles/ftp.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el ftp.servers.update permiso, que se requiere para iniciar o detener un servidor SFTP.

También puedes obtener este permiso con roles personalizados o otros roles predefinidos.

Detén un servidor

Cuando detienes un servidor, sucede lo siguiente:

• Se deniega el acceso y se descartan las conexiones activas. Es posible que los usuarios que tengan una conexión activa vean un mensaje de error como el siguiente:

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

• No se pueden establecer conexiones nuevas.

Para detener un servidor, sigue estos pasos.

REST

Para detener un servidor, usa el servers.stop método.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el Google Cloud ID del proyecto del servidor.
• LOCATION_ID: la Google Cloud ubicación de el servidor, como us-west1.
• SERVER_ID: el ID del servidor.

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

La respuesta identifica una operación de larga duración.

Inicia un servidor

REST

Para iniciar un servidor, usa el servers.start método.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: el Google Cloud ID del proyecto del servidor.
• LOCATION_ID: la Google Cloud ubicación de el servidor, como us-west1.
• SERVER_ID: el ID del servidor.

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

La respuesta identifica una operación de larga duración. El servidor tarda unos minutos en iniciarse.

¿Qué sigue?

• Borra usuarios de un servidor SFTP
• Borra un servidor SFTP