Experience Platform API 사용

Experience Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 Experience Platform API 시작에 대한 안내서를 참조하십시오.

기본 연결 만들기

기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 Experience Platform 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.

기본 연결 ID를 만들려면 Oracle Object Storage 인증 자격 증명을 요청 매개 변수의 일부로 제공하는 동안 /connections 끝점에 대한 POST 요청을 만듭니다.

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.idOracle Object Storage 연결 사양 ID: c85f9425-fb21-426c-ad0b-405e9bd8a46c.

응답

성공한 응답은 새로 만든 연결의 연결 ID를 반환합니다. 이 ID는 다음 자습서에서 클라우드 스토리지 데이터를 탐색하는 데 필요합니다.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}

다음 단계

이 자습서에 따라 Flow Service API를 사용하여 Oracle Object Storage 연결을 만들고 고유한 연결 ID를 얻었습니다. 이 연결 ID를 사용하여 흐름 서비스 API를 사용하여 클라우드 저장소 탐색할 수 있습니다.

recommendation-more-help