Show Menu
화제×

목록 ID 매핑

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

단일 ID에 대한 ID 매핑 받기

ID가 주어지면 요청의 ID로 표시되는 동일한 네임스페이스에서 모든 관련 ID를 검색합니다.
API 형식
GET https://platform-{REGION}.adobe.io/data/core/identity/mapping

요청
옵션 1:ID를 네임스페이스(ID별 nsId )와 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에 대한 매핑을 검색합니다.
요청은 최대 1000개의 ID를 초과하지 않아야 합니다. 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로 지정됩니다. 이 예에서는 "비공개 그래프"의 기본값을 덮어쓰는 동안 이 방법 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가 regionId 표시된 위치 및 lastAssociationTime 를 제공합니다.

다음 단계

다음 자습서로 진행하여 사용 가능한 네임스페이스가 나열됩니다 .