Glossary - Update Term

Referenz

Dienst:: Purview

API-Version:: 2023-09-01

Aktualisieren Sie den angegebenen Glossarbegriff anhand seiner GUID.

PUT {endpoint}/datamap/api/atlas/v2/glossary/term/{termId}

Mit optionalen Parametern:

PUT {endpoint}/datamap/api/atlas/v2/glossary/term/{termId}?api-version=2023-09-01&includeTermHierarchy={includeTermHierarchy}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string
termId	path	True	string	Der global eindeutige Bezeichner für den Glossarbegriff.
api-version	query		string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.
includeTermHierarchy	query		boolean	Gibt an, ob die Begriffshierarchie eingeschlossen wird.

Anforderungstext

Name	Typ	Beschreibung
abbreviation	string	Die Abkürzung des Begriffs.
anchor	AtlasGlossaryHeader	Der Glossarheader mit grundlegenden Informationen.
antonyms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsüberschriften als Antonyme.
assignedEntities	AtlasRelatedObjectId[]	Ein Array verwandter Objekt-IDs.
attributes	object	Die benutzerdefinierten Attribute des Begriffs, der zuordnungszeichenfolge<, map<string, object>> ist. Der Schlüssel der ersten Ebenenzuordnung ist der Name der Begriffsvorlage.
categories	AtlasTermCategorizationHeader[]	Ein Array von Begriffskategorisierungsheadern.
classifications	AtlasClassification[]	Ein Array von Klassifizierungen.
classifies	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader.
contacts	object	Das Wörterbuch der Kontakte für Begriffe. Der Schlüssel kann Expert oder Steward sein.
createTime	integer	Die Erstellungszeit des Datensatzes.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
examples	string[]	Ein Array von Beispielen.
guid	string	Die GUID des -Objekts.
hierarchyInfo	PurviewObjectId[]	Die Hierarchieinformationen des Begriffs.
isA	AtlasRelatedTermHeader[]	Ein Array verwandter Ausdrucksheader, die die Is-a-Beziehung angibt.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
longDescription	string	Die Beschreibung der langen Version.
name	string	Der Name des Glossarobjekts.
nickName	string	Der Spitzname des Begriffs.
preferredTerms	AtlasRelatedTermHeader[]	Ein Array bevorzugter verwandter Begriffsheader.
preferredToTerms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader, die bevorzugt werden.
qualifiedName	string	Der qualifizierte Name des Glossarobjekts.
replacedBy	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader, die durch ersetzt werden.
replacementTerms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader zum Ersetzen.
resources	ResourceLink[]	Ein Array von Ressourcenlinks für den Begriff
seeAlso	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader für siehe auch.
shortDescription	string	Die Kurzversion der Beschreibung.
status	TermStatus	Status des AtlasGlossaryTerm
synonyms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als Synonyme.
templateName	TemplateName[]	Der Name der Vorlage.
translatedTerms	AtlasRelatedTermHeader[]	Ein Array von übersetzten verwandten Begriffsüberschriften.
translationTerms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader für die Übersetzung.
updateTime	integer	Die Aktualisierungszeit des Datensatzes.
updatedBy	string	Der Benutzer, der den Datensatz aktualisiert hat.
usage	string	Die Verwendung des Begriffs.
validValues	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als gültige Werte.
validValuesFor	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als gültige Werte für andere Datensätze.

Antworten

Name	Typ	Beschreibung
200 OK	AtlasGlossaryTerm	Die Anforderung war erfolgreich.
Other Status Codes	AtlasErrorResponse	Eine 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_UpdateTerm

Beispielanforderung

HTTP

PUT {endpoint}/datamap/api/atlas/v2/glossary/term/54688d39-b298-4104-9e80-f2a16f44aaea?api-version=2023-09-01

{
  "guid": "54688d39-b298-4104-9e80-f2a16f44aaea",
  "qualifiedName": "ExampleTerm1@Glossary",
  "name": "ExampleTerm1",
  "shortDescription": "Example Short Description",
  "lastModifiedTS": "1",
  "abbreviation": "T1",
  "status": "Approved",
  "anchor": {
    "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
    "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0"
  },
  "resources": [
    {
      "displayName": "Example Display Name",
      "url": "Example Url"
    }
  ],
  "seeAlso": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008"
    },
    {
      "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18"
    }
  ],
  "synonyms": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008"
    },
    {
      "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "guid": "54688d39-b298-4104-9e80-f2a16f44aaea",
  "qualifiedName": "ExampleTerm1@Glossary",
  "name": "ExampleTerm1",
  "shortDescription": "Example Short Description",
  "lastModifiedTS": "1",
  "abbreviation": "T1",
  "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
  "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
  "createTime": 1606287247276,
  "updateTime": 1606287247276,
  "status": "Approved",
  "anchor": {
    "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
    "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0"
  },
  "seeAlso": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "dfa44030-bd14-4111-a0f1-3d01c964eb01",
      "displayText": "ExampleTerm2"
    },
    {
      "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18",
      "relationGuid": "4d802ada-65f3-45a8-969f-aba47d9c6200",
      "displayText": "ExampleTerm3"
    }
  ],
  "synonyms": [
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "15bcbd12-eb48-4b63-8ff5-74f7ec3a562c",
      "displayText": "ExampleTerm2"
    },
    {
      "termGuid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18",
      "relationGuid": "bb26fe7c-6e26-46ad-b936-50a5f7ffbbaf",
      "displayText": "ExampleTerm3"
    }
  ],
  "resources": [
    {
      "displayName": "Example Display Name",
      "url": "Example Url"
    }
  ]
}

Definitionen

Name	Beschreibung
AtlasClassification	Ein instance einer Klassifizierung. Es verfügt über keine Identität, dieses Objekt ist nur vorhanden, wenn es einer Entität zugeordnet ist.
AtlasErrorResponse	Eine Fehlerantwort des Diensts
AtlasGlossaryHeader	Der Glossarheader mit grundlegenden Informationen.
AtlasGlossaryTerm	Der Glossarbegriff.
AtlasRelatedObjectId	Verweis auf ein Objekt-instance des AtlasEntity-Typs, der in Beziehungsattributwerten verwendet wird
AtlasRelatedTermHeader	Der Header des zugehörigen Begriffs.
AtlasStruct	Erfasst Details des Strukturinhalts. Nicht direkt instanziiert, wird nur über AtlasEntity, AtlasClassification verwendet.
AtlasTermCategorizationHeader	Die grundlegenden Informationen zur Begriffskategorisierung.
AtlasTermRelationshipStatus	Status für Atlas-Ausdrucksbeziehung
EntityStatus	Status: kann aktiv oder gelöscht werden
PurviewObjectId	PurviewObjectId
ResourceLink	ResourceLink
StatusAtlasRelationship	Status für atlas-Beziehung
TermStatus	Status für Begriff
TimeBoundary	Erfasst Details zur Zeitgrenze

AtlasClassification

Ein instance einer Klassifizierung. Es verfügt über 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 sein. Gelöschte Entitäten werden nicht entfernt.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
removePropagationsOnEntityDelete	boolean	Bestimmt, ob Weitergaben beim Löschen von Entitäten entfernt werden.
typeName	string	Der Name des Typs.
validityPeriods	TimeBoundary[]	Ein Array von Zeitgrenzen, die Gültigkeitsdauern angeben.

AtlasErrorResponse

Eine Fehlerantwort des Diensts

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

AtlasGlossaryHeader

Der Glossarheader mit grundlegenden Informationen.

Name	Typ	Beschreibung
displayText	string	Der Anzeigetext.
glossaryGuid	string	Die GUID des Glossars.
relationGuid	string	Die GUID der Beziehung.

AtlasGlossaryTerm

Der Glossarbegriff.

Name	Typ	Beschreibung
abbreviation	string	Die Abkürzung des Begriffs.
anchor	AtlasGlossaryHeader	Der Glossarheader mit grundlegenden Informationen.
antonyms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als Antonyme.
assignedEntities	AtlasRelatedObjectId[]	Ein Array verwandter Objekt-IDs.
attributes	object	Die benutzerdefinierten Attribute des Begriffs, der map<string, map<string, object>> ist. Der Schlüssel der ersten Ebenenzuordnung ist der Begriff Vorlagenname.
categories	AtlasTermCategorizationHeader[]	Ein Array von Begriffskategorisierungsheadern.
classifications	AtlasClassification[]	Ein Array von Klassifizierungen.
classifies	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader.
contacts	object	Das Wörterbuch der Kontakte für Begriffe. Schlüssel kann Expert oder Steward sein.
createTime	integer	Die erstellungszeit des Datensatzes.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
examples	string[]	Ein Array von Beispielen.
guid	string	Die GUID des -Objekts.
hierarchyInfo	PurviewObjectId[]	Die Hierarchieinformationen des Begriffs.
isA	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader, die die Is-a-Beziehung angibt.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
longDescription	string	Die Beschreibung der langen Version.
name	string	Der Name des Glossarobjekts.
nickName	string	Der Spitzname des Begriffs.
preferredTerms	AtlasRelatedTermHeader[]	Ein Array bevorzugter verwandter Begriffsheader.
preferredToTerms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader, die bevorzugt werden.
qualifiedName	string	Der qualifizierte Name des Glossarobjekts.
replacedBy	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader, die durch ersetzt werden.
replacementTerms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader zur Ersetzung.
resources	ResourceLink[]	Ein Array von Ressourcenlinks für den Begriff
seeAlso	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader für siehe auch.
shortDescription	string	Die Kurzversion der Beschreibung.
status	TermStatus	Status des AtlasGlossaryTerm
synonyms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als Synonyme.
templateName	TemplateName[]	Der Name der Vorlage.
translatedTerms	AtlasRelatedTermHeader[]	Ein Array von übersetzten verwandten Begriffsheadern.
translationTerms	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader für die Übersetzung.
updateTime	integer	Die Aktualisierungszeit des Datensatzes.
updatedBy	string	Der Benutzer, der den Datensatz aktualisiert hat.
usage	string	Die Verwendung des Begriffs.
validValues	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als gültige Werte.
validValuesFor	AtlasRelatedTermHeader[]	Ein Array verwandter Begriffsheader als gültige Werte für andere Datensätze.

AtlasRelatedObjectId

Verweis auf ein Objekt-instance des AtlasEntity-Typs, der in Beziehungsattributwerten verwendet wird

Name	Typ	Beschreibung
displayText	string	Der Anzeigetext.
entityStatus	EntityStatus	Status der Entität – kann aktiv oder gelöscht sein. Gelöschte Entitäten werden nicht entfernt.
guid	string	Die GUID des -Objekts.
relationshipAttributes	AtlasStruct	Erfasst Details des Strukturinhalts. Nicht direkt instanziiert, wird nur über AtlasEntity, AtlasClassification verwendet.
relationshipGuid	string	Die GUID der Beziehung.
relationshipStatus	StatusAtlasRelationship	Die Enumeration der Beziehung status.
relationshipType	string	Beziehungstyp
typeName	string	Der Name des Typs.
uniqueAttributes		Die eindeutigen Attribute des Objekts.

AtlasRelatedTermHeader

Der Header des zugehörigen Begriffs.

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

AtlasStruct

Erfasst Details des Strukturinhalts. Nicht direkt instanziiert, wird nur über AtlasEntity, AtlasClassification verwendet.

Name	Typ	Beschreibung
attributes		Die Attribute der Struktur.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
typeName	string	Der Name des Typs.

AtlasTermCategorizationHeader

Die grundlegenden Informationen zur Begriffskategorisierung.

Name	Typ	Beschreibung
categoryGuid	string	Die GUID der Kategorie.
description	string	Die Beschreibung des Datensatzes.
displayText	string	Der Anzeigetext.
relationGuid	string	Die GUID der Beziehung.
status	AtlasTermRelationshipStatus	Die status der Begriffsbeziehung.

AtlasTermRelationshipStatus

Status für Atlas-Ausdrucksbeziehung

Name	Typ	Beschreibung
ACTIVE	string	aktiv
DEPRECATED	string	deprecated
DRAFT	string	Entwurf
OBSOLETE	string	Veraltet
OTHER	string	Andere

EntityStatus

Status: kann aktiv oder gelöscht werden

Name	Typ	Beschreibung
ACTIVE	string	Die status ist aktiv.
DELETED	string	Die status wird gelöscht.

PurviewObjectId

Name	Typ	Beschreibung
displayText	string	Anzeigetext
guid	string	Die GUID des -Objekts.
itemPath	string	Elementpfad
name	string	Name
properties		Wörterbuch von
resourceId	string	Ressourcen-ID
typeName	string	Der Name des Typs.
uniqueAttributes		Die eindeutigen Attribute des Objekts.

ResourceLink

Name	Typ	Beschreibung
displayName	string	Anzeigename für URL.
url	string	Web-URL. HTTP oder HTTPS

StatusAtlasRelationship

Status für atlas-Beziehung

Name	Typ	Beschreibung
ACTIVE	string	aktiv
DELETED	string	deleted

TermStatus

Status für Begriff

Name	Typ	Beschreibung
Alert	string	Warnung
Approved	string	Genehmigt
Draft	string	Entwurf
Expired	string	Abgelaufen

TimeBoundary

Erfasst Details zur Zeitgrenze

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

Freigeben über