En este documento, se muestra cómo obtener información sobre tus servidores de Cloud FTP. Puedes enumerar todos los servidores SFTP de un proyecto y una ubicación. También puedes obtener información detallada sobre un servidor específico, como su estado y sus detalles de conexión.
Roles obligatorios
Para obtener los permisos que necesitas
para obtener información sobre los servidores SFTP,
pídele a tu administrador que te otorgue el
rol de IAM de visualizador de Cloud FTP (roles/ftp.viewer) 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 obtener información sobre los servidores SFTP. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para obtener información sobre los servidores SFTP:
-
Enumera servidores:
ftp.servers.list -
Obtén los detalles del servidor:
ftp.servers.get
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Enumera los servidores
Console
- En la consola de Google Cloud , ve a la página Cloud FTP.
Se mostrará una lista de servidores.
gcloud
Para enumerar los servidores SFTP, ejecuta el comando gcloud alpha storage ftp servers list.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- LOCATION_ID: Es la ubicación del servidor, como
us-west1.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows (PowerShell)
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows (cmd.exe)
gcloud alpha storage ftp servers list --location=LOCATION_ID
REST
Para enumerar los servidores SFTP, usa el
método servers.list.
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 .
- LOCATION_ID: Es la ubicación del servidor, como
us-west1.
Método HTTP y URL:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers
Para enviar tu solicitud, expande una de estas opciones:
El cuerpo de la respuesta es un objeto JSON con una lista de
recursos Server.
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. Si deseas 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. Si deseas 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.
Obtén detalles sobre un servidor
Para obtener información detallada sobre un servidor específico, incluida su dirección IP o su adjunto de servicio, su estado, sus credenciales y la dirección de correo electrónico del agente de servicio, sigue estos pasos.
Console
- En la consola de Google Cloud , ve a la página Cloud FTP.
Haz clic en el nombre del servidor.
gcloud
Para obtener detalles sobre un servidor SFTP, ejecuta el comando gcloud alpha storage ftp servers describe.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
- SERVER_ID: Es el ID del servidor SFTP.
- LOCATION_ID: Es la ubicación del servidor, como
us-west1.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows (PowerShell)
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows (cmd.exe)
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
REST
Para obtener detalles sobre un servidor SFTP, usa el método servers.get.
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 .
- LOCATION_ID: Es la ubicación del servidor, como
us-west1. - SERVER_ID: Es el ID del servidor SFTP.
Método HTTP y URL:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID
Para enviar tu solicitud, expande una de estas opciones:
El cuerpo de la respuesta es un
recurso Server.
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. Si deseas 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. Si deseas 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. Si deseas 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. Si deseas 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.