POST /catalog/{id}/refresh

Refreshes a catalog entity.

Refreshes all the dependent reflections of the specified physical dataset. This endpoint only functions with physical dataset IDss and has no response object.

Syntax

POST /api/v3/catalog/{id}/refresh

Response Codes

403 - User does not have permission to access the catalog entity.
404 - A catalog entity with the specified ID could not be found.

Example: Refresh Catalog Entities by ID

In this example, the virtual dataset, my_elastic_dataset is refreshed. From the POST /catalog example, the my_elastic_dataset VDS ID is e2676566-1946-4f11-8e21-9fbb366fa77a.

[info] Postman was used to generate samples.

HTTP Request

POST localhost:9047/api/v3/catalog/e2676566-1946-4f11-8e21-9fbb366fa77a/refresh

Curl

curl -X POST \
  http://localhost:9047/api/v3/catalog/e2676566-1946-4f11-8e21-9fbb366fa77a/refresh \
  -H 'Authorization: _dremioo8opojj6vn4ughkvcpalpr46d6' \
  -H 'Content-Type: application/json' \
  -H 'Postman-Token: 6f293291-2559-4596-b674-56771e6d3b43' \
  -H 'cache-control: no-cache'

Python

import requests

url = "http://localhost:9047/api/v3/catalog/e2676566-1946-4f11-8e21-9fbb366fa77a/refresh"

payload = ""
headers = {
    'Authorization': "_dremioo8opojj6vn4ughkvcpalpr46d6",
    'Content-Type': "application/json",
    'cache-control': "no-cache",
    'Postman-Token': "71e72464-ec3c-41d3-b012-cef86e5f2ce7"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)

Response

204 No Content