Obtén información del servidor SFTP

En este documento, se muestra cómo obtener información sobre tus servidores de Cloud FTP. Puedes enumerar todos los servidores SFTP en un proyecto y una ubicación. También puedes obtener información detallada sobre un servidor específico, como el estado del servidor 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:

• Enumerar servidores: ftp.servers.list
• Obtener detalles del servidor: ftp.servers.get

También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.

Enumera servidores

gcloud

Para enumerar los servidores SFTP, ejecuta el gcloud alpha storage ftp servers list comando.

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

• LOCATION_ID: Es la ubicación del servidor, como us-west1.

Ejecuta el siguiente comando:

Linux, macOS o Cloud Shell

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud alpha storage ftp servers list --location=LOCATION_ID

REST

Para enumerar los servidores SFTP, usa el servers.list método.

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

• PROJECT_ID: Es el Google Cloud ID del proyecto de.
• 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:

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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers"

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 GET `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers" | Select-Object -Expand Content

El cuerpo de la respuesta es un objeto JSON con una lista de Server recursos.

Obtén detalles sobre un servidor

Para obtener información detallada sobre un servidor específico, incluida la dirección IP o la conexión de servicio, el estado, las credenciales y la dirección de correo electrónico del agente de servicio, sigue estos pasos.

gcloud

Para obtener detalles sobre un servidor SFTP, ejecuta el gcloud alpha storage ftp servers describe comando.

Antes de usar cualquiera de los datos de comando a continuación, realiza 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

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

Windows (PowerShell)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

Windows (cmd.exe)

Nota: Asegúrate de haber inicializado Google Cloud CLI con autenticación y un proyecto mediante la ejecución de gcloud init o gcloud auth login y gcloud config set project.

gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID

REST

Para obtener detalles sobre un servidor SFTP, usa el servers.get método.

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

• PROJECT_ID: Es el Google Cloud ID del proyecto de.
• 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:

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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID"

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 GET `
    -Headers $headers `
    -Uri "https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID" | Select-Object -Expand Content

El cuerpo de la respuesta es un Server recurso.