기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ImportSshPublicKey
(ServerId로 식별되는) 특정 파일 전송 프로토콜 지원 서버에 할당된 UserName 값으로 식별되는 Transfer Family 사용자에게 SSH (Secure Shell) 퍼블릭 키를 추가합니다.
응답은 UserName 값, ServerId 값 및 SshPublicKeyId의 명칭을 반환합니다.
구문 요청
{
"ServerId": "string",
"SshPublicKeyBody": "string",
"UserName": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ServerId
-
서버에 대해 시스템에서 할당한 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
s-([0-9a-f]{17})필수 여부: 예
- SshPublicKeyBody
-
SSH 키 쌍의 퍼블릭 키 부분.
AWS Transfer Family RSA, ECDSA 및 ED25519 키를 사용할 수 있습니다.
타입: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 2048입니다.
필수 여부: 예
- UserName
-
하나 이상의 서버에 할당된 Transfer Family 사용자의 명칭.
타입: 문자열
길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 100입니다.
패턴:
[\w][\w@.-]{2,99}필수 여부: 예
응답 구문
{
"ServerId": "string",
"SshPublicKeyId": "string",
"UserName": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- ServerId
-
서버에 대해 시스템에서 할당한 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
s-([0-9a-f]{17}) - SshPublicKeyId
-
가져온 시스템에서 퍼블릭 키에 부여한 명칭.
타입: 문자열
길이 제약 조건: 고정 길이는 21입니다.
패턴:
key-[0-9a-f]{17} - UserName
-
지정한
ServerID값에 할당된 사용자 이름입니다.타입: 문자열
길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 100입니다.
패턴:
[\w][\w@.-]{2,99}
Errors
모든 작업에 공통되는 오류에 대한 내용은 일반적인 오류 섹션을 참조하십시오.
- InternalServiceError
-
서비스에 오류가 발생하면 이 예외가 발생합니다. AWS Transfer Family
HTTP 상태 코드: 500
- InvalidRequestException
-
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.
HTTP 상태 코드: 400
- ResourceExistsException
-
요청된 리소스가 존재하지 않거나 명령에 지정된 리전이 아닌 다른 리전에 있습니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
AWS Transfer Family 서비스에서 리소스를 찾을 수 없는 경우 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
AWS Transfer Family 서비스를 이용할 수 없어 요청이 실패했습니다.
HTTP 상태 코드: 500
- ThrottlingException
-
요청 제한 때문에 요청이 거부되었습니다.
HTTP 상태 코드: 400
예
예
이 명령은 id_ecdsa.pub 파일에 저장된 ECDSA 키를 가져옵니다.
aws transfer import-ssh-public-key --server-id s-021345abcdef6789 --ssh-public-key-body file://id_ecdsa.pub --user-name jane-doe
예
명령이 제대로 실행되지 않으면, 시스템에서 다음과 비슷한 정보를 반환합니다.
{ "ServerId": "s-021345abcdef6789", "SshPublicKeyId": "key-1234567890abcdef0", "UserName": "jane-doe" }
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
