Söka efter ett katalogobjekt

Om du känner till den unika identifieraren för ett specifikt Catalog-objekt kan du utföra en GET-förfrågan för att visa objektets information.

NOTE
När du visar specifika objekt är det fortfarande bra att filtrera efter egenskaper och bara returnera de egenskaper som 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}

Den 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 egenskaperna name, description, tags och files.

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 brödtexten.

{
    "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. Avsnittet i bilagan Visa relaterade objekt innehåller anvisningar om hur du visar information om dessa objekt.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676