Show Menu
SUJETS×

Recherche d’un objet

If you know the unique identifier for a specific Catalog object, you can perform a GET request to view that object's details.
Lors de l’affichage d’objets spécifiques, il est toujours recommandé de filtrer par propriétés et de renvoyer uniquement 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}
The type of Catalog object to be retrieved. Les objets valides sont :
  • accounts
  • batches
  • connections
  • connectors
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID}
L’identifiant 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 à l’aide de son identifiant, renvoyant ses propriétés name , description , state , tags et files .
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é contenant uniquement les properties demandées 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 le préfixe @ représentent des objets interconnectés. Consultez la section de l’annexe sur l’affichage des objets interconnectés pour savoir comment afficher les détails de ces objets.