ドキュメントExperience Platformソースコネクタガイド

[ベータ版]{class="badge informative"}

API でのソースのプライベートリンクのサポート

Last update: Thu Aug 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者
AVAILABILITY
この機能は限定提供（LA）で、現在、次のソースでのみサポートされています。

プライベートリンク機能を使用して、Adobe Experience Platform ソースの接続先となるプライベートエンドポイントを作成できます。 プライベート IP アドレスを使用してソースを仮想ネットワークに安全に接続し、パブリック IP を不要にし、攻撃対象領域を削減します。 複雑なファイアウォールやネットワークアドレス翻訳設定の必要性を排除し、データトラフィックが承認済みのサービスにのみ到達するようにすることで、ネットワーク設定を簡素化します。

このガイドでは、API を使用してプライベートエンドポイントを作成および使用する方法について説明します。

基本を学ぶ

このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

  • ソース:Experience Platformを使用すると、データを様々なソースから取得しながら、Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • サンドボックス:Experience Platformには、単一の 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",
      "fqdns": [],
      "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 プライベートエンドポイントの名前。
subscriptionId Azure サブスクリプションに関連付けられた ID。 詳しくは、Azure のガイド からサブスクリプションとテナント ID を取得する Azure Portal を参照してください。
resourceGroupName Azure のリソースグループの名前。 リソースグループには、Azure ソリューションに関連するリソースが含まれています。 詳しくは、Azure リソースグループの管理 に関するガイドを参照してください。
resourceName リソースの名前。 Azure えば、リソースとは、仮想マシン、Web アプリ、データベースなどのインスタンスを指します。 詳しくは、Azure リソースマネージャーについて に関する Azure ガイド参照してください。
fqdns ソースの完全修飾ドメイン名。 このプロパティは、Snowflake ソースを使用する場合にのみ必要です。
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",
  "fqdns": [],
  "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 9-row-2
プロパティ 説明
id 新しく作成したプライベートエンドポイントの ID。
name プライベートエンドポイントの名前。
subscriptionId Azure サブスクリプションに関連付けられた ID。 詳しくは、Azure のガイド からサブスクリプションとテナント ID を取得する Azure Portal を参照してください。
resourceGroupName Azure のリソースグループの名前。 リソースグループには、Azure ソリューションに関連するリソースが含まれています。 詳しくは、Azure リソースグループの管理 に関するガイドを参照してください。
resourceName リソースの名前。 Azure えば、リソースとは、仮想マシン、Web アプリ、データベースなどのインスタンスを指します。 詳しくは、Azure リソースマネージャーについて に関する Azure ガイド参照してください。
fqdns ソースの完全修飾ドメイン名。 このプロパティは、Snowflake ソースを使用する場合にのみ必要です。
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"
      }
    }
  ]
}

Enable 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 （有効期間）は分単位です。 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 リクエストを実行し、削除された ID をクエリパラメーターとして /privateEndpoints に指定します。

フローサービス flow-service

Flow Service API と組み合わせてプライベートエンドポイントを使用する方法については、次の節を参照してください。

プライベートエンドポイントとの接続の作成 create-base-connection

Experience Platformのプライベートエンドポイントとの接続を作成するには、/connections API の Flow Service エンドポイントに対して POST リクエストを実行します。

API 形式

POST /connections/

リクエスト

次のリクエストは、プライベートエンドポイントも使用して、Snowflake 用の認証済みベース接続を作成します。

選択してリクエストの例を表示
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": "Snowflake base connection",
      "description": "A base connection for a Snowflake source that uses a private link.",
      "auth": {
          "specName": "ConnectionString",
          "params": {
              "connectionString": "{CONNECTION_STRING}",
              "usePrivateLink" : true
          }
      },
      "connectionSpec": {
          "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
          "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 Snowflake 接続文字列。 詳しくは、Snowflake API 認証ガイドを参照してください。
auth.params.usePrivateLink プライベートエンドポイントを使用しているかどうかを判断するブール値。 プライベートエンドポイントを使用している場合、この値を true に設定します。
connectionSpec.id Snowflake の接続仕様 ID
connectionSpec.version Snowflake 接続仕様 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、この節を参照してください。

プライベートリンクに接続するための Snowflake アカウントの設定

プライベートリンクで Snowflake ソースを使用するには、次の前提条件の手順を完了する必要があります。

まず、Snowflake でサポートチケットを発行し、アカウントの の地域の Azure エンドポイントサービスリソース IDSnowflake をリクエストする必要があります。 Snowflake チケットを発行するには、次の手順に従います。

  1. Snowflake UI に移動し、メールアカウントを使用してログインします。 この手順では、プロファイル設定でメールが検証されていることを確認する必要があります。
  2. ユーザーメニュー を選択し、サポート を選択してサポートにアクセス Snowflake ます。
  3. サポートケースを作成するには、「+ Support Case」を選択します。 次に、関連する詳細をフォームに入力し、必要なファイルを添付します。
  4. 終了したら、ケースを送信します。

エンドポイントリソース ID の形式は次のとおりです。

subscriptions/{SUBSCRIPTION_ID}/resourceGroups/az{REGION}-privatelink/providers/microsoft.network/privatelinkservices/sf-pvlinksvc-az{REGION}
を選択して例を表示
code language-shell 
/subscriptions/4575fb04-6859-4781-8948-7f3a92dc06a3/resourceGroups/azwestus2-privatelink/providers/microsoft.network/privatelinkservices/sf-pvlinksvc-azwestus2
パラメーター
説明
例
{SUBSCRIPTION_ID}
Azure サブスクリプションを識別する一意の ID。
a1b2c3d4-5678-90ab-cdef-1234567890ab
{REGION}
Azure アカウントの Snowflake 地域。
azwestus2

プライベートリンク設定の詳細の取得

プライベートリンク設定の詳細を取得するには、Snowflake で次のコマンドを実行する必要があります。

USE ROLE accountadmin;
SELECT key, value::varchar
FROM TABLE(FLATTEN(input => PARSE_JSON(SYSTEM$GET_PRIVATELINK_CONFIG())));

次に、以下のプロパティの値を取得します。

  • privatelink-account-url
  • regionless-privatelink-account-url
  • privatelink_ocsp-url

値を取得したら、次の呼び出しを実行して、Snowflake のプライベートリンクを作成できます。

リクエスト

次のリクエストは、Snowflake のプライベートエンドポイントを作成します。

テンプレート
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": "{ENDPOINT_NAME}",
    "subscriptionId": "{AZURE_SUBSCRIPTION_ID}",
    "resourceGroupName": "{RESOURCE_GROUP_NAME}",
    "resourceName": "{SNOWFLAKE_ENDPOINT_SERVICE_NAME}",
    "fqdns": [
      "{PRIVATELINK_ACCOUNT_URL}",
      "{REGIONLESS_PRIVATELINK_ACCOUNT_URL}",
      "{PRIVATELINK_OCSP_URL}"
    ],
    "connectionSpec": {
      "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
      "version": "1.0"
    }
  }'
例
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": "TEST_Snowflake_PE",
    "subscriptionId": "4575fb04-6859-4781-8948-7f3a92dc06a3",
    "resourceGroupName": "azwestus2-privatelink",
    "resourceName": "sf-pvlinksvc-azwestus2",
    "fqdns": [
      "hf06619.west-us-2.privatelink.snowflakecomputing.com",
      "adobe-segmentationdbint.privatelink.snowflakecomputing.com",
      "ocsp.hf06619.west-us-2.privatelink.snowflakecomputing.com"
    ],
    "connectionSpec": {
      "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
      "version": "1.0"
    }
  }'

Azure Blob および Azure Data Lake Gen2 のプライベートエンドポイントを承認

Azure Blob および Azure Data Lake Gen2 ソースに対するプライベートエンドポイントリクエストを承認するには、Azure Portal にログインします。 左側のナビゲーションで「Data storage」を選択し、「Security + networking」タブに移動して「Networking」を選択します。 次に、「Private endpoints」を選択して、お使いのアカウントに関連付けられているプライベートエンドポイントとその現在の接続状態のリストを表示します。 保留中のリクエストを承認するには、目的のエンドポイントを選択し、「Approve」をクリックします。

保留中のプライベートエンドポイントのリストを含む Azure Portal。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089