DocumentatieExperience PlatformGids voor Source Connectors

Ondersteuning voor persoonlijke koppelingen voor bronnen in de API

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

Gemaakt voor:

  • Ontwikkelaar
AVAILABILITY
Deze functie wordt ondersteund door de volgende bronnen:
Ondersteuning voor privé-koppelingen is momenteel alleen beschikbaar voor organisaties die Adobe Healthcare Shield of Adobe Privacy & Security Shield hebben aangeschaft.

Met de functie Private Link kunt u persoonlijke eindpunten maken waarmee uw Adobe Experience Platform-bronnen verbinding kunnen maken. Sluit veilig uw bronnen aan een virtueel netwerk aan gebruikend privé IP adressen, die de behoefte aan openbare IPs elimineren en uw aanvalsoppervlakte verminderen. Vereenvoudig uw netwerkopstelling door de behoefte aan complexe firewall of de configuraties van de Vertaling van het Adres van het Netwerk te verwijderen, terwijl het verzekeren van gegevensverkeer slechts de goedgekeurde diensten bereikt.

Lees deze gids om te leren hoe u APIs kunt gebruiken om een privé eindpunt tot stand te brengen en te gebruiken.

recommendation-more-help

Licentiegebruiksrechten voor ondersteuning van persoonlijke koppelingen

De machtigingsgegevens voor het gebruik van licenties voor ondersteuning van persoonlijke koppelingen in bronnen zijn als volgt:

  • Klanten hebben recht op maximaal 2 TB per jaar gegevensoverdracht via ondersteunde bronnen (Azure Blob Storage , ADLS Gen2 en Azure File Storage ) voor alle sandboxen en organisaties.
  • Elke organisatie kan een maximum van 10 eindpunten voor alle productie zandbakken hebben.
  • Elke organisatie kan een maximum van 1 eindpunt voor alle ontwikkelingszandbakken hebben.
style
shade-box

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Experience Platform:

  • Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend de diensten van Experience Platform.
  • Sandboxes: Experience Platform verstrekt virtuele zandbakken die één enkele instantie van Experience Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

Platform-API's gebruiken

Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op begonnen wordt met Platform APIs.

Een privé-eindpunt maken create-private-endpoint

Maak een POST-verzoek aan /privateEndpoints om een privé-eindpunt te maken.

API formaat

POST /privateEndpoints

Verzoek

Het volgende verzoek leidt tot een privé eindpunt:

Selecteren om aanvraagvoorbeeld weer te geven
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
Eigenschap Beschrijving
name De naam van uw privé eindpunt.
subscriptionId De id die is gekoppeld aan uw Azure -abonnement. Voor meer informatie, lees de Azure gids op het terugwinnen van uw abonnement en huurder IDs van Azure Portal.
resourceGroupName De naam van de bronnengroep op Azure . Een resourcegroep bevat gerelateerde bronnen voor een Azure -oplossing. Voor meer informatie, lees de Azure gids over het leiden middelgroepen.
resourceName De naam van uw bron. In Azure verwijst een bron naar instanties zoals virtuele machines, webapps en databases. Voor meer informatie, lees de Azure gids op die de Azure middelmanagerbegrijpt.
connectionSpec.id De verbindingsspecificatie-id van de bron die u gebruikt.
connectionSpec.version De versie van de verbindingsspecificatie-id die u gebruikt.

Reactie

Een geslaagde reactie retourneert het volgende:

Selecteren om reactievoorbeeld weer te geven
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
Eigenschap Beschrijving
id Identiteitskaart van uw onlangs gecreeerd privé eindpunt.
name De naam van uw privé eindpunt.
subscriptionId De id die is gekoppeld aan uw Azure -abonnement. Voor meer informatie, lees de Azure gids op het terugwinnen van uw abonnement en huurder IDs van Azure Portal.
resourceGroupName De naam van de bronnengroep op Azure . Een resourcegroep bevat gerelateerde bronnen voor een Azure -oplossing. Voor meer informatie, lees de Azure gids over het leiden middelgroepen.
resourceName De naam van uw bron. In Azure verwijst een bron naar instanties zoals virtuele machines, webapps en databases. Voor meer informatie, lees de Azure gids op die de Azure middelmanagerbegrijpt.
connectionSpec.id De verbindingsspecificatie-id van de bron die u gebruikt.
connectionSpec.version De versie van de verbindingsspecificatie-id die u gebruikt.
state

De huidige staat van uw privé eindpunt. Geldige statussen zijn:

  • Pending
  • Failed
  • Approved
  • Rejected

Een lijst met persoonlijke eindpunten ophalen retrieve-private-endpoints

Als u een lijst met persoonlijke eindpunten van een bepaalde sandbox in uw organisatie wilt ophalen, vraagt u GET om /privateEndpoints .

API formaat

GET /privateEndpoints

Verzoek

Het volgende verzoek wint een lijst van alle privé eindpunten terug die in uw organisatie bestaan.

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Een succesvolle reactie keert een lijst van privé eindpunten in uw organisatie terug.

Selecteren om reactievoorbeeld weer te geven
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"
      }
    }
  ]
}

Hiermee wordt een lijst met persoonlijke eindpunten voor een bepaalde bron opgehaald retrieve-private-endpoints-by-source

Als u een lijst wilt ophalen met persoonlijke eindpunten die overeenkomen met een specifieke bron, vraagt u GET het /privateEndpoints -eindpunt aan en geeft u de connectionSpec.id -bron op.

API formaat

GET /privateEndpoints?property=connectionSpec.id=={CONNECTION_SPEC_ID}
Query-parameter
Beschrijving
{CONNECTION_SPEC_ID}
De verbindingsspecificatie-id van de bron waarnaar u persoonlijke eindpunten wilt zoeken.

Verzoek

Met het volgende verzoek wordt een lijst opgehaald van alle persoonlijke eindpunten die overeenkomen met de bron met de verbindingsspecificatie-id: 4c10e202-c428-4796-9208-5f1f5732b1cf .

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Een succesvol antwoord retourneert een lijst met alle persoonlijke eindpunten die overeenkomen met de bron met de verbindingsspecificatie-id: 4c10e202-c428-4796-9208-5f1f5732b1cf .

Selecteren om reactievoorbeeld weer te geven
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"
      }
    }
  ]
}

Een privé eindpunt ophalen retrieve-specific-private-endpoint

Om een specifiek privé eindpunt terug te winnen, doe een verzoek van GET aan /privateEndpoints en verstrek identiteitskaart van het privé eindpunt dat u wilt terugwinnen.

API formaat

GET /privateEndpoints/{PRIVATE_ENDPOINT_ID}
Query-parameter
Beschrijving
{PRIVATE_ENDPOINT_ID}
Identiteitskaart van het privé eindpunt dat u wilt terugwinnen.

Verzoek

Het volgende verzoek wint het privé eindpunt met identiteitskaart terug:2c5699b0-b9b6-486f-8877-ee5e21fe9a9d.

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Een geslaagde reactie retourneert het persoonlijke eindpunt met de id: 2c5699b0-b9b6-486f-8877-ee5e21fe9a9d

Selecteren om reactievoorbeeld weer te geven
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"
      }
    }
  ]
}

Een privéeindpunt oplossen resolve-private-endpoint

API formaat

GET /privateEndpoints?op=autoResolve

Verzoek

Selecteren om aanvraagvoorbeeld weer te geven
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"
      }
  }'

Reactie

Selecteren om reactievoorbeeld weer te geven
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 inschakelen enable-interactive-authoring

IMPORTANT
U moet Interactive Authoring inschakelen voordat u een flow maakt of bijwerkt en voordat u een verbinding maakt, bijwerkt of verkent.

Interactive Authoring wordt gebruikt voor functies zoals het verkennen van een verbinding of account en het voorvertonen van gegevens. Als u Interactive Authoring wilt inschakelen, moet u een POST-aanvraag indienen bij /privateEndpoints/interactiveAuthoring en enable opgeven als een operator in de queryparameters.

API formaat

POST /privateEndpoints/interactiveAuthoring?op=enable
Query-parameter
Beschrijving
op
De bewerking die u wilt uitvoeren. Als u Interactive Authoring wilt inschakelen, stelt u de op waarde in op enable .

Verzoek

Het volgende verzoek laat Interactive Authoring voor uw privé eindpunt toe en plaatst TTL aan 60 minuten.

Selecteren om aanvraagvoorbeeld weer te geven
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
Eigenschap Beschrijving
autoTerminationMinutes De Interactive Authoring TTL (time-to-live) in minuten. Interactive Authoring wordt gebruikt voor functies zoals het verkennen van een verbinding of account en het voorvertonen van gegevens. U kunt een maximum TTL van 120 minuten plaatsen. De standaard TTL is 60 minuten.

Reactie

Een geslaagde reactie retourneert HTTP-status 202 (geaccepteerd).

Interactive Authoring status ophalen retrieve-interactive-authoring-status

Als u de huidige status van Interactive Authoring voor uw persoonlijke eindpunt wilt weergeven, vraagt u GET om /privateEndpoints/interactiveAuthoring .

API formaat

GET /privateEndpoints/interactiveAuthoring

Verzoek

Met de volgende aanvraag wordt de status van Interactive Authoring opgehaald:

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Selecteren om reactievoorbeeld weer te geven
code language-json 
{
    "status": "Disabled"
}
table 0-row-2 1-row-2
Eigenschap Beschrijving
status De status van Interactive Authoring . Geldige waarden zijn: disabled , enabling , enabled .

Persoonlijk eindpunt verwijderen delete-private-endpoint

Om uw privé eindpunt te schrappen, doe een DELETE verzoek aan /privateEndpoints en verstrek identiteitskaart van het eindpunt dat u wilt schrappen.

API formaat

DELETE /privateEndpoints/{PRIVATE_ENDPOINT_ID}
Query-parameter
Beschrijving
{PRIVATE_ENDPOINT_ID}
Identiteitskaart van het privé eindpunt dat u wilt schrappen.

Verzoek

Het volgende verzoek verwijdert het persoonlijke eindpunt met de id: 02a74b31-a566-4a86-9cea-309b101a7f24 .

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Een geslaagde reactie retourneert HTTP-status 200 (Voltooid). U kunt de verwijdering controleren door een GET-aanvraag in te dienen en aan /privateEndpoints een verwijderde id op te geven als een queryparameter.

Flow Service flow-service

Lees de volgende secties voor informatie over hoe u privé eindpunten samen met Flow Service APIkunt gebruiken.

Verbinding maken met een privé-eindpunt create-base-connection

Als u een verbinding wilt maken met een privéeindpunt in Experience Platform, vraagt u een POST-aanvraag naar het /connections -eindpunt van de Flow Service API.

API formaat

POST /connections/

Verzoek

Het volgende verzoek leidt tot een voor authentiek verklaarde basisverbinding voor Azure Blob Storage, terwijl ook het gebruiken van een privé eindpunt.

Selecteren om aanvraagvoorbeeld weer te geven
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
Eigenschap Beschrijving
name De naam van uw basisverbinding.
description (Optioneel) Een beschrijving met aanvullende informatie over de verbinding.
auth.specName De verificatie die wordt gebruikt om uw bron te verbinden met Experience Platform.
auth.params.connectionString De Azure Blob Storage verbindingstekenreeks. Voor meer informatie, lees de Azure Blob Storage API authentificatiegids.
auth.params.usePrivateLink Een booleaanse waarde die bepaalt of u een privé eindpunt gebruikt of niet. Stel deze waarde in op true als u een privé-eindpunt gebruikt.
connectionSpec.id De verbindingsspecificatie-id van Azure Blob Storage .
connectionSpec.version De versie van uw Azure Blob Storage connection spec ID.

Reactie

Een geslaagde reactie retourneert de zojuist gegenereerde basis verbindings-id en -tag.

Selecteren om reactievoorbeeld weer te geven
code language-json 
{
  "id": "a59d368a-1152-4673-a46e-bd52e8cdb9a9",
  "etag": "\"f50185ed-0000-0200-0000-637e8fad0000\""
}

Hiermee worden verbindingen opgehaald die zijn gekoppeld aan een bepaald privéeindpunt retrieve-connections-by-endpoint

Om verbindingen terug te winnen verbonden aan een bepaald privé eindpunt, doe een verzoek van GET aan het /connections eindpunt en verstrek identiteitskaart van het privé eindpunt als vraagparameter.

API formaat

GET /connections?property=auth.params.privateEndpointId=={PRIVATE_ENDPOINT_ID}
Query-parameter
Beschrijving
Identiteitskaart van het privé eindpunt verbonden aan de verbindingen die u wilt terugwinnen.

Verzoek

Het volgende verzoek wint bestaande verbindingen terug die aan privé eindpunt met identiteitskaart worden gebonden: 02a74b31-a566-4a86-9cea-309b101a7f24.

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Een succesvolle reactie keert een lijst van verbindingen terug die aan het gevraagde privé eindpunt worden gebonden.

Selecteren om reactievoorbeeld weer te geven
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": {

  }
}

Verbindingen ophalen die zijn gekoppeld aan een willekeurig particulier eindpunt retrieve-connections

Als u verbindingen wilt ophalen die aan een willekeurig particulier eindpunt zijn gekoppeld, moet u een GET-aanvraag indienen bij het /connections -eindpunt en property=auth.params.usePrivateLink==true opgeven als een queryparameter.

API formaat

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

Verzoek

Het volgende verzoek wint alle verbindingen in uw organisatie terug die privé eindpunten gebruiken.

Selecteren om aanvraagvoorbeeld weer te geven
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' \

Reactie

Een geslaagde reactie retourneert alle verbindingen die aan persoonlijke eindpunten zijn gekoppeld.

Selecteren om reactievoorbeeld weer te geven
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": {

  }
}

Bijlage

Lees deze sectie voor meer informatie met Azure persoonlijke koppelingen in de API.

Een privé-eindpunt goedkeuren voor Azure Blob en Azure Data Lake Gen2

Als u een aanvraag voor een privéeindpunt voor de bronnen Azure Blob en Azure Data Lake Gen2 wilt goedkeuren, meldt u zich aan bij de map Azure Portal . Selecteer in de linkernavigatie Data storage , ga naar de tab Security + networking en kies Networking . Selecteer vervolgens Private endpoints om een lijst weer te geven met persoonlijke eindpunten die zijn gekoppeld aan uw account en de huidige verbindingsstatussen. Als u een aanvraag in behandeling wilt goedkeuren, selecteert u het gewenste eindpunt en klikt u op Approve .

het Azure portaal met een lijst van hangende privé eindpunten.

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