Dokumentation Experience Platform Användarhandbok om Source Connectors

Stöd för privata länkar för källor i API

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

Ämnen:

Skapat för:

Utvecklare

AVAILABILITY

Den här funktionen stöds av följande källor:

Stöd för privata länkar är för närvarande endast tillgängligt för organisationer som har köpt Adobe Healthcare Shield eller Adobe Privacy & Security Shield.

Du kan använda funktionen Privat länk för att skapa privata slutpunkter som dina Adobe Experience Platform-källor kan ansluta till. Anslut dina källor till ett virtuellt nätverk med privata IP-adresser på ett säkert sätt, så att du slipper använda offentliga IP-adresser och minskar antalet attacker. Förenkla nätverkskonfigurationen genom att eliminera behovet av komplexa brandväggs- eller nätverksadressöversättningskonfigurationer, samtidigt som datatrafiken endast når ut till godkända tjänster.

Läs den här guiden och lär dig hur du kan använda API:er för att skapa och använda en privat slutpunkt.

recommendation-more-help

Licensanvändningsberättigande för stöd för privata länkar

Giltighetsmåtten för licensanvändning för stöd för privata länkar i källor är följande:

Kunderna har rätt till upp till 2 TB per år dataöverföring via de källor som stöds (Azure Blob Storage, ADLS Gen2 och Azure File Storage), i alla sandlådor och organisationer.
Varje organisation kan ha högst 10 slutpunkter för alla produktionssandlådor.
Varje organisation kan ha högst en slutpunkt för alla utvecklingssandlådor.

style

shade-box

Kom igång

Handboken kräver en fungerande förståelse av följande komponenter i Experience Platform:

Källor: Med Experience Platform kan data hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med hjälp av Experience Platform tjänster.
Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda Experience Platform-instans till separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

Använda plattforms-API:er

Mer information om hur du kan anropa plattforms-API:er finns i guiden Komma igång med plattforms-API:er.

Skapa en privat slutpunkt create-private-endpoint

Skapa en POST-begäran till /privateEndpoints om du vill skapa en privat slutpunkt.

API-format

POST /privateEndpoints

Begäran

I följande begäran skapas en privat slutpunkt:

Välj för att visa begärandeexempel

code language-shell

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" } }'

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
Egenskap	Beskrivning
`name`	Namnet på din privata slutpunkt.
`subscriptionId`	Det ID som är kopplat till din Azure-prenumeration. Mer information finns i guiden Azure om hur du hämtar dina prenumerations- och klient-ID:n från Azure Portal.
`resourceGroupName`	Namnet på resursgruppen på Azure. En resursgrupp innehåller relaterade resurser för en Azure-lösning. Mer information finns i guiden Azure om hantering av resursgrupper.
`resourceName`	Namnet på resursen. I Azure refererar en resurs till instanser som virtuella datorer, webbprogram och databaser. Mer information finns i guiden Azure om att förstå Azure resurshanteraren.
`connectionSpec.id`	Anslutningens spec-ID för källan som du använder.
`connectionSpec.version`	Versionen av det anslutningsspec-ID som du använder.

Svar

Ett lyckat svar returnerar följande:

Välj för att visa svarsexempel

code language-json

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" }`

{
  "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
Egenskap	Beskrivning
`id`	ID:t för den nyligen skapade privata slutpunkten.
`name`	Namnet på din privata slutpunkt.
`subscriptionId`	Det ID som är kopplat till din Azure-prenumeration. Mer information finns i guiden Azure om hur du hämtar dina prenumerations- och klient-ID:n från Azure Portal.
`resourceGroupName`	Namnet på resursgruppen på Azure. En resursgrupp innehåller relaterade resurser för en Azure-lösning. Mer information finns i guiden Azure om hantering av resursgrupper.
`resourceName`	Namnet på resursen. I Azure refererar en resurs till instanser som virtuella datorer, webbprogram och databaser. Mer information finns i guiden Azure om att förstå Azure resurshanteraren.
`connectionSpec.id`	Anslutningens spec-ID för källan som du använder.
`connectionSpec.version`	Versionen av det anslutningsspec-ID som du använder.
`state`	Det aktuella läget för din privata slutpunkt. Giltiga lägen är: `Pending` `Failed` `Approved` `Rejected`

Hämta en lista med privata slutpunkter retrieve-private-endpoints

Om du vill hämta en lista med privata slutpunkter från en viss sandlåda i din organisation, ska du göra en GET-begäran till /privateEndpoints.

API-format

GET /privateEndpoints

Begäran

Följande begäran hämtar en lista över alla privata slutpunkter som finns i organisationen.

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Ett lyckat svar returnerar en lista med privata slutpunkter i organisationen.

Välj för att visa svarsexempel

code language-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" } } ] }

{
  "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"
      }
    }
  ]
}

Hämta en lista med privata slutpunkter för en angiven källa retrieve-private-endpoints-by-source

Om du vill hämta en lista med privata slutpunkter som motsvarar en viss källa, gör du en GET-begäran till /privateEndpoints-slutpunkten och anger connectionSpec.id för källan.

API-format

GET /privateEndpoints?property=connectionSpec.id=={CONNECTION_SPEC_ID}

Frågeparameter

Beskrivning

{CONNECTION_SPEC_ID}

Anslutningens spec-ID för källan som du vill söka efter privata slutpunkter för.

Begäran

Följande begäran hämtar en lista över alla privata slutpunkter som motsvarar källan med anslutningsspecifikation-ID: 4c10e202-c428-4796-9208-5f1f5732b1cf.

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Ett lyckat svar returnerar en lista med alla privata slutpunkter som motsvarar källan med anslutningsspecifikation-ID: 4c10e202-c428-4796-9208-5f1f5732b1cf.

Välj för att visa svarsexempel

code language-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": "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" } } ] }

{
  "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"
      }
    }
  ]
}

Hämta en privat slutpunkt retrieve-specific-private-endpoint

Om du vill hämta en specifik privat slutpunkt gör du en GET-begäran till /privateEndpoints och anger ID:t för den privata slutpunkt som du vill hämta.

API-format

GET /privateEndpoints/{PRIVATE_ENDPOINT_ID}

Frågeparameter

Beskrivning

{PRIVATE_ENDPOINT_ID}

ID för den privata slutpunkt som du vill hämta.

Begäran

Följande begäran hämtar den privata slutpunkten med ID:2c5699b0-b9b6-486f-8877-ee5e21fe9a9d.

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Ett svar returnerar den privata slutpunkten med ID: 2c5699b0-b9b6-486f-8877-ee5e21fe9a9d

Välj för att visa svarsexempel

code language-json

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" } } ] }`

{
  "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"
      }
    }
  ]
}

Lösa en privat slutpunkt resolve-private-endpoint

API-format

GET /privateEndpoints?op=autoResolve

Begäran

Välj för att visa begärandeexempel

code language-shell

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" } }'

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"
      }
  }'

Svar

Välj för att visa svarsexempel

code language-json

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" } } ] }`

{
  "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"
      }
    }
  ]
}

Aktivera Interactive Authoring enable-interactive-authoring

IMPORTANT

Du måste aktivera Interactive Authoring innan du skapar eller uppdaterar ett flöde och innan du skapar, uppdaterar eller utforskar en anslutning.

Interactive Authoring används för funktioner som att utforska en anslutning eller ett konto och förhandsgranska data. Aktivera Interactive Authoring genom att göra en POST-begäran till /privateEndpoints/interactiveAuthoring och ange enable som en operator i frågeparametrarna.

API-format

POST /privateEndpoints/interactiveAuthoring?op=enable

Frågeparameter

Beskrivning

op

Den åtgärd som du vill utföra. Aktivera Interactive Authoring genom att ange värdet op till enable.

Begäran

Följande begäran aktiverar Interactive Authoring för din privata slutpunkt och ställer in TTL på 60 minuter.

Välj för att visa begärandeexempel

code language-shell

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 }'`

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
Egenskap	Beskrivning
`autoTerminationMinutes`	Interactive Authoring TTL (time-to-live) på några minuter. Interactive Authoring används för funktioner som att utforska en anslutning eller ett konto och förhandsgranska data. Du kan ange en maximal TTL på 120 minuter. Standardvärdet för TTL är 60 minuter.

Svar

Ett lyckat svar returnerar HTTP-status 202 (Accepterad).

Hämta Interactive Authoring-status retrieve-interactive-authoring-status

Om du vill visa aktuell status för Interactive Authoring för din privata slutpunkt gör du en GET-begäran till /privateEndpoints/interactiveAuthoring.

API-format

GET /privateEndpoints/interactiveAuthoring

Begäran

Följande begäran hämtar statusen för Interactive Authoring:

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Välj för att visa svarsexempel

code language-json
`{ "status": "Disabled" }`

table 0-row-2 1-row-2
Egenskap	Beskrivning
`status`	Status för Interactive Authoring. Giltiga värden är: `disabled`, `enabling`, `enabled`.

Ta bort privat slutpunkt delete-private-endpoint

Om du vill ta bort din privata slutpunkt gör du en DELETE-förfrågan till /privateEndpoints och anger ID:t för den slutpunkt som du vill ta bort.

API-format

DELETE /privateEndpoints/{PRIVATE_ENDPOINT_ID}

Frågeparameter

Beskrivning

{PRIVATE_ENDPOINT_ID}

ID för den privata slutpunkt som du vill ta bort.

Begäran

Följande begäran tar bort privat slutpunkt med ID: 02a74b31-a566-4a86-9cea-309b101a7f24.

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Ett lyckat svar returnerar HTTP-status 200 (Slutfört). Du kan verifiera borttagningen genom att göra en GET-begäran och till /privateEndpoints och ange det borttagna ID:t som en frågeparameter.

Flödestjänst flow-service

I följande avsnitt finns information om hur du kan använda privata slutpunkter tillsammans med Flow Service API.

Skapa en anslutning med en privat slutpunkt create-base-connection

Om du vill skapa en anslutning med en privat slutpunkt i Experience Platform skapar du en POST-begäran till /connections-slutpunkten i Flow Service API:t.

API-format

POST /connections/

Begäran

Följande begäran skapar en autentiserad basanslutning för Azure Blob Storage, samtidigt som en privat slutpunkt används.

Välj för att visa begärandeexempel

code language-shell

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" } }'

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
Egenskap	Beskrivning
`name`	Namnet på din basanslutning.
`description`	(Valfritt) En beskrivning med ytterligare information om anslutningen.
`auth.specName`	Autentiseringen som används för att ansluta källan till Experience Platform.
`auth.params.connectionString`	Anslutningssträngen Azure Blob Storage. Mer information finns i Azure Blob Storage API-autentiseringsguiden.
`auth.params.usePrivateLink`	Ett booleskt värde som avgör om du använder en privat slutpunkt eller inte. Ange det här värdet till `true` om du använder en privat slutpunkt.
`connectionSpec.id`	Anslutningens spec-ID för Azure Blob Storage.
`connectionSpec.version`	Versionen av ditt Azure Blob Storage-anslutningsspec-ID.

Svar

Ett lyckat svar returnerar ditt nyligen genererade basanslutnings-ID och -tagg.

Välj för att visa svarsexempel

code language-json
`{ "id": "a59d368a-1152-4673-a46e-bd52e8cdb9a9", "etag": "\"f50185ed-0000-0200-0000-637e8fad0000\"" }`

Hämta anslutningar som är kopplade till en angiven privat slutpunkt retrieve-connections-by-endpoint

Om du vill hämta anslutningar som är kopplade till en viss privat slutpunkt gör du en GET-begäran till slutpunkten /connections och anger ID:t för den privata slutpunkten som en frågeparameter.

API-format

GET /connections?property=auth.params.privateEndpointId=={PRIVATE_ENDPOINT_ID}

Frågeparameter

Beskrivning

ID för den privata slutpunkten som är kopplad till de anslutningar som du vill hämta.

Begäran

Följande begäran hämtar befintliga anslutningar som är kopplade till en privat slutpunkt med ID: 02a74b31-a566-4a86-9cea-309b101a7f24.

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Ett lyckat svar returnerar en lista över anslutningar som är kopplade till den efterfrågade privata slutpunkten.

Välj för att visa svarsexempel

code language-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": { } }

{
  "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": {

  }
}

Hämta anslutningar som är associerade med privata slutpunkter retrieve-connections

Om du vill hämta anslutningar som är associerade med en privat slutpunkt, gör du en GET-begäran till slutpunkten /connections och anger property=auth.params.usePrivateLink==true som en frågeparameter.

API-format

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

Begäran

Följande begäran hämtar alla anslutningar i organisationen som använder privata slutpunkter.

Välj för att visa begärandeexempel

code language-shell

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' \`

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' \

Svar

Ett lyckat svar returnerar alla anslutningar som är kopplade till privata slutpunkter.

Välj för att visa svarsexempel

code language-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": { } }

{
  "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": {

  }
}

Bilaga

Läs det här avsnittet om du vill ha mer information om hur du använder Azure privata länkar i API:t.

Godkänn en privat slutpunkt för Azure Blob och Azure Data Lake Gen2

Logga in på Azure Blob om du vill godkänna en privat slutpunktsbegäran för källorna Azure Data Lake Gen2 och Azure Portal. Välj Data storage i den vänstra navigeringen, gå till fliken Security + networking och välj Networking. Välj sedan Private endpoints för att visa en lista över privata slutpunkter som är associerade med ditt konto och deras aktuella anslutningstillstånd. Om du vill godkänna en väntande begäran markerar du önskad slutpunkt och klickar på Approve.

Azure-portalen med en lista över väntande privata slutpunkter.

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