Adobe Experience Platform は、デジタルエクスペリエンスアプリケーションをグローバルな規模で強化するように設計されています。企業ではしばしば複数のデジタルエクスペリエンスアプリケーションを並行して運用し、運用コンプライアンスを確保しながら、アプリケーションの開発、テスト、導入に注力する必要があります。
このニーズに対応するために、Experience Platform は、サンドボックスを提供します。サンドボックスでは、単一の Platform インスタンスを別々の仮想環境に分割することができ、デジタルエクスペリエンスアプリケーションの開発と発展に役立ちます。
このドキュメントでは、Experience Platform のサンドボックスの概要を説明します。
サンドボックスは、Experience Platform の単一のインスタンス内の仮想パーティションで、デジタルエクスペリエンスアプリケーションの開発プロセスとシームレスに統合できます。サンドボックス内で実行されるすべてのコンテンツとアクションは、そのサンドボックスのみに限定され、他のサンドボックスには影響しません。Experience Platformでは、2 種類のサンドボックスがサポートされています。
1 つのExperience Platformインスタンスは、複数の実稼動および開発サンドボックスをサポートし、各サンドボックスは、Platform リソース(スキーマ、データセット、プロファイルなど)の独立した独自のライブラリを保持します。 また、実稼働用サンドボックスと開発用サンドボックスの両方に、顧客が作成したすべてのリソースをサンドボックスから削除するリセット機能があります。 開発用サンドボックスを実稼働用サンドボックスに変換することはできません。
デフォルトのExperience Platformライセンスにより、合計 5 つのサンドボックスが許可されます。このサンドボックスは、実稼動または開発として分類できます。 追加のサンドボックス 10 個のサンドボックスのライセンスを、合計で最大 75 個まで取得できます。 これらの追加のサンドボックスは、実稼働用サンドボックスと開発用サンドボックスの両方の作成に使用できます。 詳しくは、IMS 組織管理者またはアドビのセールス担当者にお問い合わせください。
最後に、デフォルトの実稼動サンドボックスは、IMS 組織が最初に作成されたときに作成される最初の実稼動サンドボックスです。 デフォルトの実稼働用サンドボックスを使用すると、Platform からデータを取り込んだり、使用したりできます。また、サンドボックス名やサンドボックス ID の値を含まないリクエストを受け入れることもできます。
サンドボックスを最初に作成したときは、データは含まれません。各サンドボックスは独自の独立したデータストアを維持するので、データを個別に取得する必要もあります。
要約すると、サンドボックスには次の利点があります。
デフォルトでは、組織のすべてのユーザーが実稼働用サンドボックスにアクセスできます。非実稼働用サンドボックスへのアクセスは、システム管理者、製品管理者、または製品プロファイル管理者が Adobe Admin Console を通じて許可する必要があります。
非実稼働サンドボックスの表示、作成、更新、削除をおこなうには、ユーザーにサンドボックス管理権限が付与されている必要があります。
サンドボックスの役割と権限の管理について詳しくは、「アクセス制御の概要」を参照してください。
Experience Platform ユーザーインターフェイスでは、画面の左上にあるサンドボックス切り替えコントロールを使用して、アクセス権を持つサンドボックス間を切り替えることができます。 サンドボックス管理権限を持つユーザーは、左側のナビゲーションの「サンドボックス」タブにアクセスして、組織のサンドボックスの表示と管理をおこなうこともできます。UI でサンドボックスを使用する方法について詳しくは、『サンドボックスユーザガイド』を参照してください。
Experience Platform API を呼び出す場合は、ヘッダーの x-sandbox-name
でサンドボックス名を指定する必要があります。例えば、 Catalog Service API 実稼働用サンドボックス内のすべてのデータセットを表示するには、サンドボックスの名前 (「prod」) が API リクエストのヘッダーとして提供されます。
curl -X GET \
https://platform.adobe.io/data/foundation/catalog/dataSets \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: prod'
x-sandbox-name
が API 呼び出しに含まれていない場合、システムは代わりにデフォルトのサンドボックスを使用します。ただし、デフォルトのサンドボックスを使用している場合でも、ベストプラクティスは常にこのヘッダーをすべての API 呼び出しに含めることです。このため、Experience Platform の API ドキュメントは x-sandbox-name
を必須のヘッダーとして扱っています。
サンドボックス API を使用すると、RESTful API 操作を使用してサンドボックスを管理できます。適切に書式設定されたリクエストや応答例など、API の使用方法について詳しくは、『サンドボックス開発者ガイド』を参照してください。
このドキュメントでは、Experience Platform のサンドボックスに関する基本的な概念を紹介しました。サンドボックスの管理方法について詳しくは、UI のユーザガイド 、または API の開発者ガイドを参照してください。
サンドボックスは、開発チーム向けの Platform 環境を分離する貴重なツールですが、Adobe Admin Console を使用して、より詳細なアクセス制御を管理することもできます。詳しくは、「アクセス制御の概要」を参照してください。