Skip to main content
Version: Next

CatalogClient

Home > @backstage/catalog-client > CatalogClient

A frontend and backend compatible client for communicating with the Backstage software catalog.

Signature:

class CatalogClient implements CatalogApi 

Implements: CatalogApi

Constructors

Constructor

Modifiers

Description

(constructor)(options)

Constructs a new instance of the CatalogClient class

Methods

Method

Modifiers

Description

addLocation(request, options)

Registers a new location.

getEntities(request, options)

Lists catalog entities.

getEntitiesByRefs(request, options)

Gets a batch of entities, by their entity refs.

getEntityAncestors(request, options)

Gets entity ancestor information, i.e. the hierarchy of parent entities whose processing resulted in a given entity appearing in the catalog.

getEntityByName(compoundName, options)

getEntityByRef(entityRef, options)

Gets a single entity from the catalog by its ref (kind, namespace, name) triplet.

getEntityFacets(request, options)

Gets a summary of field facets of entities in the catalog.

getLocationByEntity(entityRef, options)

Gets a location associated with an entity.

getLocationById(id, options)

Gets a registered location by its ID.

getLocationByRef(locationRef, options)

Gets a registered location by its ref.

getLocations(request, options)

List locations

queryEntities(request, options)

Gets paginated entities from the catalog.

refreshEntity(entityRef, options)

Refreshes (marks for reprocessing) an entity in the catalog.

removeEntityByUid(uid, options)

Removes a single entity from the catalog by entity UID.

removeLocationById(id, options)

Removes a registered Location by its ID.

validateEntity(entity, locationRef, options)

Validate entity and its location.