Ottenere le informazioni dell'utente SFTP

Questo documento mostra come ottenere informazioni sugli utenti Cloud FTP. Puoi elencare tutti gli utenti di un server. Puoi anche ottenere informazioni dettagliate su un utente specifico, ad esempio i mapping e le autorizzazioni della directory Cloud Storage dell'utente.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per ottenere informazioni sugli utenti SFTP, chiedi all'amministratore di concederti il ruolo IAM Cloud FTP Viewer (roles/ftp.viewer) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per ottenere informazioni sugli utenti SFTP. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per ottenere informazioni sugli utenti SFTP sono necessarie le seguenti autorizzazioni:

• Elenca utenti: ftp.users.list
• Visualizza i dettagli dell'utente: ftp.users.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Elenca utenti

REST

Per elencare gli utenti SFTP per un server, utilizza il metodo servers.users.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: l'ID progetto Google Cloud .
• LOCATION_ID: la posizione del server, ad esempio us-west1.
• SERVER_ID: l'ID server.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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

Il corpo della risposta è un oggetto JSON con un elenco di risorse User.

Visualizzare i dettagli di un utente

Per ottenere informazioni dettagliate su un utente specifico, ad esempio i mapping e le autorizzazioni della directory Cloud Storage, l'indirizzo email dell'account di servizio che accede alle risorse Cloud Storage per conto dell'utente e le credenziali dell'utente, segui questi passaggi.

REST

Per ottenere i dettagli di un utente SFTP, utilizza il metodo servers.users.get.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: l'ID progetto Google Cloud .
• LOCATION_ID: la posizione del server, ad esempio us-west1.
• SERVER_ID: l'ID del server SFTP.
• USERNAME: il nome utente dell'utente SFTP.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo 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

Il corpo della risposta è una risorsa User.