Buscar un objeto Catálogo

Si conoce el identificador único de un objeto Catalog específico, puede realizar una solicitud de GET para ver los detalles de ese objeto.

NOTA

Cuando se ven objetos específicos, sigue siendo recomendable filtrar por propiedades y devolver solo las propiedades que le interesen.

Formato de 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 y devuelve sus propiedades name, 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 properties solicitado 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"
    }
}
NOTA

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

En esta página