기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 기본 연결을 만드는 단계를 안내합니다. Oracle Object Storage 사용 Flow Service API.
이 안내서를 사용하려면 Adobe Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.
다음 섹션에서는 에 성공적으로 연결하기 위해 알아야 하는 추가 정보를 제공합니다 Oracle Object Storage 사용 Flow Service API.
주문 Flow Service 에 연결하려면 Oracle Object Storage, 다음 연결 속성에 대한 값을 제공해야 합니다.
자격 증명 | 설명 |
---|---|
serviceUrl |
다음 Oracle Object Storage 인증에 필요한 끝점입니다. 끝점 형식은 다음과 같습니다. https://{OBJECT_STORAGE_NAMESPACE}.compat.objectstorage.eu-frankfurt-1.oraclecloud.com |
accessKey |
다음 Oracle Object Storage 인증에 필요한 액세스 키 ID. |
secretKey |
다음 Oracle Object Storage 인증에 필요한 암호입니다. |
bucketName |
사용자의 액세스가 제한된 경우 허용된 버킷 이름이 필요합니다. 버킷 이름은 3자에서 63자 사이여야 하며 문자 또는 숫자로 시작하고 끝나야 하며 소문자, 숫자 또는 하이픈(- ). 버킷 이름의 형식은 IP 주소처럼 지정할 수 없습니다. |
folderPath |
사용자의 액세스가 제한된 경우 허용되는 폴더 경로가 필요합니다. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. 에 대한 연결 사양 ID Oracle Object Storage 은(는) c85f9425-fb21-426c-ad0b-405e9bd8a46c . |
이러한 값을 얻는 방법에 대한 자세한 내용은 Oracle 개체 스토리지 인증 안내서.
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 의 안내서를 참조하십시오. platform API 시작하기.
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
POST 기본 연결 ID를 만들려면 /connections
을(를) 제공하는 동안 엔드포인트 Oracle Object Storage 요청 매개 변수의 일부로 인증 자격 증명을 사용합니다.
API 형식
POST /connections
요청
다음 요청은에 대한 기본 연결을 만듭니다. Oracle Object 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": "Oracle Object Storage connection",
"description": "Oracle Object Storage connection",
"auth": {
"specName": "Access Key",
"params": {
"serviceUrl": "{SERVICE_URL}",
"accessKey": "{ACCESS_KEY}",
"secretKey": "{SECRET_KEY}",
"bucketName": "{BUCKET_NAME}",
"folderPath", "{FOLDER_PATH}"
}
},
"connectionSpec": {
"id": "c85f9425-fb21-426c-ad0b-405e9bd8a46c",
"version": "1.0"
}
}'
속성 | 설명 |
---|---|
auth.params.serviceUrl |
다음 Oracle Object Storage 인증에 필요한 끝점입니다. |
auth.params.accessKey |
다음 Oracle Object Storage 인증에 필요한 액세스 키 ID. |
auth.params.secretKey |
다음 Oracle Object Storage 인증에 필요한 암호입니다. |
auth.params.bucketName |
사용자의 액세스가 제한된 경우 허용된 버킷 이름이 필요합니다. |
auth.params.folderPath |
사용자의 액세스가 제한된 경우 허용되는 폴더 경로가 필요합니다. |
connectionSpec.id |
다음 Oracle Object Storage 연결 사양 ID: c85f9425-fb21-426c-ad0b-405e9bd8a46c . |
응답
성공한 응답은 새로 만든 연결의 연결 ID를 반환합니다. 이 ID는 다음 자습서에서 클라우드 스토리지 데이터를 탐색하는 데 필요합니다.
{
"id": "4cb0c374-d3bb-4557-b139-5712880adc55",
"etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}
이 자습서를 따라 Oracle Object Storage 을 사용한 연결 Flow Service API 및 고유한 연결 ID를 가져왔습니다. 이 연결 ID를 사용하여 다음을 수행할 수 있습니다. 흐름 서비스 API를 사용하여 클라우드 저장소 살펴보기.