목록 ID 매핑

매핑은 지정된 네임스페이스에 대한 클러스터의 모든 ID 컬렉션입니다.

단일 ID에 대한 ID 매핑 받기

ID가 주어지면 요청에서 ID로 표시되는 동일한 네임스페이스에서 모든 관련 ID를 검색합니다.

API 형식

GET https://platform-{REGION}.adobe.io/data/core/identity/mapping

요청

옵션 1:ID를 네임스페이스(nsId, ID별) 및 ID 값(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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

옵션 2:ID를 네임스페이스(ns, 이름별) 및 ID 값(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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

옵션 3:ID를 XID(xid)로 제공합니다. ID의 XID를 얻는 방법에 대한 자세한 내용은 ID에 대한 XID 가져오기를 포함하는 이 문서의 섹션을 참조하십시오.

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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

여러 ID에 대한 ID 매핑 가져오기

POST 메서드를 위에서 설명한 GET 메서드와 동일한 일괄 처리로 사용하여 여러 ID에 대한 매핑을 검색합니다.

노트

요청에는 최대 1000ID를 초과할 수 없습니다. ID가 1000개를 초과하는 요청은 400개의 상태 코드를 생성합니다.

API 형식

POST https://platform.adobe.io/data/core/identity/mappings

요청 본문

옵션 1:매핑을 검색할 XID 목록을 제공합니다.

{
    "xids": ["GYMBWaoXbMtZ1j4eAAACepuQGhs","b2NJK9a5X7x4LVE4rUqkMyM"],
    "graph-type": "Private Graph"
}

옵션 2:ID 목록을 조합 ID로 제공합니다. 여기서 각 ID 값과 네임스페이스의 이름은 네임스페이스 ID로 지정됩니다. 이 예제에서는 "Private Graph"의 기본 graph-type을 덮어쓰는 동안 이 메서드를 사용하는 방법을 보여 줍니다.

{
    "compositeXids": [{
            "nsid": 411,
            "id": "WRbM7AAAAJ_PBZHl"
        },
        {
            "nsid": 411,
            "id": "WY-RNgAAArI4rGBo"
        }
    ],
    "graph-type": "None"
}

요청

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

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

제공된 입력과 함께 관련 ID가 없는 경우 HTTP 204 응답 코드가 아무 컨텐츠도 없이 반환됩니다.

응답

{
    "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:입력 ID가 이 ID와 마지막으로 연결된 타임스탬프입니다.
  • regions:ID regionIdlastAssociationTime 표시된 위치 및 를 제공합니다.

다음 단계

사용 가능한 네임스페이스 목록🔗에 대한 다음 자습서로 진행합니다.

이 페이지에서는