Поделиться через

Glossary - Create Terms

  • Ссылка
Служба:
Purview
Версия API:
2023-09-01

Массовое создание терминов глоссария.

POST {endpoint}/datamap/api/atlas/v2/glossary/terms
С использованием необязательных параметров: 
POST {endpoint}/datamap/api/atlas/v2/glossary/terms?api-version=2023-09-01&includeTermHierarchy={includeTermHierarchy}

Параметры URI

Имя В Обязательно Тип Описание
endpoint
 path True

string

api-version
 query

string

Версия API, используемая для данной операции.
includeTermHierarchy
 query

boolean

Указывает, включена ли иерархия терминов

Текст запроса

Имя Тип Описание
body

AtlasGlossaryTerm[]

Массив определений терминов глоссария, создаваемых в массовом режиме.

Ответы

Имя Тип Описание
200 OK

AtlasGlossaryTerm[]

Запрос выполнен успешно.
Other Status Codes

AtlasErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

OAuth2Auth

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
https://purview.azure.net/.default

Примеры

Glossary_CreateTerms

Образец запроса

POST {endpoint}/datamap/api/atlas/v2/glossary/terms?api-version=2023-09-01

[
  {
    "anchor": {
      "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8"
    },
    "name": "ExampleTerm2",
    "status": "Approved",
    "shortDescription": "Example Short Description",
    "longDescription": "Example Long Description",
    "abbreviation": "T2",
    "resources": [
      {
        "displayName": "Example Display Name",
        "url": "Example Url"
      }
    ]
  },
  {
    "anchor": {
      "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8"
    },
    "name": "ExampleTerm3",
    "status": "Approved",
    "shortDescription": "Example Short Description",
    "longDescription": "Example Long Description",
    "abbreviation": "T3",
    "resources": [
      {
        "displayName": "Example Display Name",
        "url": "Example Url"
      }
    ]
  }
]

Пример ответа

Код состояния:
200 
[
  {
    "guid": "952c7ba4-4c89-42d8-a05a-7d2161be7008",
    "qualifiedName": "ExampleTerm2@Glossary",
    "name": "ExampleTerm2",
    "shortDescription": "Example Short Description",
    "lastModifiedTS": "1",
    "abbreviation": "T2",
    "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
    "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
    "createTime": 1606287312495,
    "updateTime": 1606287312495,
    "status": "Approved",
    "anchor": {
      "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
      "relationGuid": "9385640b-e6be-437d-a6b9-62d11c14a189"
    },
    "resources": [
      {
        "displayName": "Example Display Name",
        "url": "Example Url"
      }
    ]
  },
  {
    "guid": "821beef0-ced9-47ba-8f7f-c4f3459f4d18",
    "qualifiedName": "ExampleTerm3@Glossary",
    "name": "ExampleTerm3",
    "shortDescription": "Example Short Description",
    "lastModifiedTS": "1",
    "abbreviation": "T3",
    "createdBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
    "updatedBy": "23863cef-a2e9-40a3-a427-44dc0d201f61",
    "createTime": 1606287312495,
    "updateTime": 1606287312495,
    "status": "Approved",
    "anchor": {
      "glossaryGuid": "c018ddaf-7c21-4b37-a838-dae5f110c3d8",
      "relationGuid": "f4de4878-3e43-4f8b-b090-07a233bb0ce6"
    },
    "resources": [
      {
        "displayName": "Example Display Name",
        "url": "Example Url"
      }
    ]
  }
]

Определения

Имя Описание
AtlasClassification

Экземпляр классификации; у него нет удостоверения, этот объект существует только в том случае, если он связан с сущностью.
AtlasErrorResponse

Ответ об ошибке от службы
AtlasGlossaryHeader

Заголовок глоссария с основными сведениями.
AtlasGlossaryTerm

Термин глоссария.
AtlasRelatedObjectId

Ссылка на экземпляр объекта типа AtlasEntity, используемого в значениях атрибута связи
AtlasRelatedTermHeader

Заголовок связанного термина.
AtlasStruct

Записывает сведения о содержимом структуры. Экземпляр не создается напрямую, используется только через AtlasEntity, AtlasClassification.
AtlasTermCategorizationHeader

Основные сведения для классификации терминов.
AtlasTermRelationshipStatus

Состояние связи терминов atlas
EntityStatus

Состояние — может быть активным или удаленным
PurviewObjectId

PurviewObjectId
ResourceLink

ResourceLink
StatusAtlasRelationship

Состояние связи atlas
TermStatus

Состояние для термина
TimeBoundary

Фиксирует сведения о границах времени

AtlasClassification

Экземпляр классификации; у него нет удостоверения, этот объект существует только в том случае, если он связан с сущностью.

Имя Тип Описание
attributes

Атрибуты структуры.
entityGuid

string

GUID сущности.
entityStatus

EntityStatus

Состояние сущности — может быть активным или удаленным. Удаленные сущности не удаляются.
lastModifiedTS

string

ETag для управления параллелизмом.
removePropagationsOnEntityDelete

boolean

Определяет, будет ли распространение удалено при удалении сущности.
typeName

string

Имя типа.
validityPeriods

TimeBoundary[]

Массив временных границ, указывающих срок действия.

AtlasErrorResponse

Ответ об ошибке от службы

Имя Тип Описание
errorCode

string

Код ошибки.
errorMessage

string

Сообщение об ошибке.
requestId

string

Идентификатор запроса.

AtlasGlossaryHeader

Заголовок глоссария с основными сведениями.

Имя Тип Описание
displayText

string

Отображаемый текст.
glossaryGuid

string

GUID глоссария.
relationGuid

string

GUID связи.

AtlasGlossaryTerm

Термин глоссария.

Имя Тип Описание
abbreviation

string

Аббревиатура термина.
anchor

AtlasGlossaryHeader

Заголовок глоссария с основными сведениями.
antonyms

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов в виде антонимов.
assignedEntities

AtlasRelatedObjectId[]

Массив связанных идентификаторов объектов.
attributes

object

Настраиваемые атрибуты термина, который является строкой карты<, строкой карты<, объектом>>. Ключом карты первого слоя является имя шаблона термина.
categories

AtlasTermCategorizationHeader[]

Массив заголовков категоризации терминов.
classifications

AtlasClassification[]

Массив классификаций.
classifies

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов.
contacts

object

Словарь контактов для терминов. Ключом может быть эксперт или стюард.
createTime

integer

Время создания записи.
createdBy

string

Пользователь, создавший запись.
examples

string[]

Массив примеров.
guid

string

GUID объекта .
hierarchyInfo

PurviewObjectId[]

Сведения об иерархии термина.
isA

AtlasRelatedTermHeader[]

Массив заголовков связанных терминов, указывающих связь is-a.
lastModifiedTS

string

ETag для управления параллелизмом.
longDescription

string

Подробное описание версии.
name

string

Имя объекта глоссария.
nickName

string

Название термина.
preferredTerms

AtlasRelatedTermHeader[]

Массив предпочтительных связанных заголовков терминов.
preferredToTerms

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов, которые предпочтительнее.
qualifiedName

string

Полное имя объекта глоссария.
replacedBy

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов, которые заменяются .
replacementTerms

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов для замены.
resources

ResourceLink[]

Массив ссылки на ресурс для термина
seeAlso

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов для см. также.
shortDescription

string

Краткая версия описания.
status

TermStatus

Состояние AtlasGlossaryTerm
synonyms

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов в качестве синонимов.
templateName

TemplateName[]

Имя шаблона.
translatedTerms

AtlasRelatedTermHeader[]

Массив переведенных связанных заголовков терминов.
translationTerms

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов для перевода.
updateTime

integer

Время обновления записи.
updatedBy

string

Пользователь, который обновил запись.
usage

string

Использование термина .
validValues

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов в качестве допустимых значений.
validValuesFor

AtlasRelatedTermHeader[]

Массив связанных заголовков терминов в качестве допустимых значений для других записей.

AtlasRelatedObjectId

Ссылка на экземпляр объекта типа AtlasEntity, используемого в значениях атрибута связи

Имя Тип Описание
displayText

string

Отображаемый текст.
entityStatus

EntityStatus

Состояние сущности — может быть активным или удаленным. Удаленные сущности не удаляются.
guid

string

GUID объекта .
relationshipAttributes

AtlasStruct

Записывает сведения о содержимом структуры. Экземпляр не создается напрямую, используется только через AtlasEntity, AtlasClassification.
relationshipGuid

string

GUID связи.
relationshipStatus

StatusAtlasRelationship

Перечисление состояния связи.
relationshipType

string

Тип отношений
typeName

string

Имя типа.
uniqueAttributes

Уникальные атрибуты объекта .

AtlasRelatedTermHeader

Заголовок связанного термина.

Имя Тип Описание
description

string

Описание связанного термина.
displayText

string

Отображаемый текст.
expression

string

Выражение термина .
relationGuid

string

GUID связи.
status

AtlasTermRelationshipStatus

Состояние связи терминов.
steward

string

Стюард термина.
termGuid

string

GUID термина.

AtlasStruct

Записывает сведения о содержимом структуры. Экземпляр не создается напрямую, используется только через AtlasEntity, AtlasClassification.

Имя Тип Описание
attributes

Атрибуты структуры.
lastModifiedTS

string

ETag для управления параллелизмом.
typeName

string

Имя типа.

AtlasTermCategorizationHeader

Основные сведения для классификации терминов.

Имя Тип Описание
categoryGuid

string

GUID категории.
description

string

Описание записи.
displayText

string

Отображаемый текст.
relationGuid

string

GUID связи.
status

AtlasTermRelationshipStatus

Состояние связи терминов.

AtlasTermRelationshipStatus

Состояние связи терминов atlas

Имя Тип Описание
ACTIVE

string

active
DEPRECATED

string

deprecated
DRAFT

string

Проект
OBSOLETE

string

устарело
OTHER

string

иное

EntityStatus

Состояние — может быть активным или удаленным

Имя Тип Описание
ACTIVE

string

Состояние активно.
DELETED

string

Состояние удалено.

PurviewObjectId

PurviewObjectId

Имя Тип Описание
displayText

string

Отображаемый текст
guid

string

GUID объекта .
itemPath

string

Путь к элементу
name

string

Имя
properties

Словарь
resourceId

string

Идентификатор ресурса
typeName

string

Имя типа.
uniqueAttributes

Уникальные атрибуты объекта .

ResourceLink

Имя Тип Описание
displayName

string

Отображаемое имя для URL-адреса.
url

string

url-адрес веб-сайта. HTTP или HTTPS

StatusAtlasRelationship

Состояние связи atlas

Имя Тип Описание
ACTIVE

string

active
DELETED

string

deleted

TermStatus

Состояние для термина

Имя Тип Описание
Alert

string

предупреждение
Approved

string

Утвержденных
Draft

string

Проект
Expired

string

Истек

TimeBoundary

Фиксирует сведения о границах времени

Имя Тип Описание
endTime

string

Конец границы времени.
startTime

string

Начало границы времени.
timeZone

string

Часовой пояс границы времени.