ドキュメントExperience Platformアクセス制御ガイド

製品エンドポイント

最終更新日： 2025年4月4日

作成対象：

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}
NOTE
ユーザートークンが渡される場合、トークンのユーザーは、リクエストされた組織の「組織管理者」役割を持っている必要があります。

属性ベースのアクセス制御APIの/products エンドポイントを使用すると、組織内の製品に関連付けられた権限カテゴリと権限セットだけでなく、製品をプログラムで管理できます。

はじめに

このガイドで使用するAPI エンドポイントは、属性ベースのアクセス制御APIの一部です。 先に進む前に、はじめる前にを参照し、関連ドキュメントへのリンク、このドキュメントのサンプル API 呼び出しを読み取るためのガイドおよび任意の Experience Platform API を正常に呼び出すために必要なヘッダーに関する重要な情報を確認してください。

使用権限のある製品のリストの取得 list

/products エンドポイントにGET リクエストを行うことで、使用権限のある製品のリストを取得できます。

API 形式

GET /products/

リクエスト

次のリクエストは、組織に属する権限のある製品のリストを取得します。

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

応答

応答が成功すると、組織に属する権限のある製品のリストが返されます。

{
  "products": [
    {
      "id": "{ID}",
      "name": "Adobe Experience Platform",
      "serviceCode": "{SERVICE_CODE}"
    }
  ]
}
プロパティ
説明
id
クエリされた製品の対応するID。
name
クエリされた製品の名前。
serviceCode
クエリされた製品の対応するサービス コード。

製品IDで権限カテゴリを検索する

製品IDを指定しながら/products/{PRODUCT_ID}/categories エンドポイントにGET リクエストを行うことで、特定の製品の権限カテゴリを検索できます。

API 形式

GET /products/{PRODUCT_ID}/categories
パラメーター
説明
{PRODUCT_ID}
検索する権限カテゴリに関連付けられている製品のID。

リクエスト

次のリクエストは、{PRODUCT_ID}に関連付けられた権限カテゴリを取得します。

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products/{PRODUCT_ID}/categories \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

応答

応答が成功すると、クエリした製品IDに関連付けられた権限カテゴリが返されます。

{
  "categories": [
    {
        "name": "Profile Management"
    },
    {
        "name": "Data Ingestion"
    },
    {
        "name": "Sandbox Administration"
    },
    {
        "name": "Query Service"
    },
    {
        "name": "Data Management"
    },
    {
        "name": "Identity Management"
    },
    {
        "name": "Data Modeling"
    },
    {
        "name": "Data Science Workspace"
    },
    {
        "name": "Dashboards"
    },
    {
        "name": "Alerts"
    },
    {
        "name": "Data Governance"
    }
  ]
}
プロパティ
説明
category
クエリされた製品ID内で使用できる権限カテゴリ。
name
権限カテゴリの名前。

製品IDで権限セットを検索する

製品IDを指定しながら/products/{PRODUCT_ID}/permission-sets エンドポイントにGET リクエストを行うことで、特定の製品の権限セットを検索できます。

API 形式

GET /products/{PRODUCT_ID}/permission-sets
パラメーター
説明
{PRODUCT_ID}
検索する権限セットに関連付けられている製品のID。

リクエスト

次のリクエストは、{PRODUCT_ID}に関連付けられている権限セットを取得します。

curl -X GET \
  https://platform.adobe.io/data/foundation/access-control/administration/products/{PRODUCT_ID}/permission-sets \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

応答

応答が成功すると、クエリした製品IDに関連付けられた権限セットが返されます。

{
  "permission-sets": [
      {
          "id": "manage-schemas",
          "name": "Manage Schemas",
          "category": "Data Modeling",
          "permissions": [
              {
                  "resource": "schemas",
                  "actions": [
                      "read",
                      "write",
                      "delete"
                  ]
              },
              {
                  "resource": "schema-fields",
                  "actions": [
                      "read",
                      "write",
                      "delete"
                  ]
              },
              {
                  "resource": "sandboxes",
                  "actions": [
                      "view"
                  ]
              }
          ]
      },
      {
          "id": "view-schemas",
          "name": "View Schemas",
          "category": "Data Modeling",
          "permissions": [
              {
                  "resource": "schemas",
                  "actions": [
                      "read"
                  ]
              },
              {
                  "resource": "schema-fields",
                  "actions": [
                      "read"
                  ]
              },
              {
                  "resource": "sandboxes",
                  "actions": [
                      "view"
                  ]
              }
          ]
      },
  ]
}
プロパティ
説明
permission-sets
権限セットは、管理者が役割に適用できる権限のグループを表します。 管理者は、個々の権限を割り当てる代わりに、役割に権限セットを割り当てることができます。 これにより、権限のグループを含む事前定義済みの役割からカスタムの役割を作成できます。
id
クエリされた権限セットの対応するID。
name
クエリされた権限セットの対応する名前。
category
使用可能な権限カテゴリ。
permissions
権限には、サンドボックスの作成、スキーマの定義、データセットの管理など、Experience Platform の機能の表示や使用の機能が含まれます。
permissions.resource
被写体がアクセスできる、またはアクセスできないアセットまたはオブジェクト。 リソースには、ファイル、アプリケーション、サーバー、APIなどがあります。
permissions.actions
クエリされたリソースに対して被写体が実行できるアクション。 使用可能な値は、view、read、create、editおよびdeleteです
recommendation-more-help
experience-platform-help-access-control