Freigeben über

Relationship - Create

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 (uri)

Anforderungstext

Name Typ Beschreibung
attributes

Die Attribute der Struktur.
createTime

integer (int64)

Die erstellte Zeit des Datensatzes.
createdBy

string

Der Benutzer, der den Datensatz erstellt hat.
end1

AtlasObjectId

Verweisen auf eine Objektinstanz eines Typs – z. B. Entität.
end2

AtlasObjectId

Verweisen auf eine Objektinstanz 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 Parallelitätssteuerelement.
provenanceType

integer (int32)

Wird verwendet, um die Provenienz einer Instanz einer Entität oder Beziehung aufzuzeichnen.
status

StatusAtlasRelationship

Die Enumeration des Beziehungsstatus.
typeName

string

Der Name des Typs.
updateTime

integer (int64)

Die Aktualisierungszeit des Datensatzes.
updatedBy

string

Der Benutzer, der den Datensatz aktualisiert hat.
version

integer (int64)

Die Version der Beziehung.

Antworten

Name Typ Beschreibung
200 OK

AtlasRelationship

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

Relationship_Create

Beispielanforderung

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

Verweisen auf eine Objektinstanz eines Typs – z. B. Entität.
AtlasRelationship

Atlas-Beziehungsinstanz.
StatusAtlasRelationship

Status für Atlas-Beziehung

AtlasErrorResponse

Objekt

Eine Fehlerantwort des Diensts

Name Typ Beschreibung
errorCode

string

Der Fehlercode.
errorMessage

string

Die Fehlermeldung.
requestId

string (uuid)

Die Anforderungs-ID.

AtlasObjectId

Objekt

Verweisen auf eine Objektinstanz 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

Objekt

Atlas-Beziehungsinstanz.

Name Typ Beschreibung
attributes

Die Attribute der Struktur.
createTime

integer (int64)

Die erstellte Zeit des Datensatzes.
createdBy

string

Der Benutzer, der den Datensatz erstellt hat.
end1

AtlasObjectId

Verweisen auf eine Objektinstanz eines Typs – z. B. Entität.
end2

AtlasObjectId

Verweisen auf eine Objektinstanz 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 Parallelitätssteuerelement.
provenanceType

integer (int32)

Wird verwendet, um die Provenienz einer Instanz einer Entität oder Beziehung aufzuzeichnen.
status

StatusAtlasRelationship

Die Enumeration des Beziehungsstatus.
typeName

string

Der Name des Typs.
updateTime

integer (int64)

Die Aktualisierungszeit des Datensatzes.
updatedBy

string

Der Benutzer, der den Datensatz aktualisiert hat.
version

integer (int64)

Die Version der Beziehung.

StatusAtlasRelationship

Enumeration

Status für Atlas-Beziehung

Wert Beschreibung
ACTIVE

aktiv
DELETED

gelöscht