Entity - Partial Update By Unique Attributes

Service:

Purview

Version d'API:

2023-09-01

Mettre à jour partiellement l’entité : autorise la mise à jour d’un sous-ensemble d’attributs sur une entité identifiée par son type et son attribut unique, par exemple : Referenceable.qualifiedName. Les mises à jour Null ne sont pas possibles.

En plus du paramètre de chemin d’accès typeName, la ou les paires clé-valeur d’attribut peuvent être fournies au format suivant :

attr :=. REMARQUE : attrName et attrValue doivent être uniques entre les entités, par exemple. qualifiedName.

La requête REST ressemblerait à ceci : PUT /v2/entity/uniqueAttribute/type/aType ?attr :aTypeAttribute=someValue.

PUT {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}

Avec des paramètres facultatifs:

PUT {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/{typeName}?attr:qualifiedName={attr:qualifiedName}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string
typeName	path	True	string	Nom du type.
attr:qualifiedName	query		string	Nom qualifié de l’entité. (Il ne s’agit que d’un exemple. qualifiedName peut être remplacé par d’autres attributs uniques)

Corps de la demande

Nom	Type	Description
entity	AtlasEntity	Instance d’une entité, comme hive_table, hive_database.
referredEntities	<string,  AtlasEntity>	Entités référencées.

Réponses

Nom	Type	Description
200 OK	EntityMutationResult	La demande a réussi.
Other Status Codes	AtlasErrorResponse	Réponse d’erreur inattendue.

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
https://purview.azure.net/.default

Exemples

Entity_PartialUpdateByUniqueAttributes

Exemple de requête

HTTP

PUT {endpoint}/datamap/api/atlas/v2/entity/uniqueAttribute/type/azure_storage_account?attr:qualifiedName=https://exampleaccount.core.windows.net

{
  "entity": {
    "createTime": 1605766397985,
    "createdBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7",
    "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0",
    "relationshipAttributes": {
      "services": [],
      "meanings": []
    },
    "status": "ACTIVE",
    "updateTime": 1605766397985,
    "updatedBy": "8c062c84-5d25-449f-a990-9d8ab70b8ec7",
    "lastModifiedTS": "1",
    "version": 0,
    "attributes": {
      "owner": "ExampleOwner",
      "qualifiedName": "https://exampleaccount.core.windows.net",
      "createTime": 0,
      "name": "ExampleNewName"
    },
    "typeName": "azure_storage_account"
  },
  "referredEntities": {}
}

Exemple de réponse

Code d’état:

200

{
  "guidAssignments": {},
  "mutatedEntities": {
    "PARTIAL_UPDATE": [
      {
        "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0",
        "lastModifiedTS": "2",
        "attributes": {
          "qualifiedName": "https://exampleaccount.core.windows.net"
        },
        "typeName": "azure_storage_account"
      }
    ]
  },
  "partialUpdatedEntities": [
    {
      "guid": "dc507ccf-0c57-4165-9327-f37b0d13fda0",
      "lastModifiedTS": "2",
      "attributes": {
        "qualifiedName": "https://exampleaccount.core.windows.net"
      },
      "typeName": "azure_storage_account"
    }
  ]
}

Définitions

Nom	Description
AtlasClassification	Un instance d’une classification ; il n’a pas d’identité, cet objet existe uniquement lorsqu’il est associé à une entité.
AtlasEntity	Instance d’une entité, comme hive_table, hive_database.
AtlasEntityHeader	Instance d’une entité, comme hive_table, hive_database.
AtlasEntityWithExtInfo	Une instance d’une entité avec des informations étendues, comme hive_table, hive_database.
AtlasErrorResponse	Réponse d’erreur du service
AtlasTermAssignmentHeader	En-tête de l’attribution de terme.
AtlasTermAssignmentStatus	État de l’attribution de terme
EntityMutationResult	Résultat de la réponse de mutation de l’entité.
EntityStatus	État : peut être actif ou supprimé
TimeBoundary	Capture les détails de la limite de temps

AtlasClassification

Un instance d’une classification ; il n’a pas d’identité, cet objet existe uniquement lorsqu’il est associé à une entité.

Nom	Type	Description
attributes		Attributs du struct.
entityGuid	string	GUID de l’entité.
entityStatus	EntityStatus	État de l’entité : peut être actif ou supprimé. Les entités supprimées ne sont pas supprimées.
lastModifiedTS	string	ETag pour le contrôle d’accès concurrentiel.
removePropagationsOnEntityDelete	boolean	Détermine si les propagations seront supprimées lors de la suppression d’entité.
typeName	string	Nom du type.
validityPeriods	TimeBoundary[]	Tableau de limites de temps indiquant des périodes de validité.

AtlasEntity

Instance d’une entité, comme hive_table, hive_database.

Nom	Type	Description
attributes		Attributs du struct.
businessAttributes		Attributs métier
classifications	AtlasClassification[]	Tableau de classifications.
collectionId	string	ID de collection de l’entité.
contacts	object	Dictionnaire des contacts pour les entités. La clé peut être Expert ou Owner.
createTime	integer	Heure de création de l’enregistrement.
createdBy	string	Utilisateur qui a créé l’enregistrement.
customAttributes	object	Attribut personnalisé
guid	string	GUID de l’entité.
homeId	string	ID d’origine de l’entité.
isIncomplete	boolean	S’il s’agit d’une entité shell
labels	string[]	étiquettes
lastModifiedTS	string	ETag pour le contrôle d’accès concurrentiel.
meanings	AtlasTermAssignmentHeader[]	Tableau d’en-têtes d’affectation de termes indiquant les significations de l’entité.
provenanceType	integer	Permet d’enregistrer la provenance d’un instance d’une entité ou d’une relation.
proxy	boolean	Détermine s’il existe un proxy.
relationshipAttributes		Attributs de la relation.
status	EntityStatus	État de l’entité : peut être actif ou supprimé. Les entités supprimées ne sont pas supprimées.
typeName	string	Nom du type.
updateTime	integer	Heure de mise à jour de l’enregistrement.
updatedBy	string	Utilisateur qui a mis à jour l’enregistrement.
version	integer	Version de l’entité.

AtlasEntityHeader

Instance d’une entité, comme hive_table, hive_database.

Nom	Type	Description
attributes		Attributs du struct.
classificationNames	string[]	Tableau de noms de classification.
classifications	AtlasClassification[]	Tableau de classifications.
displayText	string	Texte d’affichage.
guid	string	GUID de l’enregistrement.
isIncomplete	boolean	S’il s’agit d’une entité shell
labels	string[]	étiquettes
lastModifiedTS	string	ETag pour le contrôle d’accès concurrentiel.
meaningNames	string[]	Tableau de significations.
meanings	AtlasTermAssignmentHeader[]	Tableau d’en-têtes d’affectation de terme.
status	EntityStatus	État de l’entité : peut être actif ou supprimé. Les entités supprimées ne sont pas supprimées.
typeName	string	Nom du type.

AtlasEntityWithExtInfo

Une instance d’une entité avec des informations étendues, comme hive_table, hive_database.

Nom	Type	Description
entity	AtlasEntity	Instance d’une entité, comme hive_table, hive_database.
referredEntities	<string,  AtlasEntity>	Entités référencées.

AtlasErrorResponse

Réponse d’erreur du service

Nom	Type	Description
errorCode	string	Code d'erreur.
errorMessage	string	Message d’erreur.
requestId	string	ID de demande.

AtlasTermAssignmentHeader

En-tête de l’attribution de terme.

Nom	Type	Description
confidence	integer	Confiance de l’affectation de terme.
createdBy	string	Utilisateur qui a créé l’enregistrement.
description	string	Description de l’affectation de terme.
displayText	string	Texte d’affichage.
expression	string	Expression de l’affectation de terme.
relationGuid	string	GUID de la relation.
status	AtlasTermAssignmentStatus	Status de l’attribution de termes.
steward	string	Intendant du terme.
termGuid	string	GUID du terme.

AtlasTermAssignmentStatus

État de l’attribution de terme

Nom	Type	Description
DEPRECATED	string	Le status est déconseillé.
DISCOVERED	string	Le status est découvert.
IMPORTED	string	Le status est importé.
OBSOLETE	string	Le status est obsolète.
OTHER	string	Autres status.
PROPOSED	string	Le status est proposé.
VALIDATED	string	Le status est validé.

EntityMutationResult

Résultat de la réponse de mutation de l’entité.

Nom	Type	Description
guidAssignments	object	Mappage des affectations GUID avec des entités.
mutatedEntities	object	En-têtes d’entité d’entités mutées.
partialUpdatedEntities	AtlasEntityHeader[]	Tableau d’en-têtes d’entité partiellement mis à jour.

EntityStatus

État : peut être actif ou supprimé

Nom	Type	Description
ACTIVE	string	Le status est actif.
DELETED	string	Le status est supprimé.

TimeBoundary

Capture les détails de la limite de temps

Nom	Type	Description
endTime	string	Fin de la limite de temps.
startTime	string	Début de la limite de temps.
timeZone	string	Fuseau horaire de la limite de temps.