Puoi sovrascrivere il contenuto di un Catalog oggetto utilizzando una richiesta PUT, in cui l’intera risorsa viene sostituita con il payload della richiesta.
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:
|
{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"
]