Puedes actualizar los usuarios que tienen permiso para conectarse a un servidor de Cloud FTP actualizando la configuración de acceso del servidor. También puedes actualizar los metadatos, como el nombre visible del servidor.
No puedes cambiar si un servidor es externo o interno después de que se haya creado.
Roles obligatorios
Para obtener los permisos que
necesitas para actualizar un servidor SFTP,
pídele a tu administrador que te otorgue el rol de IAM de
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 los permisos necesarios para actualizar un servidor SFTP. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para actualizar un servidor SFTP:
-
ftp.servers.update -
Si usas la consola de Google Cloud para realizar esta tarea, sigue estos pasos:
-
ftp.servers.list -
ftp.servers.get
-
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Actualiza el acceso para un servidor externo
Console
- En la consola de Google Cloud , ve a la página Cloud FTP.
Haz clic en el ID del servidor.
En la sección Configuración externa, haz clic en Editar configuración externa.
En el campo Rangos de IP permitidos, especifica las direcciones IP que tienen permiso para acceder al servidor:
Para permitir el acceso a un rango de IP, proporciona un bloque CIDR y, luego, presiona Intro. Por ejemplo,
192.0.2.0/24Para permitir conexiones desde todas las direcciones IP, usa0.0.0.0/0.Para quitar el acceso de un rango de IP, haz clic en Quitar.
Debes proporcionar al menos un valor y puedes proporcionar un máximo de 500 bloques CIDR.
Haz clic en Guardar.
gcloud
Para actualizar la configuración de acceso de un servidor externo, ejecuta el
comando gcloud alpha storage ftp servers update.
Proporciona la marca --allowed-cidr-blocks.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SERVER_ID: Es el ID del servidor.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. - CIDR_BLOCK: Es un bloque CIDR que tiene permiso para acceder al servidor. Por ejemplo,
192.0.2.0/24. Debes proporcionar al menos un valor y puedes proporcionar un máximo de 500 bloques CIDR en una lista separada por comas. Para permitir conexiones desde todas las direcciones IP, usa0.0.0.0/0.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID \ --allowed-cidr-blocks=CIDR_BLOCK
Windows (PowerShell)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ` --allowed-cidr-blocks=CIDR_BLOCK
Windows (cmd.exe)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ^ --allowed-cidr-blocks=CIDR_BLOCK
REST
Para actualizar la configuración de acceso de un servidor externo, usa el
método servers.patch.
En el parámetro de consulta updateMask, proporciona el campo externalConfig.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de Google Cloud del servidor.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. - SERVER_ID: Es el ID del servidor.
- CIDR_BLOCK: Es un bloque CIDR que tiene permiso para acceder al servidor. Por ejemplo,
192.0.2.0/24. Debes proporcionar al menos un valor y puedes proporcionar un máximo de 500 bloques CIDR . Para permitir conexiones desde todas las direcciones IP, usa0.0.0.0/0.
Método HTTP y URL:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=externalConfig
Cuerpo JSON de la solicitud:
{
"externalConfig": {
"allowedCidrBlocks": [
"CIDR_BLOCK"
]
}
}
Para enviar tu solicitud, expande una de estas opciones:
La respuesta identifica una operación de larga duración. El servidor tarda unos segundos en actualizarse.Bibliotecas cliente
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para C#.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Go.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Java.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Node.js.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para PHP.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Python.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Ruby.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Actualiza el acceso para un servidor interno
Console
- En la consola de Google Cloud , ve a la página Cloud FTP.
Haz clic en el ID del servidor.
En la sección Configuración interna, haz clic en Editar configuración interna.
En la sección Proyectos aceptados, especifica los proyectos de consumidor que pueden conectarse al servidor con Private Service Connect:
Para permitir un proyecto, haz lo siguiente:
Haz clic en Agregar proyecto aceptado.
En el campo ID o número del proyecto, ingresa el ID del proyecto o el número de un proyecto que tenga permiso para conectarse. Por ejemplo,
example-allowed-project.En el campo Límite de conexión, ingresa la cantidad máxima de extremos de Private Service Connect que se pueden crear en el proyecto del consumidor. El valor debe ser de 1 a 250 extremos.
Para quitar un proyecto permitido, haz clic en Borrar proyecto aceptado.
(Opcional) En la sección Proyectos rechazados, especifica los proyectos que tienen prohibido conectarse al servidor:
Para prohibir un proyecto, haz clic en Agregar proyecto rechazado. Ingresa el ID del proyecto o el número de un proyecto de consumidor que tiene prohibido conectarse al servidor.
Se rechaza el acceso al servidor de los proyectos de esta lista, incluso si se incluyen en la lista de proyectos permitidos.
Para quitar un proyecto prohibido, haz clic en Borrar proyecto rechazado.
Haz clic en Guardar.
gcloud
Para actualizar la configuración de acceso de un servidor interno, ejecuta el
comando gcloud alpha storage ftp servers update.
Proporciona la marca --consumer-accept-list y, de manera opcional, la marca --consumer-reject-list.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SERVER_ID: Es el ID del servidor.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. -
PROJECT_TO_ALLOW: Es el ID del proyecto o el número de un proyecto de consumidor que tiene permiso para conectarse al servidor con Private Service Connect. Por ejemplo,
example-allowed-project. Debes especificar al menos un proyecto.Puedes permitir un máximo de 500 proyectos. Proporciona varios proyectos y sus respectivos límites de conexión en una lista separada por comas. Por ejemplo,
--consumer-accept-list=projectA=20,projectB=15. - CONNECTION_LIMIT: Es la cantidad máxima de extremos de Private Service Connect que se pueden crear en el proyecto del consumidor. El valor debe ser de 1 a 250 extremos.
-
PROJECT_TO_REJECT (opcional): Es el ID del proyecto o el número de un proyecto de consumidor que tiene prohibido conectarse al servidor. Por ejemplo,
example-rejected-projectSe rechaza el acceso de los proyectos de esta lista al servidor, incluso si se incluyen en la lista de proyectos permitidos.Puedes rechazar un máximo de 64 proyectos. Proporciona varios proyectos en una lista separada por comas.
Si no quieres rechazar de forma explícita ningún proyecto, omite la marca--consumer-reject-list.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID \ --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT \ --consumer-reject-list=PROJECT_TO_REJECT
Windows (PowerShell)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ` --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT ` --consumer-reject-list=PROJECT_TO_REJECT
Windows (cmd.exe)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ^ --consumer-accept-list=PROJECT_TO_ALLOW=CONNECTION_LIMIT ^ --consumer-reject-list=PROJECT_TO_REJECT
REST
Para actualizar la configuración de acceso de un servidor interno, usa el
método servers.patch.
En el parámetro de consulta updateMask, proporciona el campo internalConfig.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de Google Cloud del servidor.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. - SERVER_ID: Es el ID del servidor.
-
PROJECT_TO_ALLOW: Es el ID del proyecto o el número de un proyecto de consumidor que tiene permiso para conectarse al servidor con Private Service Connect. Por ejemplo,
example-allowed-project. Debes especificar al menos un proyecto.Puedes permitir un máximo de 500 proyectos.
- CONNECTION_LIMIT: Es la cantidad máxima de extremos de Private Service Connect que se pueden crear en el proyecto del consumidor. El valor debe ser de 1 a 250 extremos.
-
PROJECT_TO_REJECT (opcional): Es el ID del proyecto o el número de un proyecto de consumidor que tiene prohibido conectarse al servidor. Por ejemplo,
example-rejected-projectSe rechaza el acceso de los proyectos de esta lista al servidor, incluso si se incluyen en la lista de proyectos permitidos.Puedes rechazar un máximo de 64 proyectos.
Si no quieres rechazar de forma explícita ningún proyecto, omite el objeto
consumerRejectList.
Método HTTP y URL:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=internalConfig
Cuerpo JSON de la solicitud:
{
"internalConfig": {
"consumerAcceptList": [
{
"project": "projects/PROJECT_TO_ALLOW",
"connectionLimit": CONNECTION_LIMIT
}
],
"consumerRejectList": [
{
"project": "projects/PROJECT_TO_REJECT"
}
]
}
}
Para enviar tu solicitud, expande una de estas opciones:
La respuesta identifica una operación de larga duración. El servidor tarda unos segundos en actualizarse.Bibliotecas cliente
C#
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para C#.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Go.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Java.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Node.js.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
PHP
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para PHP.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Python.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Cloud FTP, consulta las bibliotecas cliente de Cloud FTP. Para obtener más información, consulta la documentación de referencia de la API de Cloud FTP para Ruby.
Para autenticarte en Cloud FTP, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Actualiza el nombre visible de un servidor
Console
- En la consola de Google Cloud , ve a la página Cloud FTP.
Haz clic en el ID del servidor.
Haz clic en Editar nombre visible.
Ingresa un nombre visible y, luego, haz clic en Guardar.
gcloud
Para actualizar los metadatos, como el nombre visible de un servidor SFTP, ejecuta el
comando gcloud alpha storage ftp servers update.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SERVER_ID: Es el ID del servidor.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. - DISPLAY_NAME: Es un nombre visible para el servidor.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID \ --display-name="DISPLAY_NAME"
Windows (PowerShell)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ` --display-name="DISPLAY_NAME"
Windows (cmd.exe)
gcloud alpha storage ftp servers update SERVER_ID --location=LOCATION_ID ^ --display-name="DISPLAY_NAME"
REST
Para actualizar los metadatos, como el nombre visible de un servidor SFTP, usa el
método servers.patch.
En el parámetro de consulta updateMask, proporciona una lista separada por comas de los campos
que se actualizarán. En el cuerpo de la solicitud, proporciona un objeto JSON con los valores que se establecerán.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Es el ID del proyecto de Google Cloud del servidor.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. - SERVER_ID: Es el ID del servidor.
- FIELDS_TO_UPDATE: Es una lista separada por comas de los campos que se actualizarán, en relación con el
recurso del servidor. Por ejemplo, para actualizar el nombre visible, proporciona el parámetro de consulta
updateMask=displayName. - DISPLAY_NAME: Es un nombre visible para el servidor.
Método HTTP y URL:
PATCH https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID?updateMask=FIELDS_TO_UPDATE
Cuerpo JSON de la solicitud:
{
"displayName": "DISPLAY_NAME"
}
Para enviar tu solicitud, expande una de estas opciones:
La respuesta identifica una operación de larga duración. El servidor tarda unos segundos en actualizarse.