기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateProfile
AS2 전송에 사용할 로컬 또는 파트너 프로필을 생성합니다.
구문 요청
{
"As2Id": "string
",
"CertificateIds": [ "string
" ],
"ProfileType": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
요청 파라미터
모든 작업에서 사용하는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- As2Id
-
As2Id
은(는) RFC 4130에 정의된 AS2-name입니다. 인바운드 전송의 경우 파트너로부터 전송된 AS2 메시지의 AS2-From
헤더입니다. 아웃바운드 커넥터의 경우StartFileTransfer
API 작업을 사용하여 파트너에게 전송된 AS2 메시지의AS2-To
헤더입니다. 이 ID는 공백을 포함할 수 없습니다.타입: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴:
[\p{Print}\s]*
필수 여부: 예
- CertificateIds
-
가져온 인증서의 식별자 배열입니다. 프로필 및 파트너 프로필 작업에 이 식별자를 사용합니다.
타입: 문자열 배열
길이 제약 조건: 고정 길이는 22입니다.
패턴:
cert-([0-9a-f]{17})
필수 여부: 아니요
- ProfileType
-
생성할 프로필 타입을 결정합니다.
-
로컬 프로필을
LOCAL
생성하도록 지정합니다. 로컬 프로필은 AS2 지원 Transfer Family 서버 조직 또는 당사자를 나타냅니다. -
파트너 프로필을 생성하도록
PARTNER
을 지정하세요. 파트너 프로필은 Transfer Family 외부의 원격 조직을 나타냅니다.
타입: 문자열
유효 값:
LOCAL | PARTNER
필수 여부: 예
-
- Tags
-
AS2 프로필을 그룹화하고 검색하는 데 사용할 수 있는 키-값 쌍입니다.
타입: Tag 객체 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 50개입니다.
필수 여부: 아니요
응답 구문
{
"ProfileId": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- ProfileId
-
AS2 프로필의 고유 식별자로, API 호출 성공 후 반환됩니다.
타입: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
p-([0-9a-f]{17})
Errors
모든 작업에서 발생하는 일반적인 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InternalServiceError
-
이 예외는 AWS Transfer Family 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
AWS Transfer Family 서비스에서 리소스를 찾을 수 없는 경우 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
AWS Transfer Family 서비스를 이용할 수 없어 요청이 실패했습니다.
HTTP 상태 코드: 500
- ThrottlingException
-
요청 제한 때문에 요청이 거부되었습니다.
HTTP 상태 코드: 400
예
예
다음 예에서는 프로필을 생성하고 프로필 ID를 반환합니다.
인증서 ID는 import-certificate
을 실행할 때 생성되는데, 하나는 서명 인증서용이고 다른 하나는 암호화 인증서용입니다.
aws transfer create-profile --as2-id MYCORP --certificate-ids c-abcdefg123456hijk c-987654aaaa321bbbb
샘플 응답
API 호출은 새 프로필의 프로필 ID를 반환합니다.
{ "ProfileId": "p-11112222333344444" }
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.