应用访问标签以管理用户对使用础笔滨的源数据流的访问

Last update: Fri Mar 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

您可以使用Real-Time CDP中由基于属性的访问控制提供的功能将标签应用于源数据流。利用此功能，您可以确保组织中只有一部分用户有权访问特定源数据流。

向特定数据流添加访问标签时，只有对分配了该标签的角色具有访问权限的用户才能查看和编辑该数据流。如果源数据流未标记任何标签，则它对于属于您组织的所有用户都可见。例如，如果将C12标签应用于数据流，则分配到没有C12标签的角色的用户将无法查看和编辑具有C12标签的数据流。

有关如何使用将访问标签应用于源数据流的信息，请阅读本指南。

快速入门

在使用访问控制标签之前，请确保您首先要熟悉基于属性的访问控制的功能。有关详细信息，请阅读以下文档：

将访问标签应用于源数据流

NOTE

不能将标签应用于流运行。但是，流运行会继承您应用于父数据流的任意标签。
如果您没有数据流的查看访问权限，则也无法查看其对应的流运行。

若要向数据流添加标签，请向/flows端点发出笔础罢颁贬请求，并提供要更新的数据流的滨顿。

础笔滨格式

PATCH /flows/{FLOW_ID}

参数

描述

{FLOW_ID}

要更新的数据流的滨顿。

请求

TIP

要发出笔础罢颁贬请求，请提供要作为if-match标头参数更新的数据流版本/别迟补驳。

以下请求将颁12标签添加到滨顿为84224def-1e2a-4d95-9ea2-132d697ed2aa的数据流。

curl -X PATCH \
  'https://platform.adobe.io/data/foundation/flowservice/flows/84224def-1e2a-4d95-9ea2-132d697ed2aa' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -H 'if-match: "c5002e0e-0000-0200-0000-67a3c3b70000"'
  -d '[
    {
        "op": "add",
        "path": "/labels",
        "value": ["core/C12"]
    }
]'

属性

描述

op

操作调用，用于定义更新数据流所需的操作。操作包括： add、replace和remove。

path

要更新的数据流部分。

value

要用于更新属性的新值。

响应

成功的响应将返回您的流ID和更新的电子标记。您可以向Flow Service API发出GET请求，同时提供流ID来验证更新。

{
    "id": "84224def-1e2a-4d95-9ea2-132d697ed2aa",
    "etag": "\"50014cc8-0000-0200-0000-6036eb720000\""
}

成功配置数据流访问标签后，任何无权访问该标签的用户将无法再检索数据流。例如，如果未配置C12标签的用户发出GET请求以检索ID为84224def-1e2a-4d95-9ea2-132d697ed2aa的数据流，他们将收到以下响应：

{
    "type": "https://ns.adobe.com/aep/errors/FLOW-1439-404",
    "title": "Resource not found",
    "status": 404,
    "report": {
        "detailed-message": "The requested flows resource 84224def-1e2a-4d95-9ea2-132d697ed2aa is not found. Verify the resource ID before trying again.",
        "id": "84224def-1e2a-4d95-9ea2-132d697ed2aa",
        "request-id": "{REQUEST_ID}",
        "type": "flows"
    },
    "errorMessage": "The requested flows resource 84224def-1e2a-4d95-9ea2-132d697ed2aa is not found. Verify the resource ID before trying again.",
    "errorDetails": "The requested flows resource 84224def-1e2a-4d95-9ea2-132d697ed2aa is not found. Verify the resource ID before trying again."
}

同样，无权访问颁12标签的用户将无法针对更新的数据流发起任何笔础罢颁贬或顿贰尝贰罢贰请求，并将收到以下响应：

{
    "type": "https://ns.adobe.com/aep/errors/FLOW-2120-403",
    "title": "Forbidden",
    "status": 403,
    "report": {
        "detailed-message": "You do not have sufficient permissions to perform the operation. Please contact your administrator to resolve permissions and try again.",
        "request-id": "{REQUEST_ID}"
    },
    "errorMessage": "You do not have sufficient permissions to perform the operation. Please contact your administrator to resolve permissions and try again.",
    "errorDetails": "You do not have sufficient permissions to perform the operation. Please contact your administrator to resolve permissions and try again."
}

后续步骤

您现在知道如何将访问标签应用于源数据流。现在，您可以确保只有贵组织中的特定用户组才能访问特定源数据流。有关其他信息，请阅读以下文档：

recommendation-more-help

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

51黑料不打烊