기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ImportHostKey
ServerId 파라미터로 지정된 서버에 호스트 키를 추가합니다.
구문 요청
{
"Description": "string",
"HostKeyBody": "string",
"ServerId": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}요청 파라미터
모든 작업에서 사용하는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- Description
-
이 호스트 키를 식별하는 텍스트 설명.
타입: 문자열
길이 제한: 최소 길이는 0. 최대 길이는 200입니다.
패턴:
[\p{Print}]*Required: No
- HostKeyBody
-
SSH 키 쌍의 프라이빗 키 부분.
AWS Transfer Family RSA, ECDSA 및 ED25519 키를 사용할 수 있습니다.
타입: 문자열
길이 제약: 최소 길이는 0입니다. 최대 길이는 4096입니다.
필수 여부: 예
- ServerId
-
가져오려는 호스트 키가 들어 있는 서버의 식별자.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
s-([0-9a-f]{17})필수 사항 여부: Yes
- Tags
-
그룹화 및 호스트 키 검색에 사용될 수 있는 키-값 쌍입니다.
타입: Tag 객체 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 50개입니다.
필수 여부: 아니요
응답 구문
{
"HostKeyId": "string",
"ServerId": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
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
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
