Relationship - Create

Referenz

Dienst:: Purview

API-Version:: 2023-09-01

Erstellen Sie eine neue Beziehung zwischen Entitäten.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string

Anforderungstext

Name	Typ	Beschreibung
attributes		Die Attribute der Struktur.
createTime	integer	Die Erstellungszeit des Datensatzes.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
end1	AtlasObjectId	Verweis auf eine Objekt-instance eines Typs , z. B. entität.
end2	AtlasObjectId	Verweis auf eine Objekt-instance eines Typs , z. B. entität.
guid	string	Die GUID der Beziehung.
homeId	string	Die Start-ID der Beziehung.
label	string	Die Bezeichnung der Beziehung.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
provenanceType	integer	Wird verwendet, um die Herkunft einer instance einer Entität oder Beziehung aufzuzeichnen.
status	StatusAtlasRelationship	Die Enumeration der Beziehung status.
typeName	string	Der Name des Typs.
updateTime	integer	Die Aktualisierungszeit des Datensatzes.
updatedBy	string	Der Benutzer, der den Datensatz aktualisiert hat.
version	integer	Die Version der Beziehung.

Antworten

Name	Typ	Beschreibung
200 OK	AtlasRelationship	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

Relationship_Create

Beispielanforderung

HTTP

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

{
  "typeName": "AtlasGlossarySynonym",
  "attributes": {
    "expression": "Example Expression",
    "steward": "Example Steward",
    "description": "Example Description",
    "source": null,
    "status": null
  },
  "end1": {
    "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6",
    "typeName": "AtlasGlossaryTerm"
  },
  "end2": {
    "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa",
    "typeName": "AtlasGlossaryTerm"
  },
  "label": "r:AtlasGlossarySynonym",
  "status": "ACTIVE",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "version": 0
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "typeName": "AtlasGlossarySynonym",
  "attributes": {
    "expression": "Example Expression",
    "steward": "Example Steward",
    "description": "Example Description",
    "source": null,
    "status": null
  },
  "guid": "63023d5b-c499-4360-a513-16bcbf73b039",
  "end1": {
    "guid": "856d31e6-e342-a1ce-6273-22ddb77029c6",
    "typeName": "AtlasGlossaryTerm"
  },
  "end2": {
    "guid": "77481037-2874-9bdc-9b9e-76bb94ee71aa",
    "typeName": "AtlasGlossaryTerm"
  },
  "label": "r:AtlasGlossarySynonym",
  "status": "ACTIVE",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "createTime": 1553840134724,
  "updateTime": 1553840134724,
  "version": 0
}

Definitionen

Name	Beschreibung
AtlasErrorResponse	Eine Fehlerantwort des Diensts
AtlasObjectId	Verweis auf eine Objekt-instance eines Typs , z. B. entität.
AtlasRelationship	Atlas-Beziehung instance.
StatusAtlasRelationship	Status für atlas-Beziehung

AtlasErrorResponse

Eine Fehlerantwort des Diensts

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

AtlasObjectId

Verweis auf eine Objekt-instance eines Typs , z. B. entität.

Name	Typ	Beschreibung
guid	string	Die GUID des -Objekts.
typeName	string	Der Name des Typs.
uniqueAttributes		Die eindeutigen Attribute des Objekts.

AtlasRelationship

Atlas-Beziehung instance.

Name	Typ	Beschreibung
attributes		Die Attribute der Struktur.
createTime	integer	Die Erstellungszeit des Datensatzes.
createdBy	string	Der Benutzer, der den Datensatz erstellt hat.
end1	AtlasObjectId	Verweis auf eine Objekt-instance eines Typs , z. B. entität.
end2	AtlasObjectId	Verweis auf eine Objekt-instance eines Typs , z. B. entität.
guid	string	Die GUID der Beziehung.
homeId	string	Die Start-ID der Beziehung.
label	string	Die Bezeichnung der Beziehung.
lastModifiedTS	string	ETag für die Parallelitätssteuerung.
provenanceType	integer	Wird verwendet, um die Herkunft einer instance einer Entität oder Beziehung aufzuzeichnen.
status	StatusAtlasRelationship	Die Enumeration der Beziehung status.
typeName	string	Der Name des Typs.
updateTime	integer	Die Aktualisierungszeit des Datensatzes.
updatedBy	string	Der Benutzer, der den Datensatz aktualisiert hat.
version	integer	Die Version der Beziehung.

StatusAtlasRelationship

Status für atlas-Beziehung

Name	Typ	Beschreibung
ACTIVE	string	aktiv
DELETED	string	deleted

Freigeben über