Receber informações do usuário do SFTP

Este documento mostra como receber informações sobre seus usuários do Cloud FTP. É possível listar todos os usuários de um servidor. Também é possível receber informações detalhadas sobre um usuário específico, como os mapeamentos e as permissões de diretório do Cloud Storage do usuário.

Funções exigidas

Para receber as permissões necessárias para receber informações sobre usuários do SFTP, peça ao administrador para conceder a você opapel 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 usuários do SFTP. Para acessar as permissões exatas 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 usuários do SFTP:

• Listar usuários: ftp.users.list
• Receber detalhes do usuário: ftp.users.get

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

Listar usuários

REST

Para listar usuários do SFTP de um servidor, use o servers.users.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.
• SERVER_ID: o ID do servidor.

Método HTTP e URL:

GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users

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/users"

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/users" | Select-Object -Expand Content

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

Receber detalhes sobre um usuário

Para receber informações detalhadas sobre um usuário específico, como os mapeamentos e as permissões de diretório do Cloud Storage do usuário, o endereço de e-mail da conta de serviço que acessa os recursos do Cloud Storage em nome do usuário e as credenciais do usuário, siga estas etapas.

REST

Para receber detalhes sobre um usuário do SFTP, use o servers.users.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.
• USERNAME: o nome de usuário do SFTP.

Método HTTP e URL:

GET https://ftp.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/servers/SERVER_ID/users/USERNAME

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/users/USERNAME"

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/users/USERNAME" | Select-Object -Expand Content

O corpo da resposta é um User recurso.