SFTP 서버 정보 가져오기

이 문서에서는 Cloud FTP 서버에 대한 정보를 가져오는 방법을 보여줍니다. 프로젝트 및 위치의 모든 SFTP 서버를 나열할 수 있습니다. 또한 서버의 상태 및 연결 세부정보와 같은 특정 서버에 대한 세부정보를 가져올 수도 있습니다.

필요한 역할

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

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

필수 권한

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

• 서버 나열: ftp.servers.list
• 서버 세부정보 가져오기: ftp.servers.get

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

서버 나열

gcloud

SFTP 서버를 나열하려면 gcloud alpha storage ftp servers list 명령어를 실행합니다.

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

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

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud alpha storage ftp servers list --location=LOCATION_ID

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

gcloud alpha storage ftp servers list --location=LOCATION_ID

REST

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

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

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

HTTP 메서드 및 URL:

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

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

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"

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

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

서버에 대한 세부정보 가져오기

서버의 IP 주소 또는 서비스 연결, 상태, 사용자 인증 정보, 서비스 에이전트 이메일 주소를 비롯한 특정 서버에 대한 세부정보를 가져오려면 다음 단계를 따르세요.

gcloud

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

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

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

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

Linux, macOS 또는 Cloud Shell

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

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

Windows(PowerShell)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

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

Windows(cmd.exe)

참고: gcloud init 또는 gcloud auth login 및 gcloud config set project를 실행하여 Google Cloud CLI를 인증 및 프로젝트와 함께 초기화했는지 확인합니다.

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

REST

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

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

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

HTTP 메서드 및 URL:

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

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

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"

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

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