Show Menu
SUJETS×

Remplacement d’un objet

You can overwrite the contents of a Catalog object using a PUT request, wherein the entire resource is replaced with the request payload.
If you only need to update a few specific fields within a Catalog object, using a PATCH request may be more efficient.
Format d’API
PUT /{OBJECT_TYPE}/{OBJECT_ID}

Paramètre
Description
{OBJECT_TYPE}
The type of Catalog object to be replaced. 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"
]