Show Menu
TEMAS×

Reemplazar un objeto

Puede sobrescribir el contenido de un Catalog objeto mediante una solicitud de PUT, donde todo el recurso se reemplaza por la carga útil de la solicitud.
Si solo necesita actualizar algunos campos específicos dentro de un Catalog objeto, el uso de una solicitud de PATCH puede resultar más eficaz.
Formato API
PUT /{OBJECT_TYPE}/{OBJECT_ID}

Parámetro
Descripción
{OBJECT_TYPE}
Tipo de Catalog objeto 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 de 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"
]