Entity

POST /atlas/v2/entity

Changed on

Create or update an entity in Atlas. Existing entity is matched using its unique guid if supplied or by its unique attributes eg: qualifiedName. Map and array of collections are not well supported. E.g., array<array<int>>, array<map<string, int>>. For each contact type, the maximum number of contacts is 20.

Request

  • Base URL
    /catalog/api (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    OAuth 2
    Implicithttps://login.microsoftonline.com/common/oauth2/authorize
    Scopesuser_impersonation

Query parameters

businessAttributeUpdateBehavior'ignore' | 'replace' | 'merge'

Used to define the update behavior for business attributes when updating entities.

Request body

referredEntitiesobject

The referred entities.

Response

Created with EntityMutationResponse.

guidAssignmentsobject

A map of GUID assignments with entities.

mutatedEntitiesobject

The entity headers of mutated entities.

Changes

  • 2021-05-01-preview63dd676f9a6bRevision changes
    • info

      added the new optional query request parameter businessAttributeUpdateBehavior