在身分圖表中相關的身分(無論命名空間為何),都視為該身分圖表中相同「叢集」的一部分。 下面的選項提供了訪問所有群整合員的方法。
檢索單個標識的所有群整合員。
您可以使用 graph-type
用於指示要從中獲取群集的標識圖的參數。 選項包括:
graph-type
為,此為預設值。API格式
GET https://platform-{REGION}.adobe.io/data/core/identity/cluster/members?{PARAMETERS}
要求
選項1:將身分提供為命名空間(nsId
,依ID)和ID值(id
)。
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/members?nsId=411&id=WTCpVgAAAFq14FMF' \
-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}'
選項2:將身分提供為命名空間(ns
,依名稱)和ID值(id
)。
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/members?ns=AMO&id=WTCpVgAAAFq14FMF' \
-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}'
選項3:將標識提供為XID(xid
)。 如需如何取得身分識別的XID的詳細資訊,請參閱本檔案涵蓋 獲取XID以獲取身份.
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/cluster/members?xid=CJsDEAMaEAHmCKwPCQYNvzxD9JGDHZ8' \
-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}'
使用 POST
作為批的等價物 GET
上述方法,可傳回多個身分的叢集中的身分。
請求應指示最多1000個身分。 超過1000個身分的請求將產生400個狀態代碼。
API格式
POST https://platform-{REGION}.adobe.io/data/core/identity/clusters/members
要求
以下請求示範提供要為其檢索群整合員的XID清單。
存根請求
使用 x-uis-cst-ctx: stub
header會傳回短回應。 這是一種臨時解決方案,在服務完成的同時,促進早期的一體化發展進程。 不再需要時,此功能將會淘汰。
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/members \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-uis-cst-ctx: stub' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"]
}'
使用XID呼叫
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/members \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}' | json_pp
使用UID呼叫
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/clusters/members \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"graph-type": "Private Graph"
}' | json_pp
回應
「Stubed」響應
{
"version": 1,
"clusters": [{
"xid": "GZsBQnHQaGtL46ZKSvO9bNRE1DcUyQA",
"compositeXid": {
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
"members": ["e8138f65-d3d3-4485-a7e1-6712e047349d", "21312343536983537571245438594"],
"members": [{
"nsid": 0,
"id": "27064814400205787570627663430729680462"
},
{
"nsid": 411,
"id": "86826386186182763871263871263876128612"
}
]
},
{
"xid": "CJsDEAMaEAHmCKwPCQYNvzxD9JGDHZ8",
"compositeXid": {
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
"members": [],
"members": []
}
],
"unprocessedXids": ["cb0665db616f49758713252d8a335c1e"],
"unprocessedNids": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}]
}
完整回應
{
"unprocessedXids": [],
"unprocessedNids": [],
"version": "1.0.0",
"clusters": [{
"xid": "411|WRbM7AAAAJ_PBZHl",
"members": [
"411|WRbM7AAAAJ_PBZHl",
"0|47713142741924778930324734610798294416"
],
"compositeXid": {
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
"members": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 0,
"id": "47713142741924778930324734610798294416"
}
]
},
{
"xid": "411|WY-RNgAAArI4rGBo",
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"members": [
"411|WY-RNgAAArI4rGBo",
"411|WY-RNgAAArI4rGGy"
],
"members": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGGy"
}
]
}
]
}
無論請求的XID是否屬於同一群集,或是一個或多個XID是否與任何群集相關聯,響應始終在請求中為每個XID提供一個條目。
繼續下一個教學課程,前往 列出標識的群集歷史記錄