Sostituire un oggetto Catalog

Puoi sovrascrivere il contenuto di un Catalog oggetto utilizzando una richiesta PUT, in cui l’intera risorsa viene sostituita con il payload della richiesta.

NOTA

Se devi aggiornare solo alcuni campi specifici all’interno di un Catalog l'utilizzo di una richiesta PATCH può essere più efficiente.

Formato API

PUT /{OBJECT_TYPE}/{OBJECT_ID}
Parametro Descrizione
{OBJECT_TYPE} Tipo di Catalog oggetto da sostituire. Gli oggetti validi sono:
  • accounts
  • batches
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} Identificatore dell'oggetto specifico che si desidera aggiornare.

Richiesta

La seguente richiesta sovrascrive un set di dati con i valori forniti nel payload.

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: {ORG_ID}' \
  -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"
    }'

Risposta

Una risposta corretta restituisce un array contenente l'ID dell'oggetto sovrascritto. Questo ID deve corrispondere a quello inviato nella richiesta di PUT. L'esecuzione di una richiesta GET per questo oggetto ora mostra che i relativi dettagli sono stati sostituiti con quelli forniti nel payload della richiesta PUT precedente.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

In questa pagina