Glossary

Get Glossary Object

get

Get a glossary object by ID and AssetType

Query parameters
idintegerRequired
typestring · enumRequiredPossible values:
Responses
200
Successful Response
application/json
get
GET /api/v1/data/catalog/glossary?id=1&type=glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*
{
  "asset": {
    "type": "text",
    "name": "text",
    "id": 1,
    "subtype": "bigquery",
    "qual_id": "text",
    "icon": "text"
  },
  "parents": [
    {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    }
  ],
  "assets": [
    {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    }
  ],
  "attrs": {}
}

Create Glossary Object

post

Creates a glossary object and return the ID of the newly created object

Body
any ofOptional
or
or
Responses
200
Successful Response
application/json
post
POST /api/v1/data/catalog/glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "type": "glossary",
  "name": "text",
  "description": "text",
  "data_owner": "text",
  "business_owners": [
    "text"
  ]
}
{
  "id": 1,
  "type": "glossary"
}

Delete Glossary Object

delete

Deletes an existing glossary object.

Query parameters
idintegerRequired

Id of glossary object

typestring · enumRequiredPossible values:
Responses
200
Successful Response
application/json
Responseany
delete
DELETE /api/v1/data/catalog/glossary?id=1&type=glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

No content

Modify Glossary Object

patch

Modifies an existing glossary object.

Body
any ofOptional
or
or
Responses
200
Successful Response
application/json
Responseany
patch
PATCH /api/v1/data/catalog/glossary HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "id": 1,
  "type": "glossary",
  "name": "text",
  "description": "text",
  "data_owner": "text",
  "business_owners": [
    "text"
  ]
}

No content

List Glossary Objects

get

List glossary objects. If parent_id and parent_type is specified, will return all glossary objects under the parent Glossary object. If type is defined, will return all glossary objects of that type only. page_size limit is 100.

Query parameters
parent_idintegerOptional

ID of the parent object

parent_typestring · enumOptional

Type of the parent object

Possible values:
typestring · enumOptional

Filters the result to only contain glossary objects of this type

Possible values:
page_sizeinteger · min: 1 · max: 100OptionalDefault: 10
pageinteger · min: 1OptionalDefault: 1
Responses
200
Successful Response
application/json
get
GET /api/v1/data/catalog/glossary/list HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*
[
  {
    "asset": {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    },
    "parents": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "assets": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "attrs": {}
  }
]
get

Search glossary objects. If name is specified will return all glossary objects with that name. is_fuzzy flag turns on fuzzy searching that allows non-exact matching. max_results limit is 100.

Query parameters
typestring · enumOptional

Filters the result to only contain glossary objects of this type

Possible values:
namestringOptional

Search for glossary object based on the name. Case sensitive

is_fuzzybooleanOptional

Fuzzy search with name argument

Default: false
max_resultsinteger · max: 100OptionalDefault: 10
Responses
200
Successful Response
application/json
get
GET /api/v1/data/catalog/glossary/search HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*
[
  {
    "asset": {
      "type": "text",
      "name": "text",
      "id": 1,
      "subtype": "bigquery",
      "qual_id": "text",
      "icon": "text"
    },
    "parents": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "assets": [
      {
        "type": "text",
        "name": "text",
        "id": 1,
        "subtype": "bigquery",
        "qual_id": "text",
        "icon": "text"
      }
    ],
    "attrs": {}
  }
]

Attach Documentation To Term

post

Attaches documentation to a term. If an existing documentation is already attached to a term, it will be replaced.

Body
idintegerRequired
typestring · enumRequiredPossible values:
documentationobject · DocumentationRequired
Responses
200
Successful Response
application/json
Responseany
post
POST /api/v1/data/catalog/glossary/documentation HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "id": 1,
  "type": "term",
  "documentation": {}
}

No content

Delete Documentation To Term

delete

Deletes documentation of a term. Deletes the documentation attached to a term.

Query parameters
term_idintegerRequired

The ID of the Term.

Responses
200
Successful Response
application/json
Responseany
delete
DELETE /api/v1/data/catalog/glossary/documentation?term_id=1 HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*

No content

Last updated