Nachschlagen eines Katalogobjekts

Wenn Sie die eindeutige Kennung für ein bestimmtes Catalog-Objekt kennen, können Sie eine GET-Anfrage ausführen, um die Details dieses Objekts anzuzeigen.

HINWEIS

Beim Anzeigen einzelner Objekte empfiehlt es sich weiterhin, nach Eigenschaften zu filtern, um nur die Eigenschaften zurückzugeben, die Sie von Interesse sind.

API-Format

GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
Parameter Beschreibung
{OBJECT_TYPE} Der Typ des abzurufenden Catalog-Objekts. Gültige Objekte sind:
  • accounts
  • batches
  • connections
  • connectors
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} Die Kennung des spezifischen Objekts, das Sie abrufen möchten.

Anfrage

Mit der folgenden Anfrage wird ein Datensatz anhand seiner Kennung abgerufen und werden die zugehörigen Eigenschaften name, description, state, tags und files zurückgegeben.

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

Antwort

Bei einer erfolgreichen Antwort wird der angegebene Datensatz nur mit den angeforderten properties im Text zurückgegeben.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "state": "DRAFT",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSets/5ba9452f7de80400007fc52a/views/5ba9452f7de80400007fc52b/files"
    }
}
HINWEIS

Eigenschaften, deren Werte mit einem @-Präfix versehen sind, stellen miteinander verknüpfte Objekte dar. Anweisungen zum Anzeigen dieser Objekte finden Sie im Anhangsbereich zum Anzeigen von miteinander verknüpften Objekten.

Auf dieser Seite