만들기 Azure Blob 를 사용한 기본 연결 Flow Service API
기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 기본 연결을 만드는 단계를 제공합니다. Azure Blob (이하 "라고 한다) Blob") 사용 Flow Service API.
시작하기
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 를 성공적으로 만들기 위해 알아야 하는 추가 정보를 제공합니다 Blob 를 사용한 소스 연결 Flow Service API.
필요한 자격 증명 수집
주문 Flow Service 을(를) 사용하여 Blob storage에서 다음 연결 속성에 대한 값을 제공해야 합니다.
table 0-row-2 1-row-2 2-row-2 | |
---|---|
자격 증명 | 설명 |
connectionString |
인증에 필요한 인증 정보가 포함된 문자열 Blob Experience Platform. 다음 Blob 연결 문자열 패턴: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY} . 연결 문자열에 대한 자세한 내용은 다음을 참조하십시오 Blob 문서 날짜 연결 문자열 구성. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. 에 대한 연결 사양 ID Blob 은(는) d771e9c1-4f26-40dc-8617-ce58c4b53702 . |
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
자격 증명 | 설명 |
sasUri |
을(를) 연결하는 데 대체 인증 유형으로 사용할 수 있는 공유 액세스 서명 URI Blob 계정입니다. 다음 Blob SAS URI 패턴: https://{ACCOUNT_NAME}.blob.core.windows.net/?sv=<storage version>&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}> 자세한 내용은 다음을 참조하십시오. Blob 문서 날짜 공유 액세스 서명 URI. |
container |
액세스를 지정할 컨테이너의 이름입니다. 을(를) 사용하여 새 계정을 만들 때 Blob 소스 컨테이너 이름을 제공하여 선택한 하위 폴더에 대한 사용자 액세스를 지정할 수 있습니다. |
folderPath |
액세스 권한을 제공할 폴더의 경로입니다. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. 에 대한 연결 사양 ID Blob 은(는) d771e9c1-4f26-40dc-8617-ce58c4b53702 . |
Platform API 사용
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 의 안내서를 참조하십시오. platform API 시작하기.
기본 연결을 만듭니다
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
다음 Blob 소스는 연결 문자열과 SAS(공유 액세스 서명) 인증을 모두 지원합니다. SAS(공유 액세스 서명) URI를 사용하면 사용자에게 보안 위임된 인증을 부여할 수 있습니다. Blob 계정입니다. SAS 기반 인증을 사용하면 권한, 시작 및 만료일을 설정할 수 있을 뿐만 아니라 특정 리소스에 프로비저닝을 할 수 있으므로 SAS를 사용하여 다양한 액세스 수준으로 인증 자격 증명을 만들 수 있습니다.
이 단계에서는 컨테이너 이름과 하위 폴더에 대한 경로를 정의하여 계정이 액세스할 하위 폴더를 지정할 수도 있습니다.
POST 기본 연결 ID를 만들려면 /connections
을(를) 제공하는 동안 엔드포인트 Blob 요청 매개 변수의 일부로 인증 자격 증명을 사용합니다.
API 형식
POST /connections
요청
다음 요청은에 대한 기본 연결을 만듭니다. Blob 연결 문자열 기반 인증 사용:
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 고유 식별자를 포함하여 새로 생성된 기본 연결의 세부 정보를 반환합니다(
|
을(를) 만들려면 Blob POST 공유 액세스 서명 URI를 사용한 연결에서 Flow Service 에 대한 값을 제공하는 동안 API Blob sasUri
.
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
요청 | ||||||||||
|
accordion | ||
---|---|---|
응답 | ||
성공한 응답은 고유 식별자를 포함하여 새로 생성된 기본 연결의 세부 정보를 반환합니다(
|
다음 단계
이 자습서를 따라 Blob api 및 고유 ID를 사용한 연결은 응답 본문의 일부로 가져왔습니다. 이 연결 ID를 사용하여 다음을 수행할 수 있습니다. 흐름 서비스 API를 사용하여 클라우드 저장소 살펴보기.