설명서Experience Platform소스 커넥터 안내서

API의 소스에 대한 비공개 링크 지원

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자
AVAILABILITY
이 기능은 다음 소스에서 지원됩니다.
비공개 링크 지원은 현재 Adobe Healthcare Shield 또는 Adobe Privacy & Security Shield를 구입한 조직에서만 사용할 수 있습니다.

비공개 링크 기능을 사용하여 연결할 Adobe Experience Platform 소스에 대한 비공개 끝점을 만들 수 있습니다. 비공개 IP 주소를 사용하여 소스를 가상 네트워크에 안전하게 연결하여 공용 IP가 필요하지 않도록 하고 공격 표면을 줄일 수 있습니다. 데이터 트래픽이 승인된 서비스에만 도달하도록 하면서도 복잡한 방화벽 또는 네트워크 주소 변환 구성이 필요하지 않으므로 네트워크 설정을 단순화합니다.

API를 사용하여 개인 엔드포인트를 만들고 사용하는 방법에 대해 알아보려면 이 안내서를 참조하십시오.

recommendation-more-help

개인 링크 지원에 대한 라이선스 사용 권한

소스의 비공개 링크 지원에 대한 라이선스 사용 권한 지표는 다음과 같습니다.

  • 고객은 모든 샌드박스 및 조직에서 지원되는 소스(Azure Blob Storage, ADLS Gen2 및 Azure File Storage)를 통해 연간 최대 2TB의 데이터를 전송할 수 있습니다.
  • 각 조직은 모든 프로덕션 샌드박스에 대해 최대 10개의 끝점을 가질 수 있습니다.
  • 각 조직은 모든 개발 샌드박스에 대해 최대 1개의 끝점을 가질 수 있습니다.
style
shade-box

시작하기

이 안내서를 사용하려면 Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.

  • 소스: Experience Platform을 사용하면 Experience Platform 서비스를 사용하여 들어오는 데이터를 구조화하고 레이블을 지정하고 향상시키는 기능을 제공하는 동시에 다양한 소스에서 데이터를 수집할 수 있습니다.
  • 샌드박스: Experience Platform은 단일 Experience Platform 인스턴스를 별도의 가상 환경으로 분할하여 디지털 경험 애플리케이션을 개발하고 발전시키는 데 도움이 되는 가상 샌드박스를 제공합니다.

Platform API 사용

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

비공개 엔드포인트 만들기 create-private-endpoint

비공개 끝점을 만들려면 /privateEndpoints에 POST 요청을 만듭니다.

API 형식

POST /privateEndpoints

요청

다음 요청은 비공개 끝점을 만듭니다.

요청 예제를 보려면 선택
code language-shell 
curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints/' \
  -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": "ACME Private Endpoint",
      "subscriptionId": "4281a16a-696f-4993-a7d3-a3da32b846f3",
      "resourceGroupName": "acme-sources-experience-platform",
      "resourceName": "acmeexperienceplatform",
      "connectionSpec": {
          "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
          "version": "1.0"
    }
  }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
속성 설명
name 비공개 엔드포인트의 이름.
subscriptionId Azure 구독과 연계된 ID. 자세한 내용은 Azure구독 및 테넌트 ID 검색 Azure Portal에 대한가이드를 참조하십시오.
resourceGroupName Azure에 있는 리소스 그룹의 이름입니다. 리소스 그룹에 Azure 솔루션에 대한 관련 리소스가 포함되어 있습니다. 자세한 내용은 Azure리소스 그룹 관리에 대한안내서를 참조하십시오.
resourceName 리소스의 이름입니다. Azure에서 리소스는 가상 컴퓨터, 웹 앱 및 데이터베이스와 같은 인스턴스를 참조합니다. 자세한 내용은 Azure리소스 관리자 이해에 대한 Azure 안내서를 참조하십시오.
connectionSpec.id 사용 중인 소스의 연결 사양 ID입니다.
connectionSpec.version 사용 중인 연결 사양 ID의 버전입니다.

응답

성공적인 응답은 다음을 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "id": "2c7f6574-299a-4832-aec5-886e875872e2",
  "name": "ACME Private Endpoint",
  "subscriptionId": "4281a16a-696f-4993-a7d3-a3da32b846f3",
  "resourceGroupName": "acme-sources-experience-platform",
  "resourceName": "acmeexperienceplatform",
  "connectionSpec": {
      "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
      "version": "1.0"
  },
  "state": "Pending"
}
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
속성 설명
id 새로 만든 비공개 엔드포인트의 ID입니다.
name 비공개 엔드포인트의 이름.
subscriptionId Azure 구독과 연계된 ID. 자세한 내용은 Azure구독 및 테넌트 ID 검색 Azure Portal에 대한가이드를 참조하십시오.
resourceGroupName Azure에 있는 리소스 그룹의 이름입니다. 리소스 그룹에 Azure 솔루션에 대한 관련 리소스가 포함되어 있습니다. 자세한 내용은 Azure리소스 그룹 관리에 대한안내서를 참조하십시오.
resourceName 리소스의 이름입니다. Azure에서 리소스는 가상 컴퓨터, 웹 앱 및 데이터베이스와 같은 인스턴스를 참조합니다. 자세한 내용은 Azure리소스 관리자 이해에 대한 Azure 안내서를 참조하십시오.
connectionSpec.id 사용 중인 소스의 연결 사양 ID입니다.
connectionSpec.version 사용 중인 연결 사양 ID의 버전입니다.
state

비공개 끝점의 현재 상태입니다. 유효한 상태는 다음과 같습니다.

  • Pending
  • Failed
  • Approved
  • Rejected

비공개 엔드포인트 목록 검색 retrieve-private-endpoints

조직의 지정된 샌드박스에서 개인 끝점 목록을 검색하려면 /privateEndpoints에 GET 요청을 합니다.

API 형식

GET /privateEndpoints

요청

다음 요청은 조직에 있는 모든 비공개 엔드포인트 목록을 검색합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints' \
  -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' \

응답

성공적인 응답은 조직의 비공개 끝점 목록을 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "items": [
       {
      "id": "ac9eb695-0d1a-42d4-bc45-0842aeaa1eff",
      "name": "TEST_E2E_29_Jan",
      "subscriptionId": "4281a16a-696f-4993-a7d3-a3da32b846f3",
      "resourceGroupName": "acme-noid-experience-platform",
      "resourceName": "acmeprivatelinking",
      "fqdns": [

      ],
      "state": "Approved",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      }
    },
          {
      "id": "4c9eb695-0d1a-42d4-bc45-0842aeaa1efr",
      "name": "TEST_E2E_29_Jan",
      "subscriptionId": "5a0ff2f3-53d6-47e4-abb5-10a18bd3fff0",
      "resourceGroupName": "acme-sources-experience-platform",
      "resourceName": "acmeexperienceplatform",
      "fqdns": [

      ],
      "state": "Pending",
      "connectionSpec": {
        "id": "b3ba5556-48be-44b7-8b85-ff2b69b46dc4",
        "version": "1.0"
      }
    }
  ]
}

지정된 소스에 대한 비공개 엔드포인트 목록 검색 retrieve-private-endpoints-by-source

특정 소스에 해당하는 개인 끝점 목록을 검색하려면 /privateEndpoints 끝점에 GET 요청을 하고 소스의 connectionSpec.id을(를) 제공하십시오.

API 형식

GET /privateEndpoints?property=connectionSpec.id=={CONNECTION_SPEC_ID}
쿼리 매개변수
설명
{CONNECTION_SPEC_ID}
전용 끝점을 검색할 소스의 연결 사양 ID입니다.

요청

다음 요청은 연결 사양 ID가 4c10e202-c428-4796-9208-5f1f5732b1cf인 소스에 해당하는 모든 개인 끝점 목록을 검색합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints?property=connectionSpec.id==4c10e202-c428-4796-9208-5f1f5732b1cf' \
  -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' \

응답

성공한 응답은 연결 사양 ID가 4c10e202-c428-4796-9208-5f1f5732b1cf인 소스에 해당하는 모든 개인 끝점 목록을 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "items": [
       {
      "id": "ac9eb695-0d1a-42d4-bc45-0842aeaa1eff",
      "name": "TEST_E2E_29_Jan",
      "subscriptionId": "4281a16a-696f-4993-a7d3-a3da32b846f3",
      "resourceGroupName": "acme-noid-experience-platform",
      "resourceName": "acmeprivatelinkhg",
      "fqdns": [

      ],
      "state": "Approved",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      }
    },
    {
      "id": "4c9eb695-0d1a-42d4-bc45-0842aeaa1efr",
      "name": "TEST_E2E_29_Jan",
      "subscriptionId": "5a0ff2f3-53d6-47e4-abb5-10a18bd3fff0",
      "resourceGroupName": "acme-sources-experience-platform",
      "resourceName": "acmeexperienceplatform",
      "fqdns": [

      ],
      "state": "Pending",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      }
    }
  ]
}

비공개 끝점 검색 retrieve-specific-private-endpoint

특정 개인 끝점을 검색하려면 /privateEndpoints에 GET 요청을 만들고 검색할 개인 끝점의 ID를 제공하십시오.

API 형식

GET /privateEndpoints/{PRIVATE_ENDPOINT_ID}
쿼리 매개변수
설명
{PRIVATE_ENDPOINT_ID}
검색할 개인 엔드포인트의 ID입니다.

요청

다음 요청은 ID가 2c5699b0-b9b6-486f-8877-ee5e21fe9a9d인 개인 끝점을 검색합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints/2c5699b0-b9b6-486f-8877-ee5e21fe9a9d' \
  -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' \

응답

성공적인 응답이 ID가 2c5699b0-b9b6-486f-8877-ee5e21fe9a9d인 개인 끝점을 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "items": [
       {
      "id": "2c5699b0-b9b6-486f-8877-ee5e21fe9a9d",
      "name": "TEST_E2E_29_Jan",
      "subscriptionId": "5a0ff2f3-53d6-47e4-abb5-10a18bd3fff0",
      "resourceGroupName": "acme-noid-experience-platform",
      "resourceName": "acmeprivatelinkhg",
      "fqdns": [

      ],
      "state": "Approved",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      }
    }
  ]
}

비공개 끝점 확인 resolve-private-endpoint

API 형식

GET /privateEndpoints?op=autoResolve

요청

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints?op=autoResolve' \
  -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 '{
      "auth": {
          "specName": "ConnectionString",
          "params": {
              "usePrivateLink": true,
              "connectionString": "{CONNECTION_STRING}"
          }
      },
      "connectionSpec": {
          "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
          "version": "1.0"
      }
  }'

응답

응답 예를 보려면 선택
code language-json 
{
  "items": [
        {
      "id": "4c9eb695-0d1a-42d4-bc45-0842aeaa1efr",
      "name": "TEST_E2E_29_Jan",
      "subscriptionId": "5a0ff2f3-53d6-47e4-abb5-10a18bd3fff0",
      "resourceGroupName": "acme-sources-experience-platform",
      "resourceName": "acmeexperienceplatform",
      "fqdns": [

      ],
      "state": "Pending",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      }
    }
  ]
}

Interactive Authoring 사용 enable-interactive-authoring

IMPORTANT
흐름을 만들거나 업데이트하기 전과 연결을 만들거나 업데이트하거나 탐색하기 전에 Interactive Authoring을(를) 사용하도록 설정해야 합니다.

Interactive Authoring은(는) 연결 또는 계정을 탐색하고 데이터를 미리 보는 것과 같은 기능에 사용됩니다. Interactive Authoring을(를) 사용하려면 /privateEndpoints/interactiveAuthoring에 POST를 요청하고 쿼리 매개 변수에 enable을(를) 연산자로 지정하십시오.

API 형식

POST /privateEndpoints/interactiveAuthoring?op=enable
쿼리 매개변수
설명
op
수행할 작업입니다. Interactive Authoring을(를) 사용하려면 op 값을 enable(으)로 설정하십시오.

요청

다음 요청은 개인 끝점에 대해 Interactive Authoring을(를) 활성화하고 TTL을 60분으로 설정합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints/interactiveAuthoring?op=enable' \
  -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 '{
      "autoTerminationMinutes": 60
  }'
table 0-row-2 1-row-2
속성 설명
autoTerminationMinutes Interactive Authoring TTL(time-to-live)(분)입니다. Interactive Authoring은(는) 연결 또는 계정을 탐색하고 데이터를 미리 보는 것과 같은 기능에 사용됩니다. 최대 TTL은 120분으로 설정할 수 있습니다. 기본 TTL은 60분입니다.

응답

성공적인 응답은 HTTP 상태 202(허용됨)를 반환합니다.

Interactive Authoring 상태 검색 retrieve-interactive-authoring-status

개인 끝점에 대한 Interactive Authoring의 현재 상태를 보려면 /privateEndpoints/interactiveAuthoring에 GET 요청을 하십시오.

API 형식

GET /privateEndpoints/interactiveAuthoring

요청

다음 요청은 Interactive Authoring의 상태를 검색합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints/interactiveAuthoring' \
  -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' \

응답

응답 예를 보려면 선택
code language-json 
{
    "status": "Disabled"
}
table 0-row-2 1-row-2
속성 설명
status Interactive Authoring의 상태입니다. 유효한 값은 disabled, enabling, enabled입니다.

비공개 엔드포인트 삭제 delete-private-endpoint

개인 끝점을 삭제하려면 /privateEndpoints에 DELETE 요청을 하고 삭제할 끝점의 ID를 제공하십시오.

API 형식

DELETE /privateEndpoints/{PRIVATE_ENDPOINT_ID}
쿼리 매개변수
설명
{PRIVATE_ENDPOINT_ID}
삭제하려는 개인 엔드포인트의 ID입니다.

요청

다음 요청은 ID가 02a74b31-a566-4a86-9cea-309b101a7f24인 개인 끝점을 삭제합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X DELETE \
  'https://platform.adobe.io/data/foundation/connectors/privateEndpoints/02a74b31-a566-4a86-9cea-309b101a7f24' \
  -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' \

응답

성공적인 응답은 HTTP 상태 200(성공)을 반환합니다. GET 요청 및 /privateEndpoints을(를) 만들고 삭제된 ID를 쿼리 매개 변수로 제공하여 삭제를 확인할 수 있습니다.

플로우 서비스 flow-service

Flow Service API와 함께 개인 끝점을 사용하는 방법에 대한 자세한 내용은 다음 섹션을 참조하십시오.

개인 끝점으로 연결 만들기 create-base-connection

Experience Platform에서 개인 끝점으로 연결을 만들려면 /connections API의 Flow Service 끝점에 대한 POST 요청을 만듭니다.

API 형식

POST /connections/

요청

다음 요청은 개인 끝점을 사용하면서 Azure Blob Storage에 대해 인증된 기본 연결을 만듭니다.

요청 예제를 보려면 선택
code language-shell 
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": "Azure Blob Storage base connection",
      "description": "A base connection for a Azure Blob Storage source that uses a private link.",
      "auth": {
          "specName": "ConnectionString",
          "params": {
              "connectionString": "{CONNECTION_STRING}",
              "usePrivateLink" : true
          }
      },
      "connectionSpec": {
          "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
          "version": "1.0"
      }
  }'
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
속성 설명
name 기본 연결의 이름입니다.
description (선택 사항) 연결에 대한 추가 정보를 제공하는 설명입니다.
auth.specName 소스를 Experience Platform에 연결하는 데 사용 중인 인증입니다.
auth.params.connectionString Azure Blob Storage 연결 문자열입니다. 자세한 내용은 Azure Blob Storage API 인증 안내서를 참조하십시오.
auth.params.usePrivateLink 개인 끝점을 사용하는지 여부를 결정하는 부울 값입니다. 개인 끝점을 사용하는 경우 이 값을 true(으)로 설정하십시오.
connectionSpec.id 연결 사양 ID Azure Blob Storage입니다.
connectionSpec.version Azure Blob Storage 연결 사양 ID의 버전입니다.

응답

성공적인 응답은 새로 생성된 기본 연결 ID 및 etag를 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "id": "a59d368a-1152-4673-a46e-bd52e8cdb9a9",
  "etag": "\"f50185ed-0000-0200-0000-637e8fad0000\""
}

지정된 비공개 엔드포인트에 연결된 연결 검색 retrieve-connections-by-endpoint

특정 개인 끝점에 연결된 연결을 검색하려면 /connections 끝점에 대한 GET 요청을 만들고 개인 끝점의 ID를 쿼리 매개 변수로 제공하십시오.

API 형식

GET /connections?property=auth.params.privateEndpointId=={PRIVATE_ENDPOINT_ID}
쿼리 매개변수
설명
검색하려는 연결에 연결된 개인 끝점의 ID입니다.

요청

다음 요청은 ID가 02a74b31-a566-4a86-9cea-309b101a7f24인 개인 끝점에 연결된 기존 연결을 검색합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections?property=auth.params.privateEndpointId==02a74b31-a566-4a86-9cea-309b101a7f24' \
  -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' \

응답

성공한 응답은 쿼리된 개인 끝점에 연결된 연결 목록을 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "items": [
    {
      "id": "42a27b1f-8e3f-48ce-8c29-7e474b29a015",
      "createdAt": 1729154379292,
      "updatedAt": 1729154382031,
      "createdBy": "{CREATED_BY}",
      "updatedBy": "{UPDATED_BY}",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_NAME}",
      "name": "acme-e2e",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      },
      "state": "enabled",
      "auth": {
        "specName": "ConnectionString",
        "params": {
          "connectionString": "{CONNECTION_STRING}",
          "usePrivateLink": true,
          "privateEndpointId": "02a74b31-a566-4a86-9cea-309b101a7f24"
        }
      },
      "version": "\"2f01454b-0000-0200-0000-6766749a0000\"",
      "etag": "\"2f01454b-0000-0200-0000-6766749a0000\"",
      "lastOperation": {
        "started": 0,
        "updated": 0,
        "operation": "create"
      }
    },
    {
      "id": "6350311a-664c-4b08-aad4-4065781aac81",
      "createdAt": 1718199941102,
      "updatedAt": 1718199945147,
      "createdBy": "{CREATED_BY}",
      "updatedBy": "{UPDATED_BY}",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_NAME}",
      "name": "acme demo",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      },
      "state": "enabled",
      "auth": {
        "specName": "ConnectionString",
        "params": {
          "connectionString": "{CONNECTION_STRING}",
          "usePrivateLink": true,
          "privateEndpointId": "02a74b31-a566-4a86-9cea-309b101a7f24"
        }
      },
      "version": "\"3001307e-0000-0200-0000-6766cf710000\"",
      "etag": "\"3001307e-0000-0200-0000-6766cf710000\"",
      "lastOperation": {
        "started": 0,
        "updated": 0,
        "operation": "create"
      }
    }
  ],
  "_links": {

  }
}

비공개 엔드포인트와 연계된 연결 검색 retrieve-connections

개인 끝점과 연결된 연결을 검색하려면 /connections 끝점에 GET 요청을 만들고 property=auth.params.usePrivateLink==true을(를) 쿼리 매개 변수로 제공하십시오.

API 형식

GET /connections?property=auth.params.usePrivateLink==true

요청

다음 요청은 비공개 끝점을 사용하는 조직의 모든 연결을 검색합니다.

요청 예제를 보려면 선택
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connections?property=auth.params.usePrivateLink==true' \
  -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' \

응답

성공적인 응답은 개인 끝점에 연결된 모든 연결을 반환합니다.

응답 예를 보려면 선택
code language-json 
{
  "items": [
    {
      "id": "42a27b1f-8e3f-48ce-8c29-7e474b29a015",
      "createdAt": 1729154379292,
      "updatedAt": 1729154382031,
      "createdBy": "{CREATED_BY}",
      "updatedBy": "{UPDATED_BY}",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_NAME}",
      "name": "acme-e2e",
      "connectionSpec": {
        "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
        "version": "1.0"
      },
      "state": "enabled",
      "auth": {
        "specName": "ConnectionString",
        "params": {
          "connectionString": "{CONNECTION_STRING}",
          "usePrivateLink": true,
          "privateEndpointId": "02a74b31-a566-4a86-9cea-309b101a7f24"
        }
      },
      "version": "\"2f01454b-0000-0200-0000-6766749a0000\"",
      "etag": "\"2f01454b-0000-0200-0000-6766749a0000\"",
      "lastOperation": {
        "started": 0,
        "updated": 0,
        "operation": "create"
      }
    },
    {
      "id": "6350311a-664c-4b08-aad4-4065781aac81",
      "createdAt": 1718199941102,
      "updatedAt": 1718199945147,
      "createdBy": "{CREATED_BY}",
      "updatedBy": "{UPDATED_BY}",
      "createdClient": "{CREATED_CLIENT}",
      "updatedClient": "{UPDATED_CLIENT}",
      "sandboxId": "{SANDBOX_ID}",
      "sandboxName": "{SANDBOX_NAME}",
      "imsOrgId": "{ORG_NAME}",
      "name": "acme demo",
      "connectionSpec": {
        "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
        "version": "1.0"
      },
      "state": "enabled",
      "auth": {
        "specName": "ConnectionString",
        "params": {
          "connectionString": "{CONNECTION_STRING}",
          "usePrivateLink": true
        }
      },
      "version": "\"3001307e-0000-0200-0000-6766cf710000\"",
      "etag": "\"3001307e-0000-0200-0000-6766cf710000\"",
      "lastOperation": {
        "started": 0,
        "updated": 0,
        "operation": "create"
      }
    }
  ],
  "_links": {

  }
}

부록

API에서 Azure 개인 링크를 사용하는 방법에 대한 자세한 내용은 이 섹션을 참조하십시오.

Azure Blob 및 Azure Data Lake Gen2에 대한 비공개 끝점 승인

Azure Blob 및 Azure Data Lake Gen2 소스에 대한 비공개 끝점 요청을 승인하려면 Azure Portal에 로그인합니다. 왼쪽 탐색에서 Data storage ​을(를) 선택한 다음 Security + networking 탭으로 이동하여 Networking ​을(를) 선택합니다. Private endpoints ​을(를) 선택하여 계정과 연결된 개인 끝점 목록과 현재 연결 상태를 확인합니다. 보류 중인 요청을 승인하려면 원하는 끝점을 선택하고 Approve ​을(를) 클릭합니다.

보류 중인 개인 끝점 목록이 있는 Azure 포털입니다.

337b99bb-92fb-42ae-b6b7-c7042161d089