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

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

를 사용하십시오 POST 와 같은 일괄 처리 방법 GET 위에 설명된 방법으로 여러 ID에 대한 매핑을 검색할 수 있습니다.

노트

요청은 최대 1000개의 ID를 넘지 않도록 해야 합니다. 1000개의 ID를 초과하는 요청은 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 값과 네임스페이스에 이름을 지정합니다. 이 예제에서는 기본값을 덮어쓰는 동안 이 메서드를 사용하는 방법을 보여 줍니다 graph-type Private Graph

{
    "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: 다음을 제공합니다. regionIdlastAssociationTime ID가 표시되는 곳

다음 단계

다음 자습서로 진행하여 사용 가능한 네임스페이스 목록.

이 페이지에서는