Show Menu
SUJETS×

Rechercher un objet

Si vous connaissez l'identifiant unique d'un objet Catalog spécifique, vous pouvez exécuter une requête GET pour vue les détails de cet objet.
Lors de l’affichage d’objets spécifiques, il est toujours recommandé de filtrer par propriétés et de ne renvoyer que les propriétés qui vous intéressent.
Format d’API
GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}

Paramètre
Description
{OBJECT_TYPE}
Type d’objet Catalog à récupérer. Les objets valides sont :
  • accounts
  • batches
  • connections
  • connectors
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID}
Identificateur de l'objet spécifique que vous souhaitez récupérer.
Requête
La requête suivante récupère un jeu de données par son identifiant, en renvoyant ses name , description , state , tags et files propriétés.
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}'

Réponse
Une réponse réussie renvoie le jeu de données spécifié avec uniquement le jeu demandé properties dans le corps.
{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "state": "DRAFT",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSets/5ba9452f7de80400007fc52a/views/5ba9452f7de80400007fc52b/files"
    }
}

Les propriétés dont les valeurs comportent un préfixe @ représentent des objets interconnectés. Consultez la section de l’annexe sur l’ affichage des objets interconnectés pour savoir comment vue les détails de ces objets.