Show Menu
TEMAS×

Buscar un objeto

Si conoce el identificador único de un Catalog objeto específico, puede realizar una solicitud de GET para vista de los detalles de dicho objeto.
Al ver objetos específicos, sigue siendo recomendable filtrar por propiedades y devolver solo las propiedades que le interesen.
Formato API
GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}

Parámetro
Descripción
{OBJECT_TYPE}
Tipo de Catalog objeto que se va a recuperar. Los objetos válidos son:
  • accounts
  • batches
  • connections
  • connectors
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID}
Identificador del objeto específico que desea recuperar.
Solicitud
La siguiente solicitud recupera un conjunto de datos por su ID, devolviendo sus name propiedades, description , state , tags y 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}'

Respuesta
Una respuesta correcta devuelve el conjunto de datos especificado con solo el solicitado properties en el cuerpo.
{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "state": "DRAFT",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSets/5ba9452f7de80400007fc52a/views/5ba9452f7de80400007fc52b/files"
    }
}

Las propiedades cuyos valores llevan el prefijo @ representan objetos interrelacionados. Consulte la sección del apéndice sobre la visualización de objetos interrelacionados para ver los pasos para la vista de los detalles de estos objetos.