Remplacement d’un objet Catalogue

Vous pouvez remplacer le contenu d'un objet Catalog à l'aide d'une requête de PUT, dans laquelle la ressource entière est remplacée par la charge utile de la requête.

REMARQUE

Si vous devez uniquement mettre à jour quelques champs spécifiques dans un objet Catalog, l'utilisation d'une requête de PATCH peut s'avérer plus efficace.

Format d’API

PUT /{OBJECT_TYPE}/{OBJECT_ID}
Paramètre Description
{OBJECT_TYPE} Type d'objet Catalog à remplacer. Les objets valides sont :
  • accounts
  • batches
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID} Identifiant de l’objet spécifique que vous souhaitez mettre à jour.

Requête

La requête suivante remplace un jeu de données avec les valeurs fournies dans le 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: {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"
    }'

Réponse

Une réponse réussie renvoie un tableau contenant l’identifiant de l’objet remplacé. Cet identifiant doit correspondre à celui envoyé dans la requête PUT. L’exécution d’une requête GET pour cet objet affiche désormais que ses détails ont été remplacés par ceux fournis dans le payload de la requête PUT précédente.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Sur cette page