Show Menu
TEMAS×

Buscar un objeto

Si conoce el identificador único de un objeto Catalog específico, puede realizar una solicitud GET para vista de los detalles del 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 objeto Catalog 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.