Este documento mostra como obter informações sobre seus servidores do Cloud FTP. É possível listar todos os servidores SFTP em um projeto e local. Também é possível receber informações detalhadas sobre um servidor específico, como o estado do servidor e os detalhes da conexão.
Funções exigidas
Para receber as permissões necessárias para
acessar informações sobre servidores SFTP,
peça ao administrador para conceder a você o
papel do IAM de Leitor do Cloud FTP (roles/ftp.viewer) no seu 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 as permissões necessárias para receber informações sobre servidores SFTP. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para receber informações sobre servidores SFTP:
-
Listar servidores:
ftp.servers.list -
Receba os detalhes do servidor:
ftp.servers.get
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Listar servidores
Console
- No console do Google Cloud , acesse a página Cloud FTP.
Uma lista de servidores será exibida.
gcloud
Para listar servidores SFTP, execute o
comando gcloud alpha storage ftp servers list.
Antes de usar os dados do comando abaixo, faça estas substituições:
- LOCATION_ID: o local do servidor, como
us-west1.
Execute o seguinte comando:
Linux, macOS ou 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 listar servidores SFTP, use o
método servers.list.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto do Google Cloud .
- LOCATION_ID: o local do servidor, como
us-west1.
Método HTTP e URL:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers
Para enviar a solicitação, expanda uma destas opções:
O corpo da resposta é um objeto JSON com uma lista de
recursos Server.
Bibliotecas de cliente
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP C#.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Go.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Java.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Node.js.
Para autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP PHP.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Python.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Ruby.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Receber detalhes sobre um servidor
Para receber informações detalhadas sobre um servidor específico, incluindo o endereço IP ou o anexo de serviço, o estado, as credenciais e o endereço de e-mail do agente de serviço, siga as etapas abaixo.
Console
- No console do Google Cloud , acesse a página Cloud FTP.
Clique no nome do servidor.
gcloud
Para ver detalhes sobre um servidor SFTP, execute o
comando gcloud alpha storage ftp servers describe.
Antes de usar os dados do comando abaixo, faça estas substituições:
- SERVER_ID: o ID do servidor SFTP.
- LOCATION_ID: o local do servidor, como
us-west1.
Execute o seguinte comando:
Linux, macOS ou 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 ver detalhes sobre um servidor SFTP, use o
método servers.get.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto do Google Cloud .
- LOCATION_ID: o local do servidor, como
us-west1. - SERVER_ID: o ID do servidor SFTP.
Método HTTP e URL:
GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID
Para enviar a solicitação, expanda uma destas opções:
O corpo da resposta é um
recurso Server.
Bibliotecas de cliente
C#
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP C#.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Go.
Para autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Java.
Para autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Node.js.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
PHP
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP para PHP.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP Python.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Para saber como instalar e usar a biblioteca de cliente do Cloud FTP, consulte Bibliotecas de cliente do Cloud FTP. Para mais informações, consulte a documentação de referência da API Cloud FTP para Ruby.
Para se autenticar no Cloud FTP, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.