Enumerar asignaciones de identidad
Una asignación es una colección de todas las identidades de un clúster para un área de nombres especificada.
Obtener una asignación de identidad para una sola identidad
Dada una identidad, recupere todas las identidades relacionadas del mismo área de nombres que la representada por la identidad en la solicitud.
Formato de API
GET https://platform-{REGION}.adobe.io/data/core/identity/mapping
Solicitud
Opción 1: proporcione la identidad como área de nombres (nsId, por identificador) y valor de identificador (id).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?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}'
Opción 2: proporcione la identidad como área de nombres (ns, por nombre) y valor de identificador (id).
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?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}'
Opción 3: proporcione la identidad como XID (xid). Para obtener más información sobre cómo obtener el XID de una identidad, consulte la sección de este documento que trata sobre obtención del XID para una identidad.
curl -X GET \
'https://platform-va7.adobe.io/data/core/identity/mapping?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}'
Obtener asignaciones de identidad para varias identidades
Utilice el método POST como equivalente de lote del método GET descrito anteriormente para recuperar asignaciones para varias identidades.
Formato de API
POST https://platform.adobe.io/data/core/identity/mappings
Cuerpo de solicitud
Opción 1: Proporcione una lista de XID para los que recuperar asignaciones.
{
"xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
"graph-type": "Private Graph"
}
Opción 2: Proporcione una lista de identidades como ID compuestos, donde cada una de ellas nombra el valor de ID y el área de nombres por ID de área de nombres. En este ejemplo se muestra el uso de este método al sobrescribir el valor predeterminado graph-type de "Private Graph".
{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"graph-type": "None"
}
Solicitud
Usando XID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/mappings \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: 111111@AdobeOrg' \
-d '{
"xids": ["GesCQXX0CAESEE8wHpswUoLXXmrYy8KBTVgA"],
"targetNs": "0",
"graph-type": "Private Graph"
}' | json_pp
Usando UID
curl -X POST \
https://platform-va7.adobe.io/data/core/identity/mappings \
-H 'authorization: Bearer {ACCESS_TOKEN}' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: 111111@AdobeOrg' \
-d '{
"compositeXids": [{
"nsid": 411,
"id": "WRbM7AAAAJ_PBZHl"
},
{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}
],
"targetNs": "0",
"graph-type": "Private Graph"
}' | json_pp
Si no se encontraron identidades relacionadas con la entrada proporcionada, se devuelve un código de respuesta HTTP 204 sin contenido.
Respuesta
{
"version": 1,
"mappings": [{
"xid": "CAESEPl1uYyma1kMDWxx7dhbwGo",
"mapping": [{
"xid": "81218968060697815473313992060878182012",
"lastAssociationTime": "1493310475047"
}],
"compositeXid": {
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
},
"mapping": [{
"compositeXid": {
"nsid": 411,
"id": "WY-RNchvdsTSJS"
},
"lastAssociationTime": "1493310475047"
}],
"regions": [{
"regionId": "10",
"lastAssociationTime": "1493310475047"
}]
}],
"unprocessedXids": ["cb0665db616f49758713252d8a335c1e"],
"unprocessedNids": [{
"nsid": 411,
"id": "WY-RNgAAArI4rGBo"
}]
}
lastAssociationTime: marca de tiempo de la última vez que la identidad de entrada se asoció con esta identidad.regions: proporcionaregionIdylastAssociationTimepara el lugar donde se vio la identidad.
Pasos siguientes
Continúe con el siguiente tutorial para enumerar las áreas de nombres disponibles.