기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 다음에 대한 기본 연결을 만드는 단계를 안내합니다 Google Cloud Storage 사용 Flow Service API.
이 안내서에서는 Adobe Experience Platform의 다음 구성 요소를 이해하고 있어야 합니다.
다음 섹션에서는 를 사용하여 Google 클라우드 스토리지 계정에 성공적으로 연결하기 위해 알고 있어야 하는 추가 정보를 제공합니다. Flow Service API.
대상 Flow Service 와 연결 Google Cloud Storage 계정에서는 다음 연결 속성에 대한 값을 제공해야 합니다.
자격 증명 | 설명 |
---|---|
accessKeyId |
인증을 위해 사용되는 61자의 영숫자 문자열입니다 Google Cloud Storage Platform에 계정을 설정합니다. |
secretAccessKey |
인증을 위해 사용되는 40자의 기본-64로 인코딩된 문자열입니다 Google Cloud Storage Platform에 계정을 설정합니다. |
이러한 값에 대한 자세한 내용은 Google 클라우드 스토리지 HMAC 키 안내서. 고유한 액세스 키 ID 및 비밀 액세스 키를 생성하는 방법에 대한 단계는 Google Cloud Storage 개요.
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 플랫폼 API 시작.
기본 연결은 소스의 인증 자격 증명, 현재 연결 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간의 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 해당 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
기본 연결 ID를 만들려면 /connections
제공하는 동안 엔드포인트 Google Cloud Storage 요청 매개 변수의 일부로 인증 자격 증명.
API 형식
POST /connections
요청
다음 요청은에 대한 기본 연결을 만듭니다. Google Cloud Storage:
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Google Cloud Storage connection",
"description": "Connector for Google Cloud Storage",
"auth": {
"specName": "Basic Authentication for google-cloud",
"params": {
"accessKeyId": "accessKeyId",
"secretAccessKey": "secretAccessKey"
}
},
"connectionSpec": {
"id": "32e8f412-cdf7-464c-9885-78184cb113fd",
"version": "1.0"
}
}'
속성 | 설명 |
---|---|
auth.params.accessKeyId |
와 연결된 액세스 키 ID Google Cloud Storage 계정이 필요합니다. |
auth.params.secretAccessKey |
와 연결된 암호 액세스 키 Google Cloud Storage 계정이 필요합니다. |
connectionSpec.id |
다음 Google Cloud Storage 연결 사양 ID: 32e8f412-cdf7-464c-9885-78184cb113fd |
응답
성공적인 응답은 고유 식별자( )를 포함하여 새로 생성된 연결의 세부 정보를 반환합니다id
). 이 ID는 다음 자습서에서 클라우드 스토리지 데이터를 탐색하는 데 필요합니다.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}
이 자습서에 따라 다음을 만들었습니다 Google Cloud Storage api 및 고유 ID를 사용하여 연결을 응답 본문의 일부로 획득했습니다. 이 연결 ID를 사용하여 다음을 수행할 수 있습니다 흐름 서비스 API를 사용하여 클라우드 스토리지 살펴보기.