카탈로그 개체 조회

특정 Catalog 개체의 고유 식별자를 알고 있는 경우 GET 요청을 수행하여 해당 개체의 세부 정보를 볼 수 있습니다.

NOTE
특정 개체를 볼 때는 속성별로 필터링하고 원하는 속성만 반환하는 것이 좋습니다.

API 형식

GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
매개변수
설명
{OBJECT_TYPE}

검색할 Catalog 개체의 형식입니다. 유효한 오브젝트는 다음과 같습니다.

  • batches
  • dataSets
  • dataSetFiles
{OBJECT_ID}
검색할 특정 객체의 식별자입니다.

요청

다음 요청은 ID로 데이터 세트를 검색하여 해당 name, description, tagsfiles 속성을 반환합니다.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a?properties=name,description,tags,files' \
  -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}'

응답

성공적인 응답은 본문에 요청된 properties만 있는 지정된 데이터 집합을 반환합니다.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSetFiles?dataSetId=5ba9452f7de80400007fc52a"
    }
}
NOTE
값 앞에 @이(가) 붙은 속성은 상호 관련된 개체를 나타냅니다. 이러한 개체의 세부 정보를 보는 방법에 대한 단계는 상호 관련된 개체 보기에 대한 부록 섹션을 참조하십시오.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676