Acessar informações do servidor SFTP

Este documento mostra como receber informações sobre seus servidores 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 e os detalhes da conexão.

Funções exigidas

Para receber as permissões necessárias para receber informações sobre servidores SFTP, peça ao administrador para conceder a você o Leitor do Cloud FTP (roles/ftp.viewer) papel do IAM 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 que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para receber informações sobre servidores SFTP:

• Listar servidores: ftp.servers.list
• Receber detalhes do servidor: ftp.servers.get

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Listar servidores

gcloud

Para listar servidores SFTP, execute o gcloud alpha storage ftp servers list comando.

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

Observação: Para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init; ou gcloud auth login e gcloud config set project.

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (PowerShell)

Observação: Para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init; ou gcloud auth login e gcloud config set project.

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

gcloud alpha storage ftp servers list --location=LOCATION_ID

REST

Para listar servidores SFTP, use o servers.list método.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

• PROJECT_ID: o Google Cloud ID do projeto.
• 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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte 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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte 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

O corpo da resposta é um objeto JSON com uma lista de Server recursos.

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 estas etapas.

gcloud

Para receber detalhes sobre um servidor SFTP, execute o gcloud alpha storage ftp servers describe comando.

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

Observação: Para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init; ou gcloud auth login e gcloud config set project.

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

Windows (PowerShell)

Observação: Para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init; ou gcloud auth login e gcloud config set project.

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

Windows (cmd.exe)

Observação: para inicializar a Google Cloud CLI com autenticação e um projeto, execute gcloud init. ou gcloud auth login e gcloud config set project.

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

REST

Para receber detalhes sobre um servidor SFTP, use o servers.get método.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

• PROJECT_ID: o Google Cloud ID do projeto.
• 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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte 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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte 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

O corpo da resposta é um Server recurso.