CreateProfile - AWS Transfer Family
구문 요청요청 파라미터응답 구문Response ElementsErrors예시참고

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

CreateProfile

AS2 전송에 사용할 로컬 또는 파트너 프로파일을 생성합니다.

구문 요청

{
   "As2Id": "string",
   "CertificateIds": [ "string" ],
   "ProfileType": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 내용은 공통 파라미터를 참조하십시오.

요청은 JSON 형식의 다음 데이터를 수락합니다.

As2Id

As2Id 는 RFC4130에 정의된 AS2-name입니다. 인바운드 전송의 경우 파트너에서 보낸 AS2 메시지의 AS2-From 헤더입니다. 아웃바운드 커넥터의 경우 작업을 사용하여 파트너에게 전송되는 AS2 메시지의 AS2-To 헤더입니다StartFileTransferAPI. 이 ID는 공백을 포함할 수 없습니다.

타입: 문자열

길이 제약: 최소 길이는 1. 최대 길이 128.

Pattern: [\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"
}

Response Elements

작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.

다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.

ProfileId

API 호출이 성공한 후 반환되는 AS2 프로필의 고유 식별자입니다.

유형: 문자열

길이 제약 조건: 고정 길이는 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를 반환합니다.

인증서는 import-certificate를 실행할 때 생성IDs되며, 하나는 서명 인증서용이고 다른 하나는 암호화 인증서용입니다.

aws transfer create-profile --as2-id MYCORP --certificate-ids c-abcdefg123456hijk
               c-987654aaaa321bbbb

샘플 응답

API 호출은 새 프로파일의 프로파일 ID를 반환합니다.

{
    "ProfileId": "p-11112222333344444"
}

참고

언어별 중 하나API에서 이 를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.