기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ImportSshPublicKey
특정 파일 전송 프로토콜 지원 서버에 할당된 UserName 값으로 식별되고 로 식별되는 Transfer Family 사용자에게 Secure Shell(SSH) 퍼블릭 키를 추가합니다ServerId.
응답은 UserName 값, ServerId 값 및 SshPublicKeyId의 명칭을 반환합니다.
구문 요청
{
"ServerId": "string",
"SshPublicKeyBody": "string",
"UserName": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 수락합니다.
- ServerId
-
서버에 대해 시스템에서 할당한 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
Pattern:
s-([0-9a-f]{17})필수 여부: 예
- SshPublicKeyBody
-
키 페어의 퍼블릭 SSH 키 부분입니다.
AWS Transfer Family 는 RSA, ECDSA및 ED25519 키를 허용합니다.
유형: 문자열
길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 2048입니다.
필수 여부: 예
- UserName
-
하나 이상의 서버에 할당된 Transfer Family 사용자의 명칭.
타입: 문자열
길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 100입니다.
Pattern:
[\w][\w@.-]{2,99}필수 여부: 예
응답 구문
{
"ServerId": "string",
"SshPublicKeyId": "string",
"UserName": "string"
}Response Elements
작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.
다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.
- ServerId
-
서버에 대해 시스템에서 할당한 고유 식별자입니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
s-([0-9a-f]{17}) - SshPublicKeyId
-
가져온 시스템에서 퍼블릭 키에 부여한 명칭.
타입: 문자열
길이 제약 조건: 고정 길이는 21입니다.
패턴:
key-[0-9a-f]{17} - UserName
-
지정한
ServerID값에 할당된 사용자 이름입니다.타입: 문자열
길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 100입니다.
Pattern:
[\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" }
참고
언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.
