Söka efter ett katalogobjekt

Om du känner till den unika identifieraren för en specifik Catalog kan du utföra en GET-begäran för att visa information om det objektet.

NOTE
När du visar specifika objekt är det fortfarande bäst att filtrera efter egenskaper och returnerar bara de egenskaper du är intresserad av.

API-format

GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
Parameter
Beskrivning
{OBJECT_TYPE}

Typ av Catalog objekt som ska hämtas. Giltiga objekt är:

  • batches
  • dataSets
  • dataSetFiles
{OBJECT_ID}
Identifieraren för det specifika objekt som du vill hämta.

Begäran

Följande begäran hämtar en datauppsättning med dess ID och returnerar dess name, description, tagsoch files egenskaper.

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}'

Svar

Ett lyckat svar returnerar den angivna datauppsättningen med endast den begärda properties i kroppen.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSetFiles?dataSetId=5ba9452f7de80400007fc52a"
    }
}
NOTE
Egenskaper vars värden har prefixet @ representerar relaterade objekt. Se avsnittet om bilagan visa relaterade objekt för steg om hur du visar information om dessa objekt.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676