Reemplazar un objeto de catálogo

Puede sobrescribir el contenido de un objeto Catalog mediante una solicitud de PUT, donde todo el recurso se reemplaza por la carga útil de la solicitud.

NOTA

Si solo necesita actualizar algunos campos específicos dentro de un objeto Catalog, el uso de una solicitud de PATCH puede ser más eficaz.

Formato de API

PUT /{OBJECT_TYPE}/{OBJECT_ID}
Parámetro Descripción
{OBJECT_TYPE} Tipo de objeto Catalog que se va a reemplazar. Los objetos válidos son:
  • accounts
  • batches
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} Identificador del objeto específico que desea actualizar.

Solicitud

La siguiente solicitud sobrescribe un conjunto de datos con los valores proporcionados en la carga útil.

curl -X PUT \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "name": "New Dataset Name",
        "description": "New description for dataset",
        "state": "DRAFT",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSets/5ba9452f7de80400007fc52a/views/5ba9452f7de80400007fc52b/files"
    }'

Respuesta

Una respuesta correcta devuelve una matriz que contiene el ID del objeto sobrescrito. Este ID debe coincidir con el enviado en la solicitud del PUT. Al realizar una solicitud de GET para este objeto, ahora se muestra que sus detalles se han sustituido por los proporcionados en la carga útil de la solicitud de PUT anterior.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

En esta página