이 문서에서는 Cloud FTP 서버에 관한 정보를 가져오는 방법을 보여줍니다. 프로젝트 및 위치의 모든 SFTP 서버를 나열할 수 있습니다. 서버 상태 및 연결 세부정보와 같은 특정 서버에 대한 자세한 정보를 가져올 수도 있습니다.
필요한 역할
SFTP 서버에 관한 정보를 얻는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Cloud FTP 뷰어 (roles/ftp.viewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 SFTP 서버에 대한 정보를 가져오는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
SFTP 서버에 대한 정보를 가져오려면 다음 권한이 필요합니다.
-
서버 나열:
ftp.servers.list -
서버 세부정보를 가져옵니다.
ftp.servers.get
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
서버 나열
콘솔
- Google Cloud 콘솔에서 Cloud FTP 페이지로 이동합니다.
서버 목록이 표시됩니다.
gcloud
SFTP 서버를 나열하려면 gcloud alpha storage ftp servers list 명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
- LOCATION_ID: 서버의 위치입니다(예:
us-west1).
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows(PowerShell)
gcloud alpha storage ftp servers list --location=LOCATION_ID
Windows(cmd.exe)
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
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
응답 본문은 Server 리소스 목록이 있는 JSON 객체입니다.
클라이언트 라이브러리
C#
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP C# API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참고하세요. 자세한 내용은 Cloud FTP Go API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP Java API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP Node.js API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참고하세요. 자세한 내용은 Cloud FTP PHP API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참고하세요. 자세한 내용은 Cloud FTP Python API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP Ruby API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
서버에 대한 세부정보 가져오기
서버의 IP 주소 또는 서비스 연결, 상태, 사용자 인증 정보, 서비스 에이전트 이메일 주소를 포함하여 특정 서버에 대한 자세한 정보를 가져오려면 다음 단계를 따르세요.
콘솔
- Google Cloud 콘솔에서 Cloud FTP 페이지로 이동합니다.
서버 이름을 클릭합니다.
gcloud
SFTP 서버에 대한 세부정보를 가져오려면 gcloud alpha storage ftp servers describe 명령어를 실행합니다.
아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.
- SERVER_ID: SFTP 서버 ID입니다.
- LOCATION_ID: 서버의 위치입니다(예:
us-west1).
다음 명령어를 실행합니다.
Linux, macOS 또는 Cloud Shell
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows(PowerShell)
gcloud alpha storage ftp servers describe SERVER_ID --location=LOCATION_ID
Windows(cmd.exe)
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
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
응답 본문은 Server 리소스입니다.
클라이언트 라이브러리
C#
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP C# API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Go
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참고하세요. 자세한 내용은 Cloud FTP Go API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP Java API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP Node.js API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
PHP
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참고하세요. 자세한 내용은 Cloud FTP PHP API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참고하세요. 자세한 내용은 Cloud FTP Python API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Ruby
Cloud FTP용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Cloud FTP 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Cloud FTP Ruby API 참고 문서를 확인하세요.
Cloud FTP에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.