SFTP 사용자 정보 가져오기

이 문서에서는 Cloud FTP 사용자에 대한 정보를 가져오는 방법을 보여줍니다. 서버의 모든 사용자를 나열할 수 있습니다. 사용자의 Cloud Storage 디렉터리 매핑 및 권한과 같은 특정 사용자에 대한 세부정보를 가져올 수도 있습니다.

필요한 역할

SFTP 사용자에 대한 정보를 가져오는 데 필요한 권한을 얻으려면 관리자에게 프로젝트의 Cloud FTP 뷰어 (roles/ftp.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 SFTP 사용자에 대한 정보를 가져오는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

SFTP 사용자에 대한 정보를 가져오려면 다음 권한이 필요합니다.

  • 사용자 나열: ftp.users.list
  • 사용자 세부정보 가져오기: ftp.users.get

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

사용자 나열

gcloud

서버의 SFTP 사용자를 나열하려면 gcloud alpha storage ftp users list 명령어를 실행합니다.

아래의 명령어 데이터를 사용하기 전에, 다음을 바꿉니다.

  • LOCATION_ID: 서버의 위치(예: us-west1)
  • SERVER_ID: 서버 ID

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

Windows(PowerShell)

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

Windows(cmd.exe)

gcloud alpha storage ftp users list --location=LOCATION_ID --server=SERVER_ID

REST

서버의 SFTP 사용자를 나열하려면 servers.users.list 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트 ID
  • LOCATION_ID: 서버의 위치(예: us-west1)
  • SERVER_ID: 서버 ID

HTTP 메서드 및 URL: 

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

응답 본문은 User 리소스 목록이 있는 JSON 객체입니다.

사용자에 대한 세부정보 가져오기

사용자의 Cloud Storage 디렉터리 매핑 및 권한, 사용자를 대신하여 Cloud Storage 리소스에 액세스하는 서비스 계정의 이메일 주소, 사용자 인증 정보와 같은 특정 사용자에 대한 세부정보를 가져오려면 다음 단계를 따르세요.

gcloud

SFTP 사용자에 대한 세부정보를 가져오려면 gcloud alpha storage ftp users describe 명령어를 실행합니다.

아래의 명령어 데이터를 사용하기 전에, 다음을 바꿉니다.

  • USERNAME: SFTP 사용자의 사용자 이름
  • LOCATION_ID: 서버의 위치(예: us-west1)
  • SERVER_ID: SFTP 서버 ID

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID \
    --server=SERVER_ID

Windows(PowerShell)

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID `
    --server=SERVER_ID

Windows(cmd.exe)

gcloud alpha storage ftp users describe USERNAME --location=LOCATION_ID ^
    --server=SERVER_ID

REST

SFTP 사용자에 대한 세부정보를 가져오려면 servers.users.get 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • PROJECT_ID: Google Cloud 프로젝트 ID
  • LOCATION_ID: 서버의 위치(예: us-west1)
  • SERVER_ID: SFTP 서버 ID
  • USERNAME: SFTP 사용자의 사용자 이름

HTTP 메서드 및 URL: 

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

응답 본문은 User 리소스입니다.