기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS Transfer Family API 참조
<a name="api-welcome"></a>

Transfer Family에 대한 전체 API 참조 가이드는 [AWS Transfer Family API 참조](https://docs.aws.amazon.com/transfer/latest/APIReference/api-welcome.html)에서 확인할 수 있습니다.

AWS Transfer Family 는 다음 프로토콜을 통해 Amazon Simple Storage Service(Amazon S3) 스토리지 안팎으로 파일을 전송하는 데 사용할 수 있는 보안 전송 서비스입니다.
+ Secure Shell (SSH) File Transfer 프로토콜 (SFTP)
+ File Transfer 프로토콜 보안(FTPS)
+ File Transfer 프로토콜(FTP)
+ 적용성 보고서 2(AS2)

서버, 사용자, 역할은 모두 Amazon 리소스 이름(ARN)으로 식별합니다. ARN을 사용하여 개체에 태그, 키 값 쌍을 할당할 수 있습니다. 태그는 이러한 개체(entity)를 그룹화하고 검색하는 데 사용할 수 있는 메타데이터입니다. 태그를 유용하게 사용할 수 있는 대표적인 분야는 회계입니다.

다음 규칙은 AWS Transfer Family ID 형식으로 관찰됩니다.
+ `s-01234567890abcdef` 양식에서 얻은 `ServerId` 값
+ `key-01234567890abcdef` 양식에서 얻은 `SshPublicKeyId` 값

Amazon 리소스 이름(ARN) 양식은 다음과 같은 형식을 취합니다.
+ 사용자의 경우, ARN은 `arn:aws:transfer:{{region}}:{{account-id}}:server/{{server-id}}` 형식을 취합니다.

  서버 ARN의 예: `arn:aws:transfer:us-east-1:123456789012:server/s-01234567890abcdef`
+ 사용자의 경우, ARN은 `arn:aws:transfer:{{region}}:{{account-id}}:user/{{server-id}}/{{username}}` 형식을 취합니다.

  예를 들면, `arn:aws:transfer:us-east-1:123456789012:user/s-01234567890abcdef/user1`입니다.

사용 중인 DNS 항목(엔드포인트)은 다음과 같습니다.
+ `transfer.{{region}}.amazonaws.com` 형식을 취하는 API 엔드포인트
+ `server.transfer.{{region}}.amazonaws.com` 형식을 취하는 서버 엔드포인트

에 대한이 API 인터페이스 참조에는 관리하는 데 사용할 수 있는 프로그래밍 인터페이스에 대한 설명서가 AWS Transfer Family 포함되어 있습니다 AWS Transfer Family. 참조 구조는 다음과 같습니다.
+ 작업의 영문자순 목록은 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_Operations.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_Operations.html)를 참조하세요.
+ 데이터 형식의 알파벳순 목록은 [https://docs.aws.amazon.com/transfer/latest/APIReference/API_Types.html](https://docs.aws.amazon.com/transfer/latest/APIReference/API_Types.html)을 참조하세요.
+ 공통 쿼리 파라미터 목록은 [공통 파라미터](https://docs.aws.amazon.com/transfer/latest/APIReference/CommonParameters.html)를 참조하세요.
+ 오류 코드에 대한 설명은 [공통 오류](https://docs.aws.amazon.com/transfer/latest/APIReference/CommonErrors.html)를 참조하세요.

**작은 정보**  
명령을 실제로 실행하는 대신 모든 API 직접 호출에 `--generate-cli-skeleton` 파라미터를 사용하여 파라미터 템플릿을 생성하고 표시할 수 있습니다. 그런 다음 생성된 템플릿을 사용하여 사용자 정의하고 이후 명령의 입력으로 사용할 수 있습니다. 자세한 내용은 [파라미터 스켈레톤 파일 생성 및 사용](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-skeleton.html#cli-usage-skeleton-generate)을 참조하세요.