Glossary - Update

Référence

Service:: Purview

Version d'API:: 2023-09-01

Mettez à jour le glossaire donné.

PUT {endpoint}/datamap/api/atlas/v2/glossary/{glossaryId}

Avec des paramètres facultatifs:

PUT {endpoint}/datamap/api/atlas/v2/glossary/{glossaryId}?api-version=2023-09-01&ignoreTermsAndCategories={ignoreTermsAndCategories}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string
glossaryId	path	True	string	Identificateur global unique pour le glossaire.
api-version	query		string	Version de l’API à utiliser pour cette opération.
ignoreTermsAndCategories	query		boolean	Indique si les termes et les catégories sont ignorés

Corps de la demande

Nom	Type	Description
categories	AtlasRelatedCategoryHeader[]	Tableau de catégories.
classifications	AtlasClassification[]	Tableau de classifications.
createTime	integer	Heure de création de l’enregistrement.
createdBy	string	Utilisateur qui a créé l’enregistrement.
guid	string	GUID de l’objet .
language	string	Langue du glossaire.
lastModifiedTS	string	ETag pour le contrôle d’accès concurrentiel.
longDescription	string	Description de la version longue.
name	string	Nom de l’objet glossaire.
qualifiedName	string	Nom qualifié de l’objet glossaire.
shortDescription	string	Version courte de la description.
terms	AtlasRelatedTermHeader[]	Tableau d’en-têtes de termes associés.
updateTime	integer	Heure de mise à jour de l’enregistrement.
updatedBy	string	Utilisateur qui a mis à jour l’enregistrement.
usage	string	Utilisation du glossaire.

Réponses

Nom	Type	Description
200 OK	AtlasGlossary	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

Glossary_Update

Exemple de requête

HTTP

PUT {endpoint}/datamap/api/atlas/v2/glossary/c018ddaf-7c21-4b37-a838-dae5f110c3d8?api-version=2023-09-01

{
  "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",
  "terms": [
    {
      "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea",
      "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0",
      "displayText": "ExampleTerm1"
    },
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189",
      "displayText": "ExampleTerm2"
    }
  ],
  "categories": [
    {
      "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e",
      "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12",
      "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2",
      "displayText": "ExampleCategory3"
    },
    {
      "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12",
      "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a",
      "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0",
      "displayText": "ExampleCategory1"
    },
    {
      "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a",
      "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d",
      "displayText": "ExampleCategory2"
    }
  ]
}

Exemple de réponse

Code d’état:: 200

{
  "guid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
  "qualifiedName": "Glossary",
  "name": "Glossary",
  "shortDescription": "Example Short Description",
  "longDescription": "Example Long Description",
  "lastModifiedTS": "2",
  "language": "en",
  "usage": "Example Glossary",
  "createdBy": "ExampleCreator",
  "updatedBy": "ExampleUpdator",
  "createTime": 1672892675600,
  "updateTime": 1672892675688,
  "terms": [
    {
      "termGuid": "54688d39-b298-4104-9e80-f2a16f44aaea",
      "relationGuid": "7b6a8149-a928-476a-a068-dce58653cfa0",
      "displayText": "ExampleTerm1"
    },
    {
      "termGuid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
      "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189",
      "displayText": "ExampleTerm2"
    }
  ],
  "categories": [
    {
      "categoryGuid": "0d6766f6-f4b6-435b-bda2-d3edc358998e",
      "parentCategoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12",
      "relationGuid": "26a486a4-a8e2-483c-8a84-3b88e909f8d2",
      "displayText": "ExampleCategory3"
    },
    {
      "categoryGuid": "ed7458f0-9463-48a5-b5c6-4f785fb34e12",
      "parentCategoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a",
      "relationGuid": "7bdcef93-a57a-4d1d-95ab-9d3036f394a0",
      "displayText": "ExampleCategory1"
    },
    {
      "categoryGuid": "e47c4584-daca-4f9e-9092-194e04692c9a",
      "relationGuid": "94071e56-fd3e-4441-93ff-1834f818482d",
      "displayText": "ExampleCategory2"
    }
  ]
}

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é.
AtlasErrorResponse	Réponse d’erreur du service
AtlasGlossary	Objet glossaire.
AtlasRelatedCategoryHeader	En-tête de la catégorie associée.
AtlasRelatedTermHeader	En-tête du terme associé.
AtlasTermRelationshipStatus	État de la relation de termes atlas
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 de l’entité.
typeName	string	Nom du type.
validityPeriods	TimeBoundary[]	Tableau de limites de temps indiquant des périodes de validité.

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.

AtlasGlossary

Objet glossaire.

Nom	Type	Description
categories	AtlasRelatedCategoryHeader[]	Tableau de catégories.
classifications	AtlasClassification[]	Tableau de classifications.
createTime	integer	Heure de création de l’enregistrement.
createdBy	string	Utilisateur qui a créé l’enregistrement.
guid	string	GUID de l’objet .
language	string	Langue du glossaire.
lastModifiedTS	string	ETag pour le contrôle d’accès concurrentiel.
longDescription	string	Description de la version longue.
name	string	Nom de l’objet glossaire.
qualifiedName	string	Nom qualifié de l’objet glossaire.
shortDescription	string	Version courte de la description.
terms	AtlasRelatedTermHeader[]	Tableau d’en-têtes de termes associés.
updateTime	integer	Heure de mise à jour de l’enregistrement.
updatedBy	string	Utilisateur qui a mis à jour l’enregistrement.
usage	string	Utilisation du glossaire.

AtlasRelatedCategoryHeader

En-tête de la catégorie associée.

Nom	Type	Description
categoryGuid	string	GUID de la catégorie.
description	string	Description de l’en-tête de catégorie.
displayText	string	Texte d’affichage.
parentCategoryGuid	string	GUID de la catégorie parente.
relationGuid	string	GUID de la relation.

AtlasRelatedTermHeader

En-tête du terme associé.

Nom	Type	Description
description	string	Description du terme associé.
displayText	string	Texte d’affichage.
expression	string	Expression du terme.
relationGuid	string	GUID de la relation.
status	AtlasTermRelationshipStatus	Status de la relation de terme.
steward	string	Intendant du terme.
termGuid	string	GUID du terme.

AtlasTermRelationshipStatus

État de la relation de termes atlas

Nom	Type	Description
ACTIVE	string	active
DEPRECATED	string	déprécié
DRAFT	string	Projet
OBSOLETE	string	obsolète
OTHER	string	Autres

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.

Partager via