Show Menu
TÓPICOS×

Substituir um objeto

É possível substituir o conteúdo de um objeto de Catálogo usando uma solicitação PUT, onde todo o recurso é substituído pela carga da solicitação.
Se você precisar apenas atualizar alguns campos específicos em um objeto de Catálogo, o uso de uma solicitação PATCH pode ser mais eficiente.
Formato da API
PUT /{OBJECT_TYPE}/{OBJECT_ID}

Parâmetro
Descrição
{OBJECT_TYPE}
O tipo de objeto Catalog a ser substituído. Objetos válidos são:
  • accounts
  • batches
  • connections
  • dataSets
  • dataSetFiles
  • dataSetViews
{OBJECT_ID}
O identificador do objeto específico que você deseja atualizar.
Solicitação
A solicitação a seguir substitui um conjunto de dados pelos valores fornecidos na carga.
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"
    }'

Resposta
Uma resposta bem-sucedida retorna uma matriz que contém a ID do objeto substituído. Essa ID deve corresponder àquela enviada na solicitação PUT. Executar uma solicitação GET para esse objeto agora mostra que seus detalhes foram substituídos pelos fornecidos na carga da solicitação PUT anterior.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]