대상 서버 구성 만들기
대상 서버를 만드는 것은 Destination SDK으로 고유한 대상을 만드는 첫 번째 단계입니다. 대상 서버에는 서버 및 템플릿 사양, 메시지 형식 및 파일 형식 옵션(파일 기반 대상의 경우)에 대한 구성 옵션이 포함되어 있습니다.
이 페이지는 /authoring/destination-servers
API 끝점을 사용하여 고유한 대상 서버를 만드는 데 사용할 수 있는 API 요청 및 페이로드를 예시합니다.
이 끝점을 통해 구성할 수 있는 기능에 대한 자세한 설명은 다음 문서를 참조하십시오.
대상 서버 API 작업 시작 get-started
계속하기 전에 시작 안내서에서 필요한 대상 작성 권한 및 필수 헤더를 얻는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.
대상 서버 구성 만들기 create
/authoring/destination-servers
끝점에 대한 POST
요청을 수행하여 새 대상 서버 구성을 만들 수 있습니다.
platform.adobe.io/data/core/activation/authoring/destination-servers
API 형식
POST /authoring/destination-servers
만드는 대상 유형에 따라 약간 다른 유형의 대상 서버를 구성해야 합니다.
정적 스키마 대상 서버 만들기 static-destination-servers
정적 스키마를 사용하는 대상에 대한 대상 서버의 아래 예제 탭에서 참조하십시오.
아래의 샘플 페이로드에는 각 대상 서버 유형에서 지원하는 모든 매개 변수가 포함되어 있습니다. 요청에 모든 매개 변수를 포함할 필요는 없습니다. 페이로드는 필요에 따라 사용자 정의할 수 있습니다.
아래의 각 탭을 선택하여 해당 API 요청을 확인합니다.
실시간(스트리밍) 대상 서버 만들기
실시간(스트리밍) API 기반 통합을 구성할 때 아래에 표시된 것과 유사한 실시간(스트리밍) 대상 서버를 만들어야 합니다.
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
Amazon S3 대상 서버 만들기
파일 기반 Amazon S3 대상을 구성할 때 아래에 표시된 것과 유사한 Amazon S3 대상 서버를 만들어야 합니다.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
대상 서버 SFTP을(를) 만듭니다
파일 기반 SFTP 대상을 구성할 때 아래에 표시된 것과 유사한 SFTP 대상 서버를 만들어야 합니다.
accordion | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
대상 서버 Azure Data Lake Storage을(를) 만듭니다
파일 기반 Azure Data Lake Storage 대상을 구성할 때 아래에 표시된 것과 유사한 Azure Data Lake Storage 대상 서버를 만들어야 합니다.
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
대상 서버 Azure Blob Storage을(를) 만듭니다
파일 기반 Azure Blob Storage 대상을 구성할 때 아래에 표시된 것과 유사한 Azure Blob Storage 대상 서버를 만들어야 합니다.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
대상 서버 Data Landing Zone (DLZ)을(를) 만듭니다
파일 기반 Data Landing Zone (DLZ) 대상을 구성할 때 아래에 표시된 것과 유사한 Data Landing Zone (DLZ) 대상 서버를 만들어야 합니다.
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
대상 서버 Google Cloud Storage을(를) 만듭니다
파일 기반 Google Cloud Storage 대상을 구성할 때 아래에 표시된 것과 유사한 Google Cloud Storage 대상 서버를 만들어야 합니다.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
동적 스키마 대상 서버 만들기 dynamic-schema-servers
동적 스키마를 사용하면 지원되는 타겟 속성을 동적으로 검색하고 고유한 API를 기반으로 스키마를 생성할 수 있습니다. 스키마를 구성하려면 먼저 동적 스키마에 대한 대상 서버를 구성해야 합니다.
동적 스키마를 사용하는 대상에 대한 대상 서버의 예제 아래 탭에서 참조하십시오.
아래 샘플 페이로드에는 동적 스키마 서버에 필요한 모든 매개 변수가 포함되어 있습니다.
동적 스키마 서버 만들기
고유한 API 끝점에서 프로필 스키마를 검색하는 대상을 구성할 때 아래에 표시된 것과 유사한 동적 스키마 서버를 만들어야 합니다. 정적 스키마와 달리 동적 스키마는 profileFields
배열을 사용하지 않습니다. 대신 동적 스키마는 스키마 구성을 검색하는 위치에서 자체 API에 연결되는 동적 스키마 서버를 사용합니다.
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | |||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
동적 드롭다운 대상 서버 만들기 dynamic-dropdown-servers
동적 드롭다운을(를) 사용하여 고유한 API를 기반으로 드롭다운 고객 데이터 필드를 동적으로 검색하고 채웁니다. 예를 들어 대상 연결에 사용할 기존 사용자 계정 목록을 검색할 수 있습니다.
동적 드롭다운 고객 데이터 필드를 구성하려면 먼저 동적 드롭다운에 대한 대상 서버를 구성해야 합니다.
API에서 드롭다운 선택기에 표시할 값을 동적으로 검색하는 데 사용되는 대상 서버의 예 아래 탭에서 를 참조하십시오.
아래 샘플 페이로드에는 동적 스키마 서버에 필요한 모든 매개 변수가 포함되어 있습니다.
동적 드롭다운 서버 만들기
고유한 API 끝점에서 드롭다운 고객 데이터 필드의 값을 검색하는 대상을 구성할 때 아래에 표시된 것과 유사한 동적 드롭다운 서버를 만들어야 합니다.
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||||||||||||||||||||||||
|
accordion |
---|
응답 |
성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다. |
API 오류 처리 error-handling
Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 플랫폼 문제 해결 안내서에서 API 상태 코드 및 요청 헤더 오류를 참조하십시오.
다음 단계 next-steps
이 문서를 읽은 후에는 Destination SDK /authoring/destination-servers
API 끝점을 통해 새 대상 서버를 만드는 방법을 알 수 있습니다.
이 끝점으로 수행할 수 있는 작업에 대한 자세한 내용은 다음 문서를 참조하십시오.
이 끝점이 대상 작성 프로세스에 맞는 위치를 이해하려면 다음 문서를 참조하십시오.