API를 사용하여 Azure Blob Storage을(를) Experience Platform에 연결
Azure Blobg StorageAPIFlow Service 를 사용하여계정을 Adobe Experience Platform에 연결하는 방법을 알아보려면 이 안내서를 참조하십시오.
시작
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
Experience Platform API 사용
Experience Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 Experience Platform API 시작에 대한 안내서를 참조하십시오.
필요한 자격 증명 수집
인증에 대한 자세한 내용은 Azure Blob Storage 개요를 읽어 보십시오.
Azure Blob Storage 계정을 Experience Platform에 연결 connect
Azure Blob Storage 계정을 Experience Platform에 연결하는 방법에 대한 자세한 내용은 아래 단계를 참조하세요.
기본 연결 만들기
기본 연결은 소스를 Experience Platform에 연결하여 인증 세부 정보, 연결 상태 및 고유 ID를 저장합니다. 이 ID를 사용하여 소스 파일을 검색하고 데이터 유형 및 형식을 포함하여 수집할 특정 항목을 식별합니다.
다음 인증 유형을 사용하여 Azure Blob Storage 계정을 Experience Platform에 연결할 수 있습니다.
- 계정 키 인증: 저장소 계정의 액세스 키를 사용하여 인증하고 Azure Blob Storage 계정에 연결합니다.
- SAS(공유 액세스 서명): SAS URI를 사용하여 Azure Blob Storage 계정의 리소스에 위임되고 제한된 시간 제한 액세스를 제공합니다.
- 서비스 사용자 기반 인증: Azure Active Directory(AAD) 서비스 사용자(클라이언트 ID 및 암호)를 사용하여 Azure Blob 저장소 계정을 안전하게 인증합니다.
API 형식
POST /connections
기본 연결 ID를 만들려면 /connections
끝점에 POST를 요청하고 인증 자격 증명을 요청 매개 변수의 일부로 제공합니다.
계정 키 인증을 사용하려면 connectionString
, container
및 folderPath
에 대한 값을 제공하십시오.
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
매개변수 | 설명 |
connectionString |
Azure Blob Storage 계정에 대한 연결 문자열입니다. 연결 문자열 패턴은 DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY};EndpointSuffix=core.windows.net 입니다. |
container |
데이터 파일이 저장된 Azure Blob Storage 컨테이너의 이름입니다. |
folderPath |
파일이 있는 지정된 컨테이너 내의 경로입니다. |
connectionSpec.id |
Azure Blob Storage 소스의 연결 사양 ID입니다. 이 ID는 4c10e202-c428-4796-9208-5f1f5732b1cf (으)로 수정되었습니다. |
공유 액세스 서명을 사용하려면 sasUri
, container
및 folderPath
에 대한 값을 제공하십시오.
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
매개변수 | 설명 |
sasUri |
계정을 연결하는 데 대체 인증 유형으로 사용할 수 있는 공유 액세스 서명 URI입니다. 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} . |
container |
데이터 파일이 저장된 Azure Blob Storage 컨테이너의 이름입니다. |
folderPath |
파일이 있는 지정된 컨테이너 내의 경로입니다. |
connectionSpec.id |
Azure Blob Storage 소스의 연결 사양 ID입니다. 이 ID는 4c10e202-c428-4796-9208-5f1f5732b1cf (으)로 수정되었습니다. |
서비스 사용자 기반 인증을 통해 연결하려면 serviceEndpoint
, servicePrincipalId
, servicePrincipalKey
, accountKind
, tenant
, container
및 folderPath
에 대한 값을 제공하십시오.
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
---|---|
매개변수 | 설명 |
serviceEndpoint |
Azure Blob Storage 계정의 끝점 URL입니다. 일반적으로 형식은 https://{ACCOUNT_NAME}.blob.core.windows.net 입니다. |
servicePrincipalId |
인증에 사용되는 Azure Active Directory(AAD) 서비스 사용자의 클라이언트/응용 프로그램 ID입니다. |
servicePrincipalKey |
Azure 서비스 주체와 연결된 클라이언트 암호 또는 암호입니다. |
accountKind |
Azure Blob Storage 계정의 형식입니다. 일반적인 값에는 Storage (일반 목적 V1), StorageV2 (일반 목적 V2), BlobStorage 및 BlockBlobStorage 이(가) 포함됩니다. |
tenant |
서비스 주체가 등록된 Azure Active Directory(AAD) 테넌트 ID입니다. |
container |
데이터 파일이 저장된 Azure Blob Storage 컨테이너의 이름입니다. |
folderPath |
파일이 있는 지정된 컨테이너 내의 경로입니다. |
connectionSpec.id |
Azure Blob Storage 소스의 연결 사양 ID입니다. 이 ID는 4c10e202-c428-4796-9208-5f1f5732b1cf (으)로 수정되었습니다. |
성공한 응답은 고유 식별자(id
)를 포함하여 새로 만든 기본 연결의 세부 정보를 반환합니다. 다음 단계에서 소스 연결을 만들려면 이 ID가 필요합니다.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}
다음 단계
이 자습서에 따라 API를 사용하여 Blob 연결을 만들었고 고유 ID를 응답 본문의 일부로 가져왔습니다. 이 연결 ID를 사용하여 흐름 서비스 API를 사용하여 클라우드 저장소 탐색할 수 있습니다.