Atualizar um objeto

É possível atualizar parte de um Catalog objeto incluindo sua ID no caminho de uma solicitação de PATCH. Este documento aborda os dois métodos para executar operações de PATCH em objetos do Catálogo:

  • Uso de campos
  • Uso da notação de Patch JSON
OBSERVAÇÃO

As operações de PATCH em um objeto não podem modificar seus campos expansíveis, que representam objetos inter-relacionados. As modificações a objetos interrelacionados devem ser feitas diretamente.

Atualizar usando campos

A chamada de exemplo a seguir demonstra como atualizar um objeto usando campos e valores.

Formato da API

PATCH /{OBJECT_TYPE}/{OBJECT_ID}
Parâmetro Descrição
{OBJECT_TYPE} O tipo de Catalog objeto a ser atualizado. 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 atualiza os campos name e description de um conjunto de dados para os valores fornecidos na carga. Campos de objeto que não devem ser atualizados podem ser excluídos da carga.

curl -X PATCH \
  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":"Updated Dataset Name",
       "description":"Updated description for Sample Dataset"
      }'

Resposta

Uma resposta bem-sucedida retorna uma matriz que contém a ID do conjunto de dados atualizado. Essa ID deve corresponder àquela enviada na solicitação de PATCH. A execução de uma solicitação de GET para este conjunto de dados agora mostra que somente os valores name e description foram atualizados enquanto todos os outros valores permanecem inalterados.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Atualizar usando notação de Patch JSON

A chamada de exemplo a seguir demonstra como atualizar um objeto usando o Patch JSON, conforme descrito em RFC-6902.

Formato da API

PATCH /{OBJECT_TYPE}/{OBJECT_ID}
Parâmetro Descrição
{OBJECT_TYPE} O tipo de Catalog objeto a ser atualizado. 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 atualiza os campos name e description de um conjunto de dados para os valores fornecidos em cada objeto de Patch JSON. Ao usar o Patch JSON, você também deve definir o cabeçalho Content-Type como application/json-patch+json.

curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json-patch+json' \
  -d '[
        { "op": "add", "path": "/name", "value": "New Dataset Name" },
        { "op": "add", "path": "/description", "value": "New description for dataset" }
      ]'

Resposta

Uma resposta bem-sucedida retorna uma matriz que contém a ID do objeto atualizado. Essa ID deve corresponder àquela enviada na solicitação de PATCH. A execução de uma solicitação de GET para esse objeto agora mostra que somente os valores name e description foram atualizados enquanto todos os outros valores permanecem inalterados.

[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Nesta página