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에 대한 매핑을 검색합니다.
요청은 최대 1,000개의 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와 마지막으로 연결된 타임스탬프
  • regions :ID가 표시된 regionId 위치와 lastAssociationTime 위치를 제공합니다.

다음 단계

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