Glossary - Create

Dienst:

Purview

API-Version:

2023-09-01

Erstellen Sie ein Glossar.

POST {endpoint}/datamap/api/atlas/v2/glossary

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string (uri)

Anforderungstext

Name	Typ	Beschreibung
categories	AtlasRelatedCategoryHeader[]	Ein Array von Kategorien.
classifications	AtlasClassification[]	Ein Array von Klassifizierungen.
createTime	integer (int64)	Die erstellte Zeit des Datensatzes.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
guid	string	Die GUID des Objekts.
language	string	Die Sprache des Glossars.
lastModifiedTS	string	ETag für Parallelitätssteuerelement.
longDescription	string	Die Beschreibung der langen Version.
name	string	Der Name des Glossarobjekts.
qualifiedName	string	Der qualifizierte Name des Glossarobjekts.
shortDescription	string	Die kurze Version der Beschreibung.
terms	AtlasRelatedTermHeader[]	Ein Array verwandter Ausdrucksheader.
updateTime	integer (int64)	Die Aktualisierungszeit des Datensatzes.
updatedBy	string	Der Benutzer, der den Datensatz aktualisiert hat.
usage	string	Die Verwendung des Glossars.

Antworten

Name	Typ	Beschreibung
200 OK	AtlasGlossary	Die Anforderung ist erfolgreich.
Other Status Codes	AtlasErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

OAuth2Auth

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
https://purview.azure.net/.default

Beispiele

Glossary_Create

Beispielanforderung

HTTP

POST {endpoint}/datamap/api/atlas/v2/glossary

{
  "name": "Glossary",
  "shortDescription": "Example Short Description",
  "longDescription": "Example Long Description",
  "language": "en",
  "usage": "Example Glossary"
}

Beispiel für eine Antwort

Statuscode:

200

{
  "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
  "qualifiedName": "Glossary",
  "name": "Glossary",
  "shortDescription": "Example Short Description",
  "longDescription": "Example Long Description",
  "lastModifiedTS": "1",
  "language": "en",
  "usage": "Example Glossary",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "createTime": 1672892675688,
  "updateTime": 1672892675688
}

Definitionen

Name	Beschreibung
AtlasClassification	Eine Instanz einer Klassifizierung; es hat keine Identität, dieses Objekt ist nur vorhanden, wenn es einer Entität zugeordnet ist.
AtlasErrorResponse	Eine Fehlerantwort des Diensts
AtlasGlossary	Das Glossarobjekt.
AtlasRelatedCategoryHeader	Die Kopfzeile der zugehörigen Kategorie.
AtlasRelatedTermHeader	Die Kopfzeile des zugehörigen Ausdrucks.
AtlasTermRelationshipStatus	Status für Atlas-Begriffsbeziehung
EntityStatus	Status – kann aktiv oder gelöscht werden
TimeBoundary	Erfasst Zeitbegrenzungsdetails

AtlasClassification

Objekt

Eine Instanz einer Klassifizierung; es hat keine Identität, dieses Objekt ist nur vorhanden, wenn es einer Entität zugeordnet ist.

Name	Typ	Beschreibung
attributes		Die Attribute der Struktur.
entityGuid	string	Die GUID der Entität.
entityStatus	EntityStatus	Status der Entität – kann aktiv oder gelöscht werden. Gelöschte Entitäten werden nicht entfernt.
lastModifiedTS	string	ETag für Parallelitätssteuerelement.
removePropagationsOnEntityDelete	boolean	Bestimmt, ob Verteilungen beim Löschen der Entität entfernt werden.
typeName	string	Der Name des Typs.
validityPeriods	TimeBoundary[]	Ein Array von Zeitgrenzen, das gültigkeitsperioden angibt.

AtlasErrorResponse

Objekt

Eine Fehlerantwort des Diensts

Name	Typ	Beschreibung
errorCode	string	Der Fehlercode.
errorMessage	string	Die Fehlermeldung.
requestId	string (uuid)	Die Anforderungs-ID.

AtlasGlossary

Objekt

Das Glossarobjekt.

Name	Typ	Beschreibung
categories	AtlasRelatedCategoryHeader[]	Ein Array von Kategorien.
classifications	AtlasClassification[]	Ein Array von Klassifizierungen.
createTime	integer (int64)	Die erstellte Zeit des Datensatzes.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
guid	string	Die GUID des Objekts.
language	string	Die Sprache des Glossars.
lastModifiedTS	string	ETag für Parallelitätssteuerelement.
longDescription	string	Die Beschreibung der langen Version.
name	string	Der Name des Glossarobjekts.
qualifiedName	string	Der qualifizierte Name des Glossarobjekts.
shortDescription	string	Die kurze Version der Beschreibung.
terms	AtlasRelatedTermHeader[]	Ein Array verwandter Ausdrucksheader.
updateTime	integer (int64)	Die Aktualisierungszeit des Datensatzes.
updatedBy	string	Der Benutzer, der den Datensatz aktualisiert hat.
usage	string	Die Verwendung des Glossars.

AtlasRelatedCategoryHeader

Objekt

Die Kopfzeile der zugehörigen Kategorie.

Name	Typ	Beschreibung
categoryGuid	string	Die GUID der Kategorie.
description	string	Die Beschreibung der Kategorieüberschrift.
displayText	string	Der Anzeigetext.
parentCategoryGuid	string	Die GUID der übergeordneten Kategorie.
relationGuid	string	Die GUID der Beziehung.

AtlasRelatedTermHeader

Objekt

Die Kopfzeile des zugehörigen Ausdrucks.

Name	Typ	Beschreibung
description	string	Die Beschreibung des zugehörigen Ausdrucks.
displayText	string	Der Anzeigetext.
expression	string	Der Ausdruck des Ausdrucks.
relationGuid	string	Die GUID der Beziehung.
status	AtlasTermRelationshipStatus	Der Status der Ausdrucksbeziehung.
steward	string	Der Steward des Begriffs.
termGuid	string	Die GUID des Ausdrucks.

AtlasTermRelationshipStatus

Enumeration

Status für Atlas-Begriffsbeziehung

Wert	Beschreibung
ACTIVE	aktiv
DEPRECATED	veraltet
DRAFT	Entwurf
OBSOLETE	obsolet
OTHER	andere

EntityStatus

Enumeration

Status – kann aktiv oder gelöscht werden

Wert	Beschreibung
ACTIVE	Der Status ist aktiv.
DELETED	Der Status wird gelöscht.

TimeBoundary

Objekt

Erfasst Zeitbegrenzungsdetails

Name	Typ	Beschreibung
endTime	string	Das Ende der Zeitgrenze.
startTime	string	Der Anfang der Zeitgrenze.
timeZone	string	Die Zeitzone der Zeitgrenze.