SFTP 사용자 정보 가져오기

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

필요한 역할

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

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

필수 권한

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

• 사용자 목록을 표시합니다. ftp.users.list
• 사용자 세부정보 가져오기: ftp.users.get

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

사용자 나열

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

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

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

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)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

$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

응답 본문은 User 리소스 목록이 포함된 JSON 객체입니다.

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

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

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

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

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

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)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

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

$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

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