Get catalog item details
/api/20210901/catalog/{type}/{id}
Request
-
id(required): string
Catalog item ID in base64url format.
-
type(required):
Type of catalog item. The content types that this API supports include folders, workbooks, subject areas, analyses, dashboards, dashboard pages, reports, connections, datasets, data flows, sequences, scripts, and semantic models.
-
excludedFields: string
Comma separated list of fields to exclude from response.
-
fields: string
Comma separated list of fields to include in response.
-
limit: integer
Number of catalog items per page.
-
page: integer
Page number.
-
search: string
search string
-
sortBy: string
Sort by criteria.
-
sortOrder: string
Sort order.Allowed Values:
[ "ASC", "DESC" ]
-
type:
catalog item type filter
There's no request body for this operation.
Back to TopResponse
- application/json
200 Response
-
object
CatalogItemIdRef
-
object
CatalogItemParentIdNameRef
-
object
Discriminator: type
Discriminator:
{ "propertyName":"type" }
object
-
description: string
Catalog item description, if any
-
lastModified: string
(date-time)
Catalog item last modified date and time
-
owner: string
Catalog item owner
-
type: string
Allowed Values:
[ "workbooks", "folders", "datasets", "connections", "dataflows", "models", "sequences", "subjectAreas", "analysis", "reports", "dashboards", "dashboardpages", "scripts" ]
object
-
name: string
Catalog item name
-
parentId: string
Catalog parent item identifier (if catalog item has a parent)
400 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
401 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
403 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
404 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
500 Response
object
-
code(required): string
Short error code that defines the error, meant for programmatic parsing.
-
message(required): string
Human-readable error string.
Examples
This example shows you how to obtain details about a specific catalog object,
MySalesWorkbook
. The object type
value is
workbooks
. The object ID of the workbook is
/@Catalog/shared/Sales/MySalesWorkbook
which has the Base64URL-safe
encoded id
value
L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s
cURL Example:
First, obtain the object ID of the workbook you want details for. Base64URL-safe encode the
value to determine the id
. You can obtain the Object ID value from
the Inspect dialog for the object in Oracle Analytics Cloud.
Run the cURL command with the required type
and id
:
curl -i --header 'Authorization: Bearer <token>' \ --request GET 'https://<hostname>/api/20210901/catalog/workbooks/L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s'
Example of Request Body
Not applicable.
Example of Response Body
Status 200:
[ { "owner": "smith", "name": "MySalesWorkbook", "description": "My cool sales analytics", "id": "L0BDYXRhbG9nL3NoYXJlZC9TYWxlcy9NeVNhbGVzV29ya2Jvb2s", "lastModified": "2024-01-01T18:59:16Z", "type": "workbooks", "parentId": "L0BDYXRhbG9nL3NoYXJlZC9TYWxlcw" } ]